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