22.1.15 SOAPMessageクラス
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メッセージを送受信してください。