org.apache.felix.webconsole

Class SimpleWebConsolePlugin

java.lang.Object

javax.servlet.GenericServlet

javax.servlet.http.HttpServlet

org.apache.felix.webconsole.AbstractWebConsolePlugin

org.apache.felix.webconsole.SimpleWebConsolePlugin

All Implemented Interfaces:

Serializable, Servlet, ServletConfig

public abstract class SimpleWebConsolePlugin
extends AbstractWebConsolePlugin

SimpleWebConsolePlugin is an utility class that provides default implementation of the AbstractWebConsolePlugin and supports the following features:

• Methods for (un)registering the web console plugin service
• Default implementation for resource loading

See Also:

Serialized Form

Field Summary

Fields inherited from class org.apache.felix.webconsole.AbstractWebConsolePlugin

ATTR_FILEUPLOAD, ATTR_FILEUPLOAD_REPO, GET_RESOURCE_METHOD_NAME

Constructor Summary

Constructors

Constructor and Description
SimpleWebConsolePlugin(String label, String title, String[] css) Creates new Simple Web Console Plugin with the default category (null)
SimpleWebConsolePlugin(String label, String title, String category, String[] css) Creates new Simple Web Console Plugin with the given category.

Method Summary

Modifier and Type	Method and Description
void	deactivate() This method will close all service trackers, created by getService(String) method.
String	getCategory() This method should return category string which will be used to render the plugin in the navigation menu.
String	getLabel() Retrieves the label.
Object	getService(String serviceName) Gets the service with the specified class name.
String	getTitle() Retrieves the title of the plug-in.
SimpleWebConsolePlugin	register(BundleContext bc) This is an utility method.
void	unregister() An utility method that removes the service, registered by the register(BundleContext) method.

Methods inherited from class org.apache.felix.webconsole.AbstractWebConsolePlugin

activate, getBrandingPlugin, getBundle, getParameter, getServletName, log, log, setBrandingPlugin, setLogLevel

Methods inherited from class javax.servlet.http.HttpServlet

service

Methods inherited from class javax.servlet.GenericServlet

destroy, getInitParameter, getInitParameterNames, getServletConfig, getServletContext, getServletInfo, init, init, log, log

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleWebConsolePlugin

public SimpleWebConsolePlugin(String label,
                              String title,
                              String[] css)

Creates new Simple Web Console Plugin with the default category (null)

Parameters:

label - the front label. See AbstractWebConsolePlugin.getLabel()

title - the plugin title . See AbstractWebConsolePlugin.getTitle()

css - the additional plugin CSS. See AbstractWebConsolePlugin.getCssReferences()

SimpleWebConsolePlugin

public SimpleWebConsolePlugin(String label,
                              String title,
                              String category,
                              String[] css)

Creates new Simple Web Console Plugin with the given category.

Parameters:

label - the front label. See AbstractWebConsolePlugin.getLabel()

title - the plugin title . See AbstractWebConsolePlugin.getTitle()

category - the plugin's navigation category. See AbstractWebConsolePlugin.getCategory()

css - the additional plugin CSS. See AbstractWebConsolePlugin.getCssReferences()

Method Detail

getLabel

public final String getLabel()

Description copied from class: AbstractWebConsolePlugin

Retrieves the label. This is the last component in the servlet path. This method MUST be overridden, if the AbstractWebConsolePlugin.AbstractWebConsolePlugin() constructor is used.

Specified by:

getLabel in class AbstractWebConsolePlugin

Returns:

the label.

See Also:

AbstractWebConsolePlugin.getLabel()

getTitle

public final String getTitle()

Description copied from class: AbstractWebConsolePlugin

Retrieves the title of the plug-in. It is displayed in the page header and is also included in the title of the HTML document. This method MUST be overridden, if the AbstractWebConsolePlugin.AbstractWebConsolePlugin() constructor is used.

Specified by:

getTitle in class AbstractWebConsolePlugin

Returns:

the plugin title.

See Also:

AbstractWebConsolePlugin.getTitle()

getCategory

public String getCategory()

Description copied from class: AbstractWebConsolePlugin

This method should return category string which will be used to render the plugin in the navigation menu. Default implementation returns null, which will result in the plugin link rendered as top level menu item. Concrete implementations wishing to be rendered as a sub-menu item under a category should override this method and return a string or define felix.webconsole.category OSGi property. Currently only single level categories are supported. So, this should be a simple String.

Overrides:

getCategory in class AbstractWebConsolePlugin

Returns:

category

See Also:

AbstractWebConsolePlugin.getCategory()

register

public final SimpleWebConsolePlugin register(BundleContext bc)

This is an utility method. It is used to register the plugin service. Don't forget to call the unregister() when the plugin is no longer needed.

Parameters:

bc - the bundle context used for service registration.

Returns:

self

unregister

public final void unregister()

An utility method that removes the service, registered by the register(BundleContext) method.

getService

public final Object getService(String serviceName)

Gets the service with the specified class name. Will create a new ServiceTracker if the service is not already got.

Parameters:

serviceName - the service name to obtain

Returns:

the service or null if missing.

deactivate

public void deactivate()

This method will close all service trackers, created by getService(String) method. If you override this method, don't forget to call the super.

Overrides:

deactivate in class AbstractWebConsolePlugin

See Also:

AbstractWebConsolePlugin.deactivate()