Stock Quote - Configurar e Executar


Configurando a Amostra
Executando a Amostra

Há dois clientes de Stock Quote, uma versão J2SE (Java 2 Standard Edition) e uma versão gerenciada por contêiner J2EE (Java 2 Enterprise Edition). Se você deseja aproveitar ao máximo os serviços do contêiner J2EE, execute a versão J2EE.

Configurando a Amostra

Para concluir a configuração dessa amostra, implemente o aplicativo de amostra de serviços da Web do JAX-WS no servidor. Se o aplicativo de amostra ainda não foi implementado, consulte as instruções para Reconstruir e Implementar o Arquivo WebServicesSamples.ear.

Executando a Amostra

Verifique se o servidor foi iniciado antes de executar os clientes.

A Amostra Stock Quote consiste em dois clientes e um único bean corporativo implementado no servidor. Um deles é um cliente simples J2SE. Você pode localizá-lo em um programa denominado GetQuote. O outro é um cliente J2EE (Java 2 Enterprise Edition). Você pode localizá-lo no GetQuoteClient.jar.

Executando o Cliente Simples J2SE Stock Quote
Executando o Cliente Aplicativo J2EE Stock Quote

Clientes de Stock Quote

Os clientes de Stock Quote consultam o bean corporativo StockQuote para recuperar cotações de ações atuais da Web. O serviço da Web StockQuote pode retornar um valor fixo ou cotações de ações atuais se uma conexão com a Internet estiver disponível. O primeiro argumento para os clientes de Stock Quote é a URL do nó de extremidade de destino, que especifica o serviço da Web a ser utilizado. O segundo argumento é o símbolo de ação. Você pode utilizar um valor XXX para obter o preço fixo sem utilizar uma conexão com a Internet.

Executando o Cliente Simples J2SE de Stock Quote

O cliente J2SE de Stock Quote não é gerenciado por contêiner.

Para obter mais instruções gerais sobre como chamar o cliente J2SE do WebSphere, consulte o tópico sobre desenvolvimento do código do Thin Application Client no InfoCenter.

Para executar o cliente simples J2SE de Stock Quote a partir de um WebSphere Application Server, execute as seguintes etapas com base no sistema operacional:

  1. Inicie o servidor.
  2. Abra um prompt de comandos.
  3. Emita os seguintes comandos:

    Em plataformas Windows:

    cd raiz_do_perfil\bin
    setupCmdLine
    cd raiz_da_instalação\bin
    setupCmdLine

    Em plataformas Linux, UNIX e z/OS:

    cd raiz_do_perfil/bin
    . ./setupCmdLine.sh
    cd raiz_da_instalação/bin
    . ./setupCmdLine.sh

    Em plataformas iSeries:

    cd raiz_do_perfil/bin
    . ./setupCmdLine
    cd raiz_da_instalação/bin
    . ./setupCmdLine

  4. Emita o seguinte comando:

    Em plataformas Windows:

    "%JAVA_HOME%\bin\java" %WAS_LOGGING% -classpath "%WAS_CLASSPATH%;%WAS_HOME%\samples\lib\WebServicesSamples\simpleClients.jar;%WAS_HOME%\runtimes\com.ibm.ws.webservices.thinclient_7.0.0.jar" samples.stock.GetQuote <URL> <símbolo>

    Em plataformas Linux, UNIX e z/OS:

    "$JAVA_HOME/bin/java" $WAS_LOGGING -classpath "$CLASSPATH:$WAS_CLASSPATH:$WAS_HOME/samples/lib/WebServicesSamples/simpleClients.jar:$WAS_HOME/runtimes/com.ibm.ws.webservices.thinclient_7.0.0.jar" samples.stock.GetQuote <URL> <símbolo>

    Em plataformas iSeries:

    java $JAVA_PARM -classpath "$CLASSPATH:$WAS_CLASSPATH:$WAS_HOME/samples/lib/WebServicesSamples/simpleClients.jar:$WAS_HOME/runtimes/com.ibm.ws.webservices.thinclient_7.0.0.jar" samples.stock.GetQuote <URL> <símbolo>

    em que:
    <A URL> é o endereço do nó de extremidade de serviço http://<host_name>:<porta>/StockQuote/services/xmltoday-delayed-quotes em que <host_name> é o nome do host (padrão é localhost) e <porta> é o número da porta (padrão é 9080).
    <símbolo> é um símbolo de estoque

    Execuções bem-sucedidas do cliente de Stock Quote no Windows exibem a seguinte saída:

    C:\>"%JAVA_HOME%\bin\java" %WAS_LOGGING% -classpath "%WAS_CLASSPATH%;%WAS_HOME%\samples\lib\WebServicesSamples\simpleClients.jar;%WAS_HOME%\runtimes\com.ibm.ws.webservices.thinclient_7.0.0.jar" samples.stock.GetQuote http://localhost:9080/StockQuote/services/xmltoday-delayed-quotes XXX
    XXX: 55.25
     
    C:\>"%JAVA_HOME%\bin\java" %WAS_LOGGING% -classpath "%WAS_CLASSPATH%;%WAS_HOME%\samples\lib\WebServicesSamples\simpleClients.jar;%WAS_HOME%\runtimes\com.ibm.ws.webservices.thinclient_7.0.0.jar" samples.stock.GetQuote http://localhost:9080/StockQuote/services/xmltoday-delayed-quotes DELL
    DELL: 23.67
     
    

Executando o Cliente Aplicativo J2EE de Stock Quote

O GetQuoteClient.jar do aplicativo J2EE é uma versão gerenciada por contêiner do cliente de Stock Quote.

Nas etapas seguintes, a variável raiz_da_instalação refere-se à raiz de instalação do WebSphere.

Para executar o cliente aplicativo J2EE de Stock Quote a partir de um WebSphere Application Server, execute as seguintes etapas com base em seu sistema operacional:

  1. Inicie o servidor.
  2. Abra um prompt de comandos.
  3. Digite os seguintes comandos:

    Em plataformas Windows:

    cd <raiz_do_perfil>\bin
    setupCmdLine

    Nas plataformas Linux, UNIX e z/OS:

    cd <raiz_do_perfil>/bin
    . ./setupCmdLine.sh

    Em plataformas iSeries:

    cd <raiz_do_perfil>/bin
    . ./setupCmdLine

    em que <raiz_do_perfil> representa o diretório de instalação do perfil.
  4. Mude para o diretório raiz_da_instalação/samples/lib/WebServicesSamples
    em que:
    raiz_da_instalação é a raiz de instalação do WebSphere Application Server ou a raiz de instalação do perfil caso a Amostra seja reconstruída.
  5. Emita o seguinte comando:

    Nas plataformas Windows:

    <raiz_da_instalação>\bin\launchClient ApplicationClients.ear -CCjar=GetQuoteClient.jar [<URL>] <símbolo>

    Em plataformas Linux, UNIX e z/OS:

    <raiz_da_instalação>/bin/launchClient.sh ApplicationClients.ear -CCjar=GetQuoteClient.jar [<URL>] <símbolo>

    Em plataformas iSeries:

    <raiz_da_instalação>/bin/launchClient ApplicationClients.ear -CCjar=GetQuoteClient.jar [<URL>] <símbolo>

    em que:
    <A URL> é o endereço do nó de extremidade de serviço http://<host_name>:<porta>/StockQuote/services/xmltoday-delayed-quotes em que <host_name> é o nome do host (padrão é localhost) e <porta> é o número da porta (padrão é 9080).
    <símbolo> é um símbolo de estoque

    O exemplo a seguir mostra duas execuções bem-sucedidas do cliente J2EE do aplicativo de stock quote:

    C:\WebSphere\AppServer\samples>\WebSphere\AppServer\bin\launchClient \WebSphere\AppServer\samples\lib\WebServicesSamples\ApplicationClients.ear -CCjar=GetQuoteClient.jar IBM
    IBM WebSphere Application Server, Release 7.0
    J2EE Application Client Tool
    Copyright IBM Corp., 1997-2008
    WSCL0012I: Processando argumentos da linha de comandos.
    WSCL0013I: Inicializando o J2EE Application Client Environment.
    [3/29/06 14:55:22:359 CST] 0000000a  W UOW=null source=com.ibm.ws.ssl.config.SSLConfig org=IBM prod=WebSphere component=Application Server thread=[P=720609:O=0:CT]
              CWPKI0041W: Um ou mais armazenamentos de chaves estão utilizando a senha padrão.
    WSCL0035I: A inicialização do Ambiente do J2EE Application Client foi concluída.
    WSCL0014I: Chamando o Aplicativo Cliente class com.ibm.websphere.samples.webservices.stockClient.GetQuote
    IBM: 83.36
     
    C:\WebSphere\AppServer\samples>\WebSphere\AppServer\bin\launchClient \WebSphere\AppServer\samples\lib\WebServicesSamples\ApplicationClients.ear -CCjar=GetQuoteClient.jar XXX
    IBM WebSphere Application Server, Release 7.0
    J2EE Application Client Tool
    Copyright IBM Corp., 1997-2008
    WSCL0012I: Processando argumentos da linha de comandos.
    WSCL0013I: Inicializando o J2EE Application Client Environment.
    [3/29/06 15:00:04:062 CST] 0000000a  W UOW=null source=com.ibm.ws.ssl.config.SSLConfig org=IBM prod=WebSphere component=Application Server thread=[P=2171:O=0:CT]
              CWPKI0041W: Um ou mais armazenamentos de chaves estão utilizando a senha padrão.
    WSCL0035I: A inicialização do Ambiente do J2EE Application Client foi concluída.
    WSCL0014I: Chamando o Aplicativo Cliente class com.ibm.websphere.samples.webservices.stockClient.GetQuote
    XXX: 55.25
      

Você pode obter informações adicionais sobre como o cliente e o aplicativo funcionam, consultando as Notas Técnicas sobre Stock Quote e visualizando o código-fonte Java.