-
public interface Connection
A Connection represents an application-level handle that is used by a client to access the underlying physical connection. The actual physical connection associated with a Connection instance is represented by a ManagedConnection instance.A client gets a Connection instance by using the
getConnection
method on aConnectionFactory
instance. A connection can be associated with zero or more Interaction instances.- Version:
- 0.8
- Author:
- Rahul Sharma
- See Also:
ConnectionFactory
,Interaction
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method and Description void
close()
Initiates close of the connection handle at the application level.Interaction
createInteraction()
Creates an Interaction associated with this Connection.LocalTransaction
getLocalTransaction()
Returns an LocalTransaction instance that enables a component to demarcate resource manager local transactions on the Connection.ConnectionMetaData
getMetaData()
Gets the information on the underlying EIS instance represented through an active connection.ResultSetInfo
getResultSetInfo()
Gets the information on the ResultSet functionality supported by a connected EIS instance.
-
-
-
Method Detail
-
createInteraction
Interaction createInteraction() throws ResourceException
Creates an Interaction associated with this Connection. An Interaction enables an application to execute EIS functions.- Returns:
- Interaction instance
- Throws:
ResourceException
- Failed to create an Interaction
-
getLocalTransaction
LocalTransaction getLocalTransaction() throws ResourceException
Returns an LocalTransaction instance that enables a component to demarcate resource manager local transactions on the Connection. If a resource adapter does not allow a component to demarcate local transactions on an Connection using LocalTransaction interface, then the method getLocalTransaction should throw a NotSupportedException.- Returns:
- LocalTransaction instance
- Throws:
ResourceException
- Failed to return a LocalTransaction instance because of a resource adapter errorNotSupportedException
- Demarcation of Resource manager local transactions is not supported on this Connection- See Also:
LocalTransaction
-
getMetaData
ConnectionMetaData getMetaData() throws ResourceException
Gets the information on the underlying EIS instance represented through an active connection.- Returns:
- ConnectionMetaData instance representing information about the EIS instance
- Throws:
ResourceException
- Failed to get information about the connected EIS instance. Error can be resource adapter-internal, EIS-specific or communication related.
-
getResultSetInfo
ResultSetInfo getResultSetInfo() throws ResourceException
Gets the information on the ResultSet functionality supported by a connected EIS instance.- Returns:
- ResultSetInfo instance
- Throws:
ResourceException
- Failed to get ResultSet related informationNotSupportedException
- ResultSet functionality is not supported
-
close
void close() throws ResourceException
Initiates close of the connection handle at the application level. A client should not use a closed connection to interact with an EIS.- Throws:
ResourceException
- Exception thrown if close on a connection handle fails.Any invalid connection close invocation--example, calling close on a connection handle that is already closed--should also throw this exception.
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 18/08/2025 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-javaee-rf-javax/resource/cci/connection.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur van deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.