javax.resource.spi
Interface ResourceAdapterAssociation

All Known Subinterfaces:

ActivationSpec

public interface ResourceAdapterAssociation

This interface specifies the methods to associate a ResourceAdapter object with other objects that implement this interface like ManagedConnectionFactory and ActivationSpec.

Version:

1.0

Author:

Ram Jeyaraman

Method Summary

ResourceAdapter	getResourceAdapter() Get the associated ResourceAdapter object.
void	setResourceAdapter(ResourceAdapter ra) Associate this object with a ResourceAdapter object.

Method Detail

getResourceAdapter

public ResourceAdapter getResourceAdapter()

Get the associated ResourceAdapter object.

Returns:

the associated ResourceAdapter object.

setResourceAdapter

public void setResourceAdapter(ResourceAdapter ra)
                        throws ResourceException

Associate this object with a ResourceAdapter object. Note, this method must be called exactly once. That is, the association must not change during the lifetime of this object.

Parameters:

ra - ResourceAdapter object to be associated with.

Throws:

ResourceException - generic exception.

ResourceAdapterInternalException - resource adapter related error condition.

IllegalStateException - indicates that this object is in an illegal state for the method invocation. For example, this occurs when this method is called more than once on the same object.