All Known Implementing Classes:

MockServiceFactory, ServiceFactoryObject
```
public interface ServiceFactory
```
Factory for getting and using registered Attivio APIs.

Method Summary

All Methods Instance Methods Abstract Methods Deprecated Methods
Modifier and Type	Method	Description
`<T> T`	`getService(java.lang.Class<T> clazz)`	See `getService(Class, String, long)`.
`<T> T`	`getService(java.lang.Class<T> clazz, long timeout)`	See `getService(Class, String, long)`.
`<T> T`	`getService(java.lang.Class<T> clazz, java.lang.String nodeName)`	See `getService(Class, String, long)`.
`<T> T`	`getService(java.lang.Class<T> clazz, java.lang.String nodeName, long timeout)`	Deprecated. use `getService(Class, Map, long)`
`<T> T`	`getService(java.lang.Class<T> clazz, java.util.Map<java.lang.String,java.lang.String> attributes, long timeout)`	Returns an implementation of the desired service API.

- Method Detail
  - getService
```
<T> T getService(java.lang.Class<T> clazz)
          throws AttivioException
```
    See getService(Class, String, long). Node will default to null and timeout will be -1L.
    
    Throws:
    
    AttivioException
  - getService
```
<T> T getService(java.lang.Class<T> clazz,
                 long timeout)
          throws AttivioException
```
    See getService(Class, String, long). Node will default to null.
    
    Throws:
    
    AttivioException
  - getService
```
<T> T getService(java.lang.Class<T> clazz,
                 java.lang.String nodeName)
          throws AttivioException
```
    See getService(Class, String, long). Timeout will default to -1L.
    
    Throws:
    
    AttivioException
  - getService
```
@Deprecated
<T> T getService(java.lang.Class<T> clazz,
                 java.lang.String nodeName,
                 long timeout)
          throws AttivioException
```
    Deprecated.
    use getService(Class, Map, long)
    
    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

Interface ServiceFactory

Method Summary

Method Detail

getService

getService

getService

getService

getService