Mechanism to manage the lifecycle of a resource adapter
View Patent ↗Providing a contract between an application server and a resource adapter that allows the application server to manage the lifecycle of the resource adapter. When deploying a resource adapter (or during application server startup), an application server bootstraps a resource adapter instance in an appropriate address space. When a resource adapter is undeployed (or during application server shutdown), the application server notifies the resource adapter instance to stop functioning in order to allow safe unloading. The contract provides a mechanism for an application server to manage the lifecycle of a resource adapter instance, allowing an application server to bootstrap a resource adapter instance during resource adapter deployment or application server startup and to expose some of its useful facilities to the resource adapter instance. It also provides a mechanism to notify the resource adapter instance while it is undeployed or during an orderly shutdown of the application server.
1. A method for managing a lifecycle of a resource adapter by an application server, comprising:
configuring the resource adapter;
deploying the configured resource adapter, including instantiating a resource adapter instance in an associated memory space of the application server and exposing a set of application server facilities to the instantiated resource adapter instance;
bootstrapping the configured resource adapter by the application server; and
notifying the bootstrapped configured resource adapter to shutdown by the application server.
2. A method as recited in claim 1 , wherein the set of application server facilities includes, a work manager facility, a security manager facility, and a connection manager facility.
3. A method as recited in claim 1 , further comprising:
determining if an exception has been thrown during the bootstrapping;
if it has been determined that the exception has been thrown during the bootstrapping, then
stopping the bootstrapping; and
retrying the bootstrapping subsequent to the stopping.
4. A method as recited in claim 1 , further comprising:
determining if the application server is shutting down;
if it is determined that the application server is shutting down, then
notifying the resource adapter instance to stop functioning.
5. A method as recited in claim 4 , further comprising:
when the resource adapter has stopped functioning,
undeploying the stopped resource adapter.
6. An apparatus for managing a lifecycle of a resource adapter by an application server, comprising:
a processor; and
a memory storing computer instructions for:
configuring the resource adapter;
deploying the configured resource adapter, including instantiating a resource adapter instance in an associated memory space of the application server and exposing a set of application server facilities to the instantiated resource adapter instance;
bootstrapping the configured resource adapter by the application server; and
notifying the bootstrapped configured resource adapter to shutdown by the application server.
7. An apparatus as recited in claim 6 , wherein the set of application server facilities includes, a work manager facility, a security manager facility, and a connection manager facility.
8. An apparatus as recited in claim 6 , wherein the memory further includes computer instructions for:
determining if an exception has been thrown during the bootstrapping;
if it has been determined that the exception has been thrown during the bootstrapping, then
stopping the bootstrapping; and
retrying the bootstrapping subsequent to the stopping.
9. An apparatus as recited in claim 6 , wherein the memory further includes computer instructions for:
determining if the application server is shutting down;
if it is determined that the application server is shutting down, then
notifying the resource adapter instance to stop functioning.
10. An apparatus as recited in claim 9 , wherein the memory further includes computer instructions for:
when the resource adapter has stopped functioning,
undeploying the stopped resource adapter.
11. A computer program product, stored on a computer-readable storage medium, for managing a lifecycle of a resource adapter, comprising instructions operable to cause a computer to:
configure the resource adapter;
deploy the configured resource adapter, including instantiating a resource adapter instance in an associated memory space of the application server and exposing a set of application server facilities to the instantiated resource adapter instance;
bootstrap the configured resource adapter by the application server; and
notify the bootstrapped configured resource adapter to shutdown by the application server.
12. A computer program product as recited in claim 11 , wherein the set of application server facilities includes, a work manager facility, a security manager facility, and a connection manager facility.
13. A computer program product as recited in claim 11 , further comprising instructions to:
determine if an exception has been thrown during the bootstrapping;
if it has been determined that the exception has been thrown during the bootstrapping, then
stop the bootstrapping; and
retry the bootstrapping subsequent to the stopping.
14. A computer program product as recited in claim 11 , further comprising instructions to:
determine if the application server is shutting down;
if it is determined that the application server is shutting down, then
notify the resource adapter instance to stop functioning.
15. A computer program product as recited in claim 14 , further comprising instructions to:
when the resource adapter has stopped functioning,
undeploy the stopped resource adapter.