aQute.bnd.annotation.xml.XMLAttribute Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of biz.aQute.bndlib Show documentation

bndlib: A Swiss Army Knife for OSGi

There is a newer version: 7.0.0

package aQute.bnd.annotation.xml;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * Define an xml attribute extension annotation. In cooperation with an
 * XMLAttribute-aware annotation processor, such as the bnd plugins for DS and
 * (spec) metatype annotations, the values specified for the members of the
 * annotation will be added to the appropriate xml element in the document being
 * generated, using the namespace specified and attempting to use the prefix
 * specified. This will only occur if the generated document namespace matches
 * one of the embedIn strings. Supporting classes for this are in the
 * aQute.bnd.xmlattribute package.
 * 
 * For example:
 * 
 * 
 * @XMLAttribute(namespace = "org.foo.extensions.v1", prefix =
 * "foo", embedIn = "*")
 * @Retention(RetentionPolicy.CLASS) @Target(ElementType.TYPE)
 * @interface OCDTestExtensions { boolean booleanAttr() default true; //
 * default provided, thus optional String stringAttr(); // no default, must be
 * specified Foo fooAttr(); } @ObjectClassDefinition
 * @OCDTestExtensions(stringAttr = "ocd", fooAttr = Foo.A) public
 * static interface TestExtensions {}
 * 
 * 
 * results in
 * 
 *  *  
 *  ...
 * 
 */
@Retention(RetentionPolicy.CLASS)
@Target({
		ElementType.ANNOTATION_TYPE
})
public @interface XMLAttribute {

	/**
	 * xml namespace for the emitted attritrbutes
	 * 
	 * @return xml namespace for the emitted attritrbutes
	 */
	String namespace();

	/**
	 * Suggested prefix for the specified namespace. This will be modified as
	 * necessary to avoid conflicts.
	 * 
	 * @return suggested prefix for the specified namespace.
	 */
	String prefix() default "ns";

	/**
	 * Array of document namespaces this annotation should embed attributes in.
	 * 
	 * @return array of applicable xml namespaces
	 */
	String[] embedIn() default {
			"*"
	};

	/**
	 * Array of Strings of the form key=value where the key is the name of a
	 * member and the value is the xml attribute name to use for that member's
	 * value. For instance, "value=simple" causes @Simple("foo") to emit
	 * ns:simple="foo".
	 * 
	 * @return Array of member-name to xml-attribute-name mappings.
	 * @since 1.1
	 */
	String[] mapping() default {};

}