SOAPMessageクラスのメソッドを使用する場合の注意事項を示します。
- 次に示すメソッドの引数にnullは指定しないでください。nullを指定した場合の動作は保証されません。
- addAttachmentPart(AttachmentPart AttachmentPart)
- getAttachment(SOAPElement element)
- writeTo(OutputStream out)
- addAttachmentPart(AttachmentPart AttachmentPart)メソッドのAttachmentPart引数に空のAttachmentPartオブジェクトを指定しないでください。指定した場合の動作は保証されません。
- createAttachmentPart(Object content, String contentType)メソッドの第1引数には,第2引数に指定したMIMEタイプに適合するオブジェクトを指定してください。適合しないオブジェクトを指定した場合の動作は保証されません。また,nullを指定した場合の動作も保証されません。
- getAttachment(SOAPElement element)メソッドの引数に指定した要素の値やhref属性からAttachmentPartを参照する場合は,存在するAttachmentPartを示すCID URLスキーム(RFC 2392規定)を記述してください。存在しないAttachmentPartを示すCID URLスキームを記述した場合の動作は保証されません。
- getAttachments(MimeHeaders headers)メソッドを使用した場合の動作は保証されません。SOAPMessage#getAttachments()メソッドまたはgetAttachment(SOAPElement)メソッドでAttachmentPartを取得する必要があります。
- getProperty(String property)メソッドの引数にnullを指定した場合,nullが返されます。
- Application ServerのJAX-WS機能が対応しているSOAPメッセージの文字エンコードは,utf-8だけです。ただし,getProperty(String property)メソッドの引数にSOAPMessage.CHARACTER_SET_ENCODINGを指定してプロパティ値を取得する場合,nullが返される場合があります。
- SOAPMessage#setPropertyメソッドで対象プロパティを設定していない場合,getProperty(String property)メソッドにはnullが返されます。
- removeAttachments(MimeHeaders headers)メソッドの引数にnullを指定した場合,AttachmentPartはすべて削除されます。
- setContentDescription(String description)メソッドの引数にnullを指定した場合,Content-Descriptionヘッダには値が設定されません。空文字を指定した場合は,Content-Descriptionヘッダに空文字が設定されます。
- setProperty(String property, Object value)メソッドのproperty引数にはSOAPMessage.CHARACTER_SET_ENCODINGまたはSOAPMessage.WRITE_XML_DECLARATIONを指定してください。SOAPMessage.CHARACTER_SET_ENCODINGまたはSOAPMessage.WRITE_XML_DECLARATION以外のプロパティを指定しても,無視されます。
- setProperty(String property, Object value)メソッドのproperty引数にSOAPMessage.CHARACTER_SET_ENCODINGを指定する場合は,value引数にutf-8を指定してください。utf-8以外の値を指定した場合の動作は保証されません。
- setProperty(String property, Object value)メソッドのproperty引数にSOAPMessage.WRITE_XML_DECLARATIONを指定する場合は,"true"または"false"を指定してください。"true"または"false"以外を指定した場合の動作は保証されません。
- setProperty(String property, Object value)メソッドのproperty引数にnullを指定しないでください。指定した場合の動作は保証されません。
- Dispatch/ProviderでSOAPメッセージを送受信する場合,setProperty(String property, Object value)メソッドではプロパティを設定できません。プロパティを設定したい場合は,SOAPConnectionでSOAPメッセージを送受信してください。