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

Question

Я пытаюсь найти некоторую информацию о том, что на самом деле делает файл 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 файл?

Answer 1

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

Answer 2

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

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

source: http://download.oracle.com/javase/6/docs/technotes/tools/solaris/javadoc.html#sourcefiles

Answer 3

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