Prática em Laboratório N.04 Criando uma aplicação composta a partir de um serviço Web O objetivo deste exercício é fornecer uma introdução a criação de uma aplicação composta de modo a ilustrar o processo de construção, implantação, execução e teste da mesma. Para tanto irá se implementar uma aplicação simples de avaliação de pedidos de empréstimos. Business Use Case A aplicação de processamento de pedidos de empréstimos satisfaz a seguintes requisitos: O cliente solicita um empréstimo através do preenchimento de uma solicitação de empréstimo que inclui informações tais como dados de identificação pessoal, quantia requisitada e histórico de crédito. Quanto a solicitação de empréstimo é recebida, as informações pessoais fornecidas pelo cliente são verificadas em um banco de dados existente e o empréstimo é aprovado ou rejeitado com base nas informações e no montante solicitado. Depois que certas formalidades forem cumpridas, um relatório, sob a forma de uma carta de aprovação (no caso de aprovação), é gerado e enviado ao cliente, confirmando assim a aprovação de sua solicitação de empréstimo. Se a solicitação de empréstimo for rejeitada por alguma razão, um relatório contendo os motivos da não aprovação é gerado e exibido para o cliente. Criando um serviço Web com Lógica de Processamento de Empréstimos Criando um módulo EJB: 1. Escolha Arquivo > Novo projeto (Ctrl-Shift-N). Selecione EJB Module na categoria Java EE e clique em Next.
2. No campo Project Name, digite LoanProcessor e clique em Next. 3. Na página Server and Settings, verifique se o servidor selecionado é GlassFish V2, e clique em Finish. A janela de Projetos agora contém um nodo correspondente ao projeto de um EJB Module chamado LoanProcessor. Criando um serviço Web: 1. Na janela de Projetos, clique com o botão direito do mouse no nó LoanProcessor e escolha New > Web Service. 2. Chame o serviço Web de LoanProcessor e digite org.me.loanprocessor no Pacote. 3. Deixe selecionado Create Web Service from Scratch (Criar serviço Web do início). 4. Clique em Finish. O IDE cria o serviço Web e abre LoanProcessor.java no Editor. 5. Expanda o nodo Web Services. 6. Clique com o botão direito do mouse sobre o nodo LoanProcessor (que representa o serviço Web) e selecione Add Operation. O diálogo Add Operation será exibido. 7. No campo Name, digite processapplicoperation. 8. Na lista de parâmetros, adicione os sete parâmetros conforme descritos a seguir. Name socialsecuritynumber applicantname applicantaddress applicantemailaddress applicantage applicantgender annualsalary amountrequested Type java.lang.string java.lang.string java.lang.string java.lang.string java.lang.integer java.lang.string java.lang.double java.lang.double
9. Clique em OK. 10. No editor de código, clique no botão Source para exibir o código do arquivo LoanProcessor.java (caso ele não esteja visível). 11. No Editor de código, substitua //TODO write your implementation code here: return null; pelo seguinte código: int MINIMUM_AGE_LIMIT = 18; int MAXIMUM_AGE_LIMIT = 65; double MINIMUM_SALARY = 20000; int AVERAGE_LIFE_EXPECTANCY = 70; String result = "Loan Application APPROVED."; // Check age of applicant // If less than min age limit, rejected if(applicantage < MINIMUM_AGE_LIMIT) { result = "Loan Application REJECTED - Reason: Under-aged " + applicantage + ". Age needs to be over " + MINIMUM_AGE_LIMIT + " years to qualify."; System.out.println(result); return result; } // Check age of applicant // If more than max age limit, rejected if(applicantage > MAXIMUM_AGE_LIMIT) { result = "Loan Application REJECTED - Reason: Over-aged " + applicantage +
} ". Age needs to be under " + MAXIMUM_AGE_LIMIT + " years to qualify."; System.out.println(result); return result; // Check annual salary // If less than min salary, rejected if(annualsalary < MINIMUM_SALARY) { result = "Loan Application REJECTED - Reason: Annual Salary $" + annualsalary + " too low. Annual Salary needs to be over $" + MINIMUM_SALARY + " to qualify."; System.out.println(result); return result; } // Calculate the years to pay off loan based on applicantage int yearstorepay = AVERAGE_LIFE_EXPECTANCY - applicantage; // Calculate the max amount of loan based on years to pay off loan double limit = annualsalary * yearstorepay * 0.5; // Check amount requested, if higher than limit, rejected if(amountrequested > limit) { result = "Loan Application REJECTED - Reason: You are asking for too much $" + amountrequested + ". Annual Salary $" + annualsalary + ", Age " + applicantage + " years. Your limit is $" + limit; System.out.println(result); return result; } System.out.println(result); return result; 12. Salve suas alterações. 13. Compile (Clean and Build), implante (Deploy) e teste o serviço Web (selecione o nodo correspondente ao serviço Web e escolha Test Web Service). Criando um Projeto para um Módulo BPEL Agora iremos criar um projeto para conter um módulo BPEL chamado LoanRequestor. Para criar o projeto LoanRequestor: 1. Escolha Arquivo > Novo projeto (Ctrl-Shift-N). Selecione BPEL Module na categoria SOA e clique em Next. 2. No campo Project Name, digite LoanRequestor e clique em Finish.
Criando um Esquema XML Agora iremos adicionar um esquema XML ao projeto do módulo BPEL. Para criar o esquema LoanRequestor.xsd: 1. Expanda o nodo do projeto LoanRequestor, clique com o botão direito do mouse no nó Process Files e escolha New > Other. O assitente New File será exibido. 2. Faça o seguinte: a. Selecione a categoria XML e, em seguida, XML Schema. Clique em Next. b. No campo File Name, digite LoanRequestor. c. Clique em Finish. 3. No editor, clique no botão de Design para abrir a visualização de Design do esquema XML. Para adicionar tipos complexos ao esquema XML: 1. Na Paleta (a direita da janela de Design), expanda a seção XML Schema Components e selecione o ícone Complex Type. Se a Paleta não estiver visível, escolha Window > Palette a partir no menu principal. 2. Arreste sua seleção para a área de design sob o nodo Complex Types. O IDE adicionará um nodo Complex Type e o nome do tipo complexo (newcomplextype) estará selecionada e pronto para que você o altere. 3. Digite processapplictype como nome do novo nodo e pressione Enter. 4. Repita os passos de 1 a 3 para criar outro tipo complexo chamado processapplicresptype.
Para adicionar elementos locais ao tipo processapplictype: 1. Na seção XML Components da Paleta, selecione o ícone Element e arraste sua seleção sobre o nodo processapplictype da área de design. O IDE adicionará um nodo correspondente ao elemento com nome newelement. 2. Se a janela de propriedade não estiver visível, escolha Window > Properties. 3. Utilize a janela Properties para modificar o nome do novo elemento para socialsecuritynumber. 4. Analogamente, modifique a propriedade Nillable para True. 5. Altere a propriedade Definition, selecionando o tipo string dentro do nodo Built-in Types e clique em OK. 6. Repita os passos de 1 a 5 para adicionar os seguintes elementos: Name Nillable Definition applicantname True string applicantaddress True string applicantemailaddress True string applicantage True int applicantgender True string annualsalary True double amountrequested True double Para adicionar um elemento local ao tipo processapplicresptype: 1. Na seção XML Components da Paleta, selecione o ícone Element e arraste sua seleção sobre o nodo processapplicresptype da área de design. O IDE adicionará um nodo correspondente ao elemento com nome newelement. 2. Utilize a janela Properties para modificar o nome do novo elemento para return. 3. Altere a propriedade Definition, selecionando o tipo string dentro do nodo Built-in Types e clique em OK.
Para adicionar elementos globais: 1. Na seção XML Components da Paleta, selecione o ícone Element e arraste sua seleção sobre o nodo Elements da área de design. O IDE adicionará um nodo correspondente ao elemento com nome newelement. 2. Utilize a janela Properties para modificar o nome do novo elemento para processapplicelement. 3. Altere a propriedade Definition, selecionando o tipo processapplictype dentro do nodo Complex Types e clique em OK. 4. Repita os passos de 1 a 3 para adicionar um elemento global chamado processapplicrespelement e selecione processapplicresptype como para a definição do mesmo. 5. Salve suas modificações. Criando um Documento WSDL Agora iremos adicionar um documento WSDL ao projeto do módulo BPEL. Para criar o documento LoanRequestor.wsdl: 1. Expanda o nodo do projeto LoanRequestor, clique com o botão direito do mouse no nó Process Files e escolha New > WSDL Document. O assitente de documentos WSDL será exibido. 2. No campo File Name, digite LoanRequestor e clique em Next. 3. Na área de Input da página de Abstract Configuration faça o seguinte: a. Na coluna Message Part Name, altere o nome para requestloanmessage e pressione Enter. b. Na coluna Element Or Type, clique no botão com reticências e modifique o elemento para processapplicelement. Localize e expanda By File > LoanRequestor > src/loanrequestor.xsd > Elements e selecione processapplicelement. 4. Na área de Output da página de Abstract Configuration faça o seguinte: a. Na coluna Message Part Name, altere o nome para responsepart e pressione Enter.
b. Na coluna Element Or Type, clique no botão com reticências e modifique o elemento para processapplicrespelement. Localize e expanda By File > LoanRequestor > src/loanrequestor.xsd > Elements e selecione processapplicrespelement. 5. Clique em Finish e salve suas modificações. Criando um Processo BPEL Agora iremos adicionar um processo BPEL ao projeto. Para criar o documento LoanRequestor.bpel: 1. Expanda o nodo do projeto LoanRequestor, se já existir um nodo chamado basta selecioná-lo com um duplo clique e seguir para o próximo tópico. Caso contrário, clique com o botão direito do mouse no nó Process Files e escolha New > BPEL Process. O assitente New BPEL Process será exibido.
2. No campo File Name, digite LoanRequestor. Clique em Finish. Para adicionar Partner Links: 1. Selecione o nodo LoanRequestor.wsdl. Arraste sua seleção (LoanRequestor.wsdl) para o lado esquerdo da área de design (região da margem esquerda). O IDE irá lhe fornecer dicas visuais de modo a orientá-lo onde é possível colocar (drop) sua seleção. 2. Use o Editor de Propriedades para alterar o nome para BpelImplementation (para ativar o editor, selecione o ícone com forma de lápis sobre a representação gráfica do Partner Link recém criado). 3. Aceite os demais valores default e clique em OK. 4. Na janela de Projetos, expanda o nodo do projeto de módulo EJB LoanProcessor e selecione o nodo correspondente ao serviço Web LoanProcessor. 5. Arraste sua seleção (LoanProcessor) para o lado direito da área de design (região da margem direita). O IDE irá lhe fornecer dicas visuais de modo a orientá-lo onde é possível colocar (drop) sua seleção. Em seguida o diálogo Create New Partner Link será exibido. 6. Altere o nome para EjbImplementation. Aceite os demais valores default e clique em OK.
Para adicionar uma atividade Receive: 1. Na seção Web Service da Paleta, selecione o ícone Receive e arraste sua seleção para a área de design entre as atividades Process Start e Process End. O IDE adicionará um nodo correspondente a atividade com nome Receive1. 2. Clique no botão de edição para atividade recém inserida. 3. Altere o nome para ReceiveFromCustomer, selecione BpelImplementation na lista de Partner Links. O IDE automaticamente preenche o campo Operation com LoanRequestorOperation. 4. Clique no botão Create próximo ao campo Input Variable. O diálogo New Input Variable é exibido, aceite os valores default e clique em OK. 5. Dessa forma será criada uma nova variável de entrada chamada LoanRequestorOperationIn. 6. Clique em OK para fechar o editor.
A atividade Receive é agora rotulada como ReceiveFromCustomer e a conexão entre a atividade Receive e o Partner Link BpelImplementation é exibida. Para adicionar uma atividade Invoke: 1. Na seção Web Service da Paleta, selecione o ícone Invoke e arraste sua seleção para a área de design logo abaixo da atividade ReceiveFromCustomer. O IDE adicionará um nodo correspondente a atividade com nome Invoke1. 2. Clique no botão de edição para atividade recém inserida. 3. Altere o nome para InvokeLoanProcessorEJB, selecione EjbImplementation na lista de Partner Links. O IDE automaticamente preenche o campo Operation com processapplicoperation. 4. Clique no botão Create próximo ao campo Input Variable. O diálogo New Input Variable é exibido, aceite os valores default e clique em OK. 5. Dessa forma será criada uma nova variável de entrada chamada ProcessApplicOperationIn. 6. Clique no botão Create próximo ao campo Output Variable. O diálogo New Output Variable é exibido, aceite os valores default e clique em OK. 7. Dessa forma será criada uma nova variável de saída chamada ProcessApplicOperationOut.
8. Clique em OK para fechar o editor. A atividade Invoke é agora rotulada como InvokeLoanProcessorEJB e a conexão entre a atividade Invoke e o Partner Link EjbImplementation é exibida. Para adicionar uma atividade Reply: 1. Na seção Web Service da Paleta, selecione o ícone Reply e arraste sua seleção para a área de design logo abaixo da atividade InvokeLoanProcessorEJB. O IDE adicionará um nodo correspondente a atividade com nome Reply1. 2. Clique no botão de edição para atividade recém inserida. 3. Altere o nome para ReplyToCustomer, selecione BpelImplementation na lista de Partner Links. O IDE automaticamente preenche o campo Operation com LoanRequestorOperation. 4. Certifique-se que Normal Response está selecionado. 5. Clique no botão Create próximo ao campo Output Variable. O diálogo New Output Variable é exibido, aceite os valores default e clique em OK.
6. Dessa forma será criada uma nova variável de saída chamada LoanRequestorOperationOut. 7. Clique em OK para fechar o editor. A atividade Reply é agora rotulada como ReplyToCustomer e a conexão entre a atividade Reply e o Partner Link BpelImplementation é exibida. Para adicionar a atividade de Assign CopyCustomerInfo: 1. Na seção Basic Activities da Paleta, selecione o ícone Assign e arraste sua seleção para a área de design entre as atividades ReceiveFromCustomer e InvokeLoanProcessorEJB. O IDE adicionará um nodo correspondente a atividade com nome Assign1. 2. Use a janela de propriedades para alterar o nome da atividade para CopyCustomerInfo. Se a janela de propriedade não estiver visível, escolha Windows > Properties. 3. No editor, selecione o botão Mapper para abrir a janela do BPEL Mapper.
4. No lado esquerdo da janela do BPEL Mapper, expanda os nodos Variables > LoanRequestorOperationIn > requestloanmessage. Será, então, exibido um nodo para cada elemento local do tipo complexo processapplictype criado anteriormente no esquema. 5. No lado direito da janela do BPEL Mapper, expanda os nodos Variables > ProcessApplicOperationIn > parameters. Será, então, exibido um nodo para cada elemento. 6. Arraste o nodo correspondente ao socialsecuritynumber do lado esquerdo (fonte) para o nodo de mesmo nome do lado direito (destino). 7. Repita o passo anterior para cada um dos demais elementos: applicantname, applicantaddress, applicantemailaddress, applicantage, applicantgender, annualsalary e amounrequested. 8. Salve suas modificações.
Para adicionar a atividade de Assign CopyLoanStatus: 1. No editor de BPEL, selecione o botão de Design para retornar a modo de design. 2. Na seção Basic Activities da Paleta, selecione o ícone Assign e arraste sua seleção para a área de design entre as atividades InvokeLoanProcessorEJB e ReplyToCustomer. O IDE adicionará um nodo correspondente a atividade com nome Assign1. 3. Use a janela de propriedades para alterar o nome da atividade para CopyLoanStatus. Se a janela de propriedade não estiver visível, escolha Windows > Properties. 4. No editor, selecione o botão Mapper para abrir a janela do BPEL Mapper. 5. No lado esquerdo da janela do BPEL Mapper, expanda os nodos Variables > ProcessApplicOperationOut > parameters. Será, então, exibido um nodo return. 6. No lado direito da janela do BPEL Mapper, expanda os nodos Variables > LoanRequestorOperationOut > responsepart. Será, então, exibido um nodo return. 7. Arraste o nodo correspondente ao return do lado esquerdo (fonte) para o nodo de mesmo nome do lado direito (destino). 8. Salve suas modificações e compile seu projeto de módulo BPEL (selecione o nodo LoanRequestor com o botão direito e clique Clean and Build).
Criando um Projeto de Aplicação Composta Antes de implantar um projeto de módulo BPEL, devemos criar uma aplicação composta. Para criar um projeto de aplicação composta: 1. Escolha Arquivo > Novo projeto (Ctrl-Shift-N). Selecione Composite Application na categoria SOA e clique em Next. 2. No campo Project Name, digite LoanRequestorCompositeApp e clique em Finish. Usando Editor CASA (Composite Application Service Assembly) Agora iremos utiliza o editor CASA para modificar a configuração do projeto e construir/implantar o projeto de módulo BPEL. 1. Selecione o nodo correspondente ao projeto LoanRequestor e arraste sua seleção para a área de módulos JBI.
2. Clique no botão Build Project na barra de ferramentas do editor para construir o projeto de módulo BPEL LoanRequestor. Quando este passo se concluir: a. A janela de saída deverá conter uma mensagem indicando sucesso BUILD SUCCESSFUL. b. O editor irá exibir a seguinte configuração. Para criar WSDL Endpoints: 1. Na seção WSDL Bindings da Paleta, selecione o ícone SOAP e arraste sua seleção para a área de WSDL Ports (lado esquerdo do editor). 2. Use a janela de propriedades para alterar o nome do Endpoint LoanProcessorPort. Se a janela de propriedade não estiver visível, escolha Windows > Properties. 3. Arraste o ícone de Consume Endpoint EjbImplementation em LoanRequestor para o Provide Endpoint em LoanProcessorPort. 4. Use o Editor de Propriedades para alterar a propriedade Location (SOAP Address) do Endpoint LoanProcessorPort para http://localhost:8080/loanprocessorservice/loanprocessor (para ativar o editor, selecione o ícone com forma de lápis junto a representação gráfica do Endpoint recém criado).
5. Na seção WSDL Bindings da Paleta, selecione novamente o ícone SOAP e arraste sua seleção para a área de WSDL Ports (lado esquerdo do editor). 6. Use a janela de propriedades para alterar o nome do Endpoint LoanRequestPort. 7. Arraste o ícone de Consume Endpoint LoanRequestPort para o Provide Endpoint BpelImplementation em LoanRequestor. 8. Salve as alterações em seu projeto. Implantando e Testando uma Aplicação Composta Para implantar um projeto de aplicação composta: 1. Selecione com o botão direito do mouse o nodo LoanRequestorCompositeApp e clique em Deploy. 2. Verifique se a aplicação composta foi implantada corretamente. Vá a janela Services e expanda o nó Servers > Glassfish v2.1 > JBI > Service Assemblies. Verifique também se o módulo EJB ainda se encontra implantado. Vá a janela Services e expanda o nó Servers > Glassfish v2.1 > Applications > EJB Modules. Caso seja necessário repita o procedimento de implantação tanto da aplicação composta quanto do módulo EJB.
Para adicionar um caso de teste para uma requisição aprovada: 1. Expanda o nodo LoanRequestorCompositeApp e clique com o botão direito do mouse no nodo Test, selecione New Test Case no menu popup. 2. No campo Test Case Name, digite ApprovedTestCase e clique em Next. 3. Na página Select WSDL Document, expanda o nodo LoanRequestorCompositeApp Process Files, selecione LoanRequestorCompositeApp.wsdl e clique em Next. 4. Na página Select Operation to Test, selecione LoanRequestorOperation e clique em Finish. O IDE irá adicionar um novo nodo sob o nodo Test chamado ApprovedTestCase. Esse nodo possui dois subnodos: Input e Output.
5. Altere o arquivo Input.xml, para os seguintes valores: <loan:socialsecuritynumber>111-11-1111</loan:socialsecuritynumber> <loan:applicantname>joao da Silva</loan:applicantName> <loan:applicantaddress>rua das Flores, 234</loan:applicantAddress> <loan:applicantemailaddress>jsilva@gmail.com</loan:applicantemailaddress> <loan:applicantage>36</loan:applicantage> <loan:applicantgender>male</loan:applicantgender> <loan:annualsalary>100000</loan:annualsalary> <loan:amountrequested>1000000</loan:amountrequested> 6. Feche o arquivo Input.xml e salve todas suas alterações. Para adicionar um caso de teste para uma requisição rejeitada: 1. Expanda o nodo LoanRequestorCompositeApp e clique com o botão direito do mouse no nodo Test, selecione New Test Case no menu popup. 2. No campo Test Case Name, digite RejectedTestCase e clique em Next. 3. Na página Select WSDL Document, expanda o nodo LoanRequestorCompositeApp Process Files, selecione LoanRequestorCompositeApp.wsdl e clique em Next. 4. Na página Select Operation to Test, selecione LoanRequestorOperation e clique em Finish.
O IDE irá adicionar um novo nodo sob o nodo Test chamado ApprovedTestCase. Esse nodo possui dois subnodos: Input e Output. 5. Altere o arquivo Input.xml, para os seguintes valores: <loan:socialsecuritynumber>222-22-2222</loan:socialsecuritynumber> <loan:applicantname>maria da Silva</loan:applicantName> <loan:applicantaddress>rua Chapeco, 456</loan:applicantAddress> <loan:applicantemailaddress> msilva@gmail.com</loan:applicantemailaddress> <loan:applicantage>15</loan:applicantage> <loan:applicantgender>female</loan:applicantgender> <loan:annualsalary>100000</loan:annualsalary> <loan:amountrequested>1000000</loan:amountrequested> 6. Feche o arquivo Input.xml e salve todas suas alterações. Para preencher o caso de teste ApprovedTestCase com informação para validação: 1. Faça um duplo clique em Output.xml no nodo ApprovedTestCase, para examinar o conteúdo desse arquivo. Veja que ele está inicialmente vazio.
2. Clique com o botão direito do mouse no nodo ApprovedTestCase, e selecione Run. Essa será uma execução especial (pois Output.xml está vazio) e o diálogo Overwrite Empty Output será exibido. 3. Clique em Yes. O IDE preenche Output.xml com informação default.
Para executar um caso de teste: 1. Clique com o botão direito do mouse no nodo ApprovedTestCase, e selecione Run. O conteúdo de Output.xml agora será preservado e utilizado para comparação. 2. Execute procedimento análogo para preencher Output.xml do nodo RejectedTestCase. Realize em seguida teste para verificar se tudo funciona corretamente (isto é, se o pedido é realmente rejeitado). 3. Salve todas as suas alterações.