Construir as classes cliente - Módulo de Invocação

Módulo de Invocação

Passo 3: Construir as classes cliente

A construção das classes cliente consiste em invocar o comando “build” do script build.xml. Seu objetivo é gerar as classes necessárias para executar o utilitário do lado do cliente.

O comando “build” aciona outros comandos básicos, que executados em conjunto, realizam as tarefas necessárias para construir toda a infra-estrutura para o cliente invocar o serviço.

<target name="build"

depends="prepare,generate-testcases, generate-axis,generate-jwsdp,

generate-systinet, copy-files,compile">

Figura 5.8 - Comando para construir as classes clientes

O comando “build” é responsável pela invocação, nessa ordem, dos comandos “prepare”, “generate-testcases”, “generate-axis”, “generate-jwsdp”, “generate-systinet”, “copy-files” e “compile” (Figura 5.8), que também podem ser executados separadamente. As próximas subseções apresentam as tarefas realizadas por cada um desses comandos.

Tarefa 1: Preparando o diretório build

Essa tarefa consiste em invocar o comando “prepare” (Figura 5.9), que é responsável por limpar todo o conteúdo dentro do diretório “build” e, novamente, criar todos os seus subdiretórios – classes, src, generate e testcase.

Embora seja um comando simples, o mesmo é importante para garantir ao desenvolvedor que nenhum outro arquivo, gerado em execuções anteriores, seja utilizado erradamente. <target name="prepare"> <delete dir="${build.dir}" /> <mkdir dir="${build.dir}" /> <mkdir dir="${build.src.dir}" /> <mkdir dir="${build.classes.dir}" /> <mkdir dir="${build.generate.dir}" /> <mkdir dir="${build.testcase.dir}" /> </target>

Tarefa 2: Gerando as classes de teste

Essa tarefa consiste em invocar o comando “generate-testcases” para gerar as classes que serão usadas para invocar as operações do serviço Web Services. Esse comando foi definido para automatizar a execução do módulo de geração das classes de teste e apenas é executado quando o desenvolvedor habilita a propriedade “generate-testcase” do arquivo jwsperf.xml, que indiretamente torna a propriedade “generate.testcase.present” verdadeira.

Figura 5.10 - Comando para gerar as classes de teste

A Figura 5.10 ilustra as tarefas realizadas por esse comando. As mesmas consistem em copiar para o diretório “build/testcase” apenas os arquivos fontes que compõem o módulo de geração das classes de teste, a fim de serem compilados. Antes de executar esse módulo invocando a classe WSDLParser, as classes de teste geradas em

execuções anteriores são apagadas.

O código resultante da execução desse comando depende da configuração da propriedade “toolkit” do arquivo jwsperf.xml. Além do toolkit, também são informados a localização do arquivo WSDL, o pacote das classes geradas e o diretório para armazená-las.

Tarefa 3: Construindo com o toolkit Axis

Essa tarefa consiste em invocar o comando “generate-axis”, porém o mesmo apenas é executado se o desenvolvedor tiver configurado a propriedade “toolkit” para usar o Axis. Caso contrário, essa tarefa não será executada, porque a propriedade “axis.toolkit” será falsa.

Figura 5.11 - Comando para gerar as classes usando o toolkit Axis

O objetivo é invocar a classe WSDL2Java do toolkit Axis para gerar as classes

específicas desse toolkit. A partir da Figura 5.11, verifica-se que os parâmetros para executar essa classe são a localização do arquivo WSDL (“${wsdl.uri}”), o diretório raiz para armazenar as classes geradas (“${build.generate.dir}”) e o pacote que todos os

namespaces do arquivo WSDL deverão ser mapeados (“${stub.package}”). O valor

padrão das propriedades “${build.generate.dir}” e “${stub.package}” são “build\generate” e “br.ufpe.cin.jwsperf.communication.ws”, respectivamente.

Tarefa 4: Construindo com o toolkit JWSDP

De forma semelhante à anterior, essa tarefa apenas é executada quando o toolkit JWSDP estiver configurado. O objetivo do comando “generate-jwsdp” é gerar os artefatos do cliente específicos desse toolkit usando a sua ferramenta WSCompile.

<wscompile keep="true" client="true"

base="${build.generate.dir}" config="${jwsdp.config.file}"> <classpath> <path refid="jwsdp.classpath"/> </classpath> </wscompile> </target>

WSCompile é uma ferramenta simples e foi projetada para obter a localização da interface WSDL a partir do arquivo de configuração “${jwsdp.config.file}” (Figura 5.12). O nome padrão desse arquivo é config.xml e está localizado no diretório “config\xmls”. Além do arquivo WSDL, a ferramenta também lê desse arquivo o atributo “packageName”, que especifica o pacote das classes geradas e seu valor está configurdo na configurado na propriedade “${stub.package}”.

Analisando a Figura 5.12, verifica-se que o comando “wscompile” apenas deve gerar os artefatos do lado do cliente (cliente=“true”), manter os arquivos gerados (keep=“true”) e armazená-los no diretório indicado pelo parâmetro base=“${build.generate.dir}”.

Tarefa 5: Construindo com o toolkit SSJ

Quando o toolkit SSJ é configurado, o comando “generate-systinet” é executado e as classes do cliente SSJ são geradas usando a ferramenta de linha de comando WSDL2Java disponibilizada pelo próprio toolkit. Semelhantemente aos comandos anteriores, as classes cliente também são geradas a partir da interface WSDL indicada pelo parâmetro wsdlURL=“${wsdl.uri}” (Figura 5.13).

Figura 5.13 - Comando para gerar as classes usando o toolkit SSJ

Além da interface WSDL, também são passados como parâmetro o diretório onde as classes serão geradas (outputDirectory=“${build.generate.dir}"), seu pacote (interfacePackage="${stub.package}") e as propriedades indicando que as classes devem ser sobrescritas a cada execução (force="true") e devem ser geradas seguindo o padrão JavaBeans (generateJavaBeans=“true”) e o esquema definido no arquivo WSDL (strictSchema="true").

Tarefa 6: Copiando as classes geradas

Essa tarefa consiste em executar o comando “copy-files” (Figura 5.14) que copia para o diretório “build/src” todas as classes que compõem o módulo de invocação, as classes de teste geradas a partir do comando “generate-testcases” e as classes clientes específicas dos toolkits geradas pelos comandos “generate-axis”, “generate-jwsdp” ou “generate-systinet”.

Figura 5.14 - Comando para copiar as classes geradas

Tarefa 7: Compilando as classes

O comando “compile” (Figura 5.15) compila todos os arquivos Java gerados e os arquivos fontes do próprio utilitário, ambos armazenados no diretório “build/src”. Os arquivos resultantes da compilação são armazenados no diretório “build/classes”. Esse passo pode ser executado separadamente, caso as classes de teste geradas sejam alteradas para montar os objetos que serão passados como parâmetro,

No documento Diretrizes e um utilitário para avaliação de desempenho de toolkits web services (páginas 91-97)