Что такое JAXB сгенерированный package-info.java

Я пытаюсь найти некоторую информацию о том, что на самом деле делает файл package-info.java, сгенерированный JAXB xjc. Все, что находится в файле,

@javax.xml.bind.annotation.XmlSchema(namespace = "http://www.example.com", elementFormDefault = javax.xml.bind.annotation.XmlNsForm.QUALIFIED)
package the.generated.package.path;

Что это за package-info.java файл, используемый для?

Ответы

Ответ 1

package-info.java - это способ применения аннотаций java на уровне пакета. В этом случае Jaxb использует аннотации на уровне пакета, чтобы указать пространство имен, и указать квалификацию пространства имен для атрибутов (источник).

Ответ 2

Это также полезно при создании javadoc

package-info.java - может содержать объявление пакета, пакет аннотации, комментарии к пакетам и теги Javadoc. Этот файл является новым в JDK 5.0 и является предпочтительным по сравнению с package.html.

источник: http://download.oracle.com/javase/6/docs/technotes/tools/solaris/javadoc.html#sourcefiles

Ответ 3

Если вы хотите определить пространство имен по умолчанию для элементов в вашей Java-модели, вы можете определить его в package-info.java