| 
 | J2EE1.4 SDK | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
ConnectionFactory provides an interface for getting
  connection to an EIS instance. An implementation of ConnectionFactory
  interface is provided by a resource adapter.
  
Application code looks up a ConnectionFactory instance from JNDI namespace and uses it to get EIS connections.
An implementation class for ConnectionFactory is required to 
  implement java.io.Serializable and 
  javax.resource.Referenceableinterfaces to support 
  JNDI registration.
Connection, 
Referenceable| Method Summary | |
|  Connection | getConnection()Gets a connection to an EIS instance. | 
|  Connection | getConnection(ConnectionSpec properties)Gets a connection to an EIS instance. | 
|  ResourceAdapterMetaData | getMetaData()Gets metadata for the Resource Adapter. | 
|  RecordFactory | getRecordFactory()Gets a RecordFactory instance. | 
| Methods inherited from interface javax.resource.Referenceable | 
| setReference | 
| Methods inherited from interface javax.naming.Referenceable | 
| getReference | 
| Method Detail | 
public Connection getConnection()
                         throws ResourceException
ResourceException - Failed to get a connection to
                                the EIS instance. Examples of
                                error cases are:
          
public Connection getConnection(ConnectionSpec properties)
                         throws ResourceException
It is important to note that the properties passed through the getConnection method should be client-specific (example: username, password, language) and not related to the configuration of a target EIS instance (example: port number, server name). The ManagedConnectionFactory instance is configured with complete set of properties required for the creation of a connection to an EIS instance.
properties - Connection parameters and security
                              information specified as 
                              ConnectionSpec instance
ResourceException - Failed to get a connection to
                              the EIS instance. Examples of
                              error cases are:
          ConnectionSpec
public RecordFactory getRecordFactory()
                               throws ResourceException
ResourceException - Failed to create a RecordFactory
NotSupportedException - Operation not supported
public ResourceAdapterMetaData getMetaData()
                                    throws ResourceException
ResourceException - Failed to get metadata information 
                              about the resource adapter| 
 | J2EE1.4 SDK | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
Copyright 2003 Sun Microsystems, Inc. All rights reserved.