Ferramentas do esquema XML: Recuperando e referenciando recursos XML externos

O objetivo deste tutorial é recuperar arquivos do esquema externo para o projeto mySchemaPrj. A recuperação XML de recursos recupera documentos do esquema XML e WSDL (linguagem de descrição de serviços da Web). O assistente verifica se o encerramento transitivo se cumpre, incluindo o esquema XML incorporado no WSDL. O IDE irá recuperar o encerramento dos recursos quando você recuperar recursos de um URL.

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

superior

Recuperando recursos XML

Depois de usar as instruções deste procedimento para recuperar recursos XML, você fará referência a esses recursos na próxima parte, Referenciando esquemas externos.

Para recuperar recursos XML:

1. Se mySchemaPrj não estiver aberto no IDE, abra-o agora.
2. Se a janela Saída não estiver visível, escolha Janela > Saída.
   Quando o IDE recupera os recursos, mensagens informativas são exibidas na janela Saída.
3. Na janela Projetos, expanda o nó do projeto mySchemaPrj e expanda o nó Pacotes de origem.
4. Selecione o nó <pacote padrão>, clique com o botão direito do mouse e escolha Novo > Arquivo/Pasta.
5. Na caixa de diálogo Novo arquivo, em Categorias, selecione o nó XML e, na lista Tipos de arquivo, selecione Documento(s) do esquema XML externo.
6. Clique em Próximo.
   A página Nova recuperação de documentos se abre.
7. Na página Especificar local do recurso, selecione a origem da qual recuperar o arquivo.
   
   • Para recuperar os recursos de um URL:
     
     1. Selecione o botão de opção Do URL.
     2. No campo de texto abaixo do botão de opção Do URL, digite http://docs.oasis-open.org/ubl/cd-UBL-1.0/xsd/maindoc/UBL-Order-1.0.xsd
        Neste exemplo, estamos recuperando um esquema UBL de amostra, incluído no Java WSDP Versão 2.0, diretamente de um URL, em vez de usar uma instalação local.
     3. Aceite o valor padrão para o campo Salvar na pasta, caminho-do-projeto\mySchemaPrj\src.
     4. Clique em Finalizar.
        Observe as informações exibidas na janela Saída. O IDE mostra quais arquivos estão sendo copiados para as pastas do projeto e se houver erros, eles serão exibidos na janela Saída.
        O nó Pacotes de origem do seu projeto agora possui três nós adicionais: docs.oasis-open.org.ubl.cd-UBL-1.0.xsd.codelist, docs.oasis-open.org.ubl.cd-UBL-1.0.xsd.common e docs.oasis-open.org.ubl.cd-UBL-1.0.xsd.maindoc.

      Exibir demonstração

   • Para recuperar os recursos do sistema de arquivos local:
     
     1. Selecione o botão de opção Do sistema de arquivos local.
     2. Clique no botão Explorar ao lado do campo de texto no botão de opção Do sistema de arquivos local.
     3. Na caixa de diálogo Abrir, navegue para a pasta que contém o esquema que você deseja recuperar e selecione-a.
        Neste exemplo, estamos recuperando um esquema de amostra incluído no Java WSDP Versão 2.0. O arquivo do esquema está nesta pasta:
        pasta-de-instalação-do-jwsdp\jwsdp-2.0\jaxb\samples\ubl\cd-UBL-1.0\.
     4. Aceite o valor padrão para o campo Salvar na pasta, caminho-do-projeto\mySchemaPrj\src.
     5. Clique em Finalizar.
        Observe as informações exibidas na janela Saída. O IDE mostra quais arquivos estão sendo copiados para as pastas do projeto e se houver erros, eles serão exibidos na janela Saída.
        O nó Pacotes de origem do seu projeto agora possui três nós adicionais: xsd.codelist, xsd.common e xsd.maindoc.

      Exibir demonstração

   Expanda os nós para ver informações sobre o arquivo do esquema recuperado para o seu projeto. A ilustração a seguir mostra os nós expandidos dos recursos recuperados do esquema UBL de amostra instalado localmente.
   
   

   

superior

Referenciando esquemas externos

Neste procedimento, você adicionará um arquivo do esquema XML ao seu projeto e depois fará referência aos arquivos do esquema recuperados na parte anterior.

Para adicionar um novo arquivo do esquema XML ao projeto mySchemaPrj:

1. Na janela Projetos, expanda o nó mySchemaPrj e expanda o nó Pacotes de origem.
2. Selecione o nó <pacote padrão>, clique com o botão direito do mouse e escolha Novo > Arquivo/Pasta.
   O assistente para Novo arquivo se abre.
3. Na lista Categorias, selecione XML e na lista Tipos de arquivo, selecione Esquema XML.
4. Clique em Próximo.
   A página Nome e local do assistente é aberta.
5. Na página Nome e local do assistente, certifique-se de que o Nome do arquivo é newXmlSchema, aceite os outros valores padrão e clique em Finalizar.
   Observação: Se o padrão do nome do arquivo não for newXmlSchema, altere-o para newXmlSchema para corresponder às instruções neste documento.
   O IDE abre uma nova guia para o arquivo newXmlSchema com a exibição Esquema aberta.

 Exibir demonstração

Para adicionar uma referência externa:

1. Na exibição em coluna da exibição Esquema do arquivo newXmlSchema.xsd, selecione o nó raiz (http://xml.netbeans.org/schema/newXMLSchema), clique com o botão direito do mouse e escolha Adicionar > Importação.
   A caixa de diálogo Importação se abre.
2. Na lista Local, selecione o arquivo do esquema.
   
   • Para selecionar um arquivo do esquema de recursos recuperados de um URL:
     
     1. Expanda os nós Por arquivo > mySchemaPrj > src > docs.oasis-open.org > ubl > cd-UBL-1.0 > xsd > maindoc.
     2. Selecione UBL-Order-1.0.xsd.
        O campo Espaço de nome abaixo da lista Local é preenchido pelo IDE e contém o seguinte valor: urn:oasis:names:specification:ubl:schema:xsd:Order-1.0.
     3. No campo Novo prefixo, digite myRef e clique em OK.
        O IDE adiciona a importação ao arquivo do esquema.

      Exibir demonstração

   • Para selecionar um arquivo do esquema de recursos recuperados da amostra instalada localmente:
     
     1. Expanda os nós Por arquivo > mySchemaPrj > src > xsd > maindoc.
     2. Selecione UBL-Order-1.0.xsd.
        O campo Espaço de nome abaixo da lista Local é preenchido pelo IDE e contém o seguinte valor: urn:oasis:names:tc:ubl:Order:1:0.
     3. No campo Novo prefixo, digite myRef.
     4. Clique em OK.
        O IDE adiciona a importação ao arquivo do esquema.

      Exibir demonstração

3. Na primeira coluna da exibição Esquema, selecione o nó Esquemas referenciados.
   O IDE mostra o novo nó importação na segunda coluna da exibição. Se você tiver recuperado recursos da amostra instalada localmente, o nó importação deve ser semelhante ao exibido abaixo.
   
   

   

4. Na segunda coluna da exibição Esquema, selecione o nó importação, clique com o botão direito do mouse e escolha Ir para > Fonte.
   O IDE substitui a exibição Esquema pela exibição Fonte. Observe que o IDE atualizou o componente de esquema para incluir um atributo xmlns do esquema que você referenciou e do prefixo que você definiu.
5. Feche a janela Saída clicando no botão Fechar na barra de título da janela.
6. No menu principal do IDE, escolha Janela > Fechar todos os documentos.
7. Quando o IDE solicitar que você salve as alterações, clique em Salvar.
8. Na janela Projetos, clique com o botão direito do mouse no nó mySchemaPrj e escolha Fechar projeto.

superior

Próxima etapa

As etapas em Preenchendo esquemas XML usando a exibição Design mostram como usar a exibição Design no editor do esquema XML para preencher e modificar arquivos do esquema XML.

superior