[Ws Wiki] Update of "ja/axis/UsingCommandLineTools" by ToshiyukiKimura

[Apache Wiki <wi...@apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Ws Wiki" for change notification.

The following page has been changed by ToshiyukiKimura:
http://wiki.apache.org/ws/ja/axis/UsingCommandLineTools

The comment on the change is:
Axis Wiki in Japanese

New page:
##language:ja

'''はじめに'''

Axis には、新しいユーザにとって使い方がかなり基本的なコマンドラインツールがあります。これらは wsdl2java、java2wsdl、tcpmon、adminclient です。これらのツールは全て java を介して呼び出す必要があり、正しく動かすためにはかなり複雑なクラスパスを必要とします。

java [クラスパス] [クラスの完全修飾名] パラメータ

このようにしてツールを使うのはとてももどかしいです。というのもコマンドラインはとても長く、間違いやすいからです。ですからいくつかの役立つツールを作成したほうが賢いでしょう。

誰かこの unix バージョンを作成してくれませんか? - {{{AndrewPremdas}}}

'''コマンドラインツールの設定'''

これから axis 用のいくつかの便利なバッチファイルを作成します。これらをあなたのパスに入れておくとよいでしょう。以下のものを作成します。

setaxiscp - ツールが必要とするクラスパスを入れておく環境変数 AXIS_CP を設定します 
java2wsdl - java2wsdl を起動します 
wsdl2java - wsdl2java を起動します 
adminclient - adminclient を起動します 
tcpmon - tcp モニタツールを起動します 
以上の事をする前に、ツールのロギングを設定します。

'''ロギングの設定'''

全てのコマンドラインツールはロギングを持っています。ですからロギングが正しく初期化されることを保証するために簡単な log4j.properties ファイルを作成します。

# axis 用の簡単な log4j 設定 #[[BR]]
# ログメッセージを直接 stdout へ #[[BR]]
log4j.appender.stdout=org.apache.log4j.ConsoleAppender[[BR]]
log4j.appender.stdout.Target=System.out[[BR]]
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout[[BR]]
log4j.appender.stdout.layout.ConversionPattern=%d{ABSOLUTE} %5p %c{1}:%L - %m%n[[BR]]

# ここでロギングレベルを変更[[BR]]
log4j.rootLogger=info, stdout[[BR]] 
これを、これから LOG4J_PROPERTIES_HOME と定義する場所に置く必要があります。[[BR]]

'''クラスパスの設定'''

コマンドラインツールは以下の jar ファイルにアクセスする必要があります。

全ての axis jar ファイル[[BR]]
activation.jar [[BR]]
mail.jar [[BR]]
xml パーサの jarファイル [[BR]]
log4j.properties ファイル [[BR]]
ですからまずしなくてはならないことは、これらの場所へのパスを作成することです。

set AXIS_HOME=C:\lib.dir\axis-1_2beta[[BR]]
set ACTIVATION_HOME=C:\lib.dir\jaf-1.0.2[[BR]]
set MAIL_HOME=C:\lib.dir\javamail-1.3.1[[BR]]
set XML_HOME=C:\lib.dir\xalan-j_2_6_0\bin[[BR]]
set LOG4J_PROPERTIES_HOME=C:\axisUtils[[BR]]

set AXIS_LIB=%AXIS_HOME%\lib[[BR]]
次にそれぞれのライブラリへのパスを追加します。これを一度に行います。なぜならユーザガイド (http://ws.apache.org/axis/java/user-guide.html) やインストールガイド (http://ws.apache.org/axis/java/install.html#deploy) に従ってもできなかったからです。これによりタイプミスによってもたらされるいかなる問題も突き止めやすくなります。

set AXISCP=.[[BR]]
set AXISCP=%AXISCP%;%ACTIVATION_HOME%\activation.jar[[BR]]
set AXISCP=%AXISCP%;%AXIS_LIB%\axis.jar[[BR]]
set AXISCP=%AXISCP%;%AXIS_LIB%\commons-discovery.jar[[BR]]
set AXISCP=%AXISCP%;%AXIS_LIB%\commons-logging.jar[[BR]]
set AXISCP=%AXISCP%;%AXIS_LIB%\jaxrpc.jar[[BR]]
set AXISCP=%AXISCP%;%AXIS_LIB%\saaj.jar[[BR]]
set AXISCP=%AXISCP%;%AXIS_LIB%\log4j-1.2.8.jar[[BR]]
set AXISCP=%AXISCP%;%AXIS_LIB%\wsdl4j.jar[[BR]]
set AXISCP=%AXISCP%;%MAIL_HOME%\mail.jar[[BR]]
set AXISCP=%AXISCP%;%XML_HOME%\xml-apis.jar[[BR]]
set AXISCP=%AXISCP%;%XML_HOME%\xercesImpl.jar[[BR]]
次に、パスに log4j.properties の場所を追加します。[[BR]]

set AXISCP=%AXISCP%;%LOG4J_PROPERTIES_HOME%[[BR]]
これを setaxiscp.bat として保存します。完全なバージョンがこのページの一番最後にあります。

'''コマンドラインツールを呼び出す便利なツールを作成する'''

各ツールのバッチファイルを作成します。

java2wsdl.bat

  java -cp %AXISCP% org.apache.axis.wsdl.Java2WSDL %*
wsdl2java.bat

  java -cp %AXISCP% org.apache.axis.wsdl.WSDL2Java %*
adminclient.bat

  java -cp %AXISCP% org.apache.axis.client.AdminClient %*
tcpmon.bat

  java -cp %AXISCP% org.apache.axis.utils.tcpmon %*

'''使い方'''

コマンドウィンドウを開いて setaxiscp を実行すれば他のバッチファイルを使うことができます。ヘルプを見るには -h パラメータだけを渡します。

setaxiscp.bat [[BR]]
@ECHO OFF

REM Locations: Change these to match your environment[[BR]]
set AXIS_HOME=C:\lib.dir\axis-1_2beta[[BR]]
set ACTIVATION_HOME=C:\lib.dir\jaf-1.0.2[[BR]]
set MAIL_HOME=C:\lib.dir\javamail-1.3.1[[BR]]
set XML_HOME=C:\lib.dir\xalan-j_2_6_0\bin[[BR]]
set LOG4J_PROPERTIES_HOME=C:\axisUtils[[BR]]

set AXIS_LIB=%AXIS_HOME%\lib[[BR]]

REM Create the class path[[BR]]
set AXISCP=.[[BR]]
set AXISCP=%AXISCP%;%ACTIVATION_HOME%\activation.jar[[BR]]
set AXISCP=%AXISCP%;%AXIS_LIB%\axis.jar[[BR]]
set AXISCP=%AXISCP%;%AXIS_LIB%\commons-discovery.jar[[BR]]
set AXISCP=%AXISCP%;%AXIS_LIB%\commons-logging.jar[[BR]]
set AXISCP=%AXISCP%;%AXIS_LIB%\jaxrpc.jar[[BR]]
set AXISCP=%AXISCP%;%AXIS_LIB%\saaj.jar[[BR]]
set AXISCP=%AXISCP%;%AXIS_LIB%\log4j-1.2.8.jar[[BR]]
set AXISCP=%AXISCP%;%AXIS_LIB%\wsdl4j.jar[[BR]]
set AXISCP=%AXISCP%;%MAIL_HOME%\mail.jar[[BR]]
set AXISCP=%AXISCP%;%XML_HOME%\xml-apis.jar[[BR]]
set AXISCP=%AXISCP%;%XML_HOME%\xercesImpl.jar[[BR]]

ECHO set up classpath[[BR]]

REM set logging to the console using log4j[[BR]]
set AXISCP=%AXISCP%;%LOG4J_PROPERTIES_HOME%[[BR]]

ECHO initialised logging

ECHO Should now be able to call[[BR]]
ECHO     adminclient, tcpmon, wsdl2java, java2wsdl /axis/ja.[[BR]]