xjc - Архитектура Java™ для Привязки XML Привязка Компилятора
Версия спецификации: 2.1 Ссылочная Реализация (RI) Версия: 2.1.3
Запуск xjc
Обязательный компилятор может быть запущен, используя соответствующее xjc сценарий оболочки в bin каталог для Вашей платформы. Мы также обеспечиваем задачу Муравья работать, привязка complier - см. инструкции для того, чтобы .
% xjc -help
Вывод
Usage: xjc [-options ...] <schema file/URL/dir/jar> ... [-b <bindinfo>] ...
If dir is specified, all schema files in it will be compiled.
If jar is specified, /META-INF/sun-jaxb.episode binding file will be compiled.
Options:
-nv : do not perform strict validation of the input schema(s)
-extension : allow vendor extensions - do not strictly follow the Compatibility Rules and App E.2 from the JAXB Spec
-b <file/dir> : specify external bindings files (each <file> must have its own -b); if a directory is given, **/*.xjb is searched
-d <dir> : generated files will go into this directory
-p <pkg> : specifies the target package
-httpproxy <proxy> : set HTTP/HTTPS proxy; format is [user[:password]@]proxyHost:proxyPort
-httpproxyfile <f> : works like -httpproxy but takes the argument in a file to protect password
-classpath <arg> : specify where to find user class files
-catalog <file> : specify catalog files to resolve external entity references; support TR9401, XCatalog, and OASIS XML Catalog format
-readOnly : generated files will be in read-only mode
-npa : suppress generation of package level annotations (**/package-info.java)
-no-header : suppress generation of a file header with timestamp
-target 2.0 : behave like XJC 2.0 and generate code that doesnt use any 2.1 features
-xmlschema : treat input as W3C XML Schema (default)
-relaxng : treat input as RELAX NG (experimental,unsupported)
-relaxng-compact : treat input as RELAX NG compact syntax (experimental,unsupported)
-dtd : treat input as XML DTD (experimental,unsupported)
-wsdl : treat input as WSDL and compile schemas inside it (experimental,unsupported)
-verbose : be extra verbose
-quiet : suppress compiler output
-help : display this help message
-version : display version information
Extensions:
-Xlocator : enable source location support for generated code
-Xsync-methods : generate accessor methods with the 'synchronized' keyword
-mark-generated : mark the generated code as @javax.annotation.Generated
-episode <FILE> : generate the episode file for separate compilation
ОПЦИИ
-nv
По умолчанию XJC обязательный компилятор выполняет строгую проверку допустимости исходной схемы прежде, чем обработать это. Используйте эту опцию, чтобы отключить строгую проверку допустимости схемы. Это не означает, что обязательный компилятор не будет выполнять проверки допустимости, это просто означает, что это выполнит менее - строгая проверка допустимости.
- расширение
По умолчанию XJC обязательный компилятор строго осуществляет правила, обрисованные в общих чертах в главе Совместимости Спецификации JAXB. Приложение E.2 определяет ряд функций XML-схемы W3C, которые не полностью поддерживаются JAXB v1.0. В некоторых случаях Вам можно разрешить использовать их в "-расширение" режим, включенный этим переключателем. В (строгом) режиме по умолчанию Вы также ограничиваетесь использованием только обязательных настроек, определенных в спецификации. При использовании "-расширение" переключатель, Вам разрешат использовать Расширения Поставщика JAXB
-b <файл>
Определите один или более внешних обязательных файлов, чтобы обработать. (У каждого обязательного файла должно быть свое собственное "-b" переключатель.) Синтаксис внешних обязательных файлов чрезвычайно гибок. У Вас может быть единственный обязательный файл, который содержит настройки для многократных схем, или можно повредить настройки в многократные файлы привязки: xjc schema1.xsd schema2.xsd schema3.xsd -b bindings123.xjb xjc schema1.xsd schema2.xsd schema3.xsd -b bindings1.xjb -b bindings2.xjb -b bindings3.xjb Кроме того, упорядочивание файлов схемы и обязательных файлов на командной строке не имеет значения.
-d <dir>
По умолчанию XJC обязательный компилятор генерирует классы контента Java в текущем каталоге. Используйте эту опцию, чтобы определить альтернативный выходной каталог. Выходной каталог должен уже существовать, XJC, обязательный компилятор не будет создавать это для Вас.
-p <pkg>
Определение целевого пакета через этот параметр командной строки переопределяет любую обязательную настройку для имени пакета и алгоритма имени пакета по умолчанию, определенного в спецификации.
-httpproxy <прокси>
Определите прокси HTTP/HTTPS. Формат является [пользователем [:password]] proxyHost [:proxyPort]. Старое -host и -port все еще поддерживаются RI для назад совместимости, но они были осуждены. Отметьте, что пароль, определенный с этой опцией, является параметром, который видим другим пользователям, которые используют top команда, например. Для большей безопасности использовать -httpproxyfile, ниже.
-httpproxyfile <файл>
Определите прокси HTTP/HTTPS, используя файл. Тот же самый формат как выше, но пароль, определенный в файле, не видим другим пользователям.
- путь к классу <аргумент>
Определите, где счесть файлы класса клиентского приложения используемыми <jxb:javaType> и <xjc:superClass> настройки.
- каталог <файл>
Определите файлы каталога, чтобы разрешить внешние ссылки на сущность. Поддерживает TR9401, XCatalog, и XML ОАЗИСА формат Каталога. Пожалуйста, считайте XML Объект и документ Преобразователей URI или catalog-resolver пример приложения.
- только для чтения
По умолчанию, XJC, обязательный компилятор не защищает от записи исходные файлы Java, которые это генерирует. Используйте эту опцию, чтобы вынудить XJC обязательный компилятор отметить сгенерированные источники Java, только для чтения.
-npa
Подавите генерацию аннотаций уровня пакета в **/package-info.java. Используя этот переключатель заставляет сгенерированный код усваивать те аннотации в другие сгенерированные классы.
- никакой-заголовок
Подавите генерацию комментария заголовка файла, который включает некоторое примечание и метку времени. Используя это делает сгенерированный код более благоприятным для разности.
- цель 2.0
Избегите генерировать код, который полагается на любой JAXB 2.1 функции. Это позволит сгенерированному коду выполнять с JAXB 2.0 времени выполнения (такие как JavaSE 6.)
-xmlschema
Обработайте входные схемы как XML-схему W3C (значение по умолчанию). Если Вы не определите этот переключатель, то Ваши входные схемы будут обработаны как XML-схема W3C.
-relaxng
Обработайте входные схемы, как ОСЛАБЛЯЮТ НАНОГРАММ (экспериментальный, неподдерживаемый). Поддержка ОСЛАБЛЯЕТСЯ, схемы НАНОГРАММА обеспечивается как Расширение Поставщика JAXB.
- relaxng-компактный
Обработайте входные схемы, как ОСЛАБЛЯЮТ НАНОГРАММ компактный синтаксис (экспериментальный, неподдерживаемый). Поддержка ОСЛАБЛЯЕТСЯ, схемы НАНОГРАММА обеспечивается как Расширение Поставщика JAXB.
- дата
Обработайте входные схемы как DTD XML (экспериментальный, неподдерживаемый). Поддержка ОСЛАБЛЯЕТСЯ, схемы НАНОГРАММА обеспечивается как Расширение Поставщика JAXB.
-wsdl
Ввод обработки как WSDL и схемы компиляции в этом (экспериментальный, неподдерживаемый).
- тихий
Подавите выход компилятора, такой как информация о продвижении и предупреждения.
- многословный
Будьте дополнительны многословный, такие как печать информационных сообщений, или отображение стека прослеживает на некоторые ошибки.
- справка
Выведите на экран краткую сводку переключателей компилятора.
- версия
Выведите на экран информацию о версии компилятора.
<файл/URL/dir схемы>
Определите один или более файлов схемы, чтобы скомпилировать. Если Вы определите каталог, то xjc отсканирует его для всех файлов схемы и скомпилирует их.
Нестандартные Параметры командной строки
-Xlocator
Заставляет сгенерированный код представлять информацию о Локаторе SAX об исходном XML в бобовых экземплярах Java после немаршалинга.
- Xsync-методы
Причины все сгенерированные сигнатуры методов, чтобы включать synchronized ключевое слово.
- сгенерированный меткой
Отметьте сгенерированный код с аннотацией @javax.annotation.Generated.
- эпизод <файл>
Генерируйте указанный файл эпизода для раздельной компиляции.
Устаревшие и Удаленные Параметры командной строки
- узел & - порт
Эти опции были осуждены и заменены-httpproxy опцией. Для назад совместимости мы будем продолжать поддерживать эти опции, но они больше не будут задокументированы и могут быть удалены из будущих выпусков.
- время выполнения использования
Начиная с JAXB 2.0 спецификации определили переносимое время выполнения, больше не необходимо для RI JAXB генерировать **/impl/runtime пакеты. Поэтому, этот переключатель является устаревшим и был удален.
- источник
- исходный переключатель совместимости был представлен в первом JAXB 2.0 Ранних выпуска Доступа. Мы решили удалить этот переключатель из будущих выпусков JAXB 2.0. Если Вы должны генерировать 1.0.x код, пожалуйста, используйте установку 1.0.x кодовая база.
Ограничения компилятора
Вообще, является самым безопасным скомпилировать все связанные схемы как единый блок с теми же самыми обязательными переключателями компилятора.
Пожалуйста, помните следующий список ограничений, работая xjc. Большинство этих проблем только применяется, компилируя многократные схемы с многократными вызовами xjc.
Чтобы скомпилировать многократные схемы одновременно, сохраните следующие правила приоритета для целевого имени пакета Java в памяти:
"-p"параметр командной строки берет наивысший приоритет.
<jaxb:package> настройка
Если targetNamespace объявляется, применяться targetNamespace -> Алгоритм имени пакета Java определяется в спецификации.
Если нет targetNamespace объявляется, используйте hardcoded пакет, названный "сгенерированным".
Не законно иметь больше чем один <jaxb:schemaBindings> на пространство имен, таким образом, невозможно иметь две схемы в том же самом целевом пространстве имен, скомпилированном в различные пакеты Java.
Все схемы, скомпилированные в тот же самый пакет Java, должны быть представлены XJC обязательный компилятор одновременно - они не могут быть скомпилированы независимо и работа как ожидалось.
Групповое распространение замены элемента через многократные файлы схемы должно быть скомпилировано одновременно.
