Qu'est ce qu'un .épisode fichier..?

qu'est ce qu'un .épisode fichier dans JAXB..? Est-il généré par le JAXB ou est-il un fichier de configuration que nous avions manipuler pour éviter la régénération de la même classes par JAXB..?

InformationsquelleAutor quantumcrypt | 2012-03-18
  1. 30

    Remarque: je suis le EclipseLink JAXB (MOXy) plomb et un membre de la JAXB 2 (JSR-222) groupe d'experts.

    Un .épisode fichier est généré par le XJC (Schéma XML en Java) compilateur. C'est un schéma des liaisons qui associe types de schémas avec des classes existantes. Il est utile lorsque vous avez un schéma XML qui est importé par d'autres schémas, car il empêche le modèle de régénérée. Ci-dessous est un exemple:

    Produit.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>

    Depuis plusieurs schémas XML d'importation du Produit.xsd nous pouvons tirer parti de l'épisode de fichiers, de sorte que les classes correspondantes aux Produits.xsd sont générés seulement une fois.

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

    ProductPurchaseRequest.xsd

    Ci-dessous est un exemple d'un schéma XML que les importations du Produit.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>

    Lorsque nous générer des classes à partir de ce schéma XML nous avons fait référence à l'épisode de fichier que nous avons créé lorsque nous avons généré des classes Java à partir de Produits.xsd.

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

    ProductQuoteRequest.xsd

    Ci-dessous est un autre exemple d'un schéma XML que les importations du Produit.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>

    Encore une fois, générer des classes à partir de ce schéma XML nous avons fait référence à l'épisode de fichier que nous avons créé lorsque nous avons généré des classes Java à partir de Produits.xsd.

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

    Pour Plus D'Informations

    • Ce n'est pas fiable dans le maven-jaxb2-plugin, si vous pouvez fournir l'épisode de fichier, vous devez fournir l'original du fichier de schéma aussi. Citation du plugin: guide de l'utilisateur Remarque que JAXB encore besoin d'accéder à la FOIS à A et B des schémas lors de la compilation. Vous pouvez utiliser des catalogues de fournir d'autres endroits de l'schémas importés.
    InformationsquelleAutor bdoughan
  2. 8

    Je vais ajouter quelques détails.

    • En fait, .episode fichiers sont tout à fait normal de liaison de fichiers (c'est pourquoi ils travaillent avec xjc -b).
    • Ils peuvent être générés avec un spécial intégré dans le plugin (c'est ce que -episode n').
    • S'il est placé dans un BOCAL en vertu de la META-INF/sun-jaxb.episode chemin, vous pouvez faire xjc b.xsd a.jar - XJC va scanner les Pots pour les fichiers d'épisode alors une utilisation de la liaison de fichiers automatiquement.
    • Toute cette beauté qui fonctionne bien avec Maven (maven-jaxb2-plugin). Cependant, avec une version ultérieure, vous pouvez utiliser la liaison de fichiers à partir de JAR artefacts, même sans épisodes.
    • Très bon. Mais je ne peut pas lier une documentation sur l'utilisation du POT artefacts
    • Voir les entrées de ressource, il suffit d'utiliser avec bindings au lieu de schemas: confluence.highsource.org/display/MJIIP/...
    InformationsquelleAutor lexicore
  3. 0

    Apparemment, ils sont pour schéma modulaire création.

    Cela implique que les fichiers eux-mêmes peuvent être utilisés à la fois comme un outil de configuration et générative vue d'une couche de données pour le traitement en aval. Plus de contexte serait nécessaire pour déterminer ce qui est évoqué ici.

    InformationsquelleAutor MrGomez
  4. 0

    Juste un addon pour la réponse, j'aimerais donner un avis sur les moyens d'éviter d'avoir .épisode fichier généré lors de l'utilisation de 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> va le faire disparaître.

    InformationsquelleAutor Suraj Muraleedharan