Comando schemagen para Aplicativos JAXB

Utilize a ferramenta geradora de esquemas, schemagen, para gerar um esquema XML utilizando o JAXB (Java™ Architecture for XML Binding).

Utilize as APIs JAXB e as ferramentas para estabelecer mapeamentos entre classes Java e o esquema XML. Os esquemas XML descrevem os elementos de dados e os relacionamentos em um documento XML. Após a existência de uma ligação ou mapeamento de dados, é possível converter os documentos XML para e a partir de objetos Java. Agora você pode acessar dados armazenados em um documento XML sem a necessidade de entender a estrutura dos dados.

É possível gerar um arquivo de esquema a partir de classes Java usando a ferramenta geradora de esquemas schemagen para criar o esquema XML. Após a criação do mapeamento entre o esquema XML e as classes Java, os documentos da instância XML podem ser convertidos em e de objetos Java por meio do uso da API de tempo de ligação do JAXB. As classes Java resultantes contêm todas as informações necessárias exigidas pelo tempo de execução do JAXB para analisar o XML para ordenação e desordenação. É possível usar as classes JAXB nos aplicativos Java API for XML Web Services (JAX-WS) ou em aplicativos Java não JAX-WS para o processamento de dados XML.

Configurações suportadas Configurações suportadas: As ferramentas de linha de comandos wsimport, wsgen, schemagen e xjc não são suportadas na plataforma z/OS. Essa funcionalidade é permitida pelas ferramentas de montagem fornecidas com o WebSphere Application Server em execução na plataforma z/OS. Consulte sobre essas ferramentas de linha de comandos para aplicativos JAX-WS para saber mais sobre elas.sptcfg
Boas Práticas Boas Práticas: WebSphere Application Server fornece API Java para XML-Based Web Services (JAX-WS) e ferramentas do Java Architecture para XML Binding (JAXB). As ferramentas de linha de comandos wsimport, wsgen, schemagen e xjc estão localizadas no diretório app_server_root\bin\ no WebSphere Application Server tradicional.Os comandos xjc e schemagen estão localizados no diretório app_server_root\jaxb\bin\, no perfil Liberty. Em determinadas ocasiões, os artefatos gerados pelas ferramentas fornecidas pelo WebSphere Application Server e pelo JDK suportam os mesmos níveis das especificações. Em geral, os artefatos gerados pelas ferramentas JDK são portáteis entre outros ambientes de tempo de execução compatíveis. Entretanto, é uma boa prática usar as ferramentas fornecidas com este produto para obter uma perfeita integração no ambiente do WebSphere Application Server e para aproveitar os recursos que talvez só sejam suportados no WebSphere Application Server. Para usufruir das vantagens dos conjuntos de ferramentas JAX-WS e JAXB V2.2, use as ferramentas fornecidas com o servidor de aplicativos localizado no diretório app_server_root\bin\.bprac
Evitar Problemas Evitar Problemas: Ao executar a ferramenta schemagen para processar JavaBeans, o gerador de esquema não processará automaticamente as anotações @XmlSchema a partir de arquivos package-info.class existentes para derivar targetNamespaces. Para assegurar que a ferramenta schemagen processe valores de espaço de nomes corretamente, use um dos seguintes métodos:
  • Especifique explicitamente o arquivo de origem package-info.java na chamada schemagen; por exemplo:
    schemagen sample.Address sample\package-info.java
  • Use o atributo de anotação de espaço de nomes @XmlType em seus JavaBeans para especificar um espaço de nomes; por exemplo:
    @XmlType(namespace="http://myNameSpace")
    public class Address {...}
gotcha

Além de usar a ferramenta schemagen a partir da linha de comandos, é possível chamar essa ferramenta JAXB a partir de ambientes de construção Ant. Use a tarefa Ant com.sun.tools.jxc.SchemaGenTask a partir do ambiente de construção Ant para chamar a ferramenta do gerador de esquema schemagen. Para que funcione corretamente, essa tarefa Ant requer que Ant seja chamado usando o script ws_ant.

Sintaxe

A sintaxe da linha de comandos é:

[Windows]
app_server_root\bin\schemagen.bat [options] <java_files>
[AIX][HP-UX][Linux][Solaris]
app_server_root/bin/schemagen.sh [options] <java_files>
[IBM i]
app_server_root/bin/schemagen [options] <java_files>

Parameters

Os parâmetros a seguir são opcionais para o comando schemagen:

-classpath <path>
Especifica o local dos arquivos de origem ou de classe Java.
-cp <path>
Especifica o local dos arquivos de origem ou de classe Java.
-d <path>
Especifica onde colocar o processador e os arquivos de classe Java gerados.
-episode<nome_do_arquivo>
Especifica que deve-se gerar um arquivo de episódio para compilação separada.
-encoding <encoding>
Especifica usar a codificação quando chamar a ferramenta -apt ou -javac. Essa propriedade é aplicável para o JAXB 2.2 e superior.
-help
Exibe o menu de ajuda.
-version
Imprime as informações de versão. Se você especificar essa opção, apenas as informações de versão serão incluídas na saída e o processamento normal do comando não ocorrerá.

Ícone que indica o tipo de tópico Tópico de Referência



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwbs_schemagen
Nome do arquivo: rwbs_schemagen.html