org.jboss.ejb.client

Class EJBHandle<T extends EJBObject>

java.lang.Object

org.jboss.ejb.client.EJBHandle<T>

Type Parameters:

T - the EJB remote interface type

All Implemented Interfaces:

Serializable, Handle

public final class EJBHandle<T extends EJBObject>
extends Object
implements Handle

A handle for an EJB interface.

Author:

David M. Lloyd

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
EJBHandle(EJBLocator<T> locator) Construct a new instance.

Method Summary

Modifier and Type	Method and Description
static <T extends EJBObject> EJBHandle<T>	create(EJBLocator<T> locator) Construct a new instance.
boolean	equals(EJBHandle<?> other) Determine whether this object is equal to another.
boolean	equals(Object other) Determine whether this object is equal to another.
T	getEJBObject() Obtains the EJB object reference represented by this handle.
EJBLocator<T>	getLocator() Get the locator for this handle.
int	hashCode() Get the hash code for this EJB handle.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

EJBHandle

public EJBHandle(EJBLocator<T> locator)

Construct a new instance.

Parameters:

locator - the locator for the EJB instance

Method Detail

create

public static <T extends EJBObject> EJBHandle<T> create(EJBLocator<T> locator)

Construct a new instance.

Type Parameters:

T - the EJB object type

Parameters:

locator - the locator for the EJB instance (must not be null)

Returns:

the handle (not null)

getEJBObject

public T getEJBObject()
               throws RemoteException

Obtains the EJB object reference represented by this handle.

Specified by:

getEJBObject in interface Handle

Returns:

The EJB object reference represented by this handle.

Throws:

RemoteException - - The EJB object could not be obtained because of a system-level failure.

equals

public boolean equals(Object other)

Determine whether this object is equal to another.

Overrides:

equals in class Object

Parameters:

other - the other object

Returns:

true if they are equal, false otherwise

equals

public boolean equals(EJBHandle<?> other)

Determine whether this object is equal to another.

Parameters:

other - the other object

Returns:

true if they are equal, false otherwise

hashCode

public int hashCode()

Get the hash code for this EJB handle.

Overrides:

hashCode in class Object

Returns:

the hash code

getLocator

public EJBLocator<T> getLocator()

Get the locator for this handle.

Returns:

the locator for this handle