com.microej.kf.util.service

Class SharedServiceRegistryKF

java.lang.Object

ej.service.loader.SimpleServiceLoader

ej.service.registry.SimpleServiceRegistry

com.microej.kf.util.service.SharedServiceRegistryKF

All Implemented Interfaces:

SharedServiceRegistry, ej.kf.FeatureStateListener, ej.service.ServiceLoader, ej.service.ServiceRegistry

public class SharedServiceRegistryKF
extends ej.service.registry.SimpleServiceRegistry
implements SharedServiceRegistry, ej.kf.FeatureStateListener

Implementation of the shared service registry over Kernel and Features.

This service registry is able to handle the following kind of services:

• Services owned by the kernel, available to the kernel and the features (provided that the type is part of the API)
• Services owned by a feature using shared interfaces mechanism, available to other features through Proxy instances
• Services owned by a feature using an interface owned by the kernel, only available to the kernel (kernel extensions)
• Services owned by a feature using a type owned by the feature, only available to the feature

Field Summary

Fields inherited from class ej.service.loader.SimpleServiceLoader

services

Constructor Summary

Constructors

Constructor and Description
SharedServiceRegistryKF() Creates a shared service registry.

Method Summary

Modifier and Type	Method and Description
<T> T	getService(java.lang.Class<T> serviceClass) Gets the registered implementation for the given service.
<T> void	register(java.lang.Class<T> serviceClass, T implementation)
void	stateChanged(ej.kf.Feature feature, ej.kf.Feature.State previousState)
<T> void	unregister(java.lang.Class<T> serviceClass, T implementation)

Methods inherited from class ej.service.loader.SimpleServiceLoader

checkServicePermission, createAlternativeImplementation, putService

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SharedServiceRegistryKF

public SharedServiceRegistryKF()

Creates a shared service registry.

Method Detail

register

public <T> void register(java.lang.Class<T> serviceClass,
                         T implementation)

Specified by:

register in interface ej.service.ServiceRegistry

Overrides:

register in class ej.service.registry.SimpleServiceRegistry

unregister

public <T> void unregister(java.lang.Class<T> serviceClass,
                           T implementation)

Specified by:

unregister in interface ej.service.ServiceRegistry

Overrides:

unregister in class ej.service.registry.SimpleServiceRegistry

getService

@Nullable
public <T> T getService(java.lang.Class<T> serviceClass)

Gets the registered implementation for the given service. This implementation depends on who request it. if it is a feature we search the service with the following order:

• We search it in the shared services provided by the current feature.
• We search it in the shared services provided by the kernel.
• We search it in the shared services provided by the trusted features.
• We search it in the shared services provided by the non trusted features.

if it is the kernel, we search the service with the following order:

• We search it in the shared services provided by the kernel.
• We search it in the shared services provided by the trusted features.
• We search it in the shared services provided by the non trusted features.

Specified by:

getService in interface ej.service.ServiceLoader

Overrides:

getService in class ej.service.loader.SimpleServiceLoader

Type Parameters:

T - the service type.

Parameters:

serviceClass - the service to found.

Returns:

an instance of the given service or null if no implementation is available.

stateChanged

public void stateChanged(@Nullable
                         ej.kf.Feature feature,
                         @Nullable
                         ej.kf.Feature.State previousState)

Specified by:

stateChanged in interface ej.kf.FeatureStateListener