Package org.jcsp.net

Interface Service

All Known Subinterfaces:
SecurityService
All Known Implementing Classes:
CNS, CNSService, DynamicClassLoader, SimpleSecurityAuthority

public interface Service

An interface that should be implemented by classes that are intended to be Node level JCSP.NET services.

Services should be initialized, then started and then stopped.

Author:
Quickstone Technologies Limited
  • Method Summary

    Modifier and Type
    Method
    Description
    Obtains a ServiceUserObject from a Service.
    boolean
    Initialize the service with the specified service settings.
    boolean
    Indicates whether or not a service is running.
    boolean
    This should start the service when called and return.
    boolean
    Should stop the service and then return.
  • Method Details

    • start

      boolean start()
      This should start the service when called and return.
      Returns:
      true iff the service has successfully started.
    • stop

      boolean stop()
      Should stop the service and then return.
      Returns:
      true iff the service has successfully stopped.
    • init

      boolean init(ServiceSettings settings)
      Initialize the service with the specified service settings.
      Parameters:
      settings - The settings used by the service.
      Returns:
      true iff the service has been initialized.
    • isRunning

      boolean isRunning()
      Indicates whether or not a service is running.
      Returns:
      true iff the service is currently running.
    • getUserObject

      ServiceUserObject getUserObject() throws SecurityException
      Obtains a ServiceUserObject from a Service. This allows Services to expose functionality to users that it does not want to be able to access admin features.
      Returns:
      a ServiceUserObject.
      Throws:
      SecurityException - if the calling Thread does not have access to the object.