Mechanism to manage the lifecycle of a resource adapter

• US 7,036,110 B2
• Filed: 03/25/2002
• Issued: 04/25/2006
• Est. Priority Date: 03/21/2002
• Status: Active Grant

• Current Assignee: Oracle America, Inc. (Oracle Corporation)
• Original Assignee: Sun Microsystems Incorporated (Oracle Corporation)
• Inventors: Jeyaraman, Thulasiraman
• Primary Examiner(s): Nguyen-Ba, Antony
• Application Number:
  US10/106,671
• Publication Number:
  US 20030182459A1
• Time in Patent Office: 1,492 Days
• Field of Search: 717120-121, 717/127, 717102-103, 719/310, 719/316, 719/318, 719/328, 719/330, 718/106, 709/203, 709/223, 709/224, 714/38, 714/48, 714/2, 712/244, 713/2
• US Class Current: 717/120
• CPC Class Codes: G06F 9/4416 Network booting; Remote initial program loading [RIPL]

Abstract

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.

Claims

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.