AdapterService

```
@Retention(value=CLASS)
@Target(value=TYPE)
public @interface AdapterService
```
Annotates an Adapater service. Adapters, like AspectService, are used to "extend" existing services, and can publish different services based on the existing one. An example would be implementing a management interface for an existing service, etc ....
When you annotate an adapter class with the @AdapterService annotation, it will be applied to any service that matches the implemented interface and filter. The adapter will be registered with the specified interface and existing properties from the original service plus any extra properties you supply here. If you declare the original service as a member it will be injected.
Usage Examples

Here, the AdapterService is registered into the OSGI registry each time an AdapteeService is found from the registry. The AdapterImpl class adapts the AdapteeService to the AdapterService. The AdapterService will also have a service property (param=value), and will also include eventual service properties found from the AdapteeService:
```
 
 @AdapterService(adapteeService = AdapteeService.class, properties={@Property(name="param", value="value")})
 class AdapterImpl implements AdapterService {
     // The service we are adapting (injected by reflection)
     protected AdapteeService adaptee;
   
     public void doWork() {
        adaptee.mehod1();
        adaptee.method2();
     }
 }
 
```

Required Element Summary

Required Elements
Modifier and Type Required Element and Description

java.lang.Class<?> adapteeService
Sets the adaptee service interface this adapter is applying to.

Required Elements
Modifier and Type	Required Element and Description
`java.lang.Class<?>`	`adapteeService` Sets the adaptee service interface this adapter is applying to.

Optional Element Summary

Optional Elements
Modifier and Type	Optional Element and Description
`java.lang.String`	`adapteeFilter` Sets the filter condition to use with the adapted service interface.
`java.lang.String`	`added` The callback method to be invoked when the original service is available.
`java.lang.String`	`changed` The callback method to be invoked when the original service properties have changed.
`java.lang.String`	`factoryMethod` Sets the static method used to create the adapter service implementation instance.
`java.lang.String`	`field` Sets the field name where to inject the original service.
`boolean`	`propagate` Specifies if adaptee service properties should be propagated to the adapter service.
`Property[]`	`properties` Sets some additional properties to use with the adapter service registration.
`java.lang.Class<?>[]`	`provides` Sets the adapter service interface(s).
`java.lang.String`	`removed` The callback method to invoke when the service is lost.
`java.lang.String`	`swap` name of the callback method to invoke on swap.

- Element Detail
  - adapteeService
```
public abstract java.lang.Class<?> adapteeService
```
    Sets the adaptee service interface this adapter is applying to.
  - provides
```
public abstract java.lang.Class<?>[] provides
```
    Sets the adapter service interface(s). By default, the directly implemented interface(s) is (are) used.
    
    Default:
    
    {}
  - properties
```
public abstract Property[] properties
```
    Sets some additional properties to use with the adapter service registration. By default, the adapter will inherit all adaptee service properties.
    
    Default:
    
    {}
  - adapteeFilter
```
public abstract java.lang.String adapteeFilter
```
    Sets the filter condition to use with the adapted service interface.
    
    Default:
    
    ""
  - factoryMethod
```
public abstract java.lang.String factoryMethod
```
    Sets the static method used to create the adapter service implementation instance. By default, the default constructor of the annotated class is used.
    
    Default:
    
    ""
  - field
```
public abstract java.lang.String field
```
    Sets the field name where to inject the original service. By default, the original service is injected in any attributes in the aspect implementation that are of the same type as the aspect interface.
    
    Default:
    
    ""
  - added
```
public abstract java.lang.String added
```
    The callback method to be invoked when the original service is available. This attribute can't be mixed with the field attribute.
    
    Default:
    
    ""
  - changed
```
public abstract java.lang.String changed
```
    The callback method to be invoked when the original service properties have changed. When this attribute is used, then the added attribute must also be used.
    
    Default:
    
    ""
  - swap
```
public abstract java.lang.String swap
```
    name of the callback method to invoke on swap.
    
    Default:
    
    ""
  - removed
```
public abstract java.lang.String removed
```
    The callback method to invoke when the service is lost. When this attribute is used, then the added attribute must also be used.
    
    Default:
    
    ""
  - propagate
```
public abstract boolean propagate
```
    Specifies if adaptee service properties should be propagated to the adapter service.
    
    Default:
    
    true

Annotation Type AdapterService

Usage Examples

Required Element Summary

Optional Element Summary

Element Detail

adapteeService

provides

properties

adapteeFilter

factoryMethod

field

added

changed

swap

removed

propagate