ServiceReference (plugin-framework-api 4.0.29.1 API)

```
public interface ServiceReference<T>
```
Service reference.

Author:

Cezary Kozar 3 sie 2016

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`T`	`getService()` Returns service or throws `ServiceUnavailableException` if service is not available.
`ServiceDescriptor`	`getServiceDescriptor()` Returns service descriptor used to create this reference.
`Plugin`	`getServiceProvider()` Returns `Plugin` that exported given service or null if service is exported by host.
`Class<T>`	`getServiceType()` Returns service class (only available if service class in loaded - service may be down).
`boolean`	`isAvailable()` Returns true if this service is available.
`boolean`	`isReleased()` Checks if this reference was released.
`void`	`registerCallback(ServiceCallback callback)` Registers service callback.
`void`	`release()` Releases this reference.

- Method Detail
  - isAvailable
```
boolean isAvailable()
```
    Returns true if this service is available.
    
    Returns:
    
    service availability
  - getService
```
T getService()
      throws ServiceUnavailableException
```
    Returns service or throws ServiceUnavailableException if service is not available.
    
    Returns:
    
    service instance;
    
    Throws:
    
    ServiceUnavailableException
  - getServiceProvider
```
Plugin getServiceProvider()
```
    Returns Plugin that exported given service or null if service is exported by host.
    
    Returns:
    
    plugin that exported service or null
  - isReleased
```
boolean isReleased()
```
    Checks if this reference was released.
    
    Returns:
    
    true if reference was released
  - release
```
void release()
```
    Releases this reference. All plugin references are automatically released when plugin is stopped.
  - getServiceDescriptor
```
ServiceDescriptor getServiceDescriptor()
```
    Returns service descriptor used to create this reference.
    
    Returns:
    
    service descriptor
  - getServiceType
```
Class<T> getServiceType()
```
    Returns service class (only available if service class in loaded - service may be down).
    
    Returns:
    
    service class or null if type cannot be determined
  - registerCallback
```
void registerCallback(ServiceCallback callback)
```
    Registers service callback.
    
    Parameters:
    
    callback - service callback

Interface ServiceReference<T>

Method Summary

Method Detail

isAvailable

getService

getServiceProvider

isReleased

release

getServiceDescriptor

getServiceType

registerCallback