Générer du code depuis des Schémas XML ou des DTD
Lorsque vous générez du code depuis un mappage, MapForce génère une application complète qui exécute toutes les étapes du mappage automatiquement. En option, vous pouvez générer des bibliothèques pour tous les schémas XML utilisés dans le mappage. Celles-ci permettent à votre code de créer ou de lire facilement des instances XML qui sont utilisées ou créées par le code mappage.
Pour générer des bibliothèques pour tous les schémas XML utilisés dans le mappage, cocher la case Generate Wrapper Classes dans les options du générateur de code. La prochaine fois que vous générez du code, MapForce créera non seulement une application de mappage, mais aussi des classes de wrapper pour tous les schémas utilisés dans le mappage, comme suit :
C++ ou C# | Java | Objectif |
Altova | com.altova | Bibliothèque de base contenant un support de runtime commun, à l’identique pour chaque schéma. |
AltovaXML | com.altova.xml | Bibliothèque de base contenant un support de runtime pour XML, à l’identique pour chaque schéma. |
[YourSchema] | com.YourSchema | Une bibliothèque contenant des déclarations générées depuis le schema d’entrée, nommée comme le fichier de schéma ou DTD. Cette bibliothèque est un DOM (W3C Document Object Model) wrapper qui vous permet de lire, modifier ou créer des documents XML facilement et en toute sécurité. Toutes les données sont contenues à l’intérieur du DOM, et il existe des méthodes pour les données d’extraction depuis le DOM, et pour mettre à jour et créer des données dans le DOM.
Le code généré C++ prend en charge soit Microsoft MSXML ou Apache Xerces 3. La syntaxe pour utiliser le code généré est généralement semblable pour les deux mises en œuvre DOM, à l’exception de quelques légères différences (par exemple, Xerces prend en charge plus de fonctions surchargées).
Le code C# généré utilise la bibliothèque .NET standard System.XML comme mise en œuvre sous-jacente de DOM.
Le code Java généré utilise JAXP (Java API pour le traitement XML) comme interface sous-jacente DOM. |
Tout en prototypant une application depuis un schéma XML changeant fréquemment, vous devrez éventuellement générer fréquemment du code dans le même répertoire, de manière à ce que les changements de schéma sont réfléchis immédiatement dans le code. Veuillez noter que l’application de test généré et les bibliothèques Altova sont écrasées à chaque fois que vous générez du code dans le même répertoire cible. C’est pourquoi il ne faut pas ajouter du code à l’application de test généré. Au lieu de cela, veuillez intégrer les bibliothèques dans votre projet (voir Intégrer des Bibliothèques Schema Wrapper). |
En plus des bibliothèques de base ci-dessus, quelques bibliothèques sont également générées. Les bibliothèques prises en charge sont utilisées par les bibliothèques de base d’Altova et ne sont pas prévues pour des intégrations personnalisées, puisqu’elles sont sujettes au changement.
Génération de nom et espaces de nom
MapForce génère des classes correspondant à tous les éléments déclarés ou types complexes qui redéfinissent tout type complexe de votre schéma XML, préservant la dérivation de classe, telle que définie par les extensions des types complexes dans votre schéma XML. Dans le cas de schémas complexes qui importent des composants de schéma de multiples espaces de noms, MapForce préserve cette information en générant les espaces de noms C# or C++ appropriés ou les packs Java.
Généralement, le générateur de code tente de préserver les noms pour les espaces de noms générés, classes et membres depuis le schéma XML d’origine. Les caractères qui ne sont pas valides en identifiants dans le langage cible sont remplacés par a "_". Les noms qui qui entreraient en collision avec les autres noms ou mots réservés sont rendus uniques en ajoutant un numéro. La génération de nom peut être influencée en changeant les paramètres par défaut dans le modèle SPL.
Les espaces de noms depuis le schéma XML sont convertis en packs dans Java ou espaces de noms dans le code C# or C++, utilisant le préfixe d’espace de noms depuis le schéma comme espace de nom du code. La bibliothèque complète est intégrée dans un pack pu appareil de noms dérivé depuis le nom de fichier du schéma, donc vous pouvez utiliser le multiples bibliothèques générées dans un programme sans conflits de noms.
Types de données
Le Schéma XML a un modèle de type de données plus élaboré que Java, C# ou C++. Le générateur de code convertit les types de schéma XML intégrés en des types primitifs spécifique au langage, ou pour des classes délivrées avec la bibliothèque d’Altova. Des types complexes et types dérivés dans le schéma sont convertis en classes dans la bibliothèque générée. Les facettes d’énumération de types simples sont converties en constantes symboliques.
Le mappage de types simples peut être configuré en modèle SPL, voir Référence SPL.
Si vos fichiers d’instance XML utilisent vos types de schéma associés au temps et à la durée, ceux-ci sont convertis en classes natives d’Altova dans le code généré. Pour plus d’informations concernant les classes de bibliothèque, voir :
•Référence aux classes générées (C++)
•Référence aux classes générées (C#)
•Référence aux classes générées (Java)
Pour des informations sur le type de conversion et autres détails applicables à chaque langage, voir :
•À propos des Schema Wrapper Libraries (C++)
•À propos des Schema Wrapper Libraries (C#)
•À propos des Schema Wrapper Libraries (Java)
Gestion de la mémoire
Une arborescence DOM est comprise de nœuds, qui sont toujours la propriété d’un document DOM spécifique - même si le nœud ne fait pas actuellement partie du contenu du document. Toutes les classes générées sont référencées aux nœuds DOM qu’ils représentent, et non aux valeurs. Ceci signifie qu’assigner une instance de la classe générée ne copie pas la valeur, ceci crée une référence supplémentaire aux mêmes données.
Prise en charge du schéma XML
Les constructions de schéma XML suivantes sont traduites en code :
a) espaces de noms XML
b) Types simples :
•Types de schéma XML intégrés
•Les types simples dérivés par extension
•Les types simples dérivés par restriction
•Facettes
•Enumérations
•Motifs
c) Types complexes :
•Nœud anyType intégré
•Types complexes définis par l’utilisateur
•Dérivé par extension : Mappé vers les classes dérivées
•Dérivé par restriction
•Contenu complexe
•Contenu simple
•Contenu mixte
Les fonctions de schéma XML avancées suivantes ne son pas prises en charge (ou pas entièrement prises en charge) dans les classes wrapper générées :
•Caractères génériques : xs:any and xs:anyAttribute
•Modèles de contenu (séquence, choix, tout). Le compositeur du niveau supérieur est disponible dans SPL, mais n’est pas appliqué par les classes générées.
•Valeurs par défaut et fixes pour les attributs. Celles-ci sont disponibles dans SPL, mais ne sont pas définies ou appliquées par les classes générées.
•Attributs xsi:type, types abstraits. Si vous devez écrire l’attribut xsi:type, utilisez la méthode SetXsiType() de classes générées.
•Types d’union : pas toutes les combinaisons sont prises en charge.
•Les groupes de substitution sont partiellement pris en charge (resolus comme « choice »).
•Attribut nillable="true" et xsi:nil
•Contraintes uniques
•Contraintes d’identité (key and keyref)