Commande schemagen pour les applications JAXB

Utilisez l'outil de génération de schéma, schemagen, pour générer un schéma XML à l'aide de JAXB (Java™ Architecture for XML Binding).

Utilisez les API et les outils JAXB pour créer des mappages entre un schéma XML et des classes Java. Les schémas XML décrivent les éléments de données et les relations dans un document XML. Lorsqu'un mappage de données ou une liaison existe, vous pouvez convertir des documents XML en objets ou à partir d'objets Java. Vous pouvez maintenant traiter les données stockées dans un document XML sans qu'il soit nécessaire de comprendre la structure des données.

Vous pouvez générer un fichier schéma à partir des classes Java à l'aide de l'outil de génération de schéma schemagen pour créer le schéma XML. Dès que le mappage entre le schéma XML et les classes Java existe, les documents d'instance XML peuvent être convertis à partir et vers des objets Java via l'utilisation de l'API d'exécution de liaison JAXB. Les classes Java qui en résultent contiennent toutes les informations nécessaires dont l'exécution de JAXB a besoin pour analyser le langage XML pour la conversion et la déconversion des paramètres. Vous pouvez utiliser les classes JAXB dans les applications JAX-WS (Java API for XML Web Services) ou dans vos applications Java autres que JAX-WS pour le traitement des données XML.

Configurations prises en charge Configurations prises en charge: Les outils de ligne de commande wsimport, wsgen, schemagen et xjc ne sont pas pris en charge sur la plateforme z/OS. Leur fonctionnalité est assurée par les outils d'assemblage fournis avec WebSphere Application Server s'exécutant sur la plateforme z/OS. Pour plus d'informations sur ces outils de ligne de commande, reportez-vous aux outils de ligne de commande pour les applications JAX-WS.sptcfg
Pratiques recommandées Pratiques recommandées: WebSphere Application Server fournit des outils JAX-WS (Java API for XML-Based Web Services) et JAXB (Java Architecture for XML Binding). Les outils de ligne de commande wsimport, wsgen, schemagen et xjc se trouvent dans le répertoire app_server_root\bin\ de WebSphere Application Server Traditional.Les commandes xjc et schemagen se trouvent dans le répertoire app_server_root\jaxb\bin\ du profil Liberty. Il peut arriver que les artefacts générés par les outils fournis par WebSphere Application Server et le kit de développement Java SE prennent en charge les mêmes niveaux de spécifications. En général, les artefacts générés par les outils JDK sont compatibles avec d'autres environnements d'exécution conformes. Toutefois, il est recommandé d'utiliser les outils fournis avec ce produit pour effectuer une intégration transparente au sein de l'environnement WebSphere Application Server et pour bénéficier des fonctions qui peuvent être prises en charge uniquement dans WebSphere Application Server. Pour profiter des outils JAX-WS et JAXB V2.2, utilisez les outils fournis avec le serveur d'applications qui se trouvent dans le répertoire racine_serveur_app\bin\.bprac
Eviter les incidents Eviter les incidents: Lors de l'exécution de l'outil schemagen pour traiter les JavaBeans, le générateur de schéma ne lit pas correctement les annotations @XmlSchema dans le fichier classe package-info pour dériver targetNamespaces. Pour que l'outil schemagen traite correctement les valeurs d'espace de nom, appliquez les méthodes suivants :
  • Spécifiez explicitement le fichier source package-info.java dans l'appel schemagen, par exemple :
    schemagen sample.Address sample\package-info.java
  • Use the @XmlType annotation namespace attribute within your JavaBeans to specify a namespace; for example:
    @XmlType(namespace="http://myNameSpace")
    public class Address {...}
gotcha

Outre l'utilisation de l'outil schemagen à partir de la ligne de commande, vous pouvez appeler cet outil JAXB à partir des environnements de génération Ant. Utilisez la tâche Ant com.sun.tools.jxc.SchemaGenTask à partir de l'environnement de génération Ant pour appeler l'outil de génération de schéma schemagen. Pour fonctionner correctement, la tâche Ant doit être appelée par le script ws_ant.

Syntaxe

La syntaxe de ligne de commande est la suivante :

[Windows]
racine_serveur_app\bin\schemagen.bat [options] <java_files>
[AIX][HP-UX][Linux][Solaris]
racine_serveur_app/bin/schemagen.sh [options] <java_files>
[IBM i]
racine_serveur_app/bin/schemagen [options] <java_files>

Paramètres

Les paramètres suivants sont facultatifs pour la commande schemagen :

-classpath <chemin>
Indique l'emplacement des fichiers classe ou source Java.
-cp <chemin>
Indique l'emplacement des fichiers classe ou source Java.
-d <chemin>
Indique où placer le processeur et les fichiers classe Java générés.
-episode<nom_fichier>
Indique la génération d'un fichier episode pour la compilation séparée.
-encoding <encoding>
Indique d'utiliser l'encodage spécifié lors du lancement de l'outil -apt ou -javac. Cette propriété est applicable à JAXB 2.2 et versions ultérieures.
-help
Affiche le menu d'aide.
-version
Imprime les informations de version. Si vous spécifiez cette option, seules les informations de version sont générées et le traitement de commande standard n'a pas lieu.

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwbs_schemagen
Nom du fichier : rwbs_schemagen.html