JavaTM 2 Platform
Standard Ed. 6

javax.jws
註釋型別 WebParam


@Retention(value=RUNTIME)
@Target(value=PARAMETER)
public @interface WebParam

定制單個參數到 Web Service 訊息部分和 XML 元素的映射關係。


可選元素摘要
 boolean header
          如果為 true,則參數是從訊息頭而不是訊息正文獲取的。
 WebParam.Mode mode
          參數的串流向(IN、OUT 或 INOUT 之一)。
 String name
          參數名稱。
 String partName
          表示此參數的 wsdl:part 的名稱。
 String targetNamespace
          參數的 XML 名稱空間。
 

name

public abstract String name
參數名稱。

如果該操作是 rpc 樣式的,並且尚未指定 @WebParam.partName,則此名稱是表示參數的 wsdl:part 的名稱。
如果該操作是文檔樣式的,或者參數映射到某一個頭,則此名稱是表示參數的 XML 元素的本地名稱。

如果操作是文檔樣式的,參數樣式為 BARE 並且網要為 OUT 或 INOUT,則必須指定一個名稱。

預設值:
""

partName

public abstract String partName
表示此參數的 wsdl:part 的名稱。

此名稱僅在操作是 rpc 樣式,或者操作是文檔樣式且參數樣式為 BARE 時使用。

從以下版本開始:
2.0
預設值:
""

targetNamespace

public abstract String targetNamespace
參數的 XML 名稱空間。

僅在操作是文檔樣式或者參數映射到某一個頭時使用。如果目標名稱空間被設置為 "",則此名稱空間表示空名稱空間。

預設值:
""

mode

public abstract WebParam.Mode mode
參數的串流向(IN、OUT 或 INOUT 之一)。

OUT 和 INOUT 網要只是為那些符合 Holder 型別定義(JAX-WS 2.0 [5] 的第 2.3.3 節)的參數型別所指定的。Holder 型別的參數必須為 OUT 或 INOUT。

預設值:
javax.jws.WebParam.Mode.IN

header

public abstract boolean header
如果為 true,則參數是從訊息頭而不是訊息正文獲取的。

預設值:
false

JavaTM 2 Platform
Standard Ed. 6

提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only