Package javax.xml.rpc.server
Interface ServiceLifecycle
-
public interface ServiceLifecycle
Thejavax.xml.rpc.server.ServiceLifecycle
defines a lifecycle interface for a JAX-RPC service endpoint. If the service endpoint class implements theServiceLifeycle
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
All Methods Instance Methods Abstract Methods Modifier and Type Method Description void
destroy()
JAX-RPC runtime system ends the lifecycle of a service endpoint instance by invoking the destroy method.void
init(java.lang.Object context)
Used for initialization of a service endpoint.
-
-
-
Method Detail
-
init
void init(java.lang.Object context) throws ServiceException
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.
-
-