Leveraging the Latest OSGi R7 Specifications - C Ziegeler & D Bosschaert

© 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential.
Leveraging the lastest OSGi R7 Specifications
David Bosschaert & Carsten Ziegeler | Adobe

Carsten Ziegeler
§ Principal Scientist @ Adobe Research Switzerland
§ Member of the Apache Software Foundation
§ VP of Apache Felix and Sling
§ OSGi Expert Groups and Board member
2

David Bosschaert
§ R&D Adobe Ireland
§ Co-chair OSGi Enterprise Expert Group
§ Apache Felix, Aries PMC member and committer
§ … other opensource projects
§ Cloud and embedded computing enthusiast
3

Basics

Versioning Annotations
§ Old Friends:
§ @Version, @ProviderType, @ConsumerType
§ New Friend:
§ @Export
5
D

Bundle Annotations
§ More New Friends:
§ @Capability, @Requirement, @Header
@Requirement(namespace="osgi.implementation",
name="osgi.http", version="1.1.0")
@Header(name=Constants.BUNDLE_CATEGORY, value="eclipsecon")
6
D

Converter

Object Conversion
§ Wouldn’t you like to convert anything to everything?
§ Peter Kriens’ work in Bnd started it
§ Convert
§ Scalars, Collections, Arrays
§ Interfaces, maps, DTOs, JavaBeans, Annotations
§ Need predictable behaviour – as little implementation freedom as possible
§ Can be customized
RFC 215 – Implementation in Apache Felix (/converter)
8
D

Sample conversions
§ Examples:
Converter c = Converters.standardConverter();
// Convert scalars
int i = c.convert("123").to(int.class);
UUID id = c.convert("067e6162-3b6f-4ae2-a171-2470b63dff00").to(UUID.class);
List<String> ls = Arrays.asList("978", "142", "-99");
short[] la = c.convert(ls).to(short[].class);
9
D

Convert configuration data into typed information with defaults
Map<String, String> myMap = new HashMap<>();
myMap.put("refresh", "750");
myMap.put("other", "hello");
// Convert map structures
@interface MyAnnotation {
int refresh() default 500;
String temp() default "/tmp";
}
MyAnnotation myAnn = converter.convert(someMap).to(MyAnnotation.class)
int refresh = myAnn.refresh(); // 750
Strine temp = myAnn.temp(); // "/tmp"
10
D

Customize your converter
The converter service itself always behaves the same
§ Need customizations? Create a new converter: ConverterBuilder
§ Change default behaviour of array to scalar conversion
§ Convert String[] to String via adapter
// Default behaviour
String s = converter.convert(new String[] {“hi”, “there”}).to(String.class); // s = “hi”
Converter c = converter.newConverterBuilder()
.rule(String[].class, String.class, MyCnv::saToString)
.build();
String s2 = c.convert(new String[] {“hi”, “there”}).to(String.class); // ss=“hi there”
11
D

Basics in R7
§ Bundle Annotations
§ Converter
§ Promises
§ PushStreams
12
D

Service Development

Simply Simple
§ POJOs
§ Annotations based
§ org.osgi.service.component.annotations.*
§ org.osgi.service.metatype.annotations.*
§ Declarative Services does the hard work
C

Declarative Services
15
Bundle
XML
Service Component Runtime (DS Implementation)
reads
Service Registry
manages
Components Services
registers
C

Components
16
@Component(service = {})
public class MyComponentImpl {
...
C

Lifecycle
17
@Activate
protected void activate() {
...
}
@Deactivate
private void deactivate() {
...
}
C

Services and Properties
18
@Component(service = {MyComponent.class},
property = {
Constants.SERVICE_DESCRIPTION + "=The best service in the world",
"service.ranking:Integer=5",
"tag=foo", "tag=bar"
}
)
@ServiceDescription("The best service in the world")
@ServiceRanking(5)
@Tag({"foo", "bar"})
public class MyComponentImpl implements MyComponent {
...
C

Mandatory Unary References
19
@Component(service = {MyComponent.class})
public class MyComponentImpl implements MyComponent {
@Reference(policyOption=ReferencePolicyOption.GREEDY)
private ResourceResovlerFactory factory;
... {
factory.getResourcResolver();
}
C

Multiple Cardinality Reference
20
@Reference(cardinality=ReferenceCardinality.MULTIPLE)
private volatile List<Filter> filters;
... {
final List<Filter> localFilters = filters;
for(final Filter f : localFilters) {
...
}
}
C

Configuration Admin
21
Configuration Admin
Persistent Store
Configuration
- PID
- Properties
create, update, delete
Configuration(s)
- Factory PID
- Name
- Properties
C

Define Configuration Property Type….
§ Example configuration
§ Boolean for enabled
§ String array with topics
§ String user name
22
@interface MyConfig {
boolean enabled() default true;
String[] topic() default {"topicA", "topicB"};
String userName();
}
C

© 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. 23
@Activate
private MyConfig configuration;
@Activate
protected void activate(final MyConfig config) {
// note: annotation MyConfig used as interface
this.configuration = config;
}
}
..and use in activation
C

Constructor Injection
24
@Component
public class MyComponent {
@Activate
public MyComponent(
BundleContext bundleContext,
@Reference EventAdmin eventAdmin,
Config config,
@Reference List<Receivers> receivers) {
C

Metatype
§ Define type information of data
§ ObjectClassDefinition with Attributes
§ Common use case: Configuration properties for a component
§ But not limited to this!
25
C

Configuration Metatype
26
@ObjectClassDefinition(label="My Component",
description="Coolest component in the world.")
@interface MyConfig {
@AttributeDefinition(label="Enabled",
description="Topic and user name are used if enabled")
boolean enabled() default true;
@AttributeDefinition(...)
String[] topic() default {"topicA", "topicB"};
@AttributeDefinition(...)
String userName();
}
C

Connect Component Configuration with Metatype
27
@Component ( service = {})
@Designate( ocd = MyConfig.class )
@Component ( service = {Logger.class})
@Designate( ocd = MyConfig.class , factory = true)
public class LoggerImpl implements Logger {
C

Properties, Properties, Properties
28
@Component(property = {})
Component Property Types
(defaults)
Configuration properties
(runtime)
Component Properties
(runtime)
Service Registry
activate()
C

Declarative Services
§ Developing OSGi Services made easy
§ Configuration support
§ Reference management
§ Dealing with dynamics
29
C

Service Development in R7
§ Configuration Admin
§ Metatype
§ Declarative Services
30
C

Web Development

JAX-RS Services
§ JAX-RS in OSGi
§ Service / Whiteboard Model
32
D

Simple Resource
33
@Component(service = TestService.class,
scope = ServiceScope.PROTOTYPE)
@JaxrsResource
@Path("service")
public class TestService {
@GET
@Produces("text/plain")
public String getHelloWorld() {
return "Hello World";
}
}
D

DS-Enabled
34
@JaxrsResource
@Path("service")
@Reference
private GameController game;
@Activate
protected void activate(final Config config) {}
@GET
public String getHelloWorld() {
return "Hello World";
}
}
D

Application and Parameters
35
@JaxrsApplicationSelect("(osgi.jaxrs.name=myapp)")
@JaxrsResource
@Path("service/{name}")
@GET
public String getHelloWorld(@PathParam("name") String name) {
return "Hello " + name;
}
}
D

JAX-RS Support
§ Get, Post, Delete with Parameters
§ Application support
§ JAX-RS extension support (Filters, Interceptors, etc)
§ Annotations for Declarative Services
36
D

Web Development in R7
§ JAXRS integration
§ Http Whiteboard Update
37
D

Provisioning

Reusable Configuration Format
{
"my.special.component" : {
"some_prop": 42,
"and_another": "some string"
},
"and.a.factory.cmp~foo" : {
...
},
"and.a.factory.cmp~bar" : {
...
}}
39
C

OSGi Configurator
§ Configurations as bundle resources
§ Binaries
§ State handling and ranking
40
C

Clusters, Containers, Cloud!

Cluster Information
OSGi frameworks running in a distributed environment
§ Cloud
§ IoT
§ <buzzword xyz in the future>
Many frameworks
§ New ones appearing
§ … and disappearing
§ Other entities too, like databases
42
D

Cluster Information
Discovery of OSGi frameworks in a distributed environment
§ Find out what is available
§ get notifications of changes
§ Provision your application within the given resources
§ Also: non-OSGi frameworks (e.g. Database)
§ Monitor your application
§ Provision changes if needed
RFC 183 – Implementation in Eclipse Concierge
43
D

Cluster Information
FrameworkNodeStatus service provides metadata
§ Java version
§ OSGi version
§ OS version
§ IP address
§ Physical location (country, ISO 3166)
§ Metrics
§ tags / other / custom
§ Provisioning API (install/start/stop/uninstall bundles etc…)
44
D

OSGi R7 Release

R7 Early Spec Draft Available
§ More Updates
§ Transaction Control
§ JPA Updates
§ Remote Service Intents
§ https://www.osgi.org/developer/specifications/drafts/
46
C

Leveraging the Latest OSGi R7 Specifications - C Ziegeler & D Bosschaert

Leveraging the Latest OSGi R7 Specifications - C Ziegeler & D Bosschaert

Recommended

Recommended

More Related Content

What's hot

What's hot (20)

Similar to Leveraging the Latest OSGi R7 Specifications - C Ziegeler & D Bosschaert

Similar to Leveraging the Latest OSGi R7 Specifications - C Ziegeler & D Bosschaert (20)

More from mfrancis

More from mfrancis (20)

Recently uploaded

Recently uploaded (20)

Leveraging the Latest OSGi R7 Specifications - C Ziegeler & D Bosschaert