com.webcohesion.enunciate.metadata.qname.XmlQNameEnum Maven / Gradle / Ivy

Go to download
package com.webcohesion.enunciate.metadata.qname;

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

import static java.lang.annotation.ElementType.TYPE;
import static java.lang.annotation.RetentionPolicy.RUNTIME;

/**
 * Special Enunciate support for qname enumerations. See http://docs.codehaus.org/display/ENUNCIATE/QName+Enums.
 *
 * @author Ryan Heaton
 */
@Retention (RUNTIME) @Target ({TYPE})
public @interface XmlQNameEnum {

  /**
   * The namespace for this qname enumeration. If left unspecified (i.e. the value is "##default"), then
   * standard JAXB namespacing applies, which looks like this:
   *
   * 
   *  If the enclosing package has {@link javax.xml.bind.annotation.XmlSchema} annotation,
   *  and its {@link javax.xml.bind.annotation.XmlSchema#elementFormDefault() elementFormDefault}
   *  is {@link javax.xml.bind.annotation.XmlNsForm#QUALIFIED QUALIFIED}, then the namespace of
   *  the enclosing class.
   *  Otherwise "" (which produces unqualified element in the default namespace).
   * 
   *
   * @return The namespace for this qname enumeration.
   */
  String namespace() default "##default";

  /**
   * The base type for this QName enum.
   *
   * @return The base type for this QName enum.
   */
  BaseType base() default BaseType.QNAME;

  /**
   * Enumeration of known base types of QName enums.
   */
  public enum BaseType {

    QNAME,

    URI
  }

}