Что такое файл .episode ..?

Question

что такое файл .episode в JAXB ..? Это сгенерировано JAXB или это файл конфигурации, которым мы будем манипулировать, чтобы избежать регенерации тех же классов JAXB ..?

Answer 1

Примечание: Я EclipseLink JAXB (MOXy) и являюсь членом JAXB 2 (JSR-222 ) экспертная группа.

Файл .episode генерируется компилятором XJC (XML Schema to Java). Это привязка схемы, которая связывает типы схемы с существующими классами. Это полезно, когда у вас есть одна XML-схема, которая импортируется другими схемами, поскольку она предотвращает повторное создание модели. Ниже приведен пример:

Product.xsd

<?xml version="1.0" encoding="UTF-8"?>
<schema 
    xmlns="http://www.w3.org/2001/XMLSchema" 
    targetNamespace="http://www.example.org/Product" 
    xmlns:tns="http://www.example.org/Product" 
    elementFormDefault="qualified">
    <element name="product">
        <complexType>
            <sequence>
                <element name="id" type="string"/>
                <element name="name" type="string"/>
            </sequence>
        </complexType>
    </element>
</schema>

Поскольку несколько XML-схем импортируют Product.xsd, мы можем использовать файлы эпизодов, чтобы классы, соответствующие Product.xsd, создавались только один раз.

xjc -d out -episode product.episode Product.xsd

ProductPurchaseRequest.xsd

Ниже приведен пример схемы XML, которая импортирует Product.xsd:

<?xml version="1.0" encoding="UTF-8"?>
<schema 
    xmlns="http://www.w3.org/2001/XMLSchema" 
    targetNamespace="http://www.example.org/ProductPurchaseRequest" 
    xmlns:tns="http://www.example.org/ProductPurchaseRequest"
    xmlns:prod="http://www.example.org/Product" 
    elementFormDefault="qualified">
    <import namespace="http://www.example.org/Product" schemaLocation="Product.xsd"/>
    <element name="purchase-request">
        <complexType>
            <sequence>
                <element ref="prod:product" maxOccurs="unbounded"/>
            </sequence>
        </complexType>
    </element>
</schema>

Когда мы генерируем классы из этой XML-схемы, мы ссылаемся на файл эпизода, который мы создали, когда генерировали классы Java из Product.xsd.

xjc -d out ProductPurchaseRequest.xsd -extension -b product.episode

ProductQuoteRequest.xsd

Ниже приведен другой пример схемы XML, которая импортирует Product.xsd:

<?xml version="1.0" encoding="UTF-8"?>
<schema 
    xmlns="http://www.w3.org/2001/XMLSchema" 
    targetNamespace="http://www.example.org/ProductQuoteRequest" 
    xmlns:tns="http://www.example.org/ProductQuoteRequest" 
    xmlns:prod="http://www.example.org/Product" 
    elementFormDefault="qualified">
    <import namespace="http://www.example.org/Product" schemaLocation="Product.xsd"/>
    <element name="quote">
        <complexType>
            <sequence>
                <element ref="prod:product"/>
            </sequence>
        </complexType>
    </element>
</schema>

Опять же, когда мы генерируем классы из этой схемы XML, мы ссылаемся на файл эпизода, который мы создали, когда генерировали классы Java из Product.xsd.

xjc -d out ProductQuoteRequest.xsd -extension -b product.episode

Для получения дополнительной информации

• http://blog.bdoughan.com/2011/12/reusing-generated-jaxb-classes.html

Answer 2

Я добавлю некоторые мелочи.

• На самом деле, .episode файлы - это просто обычные файлы переплета (поэтому они работают с xjc -b).
• Они могут бытьгенерируется с помощью специального встроенного плагина (это то, что делает -episode).
• Если поместить его в JAR по пути META-INF/sun-jaxb.episode, вы можете сделать xjc b.xsd a.jar - XJC будет сканировать JAR-файлы для поиска файлов эпизодовИспользование в качестве файлов привязки автоматически.
• Все это прекрасно работает с Maven ( maven-jaxb2-plugin ).Однако в более поздней версии вы можете использовать файлы привязки из JAR-артефактов даже без эпизодов.

Answer 3

Просто дополнение к ответу, я хотел бы предоставить информацию о том, как избежать создания файла .episode при использовании maven-jaxb2-plugin

         `<plugin>
            <groupId>org.jvnet.jaxb2.maven2</groupId>
            <artifactId>maven-jaxb2-plugin</artifactId>
            <version>0.12.3</version>
            <executions>
                <execution>
                    <id>schema-conversion</id>
                    <goals>
                        <goal>generate</goal>
                    </goals>
                    <configuration>
                        <schemaDirectory>src/main/schema/myschema</schemaDirectory>
                        <bindingDirectory>src/main/schema/myschema</bindingDirectory>
                        <bindingIncludes>
                            <include>binding_info.xjb</include>
                        </bindingIncludes>
                        <generateDirectory>src/main/java/</generateDirectory>
                        <episode>false</episode>
                    </configuration>
                </execution>
            </executions>
        </plugin>`

<episode>false</episode> заставит это исчезнуть.

Answer 4

Судя по всему, они предназначены для создания модульной схемы .

Это означает, что сами файлы могут использоваться как в качестве конфигуратора, так и в качестве генеративного представления уровня данных для последующей обработки. Для определения того, о чем здесь идет речь, потребуется больше контекста.