org.xwiki.component.annotation

Annotation Type Component

@Documented
@Retention(value=RUNTIME)
@Target(value=TYPE)
public @interface Component

Defines a component implementation. A hint can be specified to differentiate this implementation from another one.

Since:

1.8.1

Version:

$Id: 78330fa4f96dccdd749c599bfdd0013307593535 $

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
String[]	hints Sometimes you want to register the component several times with different hints.
Class<?>[]	roles When specified forces the component to be registered as many times as there are roles specified.
boolean	staticRegistration Whether the Component should be registered in a components.txt file or not (this can happen for example when using a component in a test and registering it dynamically without going through a components.txt file).
String	value Deprecated. since 3.1M1 use the @Named annotation instead

Element Detail

value

@Deprecated
public abstract String value

Deprecated. since 3.1M1 use the @Named annotation instead

The hint value. Can be any text value. It's used to differentiate one component implementation from another one.

Default:

""

hints

public abstract String[] hints

Sometimes you want to register the component several times with different hints. In this case the default annotation value is ignored and the passed list of hints is used instead.

Default:

{}

roles

public abstract Class<?>[] roles

When specified forces the component to be registered as many times as there are roles specified. Otherwise the superclass/interface hierarchy is scanned for ComponentRole annotations and the component is registered under all roles found.

Default:

{}

staticRegistration

public abstract boolean staticRegistration

Whether the Component should be registered in a components.txt file or not (this can happen for example when using a component in a test and registering it dynamically without going through a components.txt file).

Default:

true