Plexus – Component Descriptor Creator

The contents of this document are a work in progress

Plexus Component Descriptor Creator

NOTE: This document and the CDC itself is currently a work in progress.

The Component Descriptor Creator (or CDC for short) is a tool that will create the components.xml file from your Java code. It uses JavaDoc tags to gather the information it needs to create the component descriptor.

There is a tag for marking components, requirements and configuration. Each of the tags can have parameters as documented below.

Component Tag Parameters

Tag	Required	Description
role	y	The role of the component.
role-hint	y	The role-hint of the component.
version	n	The component version.
lifecycle-handler	n	The lifecycle handler of the component. TODO: link to the different lifecycle handlers
instantiation-strategy	n	The instantiation strategy of the component. TODO: link to the different instantiation strategies

/**
 * @plexus.component
 *   lifecycle-handler="plexus-configurable"
 */
public class DefaultActionManager
    extends AbstractLogEnabled
    implements ActionManager, Serviceable
{

Requirement Tag Parameters

These tags are used on fields to state requirements. TODO: it should be possible to override the role for a normal field.

Tag	Required	Description
role	y/n	Only required if the field is a List or Map
role-hint	n

/**
 * @plexus.requirement
 *  role-hint="foo"
 */
private ActionManager actionManager;

Configuration Tag Parameters

Note that the default value tag won't be required in the future when these tags will be used to generate a separate configuration declaration section.

Tag	Required	Description
default-value	y	Sets the default value for the configuration field

/**
 * @plexus.configuration
 *  default-value="Trygve"
 */
private String name;