Importando a partir do WSDL: Objetos Gerados e Restrições

Vários objetos são gerados quando você importa a partir do WSDL mas restrições podem se aplicar.

Objetos Gerados

Arquivos copiados por importação da linha de comandos
O comando mqsicreatemsgdefsfromwsdl copia os arquivos WSDL que ele precisa na área de trabalho antes de executar o processo de importação. Estes arquivos são os arquivos WSDL de nível superior e quaisquer importações resolvidas a partir de um local relativo. Os arquivos são copiados no conjunto de mensagens especificado em uma pasta chamada importFiles.
Arquivo de Relatório
O importador de WSDL anexa o resultado da operação de importação em um arquivo de relatório, listando todos os erros que ocorreram durante o processo. O nome do arquivo de relatório é message set.wsdl.report.txt.
Definições de mensagens SOAP
Os arquivos SOAP .mxsds necessários são incluídos no conjunto de mensagens.

Se você desejar analisar os documentos da instância do SOAP 1.2, remova manualmente as definições de SOAP 1.1 e importe as definições de SOAP 1.2 usando o assistente Arquivo de Definição de Mensagens, selecionando Mensagem fornecida pela IBM.

Se seu conjunto de mensagens tiver camadas TDS ou CWF, você poderá achar que recebeu vários avisos com relação às definições de SOAP importadas. A maioria deles pode ser ignorada, mas leve em conta os valores permitidos para atributos Booleanos. No SOAP 1.1, os valores Booleanos são 1 ou 0, enquanto no SOAP 1.2 os valores são true e false. A representação de XML dos valores Booleanos para um conjunto de mensagens é especificado nas propriedades físicas para o formato físico de XML e pode precisar ser configurada de acordo.

Arquivos de definição de mensagem
Outros nomes de arquivo de definição de mensagem são criados como nome do arquivo de entrada.mxsd e seus conteúdos dependem do estilo WSDL.
estilo de documento
As partes da mensagem WSDL para style="document" (que incluem todos os cabeçalhos SOAP, partes de falhas e de falhas do cabeçalho) se referem a um elemento definido no Esquema XML. Este elemento é importado como um elemento global e a mensagem do broker no arquivo mxsd.

A Política de Saída xsi:type na mensagem está configurada como "Nunca".

estilo de rpc
As partes da mensagem WSDL para style="rpc" (e exclusivamente as alocadas para o corpo SOAP) se referem a um tipo definido no Esquema XML. Neste caso, as mensagens de entrada e saída são criadas conforme mostrado na tabela a seguir.
  Uma mensagem de entrada Uma mensagem de saída
Derivado de filho wsdl:input (se houver algum) da operação WSDL e a mensagem WSDL e partes que ele identifica filho wsdl:output (se houver algum) da operação WSDL e a mensagem WSDL e partes que ele identifica
Nome do Elemento valor do atributo de nome no elemento de operação WSDL valor do atributo de nome no elemento de operação WSDL sufixado por "Response"
Espaço de Nomes do Elemento valor do atributo de espaço de nomes no elemento soap:body correspondente valor do atributo de espaço de nomes no elemento soap:body correspondente

Cada mensagem é um tipo complexo local, sendo uma seqüência de elementos. O nome de cada elemento é o valor do atributo de nome nas partes WSDL da mensagem identificadas pelo elemento de entrada ou de saída. Estes elementos não possuem espaço de nomes (a representação de esquema subjacente possui form="unqualified") e têm escopo definido localmente para evitar conflitos de nome. O tipo destes elementos locais é o tipo de Esquema XML referido pelo atributo de tipo do elemento da parte correspondente. O tipo é global no esquema WSDL.

Se soap:body foi definido com use="encoded" na definição de WSDL, a definição de mensagem incluirá uma referência ao grupo de atributos encodingStyle no espaço de nomes SOAP-ENV e a Política de Saída xsi:type na mensagem será configurada como "Seguir as regras de codificação SOAP". Caso contrário, a Política de Saída xsi:type na mensagem será configurada como "Nunca".

WSDLs gerado utilizando .NET
Em algumas instâncias, WSDLs são gerados utilizando .NET referências de elementos incluídos no próprio esquema. A seguir, um exemplo deste tipo:
<xsd:complexType>
		<xsd:sequence>
			<xsd:element ref="s:schema"/>
		</xsd:sequence>
</xsd:complexType>
Para WSDLs deste tipo serem importados com êxito no WebSphere Message Broker Toolkit sem erros de validação, você deve incluir manualmente uma instrução de importação de espaço de nomes no espaço de nomes do esquema. A seguir, um exemplo da instrução de importação:
<xsd:import namespace="http://www.w3.org/2001/XMLSchema"/>

Coloque a instrução de importação primeiro no elemento de esquema e assegure que ela apareça antes de qualquer definição de tipo complexo ou de elemento. Revalide o WSDL clicando com o botão direito do mouse no WSDL atualizado e clicando em Validar.

Restrições

Existem restrições relacionadas à importação de definições de WSDL onde as definições de WSDL não são compatíveis com WS-I.
Matrizes SOAP
Uma definição WSDL 1.1 pode definir uma Matriz SOAP (aplicável apenas ao estilo WSDL rpc-encoded e não compatível com WS-I):
    <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>

Algumas utilizações da matriz SOAP não são totalmente suportadas. Embora uma árvore útil seja criada durante a análise e possa ser serializada durante a gravação:

  • O modelo não leva em conta qualquer atributo SOAP-ENC:arrayType.
  • O modelo para matrizes transmitidas parcialmente não leva em conta o atributo SOAP-ENC:offset.

    Por exemplo, o primeiro elemento de uma matriz especificada com offset[2] precisa ser acessado na ESQL, não como InputRoot.MRM.array.item[3], mas como InputRoot.MRM.array.item[1].

  • O modelo para matrizes multidimensionais nivela a representação em uma única dimensão. Por exemplo, uma matriz bidimensional é acessada em ESQL, não como InputRoot.MRM.array.item[x][y], mas como InputRoot.MRM.array.item[i], em que o índice i precisa ser calculado de maneira apropriada.
Elementos Anônimos
O trecho WSDL acima descreve um documento da instância SOAP no seguinte formato:
    <SOAP-ENC:Array SOAP-ENC:arrayType="xsd:string[3]">
       <item xsi:type="xsd:string">A general text string</item>
       <item xsi:type="xsd:token">A restriction of the string type</item>
       <item xsi:type="xsd:Name">ARestrictionOfTheTokenType</item>
    </SOAP-ENC:Array>

O modelo do broker trata isso conforme o esperado mas, na codificação SOAP, os elementos de matriz também podem utilizar os elementos de tipo do espaço de nomes de codificação SOAP. Portanto, um aplicativo que está usando a mesma definição de WSDL pode criar um documento da instância no seguinte formato:

    <SOAP-ENC:Array SOAP-ENC:arrayType="xsd:string[3]">
       <SOAP-ENC:string>A general text string</SOAP-ENC:string>
       <SOAP-ENC:token>A restriction of the string type</SOAP-ENC:token>
       <SOAP-ENC:Name>ARestrictionOfTheTokenType</ SOAP-ENC:Name>
    </SOAP-ENC:Array>

É necessário editar manualmente o modelo do broker criado importando o WSDL para tratar deste caso, a menos que seja aceitável ter o analisador tratando-o como elemento autodefinido.

Avisos | Marcas | Este link é aberto em uma nova janela Downloads | Este link é aberto em uma nova janela Biblioteca | Este link é aberto em uma nova janela Suporte | Feedback

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

        
        Última atualização
        
        Última atualização : 2011-11-09 14:38:47


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.0 | ad30560_