THIS IS A TEST INSTANCE. ALL YOUR CHANGES WILL BE LOST!!!!
...
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
@Component(name="my-type")
public class Implementation {
// ...
}
|
| Center |
|---|
How to declare instances
| Code Block | ||||
|---|---|---|---|---|
| ||||
<instance component="my-type"/>
<instance component="my.Implementation"/>
<instance component="my-type" name="my-instance"/>
<instance component="my-type" name="my-instance">
<property name="property1" value="value1"/>
</instance>
|
...
- Instances can contains a configuration given under the
key-valueform. Properties can also by complex type (refer to . - How-to use iPOJO factories)
How to provide a service
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<component classname="my.service.implementation" name="my-service-impl"> <provides/> </component> <instance name="my-service-impl"/> |
...
- Only instances provides really services, so don't forget to declare an instance.
- Published service interfaces must be implemented by your component implementation
Center - Providing OSGi services
Publishing service properties
...
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
@Component
@Provides(specifications= {FooService.class, BarService.class})
public class ProvidesProperties implements FooService, BarService {
@ServiceProperty(name = "foo")
public int m_foo = 0;
@ServiceProperty(name="bar", mandatory=true)
public int m_bar;
// ...
}
|
| Center |
|---|
Consuming services
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<component classname="my.consumer.Implementation">
<requires field="fs" />
<requires>
<callback type="bind" method="bind" />
<callback type="unbind" method="unbind" />
</requires>
</component>
|
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
@Component
public class Dependency {
@Requires
public FooService fs;
@Unbind
public void unbind(BazService bz) {
//...
}
@Bind
public void bind(BazService bz) {
// ...
}
//...
}
|
| Center |
|---|
Reacting to lifecycle state changes
...
- A POJO object (implementation object) is created as soons as the instance becomes valid
- Instances that don't provide services becomes automatically immediate
Code Block xml xml title XML <component classname="my.service.implementation" name="my-service-impl" immediate="true"> <provides/> </component>
Code Block java java title Annotations @Component(immediate=true) @Provides public class Implementation implements FooService { ... }Center - Lifecycle Callback Handler
Lifecycle callbacks
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<component classname="my.implementation" name="my-impl">
<callback transition="validate" method="start" />
<callback transition="invalidate" method="stop" />
</component>
|
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
@Component
public class Implementation {
@Validate
public void start() {
}
@Invalidate
public void stop() {
}
}
|
Declaring properties
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<component classname="my.Implementation" name="my-impl">
<properties propagation="true" managedservice="MyPID">
<property name="boo" method="setBoo" />
<property field="m_bar" mandatory="true"/>
<property field="m_foo" value="4"/>
</properties>
</component>
<instance component="my-impl">
<property name="boo" value="..."/>
<property name="m_bar" value="..."/>
</instance>
<instance component="my-impl">
<property name="boo" value="..."/>
<property name="m_bar" value="..."/>
<property name="managed.service.pid" value="AnotherPID"/>
</instance>
|
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
@Component(managedservice="MyPID", propagation=true)
public class Implementation {
@Property(name="boo")
public void setBoo(int boo) {
//...
}
@Property(mandatory=true)
public int m_bar;
@Property(value="4")
public int m_foo;
}
|
| Center |
|---|
Using 'arch'
- Deploy the 'arch' command bundle (available for Felix and Equinox)
- Launch the 'arch' command in the OSGi Framework Shell
Code Block arch => displays instances name & state (equivalent to arch \-instances) arch -instance $instance_name => displays complete information about the instance $instance_name arch -factories => display the list of available factories arch -factory $factory_name => display complete information about the factory $factory_name arch -handlers => list available handlers
- Architecture Handler