WebResult (Java EE 5)

Java EE API


javax.jws Annotation Type WebResult


@Retention(value=RUNTIME)
@Target(value=METHOD)
public @interface WebResult

Implements: Annotation
@Retention(value=RUNTIME)
@Target(value=METHOD)

定制返回值到 WSDL 部分和 XML 元素的映射关系。
英文文档:

Customizes the mapping of the return value to a WSDL part and XML element.

Author:
Copyright (c) 2004 by BEA Systems, Inc. All Rights Reserved.

Optional Element Summary
 boolean
 String
 String
 String
 

abstract public String name()
返回值的名称。

如果操作是 rpc 样式,并且尚未指定

specdefault 如果操作是文档样式并且参数样式为 BARE,则默认名称为 @WebParam.operationName+?Response?;
否则为 return。

英文文档:

name

public abstract String name
Name of return value.

If the operation is rpc style and @WebResult.partName has not been specified, this is the name of the wsdl:part representing the return value.
If the operation is document style or the return value maps to a header, this is the local name of the XML element representing the return value.

Default:
""

abstract public String partName()
表示此返回值的 wsdl:part 的名称。

此名称只在操作是 rpc 样式,或者操作是文档样式且参数样式为 BARE 时使用。

specdefault {@code
since2.0

英文文档:

partName

public abstract String partName
The name of the wsdl:part representing this return value.

This is only used if the operation is rpc style, or if the operation is document style and the parameter style is BARE.

Since:
2.0
Default:
""

abstract public String targetNamespace()
返回值的 XML 名称空间。

只在操作是文档样式或者返回值映射到某一个头时使用。如果目标名称空间被设置为 ,则此名称空间表示空名称空间。

specdefault 如果操作是文档样式,参数样式是 WRAPPED,并且返回值没有映射到某一个头,则默认名称空间为空名称空间。
否则,为 Web Service 的 targetNamespace。

英文文档:

targetNamespace

public abstract String targetNamespace
The XML namespace for the return value.

Only used if the operation is document style or the return value maps to a header. If the target namespace is set to ??, this represents the empty namespace.

Default:
""

abstract public boolean header()
如果为 true,则结果是从消息头而不是消息正文获取的。
since2.0
英文文档:

header

public abstract boolean header
If true, the result is pulled from a message header rather then the message body.

Since:
2.0
Default:
false


Submit a bug or feature

Copyright 2007 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.

一看就知道只有菜鸟才干这么无知的事啦。

PS : 未经我党受权你也可自由散发此文档。 如有任何错误请自行修正;若因此而造成任何损失请直接找人民主席,请勿与本人联系。谢谢!