javax.xml.rpc
Interface Stub

All Known Subinterfaces:

Stub (src)

All Known Implementing Classes:

Stub (src)

public interface 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.

USERNAME_PROPERTY

public static final java.lang.String USERNAME_PROPERTY

Standard property: User name for authentication.

See Also:

Constant Field Values (src)

PASSWORD_PROPERTY

public static final java.lang.String PASSWORD_PROPERTY

Standard property: Password for authentication.

See Also:

Constant Field Values (src)

ENDPOINT_ADDRESS_PROPERTY

public static final java.lang.String ENDPOINT_ADDRESS_PROPERTY

Standard property: Target service endpoint address.

See Also:

Constant Field Values (src)

SESSION_MAINTAIN_PROPERTY

public static final java.lang.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.

See Also:

Constant Field Values (src)

_getPropertyNames

public java.util.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

_getProperty

public java.lang.Object _getProperty(java.lang.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 (src) - if an invalid or unsupported property name is passed.

_setProperty

public void _setProperty(java.lang.String name,
                         java.lang.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 (src) - 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.