Stock Quote - Настройка и запуск


Настройка примера
Запуск примера

Клиенты Stock Quote представлены в двух версиях - для Java 2 Standard Edition (J2SE) и Java 2 Enterprise Edition (J2EE), управляемой контейнером. Для применения всех возможностей контейнеров J2EE выберите вторую.

Настройка примера

Для настройки примера установите приложение, демонстрирующее применение Web-служб JAX-RPC, на сервере. Инструкции приведены в разделе Перекомпоновка и развертывание файла WebServicesSamples.ear.

Запуск примера

Перед запуском примера необходимо убедиться в том, что сервер для его выполнения запущен.

Пример Stock Quote состоит из двух клиентов и объекта EJB, развертываемого на сервере. Первый из них - простой клиент J2SE. Его можно найти в программе GetQuote. Второй - клиент Java 2 Enterprise Edition (J2EE). Его можно найти в GetQuoteClient.jar.

Запуск клиента J2SE Stock Quote
Запуск клиента Stock Quote для J2EE

Клиенты Stock Quote

Клиенты Stock Quote обращаются к объекту EJB StockQuote для получения текущих биржевых котировок из Internet. Если соединение с Internet недоступно, Web-служба StockQuote возвращает статические данные. В качестве первого аргумента клиенту Stock Quote необходимо задавать URL конечной точки, определяющий используемую Web-службу. В качестве второго аргумента указывается идентификатор биржи. Для получения статических цен без использования Internet укажите XXX.

Запуск простого клиента J2SE Stock Quote

Клиент для J2SE не является управляемым контейнером.

Общие инструкции по запуску клиента J2SE WebSphere содержатся в разделе о разработке простого клиента в InfoCenter.

Для запуска простого клиента J2SE из WebSphere Application Server выполните следующие действия, в зависимости от используемой операционной системы:

  1. Запустите сервер приложений.
  2. Откройте окно командной строки.
  3. Введите следующие команды:

    Платформы Windows:

    cd каталог-профайла\bin
    setupCmdLine
    cd установочный-каталог\bin
    setupCmdLine

    Платформы Linux, UNIX и z/OS:

    cd каталог-профайла/bin
    . ./setupCmdLine.sh
    cd установочный-каталог/bin
    . ./setupCmdLine.sh

    Платформы iSeries:

    cd каталог-профайла/bin
    . ./setupCmdLine
    cd установочный-каталог/bin
    . ./setupCmdLine

  4. Запустите следующую команду:

    Платформы 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> <символ>

    Платформы Linux, UNIX и 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> <символ>

    Платформы 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> <символ>

    где:
    <URL> - адрес конечной точки службы в форме http://<хост>:<порт>/StockQuote/services/xmltoday-delayed-quotes, где <хост> - имя хоста (значение по умолчанию - localhost) и <порт> - номер порта для соединения (значение по умолчанию - 9080).
    <идентификатор> - идентификатор биржи

    Ниже приведен пример вывода клиента Stock Quote в Windows, завершившего работу без ошибок:

    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
     
    

Запуск клиента Stock Quote для J2EE

Приложение J2EE GetQuoteClient.jar - клиент Stock Quote, управляемый контейнером.

В инструкциях ниже установочный-каталог следует заменить на каталог установки WebSphere.

Для запуска клиента J2EE Stock Quote из WebSphere Application Server выполните следующие действия, в зависимости от используемой операционной системы:

  1. Запустите сервер приложений.
  2. Откройте окно командной строки.
  3. Введите следующие команды:

    Платформы Windows:

    cd <каталог-профайла>\bin
    setupCmdLine

    Платформы Linux, UNIX и z/OS:

    cd <каталог-профайла>/bin
    . ./setupCmdLine.sh

    Платформы iSeries:

    cd <каталог-профайла>/bin
    . ./setupCmdLine

    где <каталог-профайла> - каталог, в котором установлен профайл.
  4. Перейдите в каталог установочный-каталог/samples/lib/WebServicesSamples
    Где:
    установочный-каталог - каталог установки WebSphere Application Server или профайла, в случае перекомпоновки примера.
  5. Введите следующие команды:

    Платформы Windows:

    <установочный-каталог>\bin\launchClient ApplicationClients.ear -CCjar=GetQuoteClient.jar [<URL>] <идентификатор>

    Платформы Linux, UNIX и z/OS:

    <установочный-каталог>/bin/launchClient.sh ApplicationClients.ear -CCjar=GetQuoteClient.jar [<URL>] <идентификатор>

    Платформы iSeries:

    <установочный-каталог>/bin/launchClient ApplicationClients.ear -CCjar=GetQuoteClient.jar [<URL>] <идентификатор>

    где:
    <URL> - адрес конечной точки службы в форме http://<хост>:<порт>/StockQuote/services/xmltoday-delayed-quotes, где <хост> - имя хоста (значение по умолчанию - localhost) и <порт> - номер порта для соединения (значение по умолчанию - 9080).
    <идентификатор> - идентификатор биржи

    Ниже приведен пример вывода клиента J2EE для 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, выпуск 7.0
    J2EE Application Client Tool
    Copyright IBM Corp., 1997-2008
    WSCL0012I: Processing command line arguments.
    WSCL0013I: Initializing the 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: One or more key stores are using the default
    password.
    WSCL0035I: Initialization of the J2EE Application Client Environment has
    completed.
    WSCL0014I: Invoking the Application Client 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, выпуск 7.0
    J2EE Application Client Tool
    Copyright IBM Corp., 1997-2008
    WSCL0012I: Processing command line arguments.
    WSCL0013I: Initializing the 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: One or more key stores are using the default
    password.
    WSCL0035I: Initialization of the J2EE Application Client Environment has
    completed.
    WSCL0014I: Invoking the Application Client class com.ibm.websphere.samples.webservices.stockClient.GetQuote
    XXX: 55.25
      

Более детальная информация о том, каким образом работают клиент и приложение, содержится в комментариях к Stock Quote, кроме того доступен исходный код Java.