Interface ServiceFactory

    • Method Detail

      • getService

        @Deprecated
        <T> T getService​(java.lang.Class<T> clazz,
                         java.lang.String nodeName,
                         long timeout)
                  throws AttivioException
        Returns an implementation of the desired service API.

        Services come in two flavors. Some services are registered by a service provider and provide services through remote client implementations. Other services are built on an external platform such as a database. The latter are referred to as client-base services since from the AIE point of view, only a client is required. In either case, this method returns a (generally proxied) implementation that provides the service API.

        The timeout parameter is applicable only to registered services. This is because client-based services are provided externally and the ServiceFactory has no way of knowing if those services are up or not. For registered services, the timeout applies to the time for that service to be registered with the system. This lets callers wait a bit (say during a startup situation) for the service to come online but not wait indefinitely.

        When the timeout is in use, the service will be checked for registration every 100ms. A timeout < 0 will wait indefinitely. Regardless of the timeout, the availability of the service will always be tried at least once. That is, a low timeout or timeout of 0 will still succeed if the service is registered or is provided by a client-based API.

        Parameters:
        clazz - the class type of the desired API
        nodeName - name of the AIE node the service must be running on, or null if any node is fine.
        timeout - timeout in ms
        Returns:
        an implementation of the API or null if unavailable within the timeout.
        Throws:
        AttivioException
      • getService

        <T> T getService​(java.lang.Class<T> clazz,
                         java.util.Map<java.lang.String,​java.lang.String> attributes,
                         long timeout)
                  throws AttivioException
        Returns an implementation of the desired service API.

        Services come in two flavors. Some services are registered by a service provider and provide services through remote client implementations. Other services are built on an external platform such as a database. The latter are referred to as client-base services since from the AIE point of view, only a client is required. In either case, this method returns a (generally proxied) implementation that provides the service API.

        The timeout parameter is applicable only to registered services. This is because client-based services are provided externally and the ServiceFactory has no way of knowing if those services are up or not. For registered services, the timeout applies to the time for that service to be registered with the system. This lets callers wait a bit (say during a startup situation) for the service to come online but not wait indefinitely.

        When the timeout is in use, the service will be checked for registration every 100ms. A timeout < 0 will wait indefinitely. Regardless of the timeout, the availability of the service will always be tried at least once. That is, a low timeout or timeout of 0 will still succeed if the service is registered or is provided by a client-based API.

        Parameters:
        clazz - the class type of the desired API
        attributes - map of attributes that must match the service, or null or an empty map if any instance is fine. To match by node name, use a key value of nodeName and the the node name as the value.
        timeout - timeout in ms
        Returns:
        an implementation of the API or null if matching service unavailable within the timeout.
        Throws:
        AttivioException