Package org.apache.karaf.util.tracker

Class BaseActivator

java.lang.Object

org.apache.karaf.util.tracker.BaseActivator

All Implemented Interfaces:

Runnable, ThreadFactory, org.osgi.framework.BundleActivator

public class BaseActivator
extends Object
implements org.osgi.framework.BundleActivator, Runnable, ThreadFactory

Field Summary

Fields

Modifier and Type	Field	Description
protected org.osgi.framework.BundleContext	bundleContext
protected ExecutorService	executor
protected org.slf4j.Logger	logger

Constructor Summary

Constructors

Constructor	Description
BaseActivator()

Method Summary

Modifier and Type	Method	Description
protected void	doClose()
protected void	doOpen()
protected void	doStart()
protected void	doStop()
protected boolean	ensureStartupConfiguration(String configId)
protected boolean	getBoolean(String key, boolean def)	Called in doStart().
protected Class<?>[]	getClassesArray(String key, String def)
protected Dictionary<String,?>	getConfiguration()
protected int	getInt(String key, int def)	Called in doStart().
protected String[]	getInterfaceNames(Object object)
protected long	getLong(String key, long def)	Called in doStart().
long	getSchedulerStopTimeout()
protected String	getString(String key, String def)	Called in doStart().
protected String[]	getStringArray(String key, String def)
protected <T> T	getTrackedService(Class<T> clazz)	Called in doStart().
protected <T> org.osgi.framework.ServiceReference<T>	getTrackedServiceRef(Class<T> clazz)
protected void	manage(String pid)	Called in doOpen().
Thread	newThread(Runnable r)
protected void	reconfigure()
protected void	register(Class[] clazz, Object service)	Called in doStart().
protected void	register(Class[] clazz, Object service, Dictionary<String,?> props)	Called in doStart().
protected <T> void	register(Class<T> clazz, T service)	Called in doStart().
protected <T> void	register(Class<T> clazz, T service, Dictionary<String,?> props)	Called in doStart().
protected void	registerMBean(Object mbean, String type)	Called in doStart().
protected void	registerMBeanWithName(Object mbean, String name)	Called in doStart().
void	run()
void	setSchedulerStopTimeout(long schedulerStopTimeout)
void	start(org.osgi.framework.BundleContext context)
void	stop(org.osgi.framework.BundleContext context)
protected void	trackService(Class<?> clazz)	Called in doOpen().
protected void	trackService(Class<?> clazz, String filter)	Called in doOpen().
protected void	trackService(String className, String filter)
void	updated(Dictionary<String,?> properties)

Methods inherited from class java.lang.Object

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

Field Detail

logger

protected final org.slf4j.Logger logger

bundleContext

protected org.osgi.framework.BundleContext bundleContext

executor

protected ExecutorService executor

Constructor Detail

BaseActivator

public BaseActivator()

Method Detail

getSchedulerStopTimeout

public long getSchedulerStopTimeout()

setSchedulerStopTimeout

public void setSchedulerStopTimeout(long schedulerStopTimeout)

start

public void start(org.osgi.framework.BundleContext context)
           throws Exception

Specified by:

start in interface org.osgi.framework.BundleActivator

Throws:

Exception

stop

public void stop(org.osgi.framework.BundleContext context)
          throws Exception

Specified by:

stop in interface org.osgi.framework.BundleActivator

Throws:

Exception

doOpen

protected void doOpen()
               throws Exception

Throws:

Exception

doClose

protected void doClose()

doStart

protected void doStart()
                throws Exception

Throws:

Exception

doStop

protected void doStop()

ensureStartupConfiguration

protected boolean ensureStartupConfiguration(String configId)
                                      throws IOException

Throws:

IOException

manage

protected void manage(String pid)

Called in doOpen().

Parameters:

pid - The configuration PID to manage (ManagedService).

updated

public void updated(Dictionary<String,?> properties)

getConfiguration

protected Dictionary<String,?> getConfiguration()

getInt

protected int getInt(String key,
                     int def)

Called in doStart().

Parameters:

key - The configuration key

def - The default value.

Returns:

The value of the configuration key if found, the default value else.

getBoolean

protected boolean getBoolean(String key,
                             boolean def)

Called in doStart().

Parameters:

key - The configuration key.

def - The default value.

Returns:

The value of the configuration key if found, the default value else.

getLong

protected long getLong(String key,
                       long def)

Called in doStart().

Parameters:

key - The configuration key.

def - The default value.

Returns:

The value of the configuration key if found, the default value else.

getString

protected String getString(String key,
                           String def)

Called in doStart().

Parameters:

key - The configuration key.

def - The default value.

Returns:

The value of the configuration key if found, the default value else.

getClassesArray

protected Class<?>[] getClassesArray(String key,
                                     String def)

getStringArray

protected String[] getStringArray(String key,
                                  String def)

reconfigure

protected void reconfigure()

run

public void run()

Specified by:

run in interface Runnable

trackService

protected void trackService(Class<?> clazz)
                     throws org.osgi.framework.InvalidSyntaxException

Called in doOpen().

Parameters:

clazz - The service interface to track.

Throws:

org.osgi.framework.InvalidSyntaxException - If the tracker syntax is not correct.

trackService

protected void trackService(Class<?> clazz,
                            String filter)
                     throws org.osgi.framework.InvalidSyntaxException

Called in doOpen().

Parameters:

clazz - The service interface to track.

filter - The filter to use to select the services to track.

Throws:

org.osgi.framework.InvalidSyntaxException - If the tracker syntax is not correct (in the filter especially).

trackService

protected void trackService(String className,
                            String filter)
                     throws org.osgi.framework.InvalidSyntaxException

Throws:

org.osgi.framework.InvalidSyntaxException

getTrackedService

protected <T> T getTrackedService(Class<T> clazz)

Called in doStart().

Type Parameters:

T - The service type.

Parameters:

clazz - The service interface to get.

Returns:

The actual tracker service object.

getTrackedServiceRef

protected <T> org.osgi.framework.ServiceReference<T> getTrackedServiceRef(Class<T> clazz)

registerMBean

protected void registerMBean(Object mbean,
                             String type)

Called in doStart().

Parameters:

mbean - The MBean to register.

type - The MBean type to register.

registerMBeanWithName

protected void registerMBeanWithName(Object mbean,
                                     String name)

Called in doStart().

Parameters:

mbean - The MBean to register.

name - The MBean name.

register

protected <T> void register(Class<T> clazz,
                            T service)

Called in doStart().

Type Parameters:

T - The service type.

Parameters:

clazz - The service interface to register.

service - The actual service instance to register.

register

protected <T> void register(Class<T> clazz,
                            T service,
                            Dictionary<String,?> props)

Called in doStart().

Type Parameters:

T - The service type.

Parameters:

clazz - The service interface to register.

service - The actual service instance to register.

props - The service properties to register.

register

protected void register(Class[] clazz,
                        Object service)

Called in doStart().

Parameters:

clazz - The service interfaces to register.

service - The actual service instance to register.

register

protected void register(Class[] clazz,
                        Object service,
                        Dictionary<String,?> props)

Called in doStart().

Parameters:

clazz - The service interfaces to register.

service - The actual service instance to register.

props - The service properties to register.

getInterfaceNames

protected String[] getInterfaceNames(Object object)

newThread

public Thread newThread(Runnable r)

Specified by:

newThread in interface ThreadFactory