org.apache.sling.testing.mock.osgi

Class MockOsgi

java.lang.Object

org.apache.sling.testing.mock.osgi.MockOsgi

public final class MockOsgi
extends Object

Factory for mock OSGi objects.

Method Summary

Modifier and Type	Method and Description
static boolean	activate(@NotNull Object target, @NotNull org.osgi.framework.BundleContext bundleContext) Simulate activation of service instance.
static boolean	activate(@NotNull Object target, @NotNull org.osgi.framework.BundleContext bundleContext, @Nullable Dictionary<String,Object> properties) Simulate activation of service instance.
static boolean	activate(@NotNull Object target, @NotNull org.osgi.framework.BundleContext bundleContext, @Nullable Map<String,Object> properties) Simulate activation of service instance.
static boolean	activate(@NotNull Object target, @NotNull org.osgi.framework.BundleContext bundleContext, Object... properties) Simulate activation of service instance.
static @NotNull ComponentContextBuilder	componentContext()
static boolean	deactivate(@NotNull Object target, @NotNull org.osgi.framework.BundleContext bundleContext) Simulate deactivation of service instance.
static boolean	deactivate(@NotNull Object target, @NotNull org.osgi.framework.BundleContext bundleContext, @Nullable Dictionary<String,Object> properties) Simulate deactivation of service instance.
static boolean	deactivate(@NotNull Object target, @NotNull org.osgi.framework.BundleContext bundleContext, @Nullable Map<String,Object> properties) Simulate activation of service instance.
static boolean	deactivate(@NotNull Object target, @NotNull org.osgi.framework.BundleContext bundleContext, Object... properties) Simulate activation of service instance.
static boolean	injectServices(@NotNull Object target, @NotNull org.osgi.framework.BundleContext bundleContext) Simulate OSGi service dependency injection.
static boolean	injectServices(@NotNull Object target, @NotNull org.osgi.framework.BundleContext bundleContext, @Nullable Map<String,Object> properties) Simulate OSGi service dependency injection.
static boolean	modified(@NotNull Object target, @NotNull org.osgi.framework.BundleContext bundleContext, @Nullable Dictionary<String,Object> properties) Simulate configuration modification of service instance.
static boolean	modified(@NotNull Object target, @NotNull org.osgi.framework.BundleContext bundleContext, @Nullable Map<String,Object> properties) Simulate configuration modification of service instance.
static boolean	modified(@NotNull Object target, @NotNull org.osgi.framework.BundleContext bundleContext, Object... properties) Simulate configuration modification of service instance.
static @NotNull org.osgi.framework.BundleContext	newBundleContext()
static @NotNull org.osgi.service.component.ComponentContext	newComponentContext()
static @NotNull org.osgi.service.component.ComponentContext	newComponentContext(@NotNull org.osgi.framework.BundleContext bundleContext, @Nullable Dictionary<String,Object> properties)
static @NotNull org.osgi.service.component.ComponentContext	newComponentContext(@NotNull org.osgi.framework.BundleContext bundleContext, @Nullable Map<String,Object> properties)
static @NotNull org.osgi.service.component.ComponentContext	newComponentContext(@NotNull org.osgi.framework.BundleContext bundleContext, Object... properties)
static @NotNull org.osgi.service.component.ComponentContext	newComponentContext(@Nullable Dictionary<String,Object> properties)
static @NotNull org.osgi.service.component.ComponentContext	newComponentContext(@Nullable Map<String,Object> properties)
static @NotNull org.osgi.service.component.ComponentContext	newComponentContext(Object... properties)
static @NotNull org.osgi.service.log.LogService	newLogService(@NotNull Class<?> loggerContext)
static void	sendBundleEvent(@NotNull org.osgi.framework.BundleContext bundleContext, @NotNull org.osgi.framework.BundleEvent bundleEvent) Simulates a bundle event on the given bundle context (that is forwarded to registered bundle listeners).
static void	setConfigForPid(@NotNull org.osgi.framework.BundleContext bundleContext, @NotNull String pid, @Nullable Map<String,Object> properties) Set configuration via ConfigurationAdmin service in bundle context for component with given pid.
static void	setConfigForPid(@NotNull org.osgi.framework.BundleContext bundleContext, @NotNull String pid, Object... properties) Set configuration via ConfigurationAdmin service in bundle context for component with given pid.
static void	shutdown(@NotNull org.osgi.framework.BundleContext bundleContext) Deactivates all bundles registered in the mocked bundle context.

Methods inherited from class java.lang.Object

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

Method Detail

newBundleContext

@NotNull
public static @NotNull org.osgi.framework.BundleContext newBundleContext()

Returns:

Mocked BundleContext instance

sendBundleEvent

public static void sendBundleEvent(@NotNull
                                   @NotNull org.osgi.framework.BundleContext bundleContext,
                                   @NotNull
                                   @NotNull org.osgi.framework.BundleEvent bundleEvent)

Simulates a bundle event on the given bundle context (that is forwarded to registered bundle listeners).

Parameters:

bundleContext - Bundle context

bundleEvent - Bundle event

newComponentContext

@NotNull
public static @NotNull org.osgi.service.component.ComponentContext newComponentContext()

Returns:

Mocked ComponentContext instance

newComponentContext

@NotNull
public static @NotNull org.osgi.service.component.ComponentContext newComponentContext(@Nullable
                                                                                                 @Nullable Dictionary<String,Object> properties)

Parameters:

properties - Properties

Returns:

Mocked ComponentContext instance

newComponentContext

@NotNull
public static @NotNull org.osgi.service.component.ComponentContext newComponentContext(@Nullable
                                                                                                 @Nullable Map<String,Object> properties)

Parameters:

properties - Properties

Returns:

Mocked ComponentContext instance

newComponentContext

@NotNull
public static @NotNull org.osgi.service.component.ComponentContext newComponentContext(@NotNull
                                                                                                 Object... properties)

Parameters:

properties - Properties

Returns:

Mocked ComponentContext instance

newComponentContext

@NotNull
public static @NotNull org.osgi.service.component.ComponentContext newComponentContext(@NotNull
                                                                                                 @NotNull org.osgi.framework.BundleContext bundleContext,
                                                                                                 @Nullable
                                                                                                 @Nullable Dictionary<String,Object> properties)

Parameters:

bundleContext - Bundle context

properties - Properties

Returns:

Mocked ComponentContext instance

newComponentContext

@NotNull
public static @NotNull org.osgi.service.component.ComponentContext newComponentContext(@NotNull
                                                                                                 @NotNull org.osgi.framework.BundleContext bundleContext,
                                                                                                 @Nullable
                                                                                                 @Nullable Map<String,Object> properties)

Parameters:

bundleContext - Bundle context

properties - Properties

Returns:

Mocked ComponentContext instance

newComponentContext

@NotNull
public static @NotNull org.osgi.service.component.ComponentContext newComponentContext(@NotNull
                                                                                                 @NotNull org.osgi.framework.BundleContext bundleContext,
                                                                                                 @NotNull
                                                                                                 Object... properties)

Parameters:

bundleContext - Bundle context

properties - Properties

Returns:

Mocked ComponentContext instance

componentContext

@NotNull
public static @NotNull ComponentContextBuilder componentContext()

Returns:

ComponentContextBuilder to build a mocked ComponentContext

newLogService

@NotNull
public static @NotNull org.osgi.service.log.LogService newLogService(@NotNull
                                                                               @NotNull Class<?> loggerContext)

Parameters:

loggerContext - Context class for logging

Returns:

Mocked LogService instance

injectServices

public static boolean injectServices(@NotNull
                                     @NotNull Object target,
                                     @NotNull
                                     @NotNull org.osgi.framework.BundleContext bundleContext)

Simulate OSGi service dependency injection. Injects direct references and multiple references. If a some references could not be injected no error is thrown.

Parameters:

target - Service instance

bundleContext - Bundle context from which services are fetched to inject.

Returns:

true if all dependencies could be injected, false if the service has no dependencies.

injectServices

public static boolean injectServices(@NotNull
                                     @NotNull Object target,
                                     @NotNull
                                     @NotNull org.osgi.framework.BundleContext bundleContext,
                                     @Nullable
                                     @Nullable Map<String,Object> properties)

Simulate OSGi service dependency injection. Injects direct references and multiple references. If a some references could not be injected no error is thrown.

Parameters:

target - Service instance

bundleContext - Bundle context from which services are fetched to inject.

properties - Service properties (used to resolve dynamic reference properties)

Returns:

true if all dependencies could be injected, false if the service has no dependencies.

activate

public static boolean activate(@NotNull
                               @NotNull Object target,
                               @NotNull
                               @NotNull org.osgi.framework.BundleContext bundleContext)

Simulate activation of service instance. Invokes the @Activate annotated method.

Parameters:

target - Service instance.

bundleContext - Bundle context

Returns:

true if activation method was called. False if no activate method is defined.

activate

public static boolean activate(@NotNull
                               @NotNull Object target,
                               @NotNull
                               @NotNull org.osgi.framework.BundleContext bundleContext,
                               @Nullable
                               @Nullable Dictionary<String,Object> properties)

Simulate activation of service instance. Invokes the @Activate annotated method.

Parameters:

target - Service instance.

bundleContext - Bundle context

properties - Properties

Returns:

true if activation method was called. False if no activate method is defined.

activate

public static boolean activate(@NotNull
                               @NotNull Object target,
                               @NotNull
                               @NotNull org.osgi.framework.BundleContext bundleContext,
                               @Nullable
                               @Nullable Map<String,Object> properties)

Simulate activation of service instance. Invokes the @Activate annotated method.

Parameters:

target - Service instance.

bundleContext - Bundle context

properties - Properties

Returns:

true if activation method was called. False if no activate method is defined.

activate

public static boolean activate(@NotNull
                               @NotNull Object target,
                               @NotNull
                               @NotNull org.osgi.framework.BundleContext bundleContext,
                               @NotNull
                               Object... properties)

Simulate activation of service instance. Invokes the @Activate annotated method.

Parameters:

target - Service instance.

bundleContext - Bundle context

properties - Properties

Returns:

true if activation method was called. False if no activate method is defined.

deactivate

public static boolean deactivate(@NotNull
                                 @NotNull Object target,
                                 @NotNull
                                 @NotNull org.osgi.framework.BundleContext bundleContext)

Simulate deactivation of service instance. Invokes the @Deactivate annotated method.

Parameters:

target - Service instance.

bundleContext - Bundle context.

Returns:

true if deactivation method was called. False if no deactivate method is defined.

deactivate

public static boolean deactivate(@NotNull
                                 @NotNull Object target,
                                 @NotNull
                                 @NotNull org.osgi.framework.BundleContext bundleContext,
                                 @Nullable
                                 @Nullable Dictionary<String,Object> properties)

Simulate deactivation of service instance. Invokes the @Deactivate annotated method.

Parameters:

target - Service instance.

bundleContext - Bundle context

properties - Properties

Returns:

true if deactivation method was called. False if no deactivate method is defined.

deactivate

public static boolean deactivate(@NotNull
                                 @NotNull Object target,
                                 @NotNull
                                 @NotNull org.osgi.framework.BundleContext bundleContext,
                                 @Nullable
                                 @Nullable Map<String,Object> properties)

Simulate activation of service instance. Invokes the @Deactivate annotated method.

Parameters:

target - Service instance.

bundleContext - Bundle context

properties - Properties

Returns:

true if deactivation method was called. False if no deactivate method is defined.

deactivate

public static boolean deactivate(@NotNull
                                 @NotNull Object target,
                                 @NotNull
                                 @NotNull org.osgi.framework.BundleContext bundleContext,
                                 @NotNull
                                 Object... properties)

Simulate activation of service instance. Invokes the @Deactivate annotated method.

Parameters:

target - Service instance.

bundleContext - Bundle context

properties - Properties

Returns:

true if deactivation method was called. False if no deactivate method is defined.

modified

public static boolean modified(@NotNull
                               @NotNull Object target,
                               @NotNull
                               @NotNull org.osgi.framework.BundleContext bundleContext,
                               @Nullable
                               @Nullable Dictionary<String,Object> properties)

Simulate configuration modification of service instance. Invokes the @Modified annotated method.

Parameters:

target - Service instance.

bundleContext - Bundle context

properties - Properties

Returns:

true if modified method was called. False if no modified method is defined.

modified

public static boolean modified(@NotNull
                               @NotNull Object target,
                               @NotNull
                               @NotNull org.osgi.framework.BundleContext bundleContext,
                               @Nullable
                               @Nullable Map<String,Object> properties)

Simulate configuration modification of service instance. Invokes the @Modified annotated method.

Parameters:

target - Service instance.

bundleContext - Bundle context

properties - Properties

Returns:

true if modified method was called. False if no modified method is defined.

modified

public static boolean modified(@NotNull
                               @NotNull Object target,
                               @NotNull
                               @NotNull org.osgi.framework.BundleContext bundleContext,
                               @NotNull
                               Object... properties)

Simulate configuration modification of service instance. Invokes the @Modified annotated method.

Parameters:

target - Service instance.

bundleContext - Bundle context

properties - Properties

Returns:

true if modified method was called. False if no modified method is defined.

setConfigForPid

public static void setConfigForPid(@NotNull
                                   @NotNull org.osgi.framework.BundleContext bundleContext,
                                   @NotNull
                                   @NotNull String pid,
                                   @Nullable
                                   @Nullable Map<String,Object> properties)

Set configuration via ConfigurationAdmin service in bundle context for component with given pid.

Parameters:

bundleContext - Bundle context

pid - PID

properties - Configuration properties

setConfigForPid

public static void setConfigForPid(@NotNull
                                   @NotNull org.osgi.framework.BundleContext bundleContext,
                                   @NotNull
                                   @NotNull String pid,
                                   @NotNull
                                   Object... properties)

Set configuration via ConfigurationAdmin service in bundle context for component with given pid.

Parameters:

bundleContext - Bundle context

pid - PID

properties - Configuration properties

shutdown

public static void shutdown(@NotNull
                            @NotNull org.osgi.framework.BundleContext bundleContext)

Deactivates all bundles registered in the mocked bundle context.

Parameters:

bundleContext - Bundle context