*** This class provides Binary Compatibility only, not Source Compatibility ***

com.sas.services.deployment
Class RMIBinding

com.sas.services.deployment.RMIBinding

All Implemented Interfaces:

DeployInterface, java.io.Serializable

public final class RMIBinding
implements DeployInterface, java.io.Serializable

RMI binding that associates an RMI remote/activatable object with a name bound to an rmiregistry. The RMI registry information is specified by the associated RMIConfiguration.

Since:

1.0

See Also:

RMIConfiguration, Serialized Form

Field Summary

static java.lang.String	BINDING_TYPE_BIND RMI binding type: bind
static java.lang.String	BINDING_TYPE_LOOKUP RMI binding type: lookup
static java.lang.String	BINDING_TYPE_REBIND RMI binding type: rebind
static java.lang.String	LOCALHOST String constant denoting the local host.
static short	RMI_BINDING_BIND RMI binding: bind remote to the rmiregistry
static short	RMI_BINDING_INVALID RMI binding: unitialized
static short	RMI_BINDING_LOOKUP RMI binding: lookup remote in the rmiregistry
static short	RMI_BINDING_REBIND RMI binding: rebind remote to the rmiregistry

Constructor Summary

RMIBinding(RMIConfiguration rmiConfiguration, java.lang.String bindName, short binding)
Constructor specifying the RMI configuration and the bind name for the RMI remote/activatable object.

Method Summary

RemoteServiceInterface	deploy() Deploys the class in-process (within the same JVM).
ActivatableWrapper	getActivatable() Gets a wrapper class encapsulating an RMI activatable object.
static short	getBinding(java.lang.String bindingType) Translates a string value representing the binding to a short.
java.lang.String	getBindName() Gets the name by which the remote/activatable object is to be bound to the rmiregistry.
java.rmi.Remote	getRemoteObject() Gets the remote object.
RMIConfiguration	getRMIConfiguration() Gets the RMI configuration, host and port, for this binding.
java.lang.String	getUrl() Gets the URL used to access the RMI service via its bind name at the using the RMI configuration.
boolean	isActivatable() Determines whether or not this binding contains an RMI activatable object.
boolean	isBind() Determines whether or not the remote is associated with an RMI registry via a "bind".
boolean	isNamingLookup() Determines whether or not a naming lookup should be done to obtain a remote object..
boolean	isRebind() Gets the preference to rebind or bind when associating a remote with an rmiregistry.
boolean	isRegisterWithRMI() Gets the preference to bind or not to bind a remote object to the rmiregistry.
void	setActivatable(ActivatableWrapper activatableWrapper) Sets the activatable.
void	setBinding(short bindingType) Sets the RMI binding type.
void	setBindName(java.lang.String bindName) Sets the name to be bound to the rmiregistry.
void	setRegisterWithRMI(boolean registerWithRMI) Specifies whether or not to bind the remote object to the rmiregistry.
void	setRemoteObject(java.rmi.Remote remoteObject) Sets the remote object to be bound to the rmiregistry.
void	setRMIConfiguration(RMIConfiguration rmiConfiguration) Sets the RMI configuration that describes the host and port.
java.lang.String	toString() Gets a string representation of this instance.
void	unbind() Unbinds the name binding from the RMI registry.

Field Detail

LOCALHOST

public static final java.lang.String LOCALHOST

String constant denoting the local host.

See Also:

Constant Field Values

BINDING_TYPE_BIND

public static final java.lang.String BINDING_TYPE_BIND

RMI binding type: bind

See Also:

BINDING_TYPE_REBIND, BINDING_TYPE_LOOKUP, Constant Field Values

BINDING_TYPE_REBIND

public static final java.lang.String BINDING_TYPE_REBIND

RMI binding type: rebind

See Also:

BINDING_TYPE_BIND, BINDING_TYPE_LOOKUP, Constant Field Values

BINDING_TYPE_LOOKUP

public static final java.lang.String BINDING_TYPE_LOOKUP

RMI binding type: lookup

See Also:

BINDING_TYPE_BIND, BINDING_TYPE_REBIND, Constant Field Values

RMI_BINDING_INVALID

public static final short RMI_BINDING_INVALID

RMI binding: unitialized

See Also:

Constant Field Values

RMI_BINDING_BIND

public static final short RMI_BINDING_BIND

RMI binding: bind remote to the rmiregistry

See Also:

Constant Field Values

RMI_BINDING_REBIND

public static final short RMI_BINDING_REBIND

RMI binding: rebind remote to the rmiregistry

See Also:

Constant Field Values

RMI_BINDING_LOOKUP

public static final short RMI_BINDING_LOOKUP

RMI binding: lookup remote in the rmiregistry

See Also:

Constant Field Values

Constructor Detail

RMIBinding

public RMIBinding(RMIConfiguration rmiConfiguration,
                  java.lang.String bindName,
                  short binding)
           throws ServiceException

Constructor specifying the RMI configuration and the bind name for the RMI remote/activatable object.

Parameters:

rmiConfiguration - RMI configuration in terms of the host and port.

bindName - Name by which the RMI remote/activatable object is to be bound to the rmiregistry.

binding - RMI binding. One of

• RMI_BINDING_BIND
• RMI_BINDING_REBIND
• RMI_BINDING_LOOKUP

Throws:

ServiceException - if unable to construct an RMI binding.

Method Detail

getBinding

public static short getBinding(java.lang.String bindingType)

Translates a string value representing the binding to a short.

Parameters:

bindingType - RMI binding type which must be one of "RMI_REBIND", "RMI_BIND" or "RMI_LOOKUP".

Returns:

Code representing the RMI binding or RMIBinding.RMI_BINDING_INVALID if an invalid binding was specified.

setBinding

public void setBinding(short bindingType)
                throws ServiceException

Sets the RMI binding type. The type must be one of:

• RMIBinding.RMI_BINDING_BIND
• RMIBinding.RMI_BINDING_REBIND
• RMIBinding.RMI_BINDING_LOOKUP

Parameters:

bindingType - RMI binding type.

Throws:

ServiceException - if an invalid binding type is specified.

getBindName

public java.lang.String getBindName()

Gets the name by which the remote/activatable object is to be bound to the rmiregistry.

Returns:

The name by which the remote/activatable object is to be bound to the rmiregistry.

setBindName

public void setBindName(java.lang.String bindName)

Sets the name to be bound to the rmiregistry.

Parameters:

bindName - The name by which the remote/activatable object is to be bound.

isRegisterWithRMI

public boolean isRegisterWithRMI()

Gets the preference to bind or not to bind a remote object to the rmiregistry.

Returns:

true if the remote is to be bound to the rmiregistry.

isRebind

public boolean isRebind()

Gets the preference to rebind or bind when associating a remote with an rmiregistry.

Returns:

true if the remote is to be associated with an rmiregistry using a "rebind" which will replace any currently registered remote or false if a "bind" is desired. Note that if a "bind" is requested and a remote is already registered, then the registration will fail.

isBind

public boolean isBind()

Determines whether or not the remote is associated with an RMI registry via a "bind".

Returns:

true if the remote is to be associated with an rmiregistry using a "bind".

isNamingLookup

public boolean isNamingLookup()

Determines whether or not a naming lookup should be done to obtain a remote object..

Returns:

true if a naming lookup should occur. If false then check isRebind() to determine whether a remote object should be registered with RMI via a rebind or bind operation.

setRegisterWithRMI

public void setRegisterWithRMI(boolean registerWithRMI)

Specifies whether or not to bind the remote object to the rmiregistry.

Parameters:

registerWithRMI - true if the remote is to be bound to the rmiregistry.

getRMIConfiguration

public RMIConfiguration getRMIConfiguration()

Gets the RMI configuration, host and port, for this binding.

Returns:

RMI configuration.

setRMIConfiguration

public void setRMIConfiguration(RMIConfiguration rmiConfiguration)

Sets the RMI configuration that describes the host and port.

Parameters:

rmiConfiguration - RMI configuration associated with this binding.

isActivatable

public boolean isActivatable()

Determines whether or not this binding contains an RMI activatable object.

Returns:

true if an activatable object is defined and false if one isn't defined.

getActivatable

public ActivatableWrapper getActivatable()

Gets a wrapper class encapsulating an RMI activatable object.

Returns:

A wrapper class containing an RMI activatable object.

setActivatable

public void setActivatable(ActivatableWrapper activatableWrapper)

Sets the activatable.

Parameters:

activatableWrapper - Wrapper encapsulating an RMI activatable object.

getRemoteObject

public java.rmi.Remote getRemoteObject()

Gets the remote object.

Returns:

Remote object.

setRemoteObject

public void setRemoteObject(java.rmi.Remote remoteObject)

Sets the remote object to be bound to the rmiregistry.

Parameters:

remoteObject - Remote object to be bound to RMI.

getUrl

public java.lang.String getUrl()

Gets the URL used to access the RMI service via its bind name at the using the RMI configuration.

Returns:

URL used to bind a name to an rmiregistry.

deploy

public RemoteServiceInterface deploy()
                              throws ServiceException

Deploys the class in-process (within the same JVM). The following deployment modes are supported:

• Binding of a remote object to the rmiregistry
• Lookup of a pre-existing remote object in the rmiregistry

Specified by:

deploy in interface DeployInterface

Returns:

Deployed service.

Throws:

ServiceException - if unable to deploy the service.

See Also:

DeployInterface.deploy()

toString

public java.lang.String toString()

Gets a string representation of this instance. Intended for debugging purposes.

Overrides:

toString in class java.lang.Object

Returns:

Debug statement describing this instance.

unbind

public void unbind()

Unbinds the name binding from the RMI registry.

*** This class provides Binary Compatibility only, not Source Compatibility ***