Module jakarta.resource

Package jakarta.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

Method Summary

Modifier and Type	Method	Description
ResourceAdapter	getResourceAdapter()	Get the associated ResourceAdapter object.
void	setResourceAdapter(ResourceAdapter ra)	Associate this object with a ResourceAdapter object.

Method Details

getResourceAdapter

ResourceAdapter getResourceAdapter()

Get the associated ResourceAdapter object.

Returns:

the associated ResourceAdapter object.

setResourceAdapter

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.