Aus WSDL importieren: generierte Objekte und Einschränkungen

Beim Import aus WSDL werden mehrere Objekte generiert, möglicherweise bestehen jedoch gewisse Einschränkungen.

Generierte Objekte

Dateien, die beim Import über die Befehlszeile kopiert werden
Der Befehl mqsicreatemsgdefsfromwsdl kopiert die benötigten WSDL-Dateien in den Arbeitsbereich, bevor der Import ausgeführt wird. Dabei handelt es sich um die WSDL-Dateien der höchsten Ebene und alle Importe, die mithilfe einer relativen Position ermittelt werden. Die Dateien werden unter den angegebenen Nachrichtensatz in einen Ordner mit dem Namen 'importFiles' kopiert.
Berichtsdatei
Das WSDL-Importprogramm hängt das Ergebnis der Importoperation an eine Berichtsdatei an, wobei alle bei dieser Operation aufgetretenen Fehler aufgelistet werden. Der Name der Berichtsdatei lautet Nachrichtensatz.wsdl.report.txt.
SOAP-Nachrichtdefinitionen
Die erforderlichen .mxsds-SOAP-Dateien werden zum Nachrichtensatz hinzugefügt.

Wenn Sie Dokumente einer SOAP 1.2-Instanz analysieren möchten, sollten Sie die SOAP 1.1-Definitionen manuell entfernen und die SOAP 1.2-Definitionen über den Assistenten für Nachrichtendefinitionsdateien importieren, indem Sie IBM eigene Nachricht auswählen.

Wenn Ihr Nachrichtensatz TDS- oder CWF-Schichten enthält, werden möglicherweise eine Reihe von Warnungen bezüglich der importierten SOAP-Definitionen angezeigt. Die meisten davon können ignoriert werden, Sie sollten jedoch die zulässigen Werte für Boolesche Attribute beachten. In SOAP 1.1 hat ein Boolescher Wert den Wert 1 oder 0, während die Werte in SOAP 1.2 'true' (wahr) und 'false' (falsch) lauten. Die XML-Darstellung von Booleschen Werten für einen Nachrichtensatz wird in den physischen Eigenschaften für das physische XML-Format angegeben und muss gegebenenfalls entsprechend eingestellt werden.

Nachrichtendefinitionsdateien
Andere Nachrichtendefinitionsdateien werden mit dem Namen Eingabedateiname.mxsd erstellt. Ihr Inhalt ist vom WSDL-Format abhängig.
Dokumentformat (style=document)
WSDL-Nachrichtenteile für style=”document” (dazu gehören die SOAP-Elemente 'header', 'fault' und 'headerfault') verweisen auf ein im XML-Schema definiertes Element. Dieses Element wird als globales Element und Brokernachricht in die mxsd-Datei importiert.

Die 'Ausgaberichtlinie für Attribut vom Typ xsi:type' wird auf 'Nie' gesetzt.

RPC-Format (style=rpc)
WSDL-Nachrichtenteile für style=”rpc” (und ausschließlich solche, die dem SOAP-Hauptteil zugeordnet sind) verweisen auf einem im XML-Schema definierten Typ. In diesem Fall werden Ein- und Ausgabenachrichten wie in der folgenden Tabelle angegeben erstellt.
  Eine Eingabenachricht Eine Ausgabenachricht
Abgeleitet von untergeordnetem Element wsdl:input (falls vorhanden) von WSDL-Operation sowie der WSDL-Nachricht und den Nachrichtenteilen, die es identifiziert untergeordnetem Element wsdl:output (falls vorhanden) von WSDL-Operation sowie der WSDL-Nachricht und den Nachrichtenteilen, die es identifiziert
Name des Elements Wert des Namensattributs (name) im WSDL-Operationselement (operation) Wert des Namensattributs (name) im WSDL-Operationselement (operation) mit dem Suffix 'Response'
Namespace des Elements Wert des Namespaceattributs (namespace) im entsprechenden soap:body-Element Wert des Namespaceattributs (namespace) im entsprechenden soap:body-Element

Jede Nachricht ist ein lokaler komplexer Typ, bestehend aus einer Folge von Elementen. Der Name jedes Elements entspricht dem Wert des Namensattributs (name) in den WSDL-Teilen (part-Elementen) der Nachricht, die entweder durch das 'input'- oder 'output'-Element identifiziert wird. Diese Elemente besitzen keinen Namespace (die zugrunde liegende Schemadarstellung enthält form="unqualified") und werden lokal Bereichen zugeordnet, um Namenskollisionen zu vermeiden. Der Typ dieser lokalen Elemente ist der XML-Schematyp, auf den das Typattribut (type) des entsprechenden 'part'-Elements verweist. Der Typ im WSDL-Schema ist ein globaler Typ.

Wenn soap:body in der WSDL-Definition mit use="encoded" definiert wurde, beinhaltet die Nachrichtendefinition einen Verweis auf die Attributgruppe 'encodingStyle' im SOAP-ENV-Namespace, und die 'Ausgaberichtlinie für Attribut vom Typ 'xsi:type' für die Nachricht wird auf 'SOAP-Codierungsregeln befolgen' gesetzt. Andernfalls wird die 'Ausgaberichtlinie für Attribut vom Typ xsi:type' für die Nachricht auf 'Nie' gesetzt.

Mithilfe von .NET generierte WSDLs
In einigen Instanzen enthalten mithilfe von .NET generierte WSDLs Elementverweise auf das Schema selbst. Nachfolgend ist ein Beispiel dieses Typs aufgeführt:
<xsd:complexType>
		<xsd:sequence>
			<xsd:element ref="s:schema"/>
		</xsd:sequence>
</xsd:complexType>
Um den erfolgreichen Import von WSDLs dieses Typs in das WebSphere Message Broker Toolkit ohne Gültigkeitsfehler zu gewährleisten, ist das manuelle Hinzufügen einer Namespace-Importanweisung zum Namespace des Schemas erforderlich. Nachfolgend ist ein Beispiel der Importanweisung aufgeführt:
<xsd:import namespace="http://www.w3.org/2001/XMLSchema"/>

Die Importanweisung muss im Schemaelement an die erste Stelle und vor komplexe Typen oder Elementdefinitionen gestellt werden. Prüfen Sie die WSDL erneut, indem Sie mit der rechten Maustaste auf die aktualisierte WSDL und anschließend auf 'Auswerten' klicken.

Einschränkungen

Einschränkungen im Zusammenhang mit dem Import von WSDL-Definitionen gelten dann, wenn die WSDL-Definitionen nicht WS-I-konform sind.
SOAP-Arrays
Eine WSDL 1.1-Definition kann ein SOAP-Array definieren (gilt nur für das RPC-codierte WSDL-Format und ist nicht WS-I-konform):
    <xsd:complexType name="t">
          <xsd:complexContent>
            <xsd:restriction base="SOAP-ENC:Array">
              <xsd:sequence>
                <xsd:element name="item" type="string" maxOccurs="unbounded"/>
              </xsd:sequence>
              <xsd:attribute ref="SOAP-ENC:arrayType" wsdl:arrayType="xsd:string[]"/>
            </xsd:restriction>
          </xsd:complexContent>
    </xsd:complexType>

Nicht jede SOAP-Array-Syntax wird in vollem Umfang unterstützt. Auch wenn beim Analysieren eine brauchbare Baumstruktur erstellt wird (und beim Schreiben serialisiert werden kann), sollten Sie Folgendes beachten:

  • Das Modell berücksichtigt das Attribut SOAP-ENC:arrayType nicht.
  • Das Modell für teilweise übertragene Arrays berücksichtigt nicht das Attribut SOAP-ENC:offset.

    Beispielsweise muss auf das erste Element eines mit offset[2] definierten Arrays in ESQL nicht als InputRoot.MRM.array.item[3], sondern als InputRoot.MRM.array.item[1] zugegriffen werden.

  • Das Modell für mehrdimensionale Arrays verflacht die Darstellung zu einem eindimensionalen Array. Beispielsweise wird auf ein zweidimensionales Array in ESQL nicht als InputRoot.MRM.array.item[x][y], sondern als InputRoot.MRM.array.item[i] zugegriffen, wobei der Index i entsprechend berechnet werden muss.
Anonyme Elemente
Der WSDL-Auszug oben beschreibt ein SOAP-Instanzdokument in folgender Form:
    <SOAP-ENC:Array SOAP-ENC:arrayType="xsd:string[3]">
       <item xsi:type="xsd:string">Eine allgemeine Textzeichenfolge</item>
       <item xsi:type="xsd:token">Eine Einschränkung des Zeichenfolge-Typs</item>
       <item xsi:type="xsd:Name">Eine Einschränkung des Token-Typs</item>
    </SOAP-ENC:Array>

Das Brokermodell bearbeitet dieses Dokument wie erwartet, aber bei der SOAP-Codierung können Array-Elemente auch die 'type'-Elemente aus dem SOAP-Codierungsnamespace verwenden. Das heißt, eine Anwendung, die dieselbe WSDL-Definition verwendet, erstellt möglicherweise ein Instanzdokument in folgender Form:

    <SOAP-ENC:Array SOAP-ENC:arrayType="xsd:string[3]">
       <SOAP-ENC:string>Eine allgemeine Textzeichenfolge</SOAP-ENC:string>
       <SOAP-ENC:token>Eine Einschränkung des Zeichenfolge-Typs</SOAP-ENC:token>
       <SOAP-ENC:Name>Eine Einschränkung des Token-Typs</ SOAP-ENC:Name>
    </SOAP-ENC:Array>

Das beim Importieren der WSDL-Definition erstellte Brokermodell muss manuell geändert werden, damit es diesen Vorgang bearbeiten kann, es sein denn, es ist akzeptabel, dass der Parser ihn wie ein selbstdefiniertes Element behandelt.

Bemerkungen | Marken | Dieser Link öffnet ein neues Fenster Downloads | Dieser Link öffnet ein neues Fenster Bibliothek | Dieser Link öffnet ein neues Fenster Support | Feedback

Copyright IBM Corporation 1999, 2011Copyright IBM Corporation 1999, 2011.

        
        Letzte Aktualisierung
        
        Letzte Aktualisierung : 2011-11-04 19:53:45


ReferenzthemaReferenzthema | Version 8.0.0.0 | ad30560_