org.apache.sling.testing.mock.osgi.context

Class OsgiContextImpl

java.lang.Object

org.apache.sling.testing.mock.osgi.context.OsgiContextImpl

@ConsumerType
public class OsgiContextImpl
extends Object

Defines OSGi context objects and helper methods. Should not be used directly but via the OsgiContext JUnit rule or extension.

Field Summary

Fields

Modifier and Type	Field and Description
protected org.osgi.service.component.ComponentContext	componentContext

Constructor Summary

Constructors

Constructor and Description
OsgiContextImpl()

Method Summary

Modifier and Type	Method and Description
@NotNull org.osgi.framework.BundleContext	bundleContext()
@NotNull org.osgi.service.component.ComponentContext	componentContext()
<ServiceType> ServiceType	getService(@NotNull Class<ServiceType> serviceType) Lookup a single service
<ServiceType> ServiceType[]	getServices(@NotNull Class<ServiceType> serviceType, @Nullable String filter) Lookup one or several services
<T> T	registerInjectActivateService(T service) Injects dependencies, activates and registers a service in the mocked OSGi environment.
<T> T	registerInjectActivateService(T service, @Nullable Map<String,Object> properties) Injects dependencies, activates and registers a service in the mocked OSGi environment.
<T> T	registerInjectActivateService(T service, Object... properties) Injects dependencies, activates and registers a service in the mocked OSGi environment.
<T> T	registerService(@Nullable Class<T> serviceClass, T service) Registers a service in the mocked OSGi environment.
<T> T	registerService(@Nullable Class<T> serviceClass, T service, @Nullable Map<String,Object> properties) Registers a service in the mocked OSGi environment.
<T> T	registerService(@Nullable Class<T> serviceClass, T service, Object... properties) Registers a service in the mocked OSGi environment.
<T> T	registerService(T service) Registers a service in the mocked OSGi environment.
protected void	setUp() Setup actions before test method execution
protected void	tearDown() Teardown actions after test method execution

Methods inherited from class java.lang.Object

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

Field Detail

componentContext

protected org.osgi.service.component.ComponentContext componentContext

Constructor Detail

OsgiContextImpl

public OsgiContextImpl()

Method Detail

setUp

protected void setUp()

Setup actions before test method execution

tearDown

protected void tearDown()

Teardown actions after test method execution

componentContext

@NotNull
public final @NotNull org.osgi.service.component.ComponentContext componentContext()

Returns:

OSGi component context

bundleContext

@NotNull
public final @NotNull org.osgi.framework.BundleContext bundleContext()

Returns:

OSGi Bundle context

registerService

@NotNull
public final <T> T registerService(@NotNull
                                             T service)

Registers a service in the mocked OSGi environment.

Type Parameters:

T - Service type

Parameters:

service - Service instance

Returns:

Registered service instance

registerService

@NotNull
public final <T> T registerService(@Nullable
                                             @Nullable Class<T> serviceClass,
                                             @NotNull
                                             T service)

Registers a service in the mocked OSGi environment.

Type Parameters:

T - Service type

Parameters:

serviceClass - Service class

service - Service instance

Returns:

Registered service instance

registerService

@NotNull
public final <T> T registerService(@Nullable
                                             @Nullable Class<T> serviceClass,
                                             @NotNull
                                             T service,
                                             @Nullable
                                             @Nullable Map<String,Object> properties)

Registers a service in the mocked OSGi environment.

Type Parameters:

T - Service type

Parameters:

serviceClass - Service class

service - Service instance

properties - Service properties (optional)

Returns:

Registered service instance

registerService

@NotNull
public final <T> T registerService(@Nullable
                                             @Nullable Class<T> serviceClass,
                                             @NotNull
                                             T service,
                                             @NotNull
                                             Object... properties)

Registers a service in the mocked OSGi environment.

Type Parameters:

T - Service type

Parameters:

serviceClass - Service class

service - Service instance

properties - Service properties (optional)

Returns:

Registered service instance

registerInjectActivateService

@NotNull
public final <T> T registerInjectActivateService(@NotNull
                                                           T service)

Injects dependencies, activates and registers a service in the mocked OSGi environment.

Type Parameters:

T - Service type

Parameters:

service - Service instance

Returns:

Registered service instance

registerInjectActivateService

@NotNull
public final <T> T registerInjectActivateService(@NotNull
                                                           T service,
                                                           @Nullable
                                                           @Nullable Map<String,Object> properties)

Injects dependencies, activates and registers a service in the mocked OSGi environment.

Type Parameters:

T - Service type

Parameters:

service - Service instance

properties - Service properties (optional)

Returns:

Registered service instance

registerInjectActivateService

@NotNull
public final <T> T registerInjectActivateService(@NotNull
                                                           T service,
                                                           @NotNull
                                                           Object... properties)

Injects dependencies, activates and registers a service in the mocked OSGi environment.

Type Parameters:

T - Service type

Parameters:

service - Service instance

properties - Service properties (optional)

Returns:

Registered service instance

getService

@Nullable
public final <ServiceType> ServiceType getService(@NotNull
                                                             @NotNull Class<ServiceType> serviceType)

Lookup a single service

Type Parameters:

ServiceType - Service type

Parameters:

serviceType - The type (interface) of the service.

Returns:

The service instance, or null if the service is not available.

getServices

@NotNull
public final <ServiceType> ServiceType[] getServices(@NotNull
                                                               @NotNull Class<ServiceType> serviceType,
                                                               @Nullable
                                                               @Nullable String filter)

Lookup one or several services

Type Parameters:

ServiceType - Service type

Parameters:

serviceType - The type (interface) of the service.

filter - An optional filter (LDAP-like, see OSGi spec)

Returns:

The services instances or an empty array.

Throws:

RuntimeException - If the filter string is not a valid OSGi service filter string.