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.

  • Method Summary

    Modifier and Type
    Method
    Description
    ServiceUserObject
    getUserObject()
    Obtains a ServiceUserObject from a Service.
    boolean
    init(ServiceSettings settings)
    Initialize the service with the specified service settings.
    boolean
    isRunning()
    Indicates whether or not a service is running.
    boolean
    start()
    This should start the service when called and return.
    boolean
    stop()
    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.