Package javax.xml.rpc.server

Interface ServiceLifecycle

public interface ServiceLifecycle
The javax.xml.rpc.server.ServiceLifecycle defines a lifecycle interface for a Jakarta XML RPC service endpoint. If the service endpoint class implements the ServiceLifeycle interface, the servlet container based Jakarta XML RPC runtime system is required to manage the lifecycle of the corresponding service endpoint objects.
Version:
1.0
Author:
Rahul Sharma

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    destroy()
    Jakarta XML RPC runtime system ends the lifecycle of a service endpoint instance by invoking the destroy method.
    void
    init(Object context)
    Used for initialization of a service endpoint.

  • Method Details

    • init

      void init(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 Jakarta XML RPC runtime system invokes the init method. The service endpoint class uses the init method to initialize its configuration and setup access to any external resources. The context parameter in the init method enables the endpoint instance to access the endpoint context provided by the underlying Jakarta XML 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 Jakarta XML RPC runtime system, the context parameter is of the Java type javax.xml.rpc.server.ServletEndpointContext. The ServletEndpointContext provides an endpoint context maintained by the underlying servlet container based Jakarta XML RPC runtime system

      Parameters:
      context - Endpoint context for a Jakarta XML 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()
      Jakarta XML RPC runtime system ends the lifecycle of a service endpoint instance by invoking the destroy method. The service endpoint releases its resourcesin the implementation of the destroy method.