This subsection describes the notes on using the methods of the SOAPMessage class.

• Do not specify null in the arguments of the following methods. If null is specified, the operations are not guaranteed.
  
  • addAttachmentPart(AttachmentPart AttachmentPart)
  • getAttachment(SOAPElement element)
  • writeTo(OutputStream out)
• Do not specify a blank AttachmentPart object in the AttachmentPart argument of the addAttachmentPart(AttachmentPart AttachmentPart) method. If specified, the operations are not guaranteed.
• In the first argument of the createAttachmentPart(Object content, String contentType) method, specify an object suitable to the MIME type specified in the second argument. If an unsuitable object is specified, the operations are not guaranteed. Also, if null is specified, the operations are not guaranteed.
• To reference AttachmentPart from the element value and the href attribute specified in the arguments of the getAttachment(SOAPElement element) method, code the CID URL schema (RFC 2392 rule) indicating the existing AttachmentPart. If the CID URL schema indicating a non-existent AttachmentPart is coded, the operations are not guaranteed.
• When the getAttachments(MimeHeaders headers) method is used, the operations are not guaranteed. You must obtain AttachmentPart with the SOAPMessage#getAttachments() or getAttachment(SOAPElement) methods.
• If null is specified in the arguments of the getProperty(String property) method, null is returned.
• The Cosminexus JAX-WS functionality only supports utf-8 as the character encoding for the SOAP messages. However, if the property value is acquired by specifying SOAPMessage.CHARACTER_SET_ENCODING in the arguments of the getProperty(String property) method, null might be returned.
• If the target property is not set up with the SOAPMessage#setProperty method, null is returned in the getProperty(String property) method.
• If null is specified in the arguments of the removeAttachments(MimeHeaders headers) method, all AttachmentPart are deleted.
• If null is specified in the arguments of the setContentDescription(String description) method, the value is not set up in the Content-Description header. If null is specified, null is set up in the Content-Description header.
• Specify SOAPMessage.CHARACTER_SET_ENCODING or SOAPMessage.WRITE_XML_DECLARATION in the property argument of the setProperty(String property, Object value) method. Other properties, even if specified, are ignored.
• When you specify SOAPMessage.CHARACTER_SET_ENCODING in the property argument of the setProperty(String property, Object value) method, specify utf-8 in the value argument. If a value other than utf-8 is specified, the operations are not guaranteed.
• When you specify SOAPMessage.WRITE_XML_DECLARATION in the property argument of the setProperty(String property, Object value) method, specify "true" or "false". If a value other than "true" or "false" is specified, the operations are not guaranteed.
• Do not specify null in the property argument of the setProperty(String property, Object value) method. If specified, the operations are not guaranteed.
• When a SOAP message is sent and received using Dispatch/ Provider, the properties cannot be set with the setProperty(String property, Object value) method. If you want to set up the properties, send and receive the SOAP message with SOAPConnection.