Nível: Intermediário Bernard Z. Kufluk, Advisory Software Engineer, IBM
Ian Hodges, Advisory Software Engineer, IBM
29/Abr/2009 Mantenha seu registro Universal Description Discovery and Integration (UDDI) atualizado com este utilitário simples para importar novos tModels (modelos técnicos) canônicos. O utilitário assegura que novos tModels canônicos definidos sejam salvos em seu banco de dados de registro UDDI do
IBM® WebSphere® Application Server com chaves definidas para a V2 e V3.
Introdução
Este artigo introduz um utilitário útil para importar tModels
(abreviação para modelos técnicos) canônicos para seu Registro UDDI do WebSphere Application
Server V6. Quando um novo nó do Registro UDDI é criado, ele é preenchido com todos os tModels canônicos de UDDI sancionados pelo comitê técnico Organization for Advancement of Structured Information Standards (OASIS) e conhecidos antes do release de uma versão do WebSphere. Ao longo do tempo, novos tModels são adotados pelo comitê técnico e tornam-se tModels canônicos. Esses tModels são frequentemente produzidos como resultado de novos padrões.
Se quiser fazer referência a qualquer novo tModel canônico em seu Registro UDDI e acompanhar os padrões emergentes, então, esse utilitário pode ser usado para importá-los para seu banco de dados UDDI.
 |
Sobre tModels
Um tModel é uma estrutura de dados que representa um conceito reutilizável, como um tipo de serviço da Web, um protocolo usado por serviços da Web ou um sistema de categoria.
Chaves de tModel em uma descrição de serviço são uma "impressão digital" técnica que pode ser usada para rastrear as origens de compatibilidade de um determinado serviço.
Fornecem um ponto de referência comum para que seja possível identificar serviços compatíveis.
tModels canônicos representam um conceito conhecido e são propriedades de um grupo de padrões conhecido, um vertical de segmento de mercado ou um consórcio.
Consulte
Recursos para obter uma lista de tModels documentados por OASIS.
|
|
Uma diferença entre tModels canônicos e tModels ordinários é que os
tModels canônicos têm dias chaves conhecidas para cada tModel; a chave da especificação da V2 e a chave da especificação da V3.
Assim, em qualquer Registro UDDI, o tModel pode ser referido por essa chave ao usar a API SOAP V2 ou V3.
Usando a API SOAP save_tModel V3, um tModel pode ser salvo em um Registro UDDI com uma chave V3 definida.
No entanto, a chave V2 não pode ser definida e o nó designará a chave conforme a especificação V2.
Com esse utilitário, é possível salvar os tModels canônicos com as chaves V2 e V3 definidas.
Fazer Download do Utilitário e Configurar o Arquivo de Propriedades
A Tabela 1 lista o conteúdo do arquivo
UDDICanonicalTModelImportTool.zip .
Tabela 1. O Conteúdo de
UDDICanonicalTModelImportTool.zip
| UDDICanonTModelImportTool.jar | O arquivo JAR para o utilitário |
|---|
| UDDICanonicalTModelImportTool.properties | Arquivo de configuração do banco de dados |
|---|
| WSRP-TModels.xml | Um arquivo de exemplo contendo tModels canônicos para importação |
|---|
| PolicyModels.xml | Um arquivo de exemplo contendo tModels canônicos de política para importação |
|---|
Após fazer download do utilitário, use o arquivo de propriedades fornecido para especificar informações de conexão para o banco de dados do registro UDDI e o local dos arquivos de mensagens e rastreio.
Para cada banco de dados suportado, o arquivo de propriedades contém uma seção para especificar detalhes da conexão.
Para seu tipo de banco de dados, remova o caractere de comentário
'#' de cada uma das propriedades. Assegure que somente um tipo de banco de dados esteja ativo.
A Lista 1 mostra um exemplo de detalhes de conexão do DB2.
Lista 1.
Arquivo de Configuração do Banco de Dados UDDICanonicalTModelImportTool.properties
##############################################
# Configuration for destination UDDI DB (DB2)#
# jar DB2_HOME/java/db2java.zip #
##############################################
dbDriver=COM.ibm.db2.jdbc.app.DB2Driver
dbUrl=jdbc:db2:uddi30
dbUser=db2admin
dbPasswd=db2password
dbDataSchema=IBMUDI30
dbSystemSchema=IBMUDS30
|
O cabeçalho do comentário denota o tipo de banco de dados e o local dos arquivos JAR que contêm o driver JDBC.
dbDriver
denomina o driver JDBC a ser carregado para ativar a conexão com o banco de dados,
dbDataSchema e dbSystemSchema denotam o nome do esquema usado para acessar as tabelas de banco de dados do Registro UDDI.
Essas propriedades não devem ser alteradas.
dbUrl é usado para denotar o nome ou o local do banco de dados do Registro UDDI dependente do RDBMS específico.
dbUser e dbPasswd são usados para definir o ID do usuário e a senha de um usuário com permissão para inserção no banco de dados do Registro UDDI.
Se seu tipo RDBMS for IBM® Cloudscape ™ integrado (WebSphere
Application Server V6) ou Apache Derby integrado (WebSphere Application
Server V6.1), então, o banco de dados pode ser acessado somente por uma JVM por vez.
Primeiro, o servidor de aplicativos hosting o registro UDDI deve ser parado para permitir que o utilitário de importação acesse o banco de dados.
O arquivo WSRP-TModels.xml é um arquivo de exemplo para testar o utilitário. Contém diversos tModels canônicos definidos pela especificação Web Services for Remote Portlets (WSRP) (consulte Recursos). Esses tModels são definidos usando-se o padrão UDDI normal, mas o elemento
tModel contém os atributos
v2tModelKey e v3tModelKey (em vez de o atributo
tModelKey). Por exemplo:
<tModel v2tModelKey="uuid:58a98609-c265-3c28-9079-85ea8b2521ef"
v3tModelKey="uddi:oasis-open.org:wsrp:service_type">
Para seus tModels canônicos, crie um arquivo XML com um elemento
canonicalTModels contendo todas as definições de tModels descritas por um documento apropriado. Para cada tModel, defina as chaves V2 e V3.
O utilitário lê e valida o arquivo XML, conecta ao banco de dados definido no arquivo de propriedades e insere os tModels canônicos no banco de dados do Registro UDDI.
Uma opção também existe para excluir tModels canônicos no arquivo XML do banco de dados do Registro UDDI.
Executar o Utilitário
Quando o arquivo de propriedades e os arquivos XML tiverem sido configurados, é possível executar o utilitário.
O caminho de classe deve incluir os arquivos JAR contendo seu driver JDBC.
Consulte o arquivo de propriedades para obter detalhes de locais usuais. A Lista 2 mostra a sintaxe para o utilitário.
Substitua ./jdbcDriver.jar pelo caminho de seus arquivos do driver JDBC e
filename pelo arquivo que contém os TModels canônicos. A opção -u remove os
tModels canônicos anteriormente importados.
Lista 2. Sintaxe para o Utilitário de Importação de tModel
java -classpath
./jdbcDriver.jar;{WAS_HOME}/lib/uddi4jv2.jar;./UDDICanonTModelImportTool.jar
com.ibm.uddi.v3.ctmit.CanonicalTModelImportTool -f <filename> [-u]
|
Os comandos de exemplo a seguir ilustram a importação e exclusão de tModels do banco de dados do registro.
java -classpath ./derby.jar;/AppServer/lib/uddi4jv2.jar;./UDDICanonTModelImportTool.jar
com.ibm.uddi.v3.ctmit.CanonicalTModelImportTool -f tmodel.xml
java -classpath ./derby.jar;/AppServer/lib/uddi4jv2.jar;./UDDICanonTModelImportTool.jar
com.ibm.uddi.v3.ctmit.CanonicalTModelImportTool -f tmodel.xml -u
|
A Lista 3 contém a saída do exemplo. Se houver um erro nas informações de conexão com o banco de dados ou no formato dos tModels definidos no XML, esses erros são relatados.
Lista 3. Saída de Exemplo do Utilitário de Importação
CWUDU5003I: Importing entities...
CWUDU5006I: Deserializing...
CWUDU5007I: Deserialized entities.
CWUDU5005I: Imported tModel, tModelKey[uddi:oasis-open.org:wsrp:service_type].
|
Se houver um erro na descrição do tModel ou não precisar mais de tModels, execute o utilitário novamente com a opção -u para remover
tModels do banco de dados.
Verificar o Conteúdo do Registro
Após os tModels terem sido importados, use o Console do Usuário do UDDI para procurar esses tModels e verifique se estão descritos corretamente no Registro UDDI, conforme mostrado na Figura 1.
Figura 1. tModels WSRP Carregados no UDDI
Os tModels canônicos agora estão disponíveis para referência a partir de outras entidades UDDI.
Resumo
Este artigo descreve um utilitário para importação de novos tModels canônicos em um banco de dados do registro UDDI do Application Server.
Permite salvar tModels com chaves definidas para UDDI V2 e V3.
Download | Descrição | Nome | Tamanho | Método de download |
|---|
| Canonical tModel import tool and sample data | UDDICanonicalTModelImportTool.zip | 216KB | HTTP |
|---|
Recursos
Sobre os autores | 
| | Bernard Kufluk é um desenvolvedor de software da IBM que trabalha no WebSphere Service Registry and Repository. Está envolvido na equipe de desenvolvimento de API desde novembro de 2005. Nos últimos sete anos, trabalhou em diversos produtos IBM, inclusive no WebSphere Voice Application Access, no WebSphere Voice Response e no Intelligent Notification Services. É possível contatá-lo em
bernard@uk.ibm.com. |
| | | Ian Hodges é um Engenheiro de Software Consultivo da IBM nos Laboratórios de Hursley da IBM, RU, que desenvolve Tecnologias da Web. Anteriormente ele era um desenvolvedor líder do WebSphere UDDI Registry. Ian trabalha com tecnologias Java há 10 anos e é um Desenvolvedor de Java Certificado pela Sun. Tem mais de 20 anos de experiência em desenvolvimento de software. É possível contatá-lo em ihodges@uk.ibm.com. |
Avalie esta página
| 
