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 Detail

      • 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.