Stub (Java EE 5)

Java EE API


javax.xml.rpc Interface Stub


public interface Stub


接口 javax.xml.rpc.Stub 是 Stub 类的公共基本接口。所有生成的 Stub 类都需要实现 javax.xml.rpc.Stub 接口。Stub 类的实例表示目标服务端口的客户端代理或 Stub 实例。

javax.xml.rpc.Stub 接口为动态配置 Stub 实例提供了一个可扩展的属性机制。

英文文档:

The interface javax.xml.rpc.Stub is the common base interface for the stub classes. All generated stub classes are required to implement the javax.xml.rpc.Stub interface. An instance of a stub class represents a client side proxy or stub instance for the target service endpoint.

The javax.xml.rpc.Stub interface provides an extensible property mechanism for the dynamic configuration of a stub instance.

Version:
0.1
Author:
Rahul Sharma
See Also:
Service

Field Summary
static String
static String
static String
static String
 
Method Summary
 Object
 Iterator
 void
 

Field Detail

英文文档:

USERNAME_PROPERTY

static final String USERNAME_PROPERTY
Standard property: User name for authentication.

Type: java.lang.String

See Also:
Constant Field Values


英文文档:

PASSWORD_PROPERTY

static final String PASSWORD_PROPERTY
Standard property: Password for authentication.

Type: java.lang.String

See Also:
Constant Field Values


英文文档:

ENDPOINT_ADDRESS_PROPERTY

static final String ENDPOINT_ADDRESS_PROPERTY
Standard property: Target service endpoint address. The URI scheme for the endpoint address specification must correspond to the protocol/transport binding for this stub class.

Type: java.lang.String

See Also:
Constant Field Values


英文文档:

SESSION_MAINTAIN_PROPERTY

static final String SESSION_MAINTAIN_PROPERTY
Standard property: This boolean property is used by a service client to indicate whether or not it wants to participate in a session with a service endpoint. If this property is set to true, the service client indicates that it wants the session to be maintained. If set to false, the session is not maintained. The default value for this property is false.

Type: java.lang.Boolean

See Also:
Constant Field Values

Method Detail

public void _setProperty(String name, Object value)
设置此 Stub 实例的配置属性的名称和值。如果 Stub 实例包含相同属性的值,那么将替换旧值。

注意,_setProperty 方法可能不检查已配置属性值的有效性。例如,对于目标服务端口地址的标准属性,_setProperty 方法不会检查其有效性。在这种情况下,Stub 配置错误在远程方法调用时检测。

name 配置属性的名称
value 属性的值
ThrowsJAXRPCException:
  • 如果指定了可一个选标的准属性名称,但此 Stub 实现类不支持此属性的配置。
  • 如果指定了无效(或不受支持的)的属性名称,或者传递了不匹配属性类型的值。
  • 如果配置有效属性的过程中出现错误。

英文文档:

_setProperty

void _setProperty(String name,
                  Object value)
Sets the name and value of a configuration property for this Stub instance. If the Stub instances contains a value of the same property, the old value is replaced.

Note that the _setProperty method may not perform validity check on a configured property value. An example is the standard property for the target service endpoint address that is not checked for validity in the _setProperty method. In this case, stub configuration errors are detected at the remote method invocation.

Parameters:
name - Name of the configuration property
value - Value of the property
Throws:
JAXRPCException -
  • If an optional standard property name is specified, however this Stub implementation class does not support the configuration of this property.
  • If an invalid or unsupported property name is specified or if a value of mismatched property type is passed.
  • If there is any error in the configuration of a valid property.

public Object _getProperty(String name)
获取特定配置属性的值。
name 将获取其值的属性的名称
return 配置属性的值
ThrowsJAXRPCException: 如果传递无效或不受支持的属性名称。
英文文档:

_getProperty

Object _getProperty(String name)
Gets the value of a specific configuration property.

Parameters:
name - Name of the property whose value is to be retrieved
Returns:
Value of the configuration property
Throws:
JAXRPCException - if an invalid or unsupported property name is passed.

public java.util.Iterator<E> _getPropertyNames()
返回可在此 Stub 实例上配置的属性名称的 Iterator 视图。
return 类型为 java.lang.String 的属性名称的 Iterator
英文文档:

_getPropertyNames

Iterator _getPropertyNames()
Returns an Iterato view of the names of the properties that can be configured on this stub instance.

Returns:
Iterator for the property names of the type java.lang.String


Submit a bug or feature

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

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

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