Utilisation des XPaths non canoniques dans une assignation de message

Si vous utilisez des parties de message .Net, vous pouvez annoter votre code avec un attribut de sérialisation XML qui, lorsqu'il est accompagné de champs distinctifs et/ou d'annotations de propriété, peut résulter en des expressions XPath assez complexes. Celles-ci peuvent être non canoniques. Les expressions XPath non canoniques ne devraient être utilisées que dans les orchestrations directement liées et peuvent échouer dans le cas d'orchestrations liées logiquement ou physiquement. Comme les orchestrations directement liées traitent le document XML sans compter sur un pipeline, le document XML entier est chargé en mémoire avant le traitement.

Expressions XPath canoniques et non canoniques

La forme canonique ou abrégée de XPath utilise la syntaxe abrégée de la spécification XPath (http://www.w3.org/TR/xpath) pour spécifier un chemin d’emplacement. Voici quelques-unes des propriétés distinctives des expressions XPath canoniques :

• L’axe child:: est supposé par défaut pour chaque étape de l’expression

• @ est l’abréviation de attribute::.

• // est l’abréviation de /descendant-or-self::node()/.

• . est l’abréviation de self::node().

• .. est l’abréviation de parent::node().

  Les expressions XPath canoniques sont des expressions simples telles que /*[local-name()='element-name' and namespaceURI()='http://MyUri.org']/*[local-name()='element-name']/@*[local-name='attribute-name'].

  par opposition aux expressions non canoniques de XPath. Cette forme est également appelée « formulaire général » ou « XPath arbitraire » et se distingue par des expressions qui sont arbitrairement complexes et peuvent combiner plusieurs axes : //element-name//*[local-name()='element-name' and position()=2].

Exemple

Prenons le programme suivant :

using System;
using System.IO;
using System.Xml.Serialization;
using Microsoft.XLANGs.BaseTypes;

namespace ComplexNetXPath
{
    public class Animal
    {
        [Property( typeof(BTS.RetryCount) )]
        public int NumberOfLegs;
    }
    public class Snake : Animal
    {
        public Snake()
        {
            NumberOfLegs = 0;
        }
    }
    public class Dog : Animal
    {
        public Dog()
        {
            NumberOfLegs = 4;
        }
    }
    public class Zoo
    {
        //
        // Dogs and snakes are the possible animals of
        // the week.
        //
        [XmlElement(typeof(Snake))]
        [XmlElement(typeof(Dog))]
        public Animal AnimalOfTheWeek;
    }
    class Class1
    {
        static void Main(string[] args)
        {
            XmlSerializer ser = new XmlSerializer(typeof(Zoo));
            Stream s = Console.OpenStandardOutput();
            Zoo z = new Zoo();
            z.AnimalOfTheWeek = new Dog();
            ser.Serialize( s, z );
            s.Flush();
            Console.WriteLine("------------------");
            z.AnimalOfTheWeek = new Snake();
            ser.Serialize( s, z );
            s.Flush();
        }
    }
}

Le type Zoo contient un champ Animal qui peut avoir la valeur Snake ou Dog. L'instance Animal comporte un champ NumberOfLegs qui est annoté de PropertyAttribute qui attribut la propriété BTS.RetryCount à ce champ.

Lorsque le champ AnimalOfTheWeek a la valeur Dog, l'instance Zoo sérialisée ressemble à ceci :

<Zoo>
  <Dog>
    <NumberOfLegs>4</NumberOfLegs>
  </Dog>
</Zoo>

Lorsque le champ AnimalOfTheWeek a la valeur Snake, l'instance Zoo sérialisée ressemble à ceci :

<Zoo>
  <Snake>
    <NumberOfLegs>0</NumberOfLegs>
  </Snake>
</Zoo>

Si l'on part du schéma XML équivalent à la classe .Net Zoo, l'expression XPath permettant de sélectionner la propriété RetryCount permettrait qu'une étape Snake ou Dog apparaisse dans le chemin de la propriété :

/*[local-name()='Zoo' and namespace-uri()='']/*[(local-name()='Dog' and namespace-uri()='') or (local-name()='Snake' and namespace-uri()='')]/*[local-name()='NumberOfLegs' and namespace-uri()='']

Les composants du pipeline XML ne peuvent pas gérer cette expression XPath non canonique. Pour contourner cette situation, n'utilisez pas d'attributs de sérialisation XML à choix multiple conjointement aux pipelines XML. En outre, utilisez les attributs de sérialisation XML suivants avec précaution :

• XmlElementAttribute

• XmlAttributeAttribute

• XmlArrayItemAttribute