Ferramentas do esquema XML: Analisando esquemas XML

Voltar para Introdução às ferramentas do esquema XML

O objetivo deste tutorial é examinar as diferentes formas em que você pode analisar os esquemas XML usando as consultas disponíveis nas ferramentas do esquema XML.

Observação: Sempre que o ícone for mostrado, você poderá clicar para exibir uma demonstração interativa detalhada das etapas descritas no tutorial.

superior

Antes de começar

Antes de passar para a parte de análise deste tutorial, você deve realizar um trabalho de preparação. Certifique-se de completar as etapas desta seção antes de ir para a próxima seção, Localizando usos do elemento de um esquema.

As tarefas de preparação são:

1. Adicionar dois tipos complexos, HybridType e SportsCarType, para estender e restringir um tipo complexo no esquema de amostra.
2. Adicionar uma substituição de elemento.
3. Adicionar um arquivo do esquema.

Para adicionar os componentes de tipo complexo HybridType e SportsCarType:

1. Se mySchemaPrj não estiver aberto no IDE, abra-o agora e, em seguida, abra o arquivo do esquema newLoanApplication.
2. Maximize a exibição, clicando com o botão direito do mouse na guia do arquivo e escolhendo Maximizar janela no menu pop-up.
   Maximizar a exibição permite que você veja mais informações sobre o esquema na exibição de coluna da exibição Esquema.
3. Na exibição Esquema, clique no botão de coluna para verificar se você está no modo de coluna da exibição.
4. Na exibição Esquema do arquivo de esquema newLoanApplication, clique com o botão direito do mouse no nó Tipos complexos e escolha Adicionar tipo complexo.
   A caixa de diálogo Tipo complexo se abre.
5. Adote o seguinte procedimento:
   
   1. No campo Nome , digite HybridType.
   2. Em Definição de tipo, selecione o botão de opção Usar definição existente.
      A parte inferior da caixa de diálogo se altera para lhe oferecer opções para definir a referência.
   3. Em Referência global, selecione o botão de opção Restrição, e na lista de tipos, expanda o nó Tipos complexos e selecione o nó CarType.
      Observe que o IDE mostra-lhe uma visualização prévia do código-fonte que será adicionado para essa definição.
   4. Clique em OK.
      O IDE adiciona um nó para o novo tipo complexo. O rótulo do nó é o nome que você inseriu no campo Nome, HybridType; o rótulo do nó também fornece informações adicionais: (restringe CarType).

    Exibir demonstração

6. Na exibição Esquema do arquivo de esquema newLoanApplication, clique com o botão direito do mouse no nó Tipos complexos e escolha Adicionar tipo complexo.
   A caixa de diálogo Tipo complexo se abre.
7. Adote o seguinte procedimento:
   
   1. No campo Nome, digite SportsCarType.
   2. Em Definição de tipo, selecione o botão de opção Usar definição existente.
      A parte inferior da caixa de diálogo se altera para lhe oferecer opções para definir a referência.
   3. Em Referência global, selecione o botão de opção Extensão, e na lista de tipos, expanda o nó Tipos complexos e selecione o nó CarType.
   4. Clique em OK.
      O IDE adiciona um nó para o novo tipo complexo. O rótulo do nó é o nome que você inseriu no campo Nome, SportsCarType; o rótulo do nó também fornece informações adicionais: (estende CarType).
   5. No menu principal do IDE, escolha Arquivo > Salvar todos.

    Exibir demonstração

   A exibição Esquema agora contém nós dos tipos complexos que você adicionou: HybridType e SportsCarType.
   Observação: Se você possui derivações em seu esquema, selecione a derivação, neste exemplo, HybridType ou SportsCarType, clique com o botão direito do mouse e escolha Ir para > Definição a fim de navegar diretamente para a definição de origem.

Para adicionar uma substituição de elemento:

1. Na exibição Esquema do arquivo do esquema newLoanApplication, clique no botão Fonte.
2. Na exibição Fonte, adicione as linhas seguintes imediatamente antes da última linha do arquivo, a linha que encerra a definição do esquema:
   

   <xs:element name="carLoanApplication" substitutionGroup="autoLoanApplication">
   </xs:element>
   

3. No menu principal do IDE, escolha Arquivo > Salvar todos.

 Exibir demonstração

Para adicionar um arquivo de esquema:

1. Se mySchemaPrj não estiver aberto no IDE, abra-o agora.
2. Na janela Projetos, expanda o nó do projeto mySchemaPrj e expanda o nó Pacotes de origem.
3. Clique com o botão direito do mouse no nó <pacote padrão> e escolha Novo > Arquivo/Pasta.
   O assistente para Novo arquivo se abre.
4. Na página Escolher tipo de arquivo, na lista Categorias, selecione o nó XML, em seguida, na lista Tipos de arquivo, selecione Esquema XML e clique em Próximo.
5. Na página Nome e local do assistente, no campo Nome do arquivo, digite newLoanHistory, aceite os outros valores padrão (Pasta: src, Espaço de nome de destino: http://xml.netbeans.org/schema/newLoanHistory) e clique em Finalizar.
   Na janela Projetos, o nó <pacote padrão> em Pacotes de origem agora contém um subnó chamado newLoanHistory.xsd. O subnó recém-criado é selecionado e o Editor de fontes contém uma guia para o novo arquivo do esquema XML, newLoanHistory.xsd.
6. Na exibição Esquema, clique no botão Fonte a fim de ir para a exibição Fonte do arquivo do esquema.
7. Na exibição Fonte, substitua o conteúdo existente pelo código de amostra abaixo.

   <?xml version="1.0" encoding="UTF-8"?>
   <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               targetNamespace="http://xml.netbeans.org/examples/targetNS"
               xmlns:tns="http://xml.netbeans.org/examples/targetNS"
               xmlns:la="http://xml.netbeans.org/examples/LoanApplication"
               elementFormDefault="qualified">
       <xsd:import namespace="http://xml.netbeans.org/examples/LoanApplication" schemaLocation="newLoanApplication.xsd"/>
       <xsd:complexType name="PriorLoan">
           <xsd:sequence>
               <xsd:element name="Tipo" type="la:LoanType"></xsd:element>
               <xsd:element name="Estado" type="la:StateType"></xsd:element>
           </xsd:sequence>
       </xsd:complexType>
       <xsd:element name="Histórico" type="tns:PriorLoan"></xsd:element>
   </xsd:schema>
   

8. No menu principal do IDE, escolha Arquivo > Salvar todos.

 Exibir demonstração

superior

Localizando usos de um componente de esquema

Neste procedimento, você usará o comando Localizar usos para exibir os usos de um componente nos dois arquivos do esquema XML do seu projeto.

Observação: O comando Localizar usos mostra os usos de um componente em todos os arquivos do esquema XML, WSDL e BPEL no projeto IDE atual.

Para localizar usos de um componente de esquema:

1. Se mySchemaPrj não estiver aberto no IDE, abra-o agora e, em seguida, abra o arquivo do esquema newLoanApplication.
2. Maximize a exibição, clicando com o botão direito do mouse na guia do arquivo e escolhendo Maximizar janela no menu pop-up.
   Maximizar a exibição permite que você veja mais informações sobre o esquema na exibição de coluna da exibição Esquema.
3. Na exibição Esquema, clique no botão de coluna para verificar se você está no modo de coluna da exibição.
4. Na primeira coluna da exibição Esquema, selecione o nó Tipos complexos.
5. Na segunda coluna, selecione o nó AddressType, clique com o botão direito do mouse e escolha Localizar usos no menu pop-up.
   O IDE abre a janela Usos de XML na parte inferior do IDE. A janela Usos de XML possui dois painéis, cada um com sua própria barra de ferramentas.
   
   • O painel esquerdo, o painel de usos, contém uma árvore que mostra os usos de AddressType.
     Os botões da barra de ferramentas desse painel permitem atualizar as informações no painel, expandir e recolher nós na árvore e percorrer os usos encontrados. Observe que quando você clica no botão Atualizar nesse painel, o IDE atualiza os dados em ambos os painéis.
   • O painel direito, o painel gráfico, mostra uma representação gráfica dos usos. Se você redimensionar a janela ou arrastar os nós para fora do painel, poderá usar o botão da barra de ferramentas Layout desse painel para atualizar o gráfico no painel.

   

   Dicas de produtividade
   • No painel gráfico, você pode clicar com o botão direito do mouse em um componente do esquema, exceto no nó que representa o componente consultado, e escolher uma opção no menu Ir para a fim de navegar diretamente para esse componente na exibição Fonte, exibição Esquema ou exibição Design. Se o componente do esquema for uma extensão ou uma restrição de outro componente do esquema, você pode navegar diretamente até o componente do esquema estendido ou restrito na exibição ativa do editor do esquema XML, escolhendo Definição no menu Ir para.
   • Use as informações abaixo para efetuar mais ou menos zoom, girar e arrastar o painel gráfico da janela Refatoração de XML.
     
     • Para efetuar menos zoom: clique com o botão direito do mouse no gráfico e arraste para cima.
     • Para efetuar mais zoom: clique com o botão direito do mouse no gráfico e arraste para baixo.
     • Para girar: clique e arraste em qualquer direção.
     • Para arrastar um nó: clique e arraste o nó.
   • Se arrastar um nó para fora da área de exibição, poderá trazê-lo de volta usando um dos seguintes métodos:
     
     • Gire na direção do nó até que ele esteja visível na área de exibição novamente.
     • Efetue menos zoom até que o nó esteja visível na área de exibição.
     • Clique no botão Layout na barra de ferramentas do painel gráfico da janela Usos de XML.
6. Para localizar usos de LoanType, faça o seguinte:
   1. Na primeira coluna da exibição Esquema do arquivo de esquema newLoanApplication, selecione o nó Tipo simples.
   2. Na segunda coluna da exibição, selecione o nó LoanType, clique com o botão direito do mouse e escolha Localizar usos no menu pop-up.
      Se a janela Usos de XML ainda estava aberta, o IDE abre uma guia Localizar usos de XML na janela Usos de XML na parte inferior do IDE. Os resultados mostram dois grupos de arquivos com o nó do arquivo e os nós de uso entre os grupos de arquivos. Você pode clicar duas vezes no grupo de arquivos para expandir ou recolher os mesmos e pode mover um grupo com o seu conteúdo, arrastando o grupo no painel gráfico.
      Uma ilustração do painel gráfico com os grupos de arquivos newLoanHistory.xsd expandidos e newLoanApplication.xsd recolhidos é mostrada abaixo.
      
      

      

7. Feche a janela Usos de XML clicando no botão Fechar na barra de título da janela.

 Exibir demonstração

superior

Localizando componentes globais não utilizados

Neste procedimento, você usará uma consulta para localizar componentes globais no esquema de aplicativo de empréstimo de amostra que não são usados em qualquer um dos arquivos do seu projeto, mySchemaPrj.

Essa consulta permite que você identifique elementos globais de nível superior ao reestruturar o esquema em torno de um único elemento raiz (modelo de design Cego veneziano).

Para localizar componentes globais não utilizados:

1. Se mySchemaPrj não estiver aberto no IDE, abra-o agora.
2. Na janela Projetos, selecione o nó do arquivo newLoanApplication.xsd, clique com o botão direito do mouse e escolha Consulta > Localizar componentes não utilizados.
   É aberta uma caixa de diálogo que permite que você exclua elementos globais.
3. Na caixa de diálogo, marque a caixa de seleção Excluir elementos globais e clique em OK.
   A janela Consulta do esquema XML é aberta com uma árvore de resultado. A consulta encontrou cinco componentes não utilizados: Borrow, HybridType, InternationalAddressType e SportsCarType aparecem no nó Tipos complexos, e Lend aparece no nó Tipos simples, mostrado na ilustração seguinte.
   A barra de status também fornece informações sobre os resultados da consulta.
   
   

   

4. Na janela Projetos, selecione o nó do arquivo newLoanApplication.xsd, clique com o botão direito do mouse e escolha Consulta > Localizar componentes não utilizados.
   É aberta uma caixa de diálogo que permite que você exclua elementos globais.
5. Na caixa de diálogo, certifique-se de que a caixa de seleção Excluir elementos globais não esteja selecionada e clique em OK.
   O IDE abre uma guia Localizar não utilizado na janela Consulta do esquema XML com os resultados da consulta. Observe que os resultados agora incluem um nó Elementos, com um nó filho, carLoanApplication.
   
   

   

6. Na guia Localizar não utilizado da janela Consulta do esquema XML, selecione o nó carLoanApplication, clique com o botão direito do mouse e escolha Ir para origem.
   O IDE abre a exibição Fonte e posiciona o cursor no início do bloco do elemento carLoanApplication.
7. Feche a janela Consulta do esquema XML clicando no botão Fechar na barra de título da janela.

 Exibir demonstração

superior

Localizando derivações de um tipo complexo

Neste procedimento, você usará uma consulta para localizar as derivações criadas durante a fase de preparação deste tutorial.

Para localizar derivações de um tipo global complexo:

1. Na janela Projetos, selecione o nó do arquivo newLoanApplication.xsd, clique com o botão direito do mouse e escolha Consulta > Localizar derivações de tipo complexo.
   A caixa de diálogo Localizar derivações se abre.
2. Na lista de tipos complexos, selecione CarType e clique em OK.
   A Consulta do esquema XML se abre com os resultados da sua consulta. As derivações que você acabou de criar para CarType são mostradas na janela.
   A barra de status fornece informações adicionais sobre os resultados: Encontrada 1 extensão e 1 restrição em CarType.
   
   

   

3. Feche a janela Consulta do esquema XML clicando no botão Fechar na barra de título da janela.

 Exibir demonstração

superior

Localizando grupos de substituição

Neste procedimento, você usará uma consulta para localizar a substituição do elemento criada durante a fase de preparação deste tutorial.

Para localizar grupos de substituição:

1. Na janela Projetos, selecione o nó do arquivo newLoanApplication.xsd, clique com o botão direito do mouse e escolha Consulta > Localizar grupos de substituição.
   O IDE mostra a substituição que você acabou de criar na janela Consulta do esquema XML e também fornece informações sobre os resultados na barra de status (Um grupo de substituição encontrado). Neste exemplo, autoLoanApplication é o elemento principal, e carLoanApplication pode ser substituído por autoLoanApplication.
   
   

   

2. Feche a janela Consulta do esquema XML clicando no botão Fechar na barra de título da janela.

 Exibir demonstração

superior

Próxima etapa

As etapas em Recuperando e referenciando recursos XML externos mostra-lhe como recuperar recursos externos em seu projeto do IDE e, em seguida, fazer referência a esses recursos em seu esquema XML.

superior