TUTORIAL DE UTILIZAÇÃO DO OWL-S COMPOSER W

Trabalho de Conclusão de CursoAluno: Adriano Novais Queiroz

Orientadora: Prof.ª Daniela Barreiro Claro

INTRODUÇÃO E OBJETIVOA funcionalidade de um determinado serviço web pode ser útil para resolver um problema específico, mas, existem situações em que este único serviço atômico pode não ser suficiente para satisfazer ao usuário por completo, apesar de resolver parcialmente o seu problema. Neste momento entra em cena o conceito de composição de serviços, onde novos serviços Web mais complexos são gerados a partir de outros mais simples.

Como cenário para este tutorial, temos um desenvolvedor que necessita de um serviço web que realize a conversão de graus celsius para graus fahrenheit. O problema é que este desenvolvedor não possui um serviço atômico que resolva seu problema. Apesar disto, ele possui dois outros serviços que juntos podem lhe ajudar. O primeiro deles realiza conversões de graus celsius para graus kelvin e o segundo converte graus kelvin em graus fahrenheit.

O objetivo a ser atingido com este tutorial é realizar a composição destes dois serviços, gerando um novo serviço que converta diretamente Celsius em Fahrenheit.

ROTEIRO• Fase I (opcional) - Requisitos do Ambiente

- Links para as ferramentas necessárias- Configurando o Apache Tomcat no Eclipse

• Fase II (opcional) - Gerando um Serviço Web utilizando o Eclipse Obs.: Não faz parte da ferramenta apresentada- Criação de um Dynamic Web Project- Criação da Classe e métodos do serviço- Executando o Serviço Web

• Fase III - Utilização do OWL-S ComposerW - Conversão de Serviço Web Sintático em Semântico - Composição Visual de Serviços Web Semânticos- Teste de Serviços Web Semânticos

• Fase IV - Avaliação da ferramenta apresentada na Fase III- Google Forms - http://goo.gl/forms/FD5srnspmh

3

As Fases I e II são opcionais. Elas demonstram o processo de configuração do ambiente e criação de um Serviço Web utilizando o Eclipse IDE, o que não faz parte das funcionalidades do OWL-S ComposerW e por isto não será avaliado.

A princípio, para que o OWL-S ComposerW consiga se comunicar com o Serviço Web, é necessário que o mesmo esteja hospedado local público ou na rede UFBA.

Para esta avaliação você deverá seguir a partir da Fase III. Para isto, copie o endereço do WSDL abaixo para utilizá-lo na ferramenta:

http://localhost:8080/Temperature/wsdl/ConvertTemperature.wsdl

O passo a passo das Fases I e II estão na seção anexos (slide 13). Caso esteja na rede UFBA ou possua um local público para hospedar os serviços web, você poderá segui-las futuramente.

4

ATENÇÃO

FASE III UTILIZAÇÃO DO

OWL-S COMPOSER WAcesse a ferramenta através do endereço:http://www.owl-s-composerw.ufba.br/app/

5

AUTENTICAÇÃO

• Para este teste não existem usuários cadastrados. Para entrar você deve inserir no campo ‘Usuário’ seu nome e sobrenome juntos, sem pontos, espaços ou caracteres especiais. Atenção! É essencial inserir os dados exatamente neste formato para que a ferramenta funcione corretamente!

• O campo 'Senha' deve ficar em branco.

• Clique em Entrar.6

CONVERSÃO DE SERVIÇO WEB SINTÁTICO (WSDL) EM SERVIÇO WEB SEMÂNTICO (OWL-S)

• Clique em Ações -> Conversão de Serviço

• Insira o endereço do wsdl do seu serviço web e clique em Analisar Ex.: http://localhost:8080/Temperature/wsdl/ConvertTemperature.wsdl (use este endereço caso não esteja na rede UFBA)

• As operações CelsiusToKelvin e kelvinToFarhenheit serão carregadas no combo box

• Para cada uma delas selecione-a e clique em Gerar Serviço Web Semântico Obs.: O Repositório Destino é o local onde você pretende hospedar o Serviço Web Semântico gerado (arquivo owl baixado). Para este exemplo não altere o endereço indicado pois o serviço será hospedado automaticamente no repositório disponibilizado pela ferramenta.

• Salve os arquivos *.owl gerados (download automático) apenas para análise posterior, não será necessário hospedar em outro local.

• Obs.: A ferramenta não realiza conversões automáticas de serviços RESTful. Para esta avaliação você poderá usar nos passos seguintes descrições que foram criadas manualmente, utilizando o repositório http://www.owl-s-composerw.ufba.br/restful/owls/

7

COMPOSIÇÃO VISUAL DE SERVIÇOS WEB SEMÂNTICOS

• Clique em Ações -> Composição Visual

• Insira o repositório onde os serviços estão hospedados e clique em Buscar Se estiver usando o repositório do OWL-S ComposerW, o endereço será como este abaixo e será preenchido automaticamente:- http://localhost/owls/adrianoqueiroz/.

• As operações celsiusToKelvin.owl e kelvinToFarhenheit.owl, criadas na etapa anterior serão carregadas no combo box

• Para cada uma delas, selecione-a e clique em Inserir. A representação do serviço aparecerá no diagrama

• Arraste os Serviços para dentro do quadro Sequence e faça as ligações entre o quadro Sequence e os Serviços, conforme a figura acima.Obs.: O sentido das ligações entre os serviços é importante: Ex.: Você deverá iniciar a ligação do output do celsiusToKelvin para o input do kelvinTo Farhenheit. Não ligue partindo do input do kelvinToFarhenheit para o output do celsiusToKelvin pois ocasionará uma falha.

• Clique em Gerar Composição. Salve os arquivos *.owl gerados apenas para análise posterior (não será necessário hospedar em outro local).8

12 3

4 5

6

TESTE DE SERVIÇOS WEB SEMÂNTICOS

• Clique em Ações -> Testar Serviço

• Insira o repositório onde os serviços foram hospedados e clique em Buscar Se estiver usando o repositório do WSComposer Web, o endereço será como este abaixo e será preenchido automaticamente:- http://localhost/owls/adrianoqueiroz/

• As operações celsiusToKelvin.owl, kelvinToFarhenheit.owl e composition.owl serão carregadas no combo box

• Selecione o Serviço Web Semântico que deseja testar.

• Insira o valor numérico para a entrada e clique em Executar.

• Ao lado será exibida a representação do serviço (Composição ou Serviço Atômico) e logo abaixo o Resultado do teste9

COMPOSIÇÃO VISUAL HETEROGÊNEA DE SERVIÇOS WEB SEMÂNTICOS

• O OWL-S ComposerW permite que sejam realizadas composições tanto para serviços SOAP quanto para RESTful. É possível realizar até mesmo uma composição heterogênea de serviços SOAP e RESTful, utilizando mais de um repositório.Composição Heterogênea CelsiusToFahrenheit

• Insira o seu repositório (preenchido automaticamente pela ferramenta) e clique em Buscar

• Selecione o Serviço Web celsiusToKelvin.owl e clique em Inserir. Aparecerá um quadrado verde indicando que se trata de um serviço web SOAP.

• Insira o repositório " http://www.owl-s-composerw.ufba.br/restful/owls/ “ , onde existem descrições que foram criadas manualmente, e clique em Buscar

• Selecione o Serviço Web kelvinToFahrenheit.owl e clique em Inserir. Aparecerá um quadrado cinza indicando que se trata de um serviço web RESTful.

• Troque o nome do arquivo para não sobrescrever a composição criada anteriormente e clique em Gerar Composição.

• Para testar o serviço gerado, repita os passos indicados no slide anterior.10

12 3

4 5

6

FASE IV FORMULÁRIO PARA AVALIAÇÃO DA FERRAMENTA OWL-S COMPOSER W

Acesse o endereço:http://goo.gl/forms/FD5srnspmh

11

AGRADECEMOS A SUA CONTRIBUIÇÃO PARA A MELHORIA DOOWL-S COMPOSER W

12

ANEXOS

13

FASE 1 CONFIGURANDO O AMBIENTE

14

REQUISITOS DO AMBIENTE

• Eclipse IDE for Java EE Developers

• Links para a versão atual - Mars.2 (4.5.2) Windows (x64)Mac OS X (x64) Linux (X64)

• Apache Tomcat®

• Link para a Versão 8.0.33

• Navegador Web15

CONFIGURANDO O APACHE TOMCAT NO ECLIPSE

• Inicie o Eclipse IDE

• No menu superior siga os passos:Window -> Preferences -> Server -> Runtimes Environments

• Clique em Add

• Selecione a versão do Apache Tomcat, neste cenário foi utilizada a versão v8.0

• Clique em Next

• Clique em Browse… e selecione o diretório onde o Tomcat está localizado

• Clique em Finish

16

FASE 1I CRIAÇÃO DE UM SERVIÇO WEB

UTILIZANDO O ECLIPSE

17

• Neste exemplo será criado um Serviço Web para realizar conversões de temperatura:- Celsius para Kelvin - Kelvin para Fahrenheit

• Crie um Dynamic Web ProjectFile -> New -> Other... -> Web -> Dynamic Web Project

• Clique em Next

• Adicione um nome ao Dynamic Web Project. Nesse exemplo, usaremos "Temperature".

• Clique em Finish

18

GERANDO UM SERVIÇO WEB

• Crie a classe ConvertTemperature dentro do pacote ws

• Crie dois métodos nesta classe:

• Celsius para Kelvinpublic float celsiusToKelvin (float celsius){

float kelvin = celsius + 273.15f;return kelvin;

}

• Kelvin para Fahrenheitpublic float kelvinToFahrenheit(float kelvin){

float fahrenheit = (kelvin - 273.15f) * 1.8000f + 32.00f;return fahrenheit;

}

19

GERANDO UM SERVIÇO WEB

Salve as alterações

A classe deverá ficar desta forma:

20

GERANDO UM SERVIÇO WEB

• Selecione a classe ConvertTemperature.java, localizada no pacote ws

• Clique com o botão direito e selecione: New -> Other... -> Web Services -> Web Service

• Clique em Next

• A tela da figura ao lado aparecerá

• Verifique se o campo Service Implementation está selecionado corretamente (ws.ConvertTemperature)

• Clique em Finish

21

GERANDO UM SERVIÇO WEB

• Abra o arquivo ConvertTemperature.wsdl, localizado em WebContent -> wsdl

• Por padrão a descrição do serviço é criada com o endereço localhost http://localhost:8080/Temperature/services/ConvertTemperature

• Para que o WS Composer Web consiga se comunicar com o serviço web criado, troque o localhost pelo IP da máquina na rede local. Exemplo abaixo de como deverá ficar, porém com o seu endereço IP. (Veja como verificar no slide seguinte) http://192.168.1.10:8080/Temperature/services/ConvertTemperature

22

GERANDO UM SERVIÇO WEB

• Para verificar seu ip no Mac OS X ou no Linux

• Abra o terminal e digite:- ifconfig

• Para verificar seu ip no Windows Abra o Executar (windows + R ) - Digite cmd e clique em Ok

• No cmd digite: - ipconfig

23

GERANDO UM SERVIÇO WEB

• Salve as alterações

• Execute o projetoClique com o botão direito no projeto Temperature e siga os passos:Run As -> Run on Server -> Finish

• Pronto! O serviço Web está disponível na rede (altere para o seu endereço IP na rede local)http://192.168.1.10:8080/Temperature/wsdl/ConvertTemperature.wsdl

24

GERANDO UM SERVIÇO WEB