-
public interface BootstrapContext
This provides a mechanism to pass a bootstrap context to a resource adapter instance when it is bootstrapped. That is, when (start(BootstrapContext)
) method on theResourceAdapter
class is invoked. The bootstrap context contains references to useful facilities that could be used by the resource adapter instance.- Version:
- Java EE Connector Architecture 1.6
- Author:
- Ram Jeyaraman, Sivakumar Thyagarajan
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method and Description Timer
createTimer()
Creates a newjava.util.Timer
instance.TransactionSynchronizationRegistry
getTransactionSynchronizationRegistry()
Provides a handle to aTransactionSynchronization
instance.WorkManager
getWorkManager()
Provides a handle to aWorkManager
instance.XATerminator
getXATerminator()
Provides a handle to aXATerminator
instance.boolean
isContextSupported(Class<? extends WorkContext> workContextClass)
A resource adapter can check an application server's support for a particular WorkContext type through this method.
-
-
-
Method Detail
-
getWorkManager
WorkManager getWorkManager()
Provides a handle to aWorkManager
instance. TheWorkManager
instance could be used by a resource adapter to do its work by submittingWork
instances for execution.- Returns:
- a
WorkManager
instance.
-
getXATerminator
XATerminator getXATerminator()
Provides a handle to aXATerminator
instance. TheXATerminator
instance could be used by a resource adapter to flow-in transaction completion and crash recovery calls from an EIS.- Returns:
- a
XATerminator
instance.
-
createTimer
Timer createTimer() throws UnavailableException
Creates a newjava.util.Timer
instance. TheTimer
instance could be used to perform periodicWork
executions or other tasks.- Returns:
- a new
Timer
instance. - Throws:
UnavailableException
- indicates that aTimer
instance is not available. The request may be retried later.
-
isContextSupported
boolean isContextSupported(Class<? extends WorkContext> workContextClass)
A resource adapter can check an application server's support for a particular WorkContext type through this method. This mechanism enables a resource adapter developer to dynamically change the WorkContexts submitted with a Work instance based on the support provided by the application server. The application server must employ an exact type equality check (that isjava.lang.Class.equals(java.lang.Class)
check) in this method, to check if it supports the WorkContext type provided by the resource adapter. This method must be idempotent, that is all calls to this method by a resource adapter for a particularWorkContext
type must return the same boolean value throughout the lifecycle of that resource adapter instance.- Parameters:
workContextClass
- The WorkContext type that is tested for support by the application server.- Returns:
- true if the
workContextClass
is supported by the application server. false if theworkContextClass
is unsupported or unknown to the application server. - Since:
- 1.6
-
getTransactionSynchronizationRegistry
TransactionSynchronizationRegistry getTransactionSynchronizationRegistry()
Provides a handle to aTransactionSynchronization
instance. TheTransactionSynchronizationRegistry
instance could be used by a resource adapter to register synchronization objects, get transaction state and status etc. This interface is implemented by the application server by a stateless service object. The same object can be used by any number of resource adapter objects with thread safety.- Returns:
- a
TransactionSynchronizationRegistry
instance. - Since:
- 1.6
-
-
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/spi/bootstrapcontext.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.