站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > JBoss 3.2.7 j2ee API Documentation 英文版文档

ManagedConnection (JBoss J2EE API) - JBoss 3.2.7 j2ee API Documentation 英文版文档


javax.resource.spi
Interface ManagedConnection


public interface ManagedConnection

A ManagedConnection instance represents a connection to the underlying recource. A ManagedConnection provides access to the two transaction interfaces, XAResource and LocalTransaction. These interfaces are used to manage transactions on the resource.


Method Summary
 void addConnectionEventListener(ConnectionEventListener listener)
          Adds a connection event listener
 void associateConnection(Object connection)
          Associates a new application level connection handle with the connection.
 void cleanup()
          Application server calls this to force cleanup of connection.
 void destroy()
          Destroys the connection to the underlying resource.
 Object getConnection(Subject subject, ConnectionRequestInfo cxRequestInfo)
          Creates a new connection handle for the underlying connection.
 LocalTransaction getLocalTransaction()
          Returns a LocalTransaction instance.
 PrintWriter getLogWriter()
          Gets the logwriter for this instance.
 ManagedConnectionMetaData getMetaData()
          Gets metadata inormation for this instances underlying resource manager instance.
 XAResource getXAResource()
          Returns an XAResource instance.
 void removeConnectionEventListener(ConnectionEventListener listener)
          Removes a connection event listener
 void setLogWriter(PrintWriter out)
          Sets the logwriter for this instance.
 

Method Detail

addConnectionEventListener

public void addConnectionEventListener(ConnectionEventListener listener)
Adds a connection event listener


removeConnectionEventListener

public void removeConnectionEventListener(ConnectionEventListener listener)
Removes a connection event listener


associateConnection

public void associateConnection(Object connection)
                         throws ResourceException
Associates a new application level connection handle with the connection.

Throws:
ResourceException

cleanup

public void cleanup()
             throws ResourceException
Application server calls this to force cleanup of connection.

Throws:
ResourceException

destroy

public void destroy()
             throws ResourceException
Destroys the connection to the underlying resource.

Throws:
ResourceException

getConnection

public Object getConnection(Subject subject,
                            ConnectionRequestInfo cxRequestInfo)
                     throws ResourceException
Creates a new connection handle for the underlying connection.

Throws:
ResourceException

getLocalTransaction

public LocalTransaction getLocalTransaction()
                                     throws ResourceException
Returns a LocalTransaction instance.

Throws:
ResourceException

getLogWriter

public PrintWriter getLogWriter()
                         throws ResourceException
Gets the logwriter for this instance.

Throws:
ResourceException

getMetaData

public ManagedConnectionMetaData getMetaData()
                                      throws ResourceException
Gets metadata inormation for this instances underlying resource manager instance.

Throws:
ResourceException

getXAResource

public XAResource getXAResource()
                         throws ResourceException
Returns an XAResource instance.

Throws:
ResourceException

setLogWriter

public void setLogWriter(PrintWriter out)
                  throws ResourceException
Sets the logwriter for this instance.

Throws:
ResourceException


Copyright © 2002 JBoss Group, LLC. All Rights Reserved.