Package javax.xml.rpc.server
Interface ServiceLifecycle
public interface ServiceLifecycle
The
javax.xml.rpc.server.ServiceLifecycle
defines a lifecycle interface for a
JAX-RPC service endpoint. If the service endpoint class implements the
ServiceLifeycle
interface, the servlet container based JAX-RPC runtime system
is required to manage the lifecycle of the corresponding service endpoint objects.- Version:
- 1.0
-
Method Summary
-
Method Details
-
init
Used for initialization of a service endpoint. After a service endpoint instance (an instance of a service endpoint class) is instantiated, the JAX-RPC runtime system invokes theinit
method. The service endpoint class uses theinit
method to initialize its configuration and setup access to any external resources. The context parameter in theinit
method enables the endpoint instance to access the endpoint context provided by the underlying JAX-RPC runtime system.The init method implementation should typecast the context parameter to an appropriate Java type. For service endpoints deployed on a servlet container based JAX-RPC runtime system, the
context
parameter is of the Java typejavax.xml.rpc.server.ServletEndpointContext
. TheServletEndpointContext
provides an endpoint context maintained by the underlying servlet container based JAX-RPC runtime system- Parameters:
context
- Endpoint context for a JAX-RPC service endpoint- Throws:
ServiceException
- If any error in initialization of the service endpoint; or if any illegal context has been provided in the init method
-
destroy
void destroy()JAX-RPC runtime system ends the lifecycle of a service endpoint instance by invoking the destroy method. The service endpoint releases its resources in the implementation of the destroy method.
-