tomcatの最近のブログ記事

サービス→クライアントへの応答をgzipで圧縮し、転送量を小さく。
大雑把には以下の通り。
  • クライアント
    • HTTPヘッダにAccept-Encoding: gzipをつけて要求を投げる。
    • 応答がContent-Encoding: gzipの場合に、帰ってきた応答を伸張する
  • サービス側(必ずしもサービス自身が担当するわけではなく)
    • 要求のHTTPヘッダにAccept-Encoding: gzipが含まれる場合、HTTP応答本文をgzipで圧縮して返す
前提とする環境は、サーバ側=Tomcat+AxisでApache+mod_jk。
最も手数の少ない方法は、
  • クライアント=.NET Framework 2.0(手元の環境をVS2005にしたのでもうこれしか確認できない)
  • サービスの応答がクライアントに帰る直前、要はmod_deflateを用いて圧縮する
というところか。Tomcat→Apache間のメッセージが圧縮されないのがイマイチだが、TomcatのFilterを用いて圧縮する方法で実現しようと思ったらやたら手数が多かったから・・・・。servlets-examplesにサンプルが付いているけど、十分複雑だよ。。。)

クライアント編

  • Web参照から生成したコードで、サービス呼び出しのスタブにあるEnableDecompressionプロパティにtrueをセットして呼び出すだけ。すばらしいシンプルさ。(06/03/01:と思ったらドキュメントによれば既定値trueらしい。あらら)
  • 後は、Accept-Encodingを付けることもHTTP応答本文を伸張することも.NET Frameworkがやってくれる。

サーバ編

  • 以下の通り、JkMountでApache→Tomcatに転送しているので、転送範囲の応答はmod_defalteで圧縮しちゃう。今のところウェブサービス以外のリソースはないのでブラウザのことは考えないで圧縮指定。
    JkMount /KeitaisoWS/services/KeitaisoKaisekiService* ajp13

    <Location "/KeitaisoWS/">
    AddOutputFilterByType DEFLATE text/html text/plain text/xml
    </Location>
  • あとはSIGHUPを送るなどして設定を有効に。

応答を見てみる

見てみると言っても、クライアントコードがメッセージを受け取った時点で伸張されていてシームレスなので、通信内容をパケットキャプチャして確認する。
  • 応答圧縮を受け入れない場合
    ≫POST /KeitaisoWS/services/KeitaisoKaisekiService HTTP/1.1
    ≫User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; MS Web Services Client Protocol 2.0.50727.42)
    ≫Content-Type: text/xml; charset=utf-8
    ≫SOAPAction: ""
    ≫Host: passing.breeze.cc
    ≫Content-Length: 557
    ≫Expect: 100-continue
    ≫Connection: Keep-Alive

    ≫HTTP/1.1 100 Continue

    ≫(要求本文)
    ≪HTTP/1.1 200 OK
    ≪Date: Mon, 27 Feb 2006 17:32:20 GMT
    ≪Server: Apache
    ≪Vary: Accept-Encoding
    ≪Connection: close
    ≪Transfer-Encoding: chunked
    ≪Content-Type: text/xml;charset=utf-8

    ≪(以下応答)

  • 応答圧縮を受け入れる場合
    ≫POST /KeitaisoWS/services/KeitaisoKaisekiService HTTP/1.1
    ≫User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; MS Web Services Client Protocol 2.0.50727.42)
    ≫Content-Type: text/xml; charset=utf-8
    ≫SOAPAction: ""
    ≫Host: passing.breeze.cc
    ≫Content-Length: 557
    ≫Expect: 100-continue
    Accept-Encoding: gzip

    ≪HTTP/1.1 100 Continue

    ≫(要求本文)
    ≪HTTP/1.1 200 OK
    ≪Date: Mon, 27 Feb 2006 17:32:30 GMT
    ≪Server: Apache
    ≪Vary: Accept-Encoding
    Content-Encoding: gzip
    ≪Connection: close
    ≪Transfer-Encoding: chunked
    ≪Content-Type: text/xml;charset=utf-8

    ≪(圧縮された応答)
  • 今回の例では、約8000バイトの応答が、約2000バイトになった。

おわりに

次はAxisクライアントで同じことをやってみようと思うが、client-config.wsddでhttpトランスポートを置き換えないとダメなのかな?と考えただけで、面倒くせぇ~という気分になるな。
アクセス解析をapacheのログとまとめて行えると便利なので、コネクタを利用してapache→Tomcatへの接続ルートを用意する。 ウチのサーバの場合、外に公開するのはNAT内のapache(TCP:80)だけにしておきたいので、Tomcat(TCP:8080)を野ざらしにしない意味もある。

mod_jk

  • Apache Tomcat - Apache Tomcatから、トップ→[Download/Tomcat Connectors]。
  • JKをダウンロードする。今回使用したのは「JK 1.2.15 Source Release tar.gz」
  • アーカイブを適当な場所に展開してビルドする。このエントリは事後に書いているので細かいことは忘れてしまったが、たぶん下のような感じ。
    > ./configure --with-apxs=/usr/sbin/apxs
    > make
  • できあがった「mod_jk.so」をapacheのmodule置き場に配置し、confにモジュールのロードとログの設定を書く。/etc/httpd/conf.d/tomcat.conf
    LoadModule jk_module modules/mod_jk.so
    JkLogFile /var/log/httpd/mod_jk.log
    JkLogLevel info
  • ウチのサーバの場合、仮想ホスト運用しているので、必要なVirtualHostディレクティブ内にJKのマウント設定を書く。何もかも外に出す必要はないので最低限の範囲で。そうしないとAdminServiceへも外からアクセスできてしまう。
    JkMount /KeitaisoWS/services/KeitaisoKaisekiService* ajp13

起動

  • apache→TomcatへTCPセッションが張られるので、Tomcatが先に起動している必要があるみたいだ。
  • Tomcatを再起動した場合、apacheにSIGHUPを送るなどして再接続が必要。これってapacheが先に起動していた場合でもセッションが確立していなかったら改めて接続を試みる、みたいな動きに出来ないのかな。。
  • ブラウザから、http://passing.breeze.cc/KeitaisoWS/services/KeitaisoKaisekiService?wsdl にアクセスしてコネクタが働いているか確認する。
  • ブラウザから、http://passing.breeze.cc/KeitaisoWS/ にアクセスしてコネクタが働いていないことを確認する。
ここまででローカルPC内でウェブサービスクライアント~サービス間の疎通を行うことが出来た。
今度はサービスプロバイダを実際にサービスを公開するサーバに載せる。
今回使用したサーバは、OS=FedoraCore3、Java=JDK5.0 update5を使用している。

導入

  • Windows上で環境構築した際に使用したzipアーカイブをlinux上でどしどし展開する。
    • /home/
      • apache-tomcat-5.5.15/
      • apache-tomcat/ (シンボリックリンク)
      • sen-1.2.1/
      • sen/ (シンボリックリンク)
  • senについては、プロジェクトのホームページからダウンロードしたアーカイブでなくて、Windows上で「辞書の準備」までした状態当該ディレクトリをアーカイブし、そのままサーバ上に展開すると、辞書を改めて用意しなくていいので手間が省ける。

Tomcat

  • ウェブアプリからsenを実行できるようにするため、conf/catalina.propertiesに以下の内容を追記する。
    sen.home=/home/sen
  • bin/startup.shを実行して起動。

デプロイ

  • こんな感じのターゲットで、ローカルの資産をWARに固めてTomcatにデプロイする。そのまま、Axisでのデプロイも行って、サービスを登録する。
    リモートからサービスをデプロイするには(AdminServiceを使うには)、server-config.wsddでenableRemoteAdminをtrueにしておく必要がある。org.apache.axis.utils.Adminを用いてserverサイドのconfigを「ローカルで」生成し、これを雛形にしてリモートAdminを有効にした状態で、WebContent/WEB-INF/sever-config.wsddとして放り込んだ。で、そのままTomcatにデプロイしてAdminClientからサービスをデプロイ、とゆー、大雑把な手段。。。
    <taskdef resource="axis-tasks.properties" />
    <taskdef name="deploy" classname="org.apache.catalina.ant.DeployTask"/>
    <taskdef name="undeploy" classname="org.apache.catalina.ant.UndeployTask"/>
    
    <property name="dist" value="./dist" />
    <property name="web" value="./WebContent" />
    <property name="war" value="KeitaisoWS.war" />
      
    <target name="deploy_ws" depends="deploy2server">
        <axis-admin
            port="8080"
            hostname="passing.breeze.cc"
            failonerror="true"
            servletpath="/KeitaisoWS/services/AdminService"
            xmlfile="./src/cc/breeze/ws/keitaiso/deploy.wsdd"
            username="AdminServiceを使うためのユーザ。user.lstに書いておく"
            password="パスワード"
        />
    </target>
    
    
    <target name="make_war">
        <delete dir="${dist}" />
        <mkdir dir="${dist}"/>
        <mkdir dir="${dist}/WEB-INF"/>
        <mkdir dir="${dist}/WEB-INF/classes"/>
        <mkdir dir="${dist}/WEB-INF/lib"/>
        <copy todir="${dist}">
            <fileset dir="${web}">
                <include name="**/*.*"/>
                <exclude name="**/*.java"/>
                <exclude name="**/jsp_servlet/*.class"/>
                <exclude name="**/build.xml"/>
                <exclude name="**/build.properties"/>
            </fileset>
        </copy>
        <copy todir="${dist}/WEB-INF/classes">
            <fileset dir="build/classes">
                <include name="**/*.*"/>
                <exclude name="**/jsp_servlet/*.class"/>
                <exclude name="**/*.java"/>
                <exclude name="**/*.wsdd"/>
            </fileset>
        </copy>
    </target>
    
    
      
    <target name="deploy2server" depends="make_war,undeploy" >
        <delete file="${war}" failonerror="false" />
        <jar jarfile="${war}" basedir="${dist}" manifest="${dist}/META-INF/MANIFEST.MF"/>    
        <deploy url="http://passing.breeze.cc:8080/manager"
            username="Tomcatのmanagerを使うためのユーザ"
            password="パスワード"
            path="/KeitaisoWS"
            war="${war}"
        />
    </target>
    
    
    <target name="undeploy">
        <undeploy url="http://passing.breeze.cc:8080/manager"
            username="Tomcatのmanagerを使うためのユーザ"
            password="パスワード"
            path="/KeitaisoWS"
            failonerror="false"
            />
    </target>
    
    		
  • Tomcatのmanagerを使うためのユーザは、サーバ側Tomcat導入ディレクトリのconf/tomcat-users.xmlに書いておく。
  • ブラウザからhttp://passing.breeze.cc:8080/managaer/htmlにアクセスしてTomcatに配備されたか確認する。
  • ブラウザからhttp://passing.breeze.cc:8080/KeitaisoWS/ →「リスト」にアクセスしてサービスが配備されたか確認する。
ここまでで、ローカル動作のTomcat上で動くウェブサービスを配備できているはず。
コアロジックの確認はしたものの、あくまで単一のJavaコード内に閉じていた。SOAP経由での疎通確認用ウェブサービスクライアントを作成する。

プロジェクト準備

  • プロジェクトを作成する。
    1. [ファイル]-[新規]-[プロジェクト]から、「/Java/Javaプロジェクト」を選択
      • この時点で作るクライアントはまだサービス利用者の立場で作成するわけではなくサービスの疎通確認用の意味合い。ゆえにインタフェース変更のセンもまだまだ捨てきれず、「/Webサービス/Webサービス・クライアント」ウィザードで作ってしまうと再度クライアントコードを生成するのが手間なのでplainなJavaプロジェクトを用いる。
    2. プロジェクト名を適当につけてプロジェクト作成。
  • Axisのライブラリを参照できるようにする
    1. プロジェクトのプロパティ→「/Javaのビルド・パス」→「ライブラリ」タブへ移動
    2. 「ライブラリーの追加」ボタン→「ユーザー・ライブラリ」を選択
    3. Axis導入時に設定した「AXIS_LIB」を選択

クライアントコード生成

  • WSDLからJavaコードを生成する。TomcatにデプロイされたWSDLを参照するのではなくローカルに生成したWSDLを直接参照する。前項同様、これから先WSDLを作り直すセンがまだあり得るので、デプロイしないでローカルでどんどん試せる方がよいと思う。
    <taskdef resource="axis-tasks.properties" />
    <target name="make_client_hinagata">
        <wsdl2java
            serverside = "no"
            output = "./src"
            url = "../KeitaisoWS/WebContent/wsdl/KeitaisoKaiseki.wsdl"
            deployscope="application"
        />
    </target>
    	
  • 生成した後は例のごとく「パッケージエクスプローラ」上で「更新」を忘れないようにする。既存のファイルの内容が更新されるだけであれば問題ないが、ファイルが増えたり減ったりした場合は明示的にプロジェクトに追加された状態を作らなければならない。これってAntタスクで書けないのかなー。

実装

  • サービスを呼び出すためのコードはWSDLから生成されているので、これを利用するコードを書く
  • 単純な例。
    public static void main(String[] args) throws Exception {
        KeitaisoKaiseki binding;
        try {
            binding = new KeitaisoKaisekiServiceLocator().getKeitaisoKaisekiService();
        } catch (javax.xml.rpc.ServiceException e) {
            throw new Exception( "" , e );
        }
    
        try {
            KeitaisoToken[] result = null;
            result = binding.analyze("やっとここまで来ましたね。");
    
            for (int i = 0; i < result.length; i++) {
                KeitaisoToken token = result[i];
                System.out.println(token.getToken() + ","
                        + token.getBasicString() + "," + token.getHinshi()
                        + "," + token.getReading() + ","
                        + token.getPronunciation());
            }
        } catch (java.rmi.RemoteException e) {
            throw new Exception( "" , e );
        }
    }
    
    		
  • サービスのバインディングを得る際、URLオブジェクトを渡すことで任意の場所にあるサービスにバインドできる。デフォルトではWSDLに書かれたURL。WSDLには最終的にサービスを公開するURLを書いてあるので、疎通用にバインドする。
    URL url = new URL("http://localhost:8080/KeitaisoWS/services/KeitaisoKaisekiService");
    binding = new KeitaisoKaisekiServiceLocator().getKeitaisoKaisekiService( url );
不明点が多いだけに、これから先もTry&Errorを繰り返すことになるはず。
繰り返されることを前提とした手順を検討する。
  1. サービスのInterfaceとやり取りするデータの入れ物を作成する。このとき、最終的な出来上がりとはパッケージを分けておく。
  2. インタフェースからWSDLを生成する。
  3. 生成したWSDLからサーバサイドのコードを生成する。
  4. 生成されたコード中の実装すべき部分を実装する。
  5. デプロイしないで、ローカルで完結し動作するまで繰り返す。
  6. サーバにデプロイして動作確認する。
  • cc.breeze.ws.keitaiso.prototype:Interfaceとデータの入れ物
    • KeitaisoToken.java([1]手書き)
    • KeitaisoKaiseki.java([1]手書き)
  • cc.breeze.ws.keitaiso:最終的な出来上がり
    • KeitaisoKaisekiServiceLocator.java([3]生成)
    • KeitaisoKaisekiServiceSoapBindingImpl.java([3]生成→[4]手書き)
    • KeitaisoKaisekiServiceSoapBindingSkeleton.java([3]生成)
    • KeitaisoKaisekiServiceSoapBindingStub.java([3]生成)
    • KeitaisoToken.java([3]生成)
    • KeitaisoKaiseki.java([3]生成)
    • KeitaisoKaisekiService.java([3]生成)

インタフェース

  • 次のような単純なインタフェースとした。最終的には生成した結果しか使わないので、あまりこだわらないでおく。
    package	cc.breeze.ws.keitaiso.prototype
    
    public interface KeitaisoKaiseki {
        public  KeitaisoToken[]  analyze( String text )  ; 
    }
    		
  • 入れ物は以下の通り。senのnet.java.sen.Tokenとほぼ同じ。WSDL生成→サーバサイドコード生成の過程でgetter/setter/コンストラクタは自動生成され、コメント含めてその他の内容は引き継げないので、フィールド(わざわざpublicにしているのはprivateだと生成対象にならないから)とコンストラクタだけ定義する。
    package	cc.breeze.ws.keitaiso.prototype
    
    public class KeitaisoToken {
        /// 分割されたトークン
        public String  token;
        /// 品詞
        public String  hinshi;
        /// 基本語(活用前、みたいなイメージか)
        public String  basicString;
        /// 元の文字列中における本トークンの開始位置
        public int     beginPosition;
        /// 元の文字列中における本トークンの終了位置
        public int     endPosition;
        /// トークンの長さ
        public int     tokenLength;
        /// トークンの読み
        public String  reading;
        /// トークンの発音
        public String  pronunciation;
        /// 付加情報
        public String  additionalInfo;
        /// 活用??
        public String  conjugationalForm;
        /// コスト
        public int     cost;
        /// ??
        public String  surface;
        
        KeitaisoToken()
        {
        }
    }
    		

WSDL生成

  • 次のようなAntターゲットを使用してWSDLを生成する。
    最初の一行目(taskdef)は、Antタスクを使用するための定義(build.xmlの先頭で宣言しておく)。axis-ant.jar内にあるaxis-tasks.propertiesで定義されている(わかりにくい)
    <taskdef resource="axis-tasks.properties" />
    	
    <target name="java2wsdl">
        <mkdir dir="WebContent/wsdl"/>
        
        <axis-java2wsdl 
            namespace = "http://breeze.cc/KeitaisoWS" 
            classname = "cc.breeze.ws.keitaiso.prototype.KeitaisoKaiseki"
            output = "./WebContent/wsdl/KeitaisoKaiseki.wsdl"
            location = "http://passing.breeze.cc/KeitaisoWS/services/KeitaisoKaisekiService"
        >
            <classpath>
                <pathelement path="build/classes"/>
            </classpath>
        </java2wsdl>
    </target>
    		

サーバサイドソース生成

  • 次のようなAntターゲットを使用してWSDLからjavaソースを生成する。
    <target name="make_server_hinagata" depends="java2wsdl">
        <axis-wsdl2java
            serverside = "yes"
            output = "./src"
            url = "./WebContent/wsdl/KeitaisoKaiseki.wsdl"
            skeletonDeploy="yes"
            deployscope="application"
        />
    </target>
    	

実装

  • コアロジックを記述する。「最初に作ったインタフェース名+ServiceSoapBindingImpl.java」が実装すべきソース。
  • ローカル確認用のMainメソッドも作っておく。実際に配備して確認する前に、ローカルなjavaアプリとして動作を確認する。
    • senに辞書その他の位置を通知しなければならないのでローカル実行時のVMオプションに「-Dsen.home=sen導入ディレクトリ」を指定すること。
  • ソース生成は何回行ってもよく、****ServiceSoapBindingImpl.javaは(上記Antターゲットの場合)既に存在する場合は上書きされない。

サービスデプロイ(ローカルTomcat)

  • サーバサイドのソース生成を行った際、サービスを配備するための「deploy.wsdd」が同時に生成されている。
  • これを用いてAxisにサービスを登録する。以下のようなAntターゲットを実行する。
    <target name="deploy_ws_local">
        <axis-admin
            port="8080"
            hostname="localhost"
            failonerror="true"
            servletpath="/KeitaisoWS/services/AdminService"
            debug="true"
            xmlfile="./src/cc/breeze/ws/keitaiso/deploy.wsdd"
        />
    </target>
    		
  • サービスのデプロイが正しく完了すれば、http://localhost:8080/コンテキスト名/→「リスト」で登録したサービス名と公開オペレーションが表示される。
ここの手順では、動的Webプロジェクトを作成して、ここからウェブサービスを作っているが、本来はウェブサービスプロジェクトを作成することで同じことができるはず。。。「はず」というのは、WTPからウェブサービス生成しようとしたのだが例外が出てしまって先に進まなかったので、別のやり方を探したから。

サーブレットが動くところまで

  • Eclipseを起動し、[ファイル]-[新規]-[その他]を選ぶ。
  • ウィザードの選択から「/Web/動的Webプロジェクト」を選択
    • プロジェクト名を適宜つける
    • Target Runtimeに「Apache Tomcat v5.5」を選択。(設定しおいたサーバ一覧から選べる)
    • Contextに名前を適宜つける。デフォルトはプロジェクト名と同じ。
  • サーバービューにTomcatインスタンスの状態が表示されているはず。ここに今回作成したプロジェクトを割り付ける。
    • Tomcatインスタンスを選択して、コンテキストメニューから「プロジェクトの追加および除去」を選ぶ。
    • 「使用可能プロジェクト」に、前項で作成した「動的Webプロジェクト」があるはずなので、これを選択し、「追加」ボタンを押す。
    • 選択したプロジェクトが「構成プロジェクト」に追加される。
    • 「終了」を押して確定する。
  • プロジェクトディレクトリ/WebContent/にAxisの必要ファイルをコピーする。lib配下だけコピーしてもいいのだけど、happyaxis.jspによる環境チェックもろもろも利用したいのでサンプルからコピーしている。
    • Axis導入ディレクトリ/webapp/axis/の配下をコピーする。
    • WebContent配下の次のファイルを「消す」。元々がサンプルとして提供されているものなので自前のウェブサービスでは使用しない。
      • WebContent/WEB-INF/classes/samples/配下全部
      • WebContent/WEB-INF/StockQuoteService.jws
  • ファイルシステム上でプロジェクトディレクトリ配下に何か置いてもEclipseのプロジェクトの一部として認識されない。プロジェクトエクスプローラ上で「更新」を行うことを忘れないようにする。WTP管理下のTomcatに対しては、プロジェクトの一部として認識されているファイルだけがデプロイされるから。
  • Tomcatを起動し、必要な環境が準備できたか確認する。
    1. サーバービューでサーバを選択し、「始動」を選択する
    2. サーバが起動したら、ブラウザで「http://localhost:8080/コンテキスト名/」にアクセスする。AxisのWelcomeページが表示されるはず。
    3. Welcomeページから「検証」をクリックして、必要なコンポーネントが揃っているか(ロードされているか)確認する。
  • WTPから起動したTomcatが認識しているモノ(デプロイされた資産など)を見たい場合は、「Eclipseのワークスペース/.metadata/.plugins/org.eclipse.wst.server.core/tmp0/配下を参照する。意図通りのファイルが配備されているか確認できる。(tmp0は変化する、のだろう)

コンテキスト固有の設定

  • axisの配布物の中からweb.xmlを持ってきたのでdisplay-nameがデフォルトのままである。せっかくなので自分のwebアプリであることがわかるように編集する。
    1. WebContent/WEB-INF/web.xmlを編集
    2. /web-app/display-nameに表示名を入れる。
  • 今回作成するウェブサービスはsenを用いて形態素解析を行う。したがって、senのライブラリがロードされるようにしなければならない。これはコンテキスト固有の問題と思われるのでWebContent配下に配置した。
    1. sen導入ディレクトリ/lib/sen.jar → WebContent/WEB-INF/lib/へコピー
  • senを使用するにはシステムプロパティsen.homeにsen導入ディレクトリを指定しなければならない。Tomcat導入ディレクトリ/conf/catalina.propertiesに記述することができるのだが、WTP管理下のTomcatの場合はここに書いても反映されない。
    パッケージエクスプローラーで見たとき「サーバー」というノードに上記で定義したWTP管理下のTomcatインスタンスの設定が見えるはず。ここにcatalina.propertiesを追加する。そして中身をTomcat導入ディレクトリ配下のcatalina.propertiesからコピーしてくる。その上で「sen.home=sen導入ディレクトリ」を追記する。
    sen.homeだけを記述するとTomcatが起動しなくなるので注意。
  • 上記のようにデプロイされる内容に変化があった場合、WTP管理下のTomcatであればその場で再デプロイされるので便利。ただし、「プロジェクトの一部」として認識されていないといけないので、ファイルやディレクトリをコピーした後は「更新」を忘れないこと。
環境の用意。
ここの手順ではEclipseのプラグイン入手についてUpdateSiteを使わずにいちいちダウンロードしているが、これはダウンロードしたプラグインを保存しておいて、別PCに再度同じ環境を作りたい、という意図から。ネットワーク環境によって数十MBのダウンロードが苦になる場合があるから。

JDK編

  • 詳細省略。使っているのは5.0

Eclipse編

  • Eclipse SDKを導入する。
    1. Eclipse downloads homeからSDKをダウンロードする。今回使ったのは3.1.2
    2. てきとうな場所にアーカイブを展開する。
    3. Eclipse Project Downloadsから「Language Pack」をダウンロードする。今回使ったのは「3.1.1_Language_Packs」
    4. Eclipseを展開したディレクトリと同じ場所にアーカイブを展開する。
  • WTPを使うので必要なプラグインを導入する。今ひとつ何が必須なのかよくわからないが、EMF/SDO・XSD・GEF・VE・WTPを導入した。
  • VE(VisualEditor)は直接関係ないのだが、JEMを含んでいるので導入する。JEMがどのタイミングで導入されたかに気がつかず、二回目の環境構築でかなりハマった。
  • EMF/SDO、XSD
    1. Eclipse Tools - EMF DownloadsからEMF/SDOをダウンロードする。今回使ったのは2.1.1のランタイム。
    2. EMFと同じ場所から、XSDをダウンロードする。今回使ったのは2.1.1のランタイム
    3. EMFと同じ場所から、「EMF 2.1 Language Packs」をダウンロードする。EMF/SDOランタイム用とXSDランタイム用をそれぞれダウンロード。
    4. ダウンロードしたアーカイブ全てをeclipseと同じ場所に展開する。
  • GEF
    1. GEF Project DownloadsからGEFをダウンロードする。今回使ったのは3.1.1のランタイム。
    2. GEF Translation PacksにNLパッケージがあるのでダウンロードする。
    3. ダウンロードしたアーカイブ全てをeclipseと同じ場所に展開する。
  • VE
    1. Visual Editor ProjectからVEをダウンロードする。今回使ったのは1.1.0.1のランタイム。
    2. ダウンロードしたアーカイブ全てをeclipseと同じ場所に展開する。
  • WTP
    1. Eclipse Web Tools Platform (WTP) DownloadsからWTPをダウンロードする。今回使ったのは1.0のランタイム
    2. WTPと同じページから「0.7.1 Language Packs」をダウンロードする。完全ではないが多くの部分が日本語化されて使いやすいので利用する。
    3. ダウンロードしたアーカイブ全てをeclipseと同じ場所に展開する。
  • 全てのアーカイブを展開したらEclipseを起動する。[ファイル]-[新規]-[プロジェクト]を選び、ウィザードの選択で「Web/動的Webプロジェクト」が選択できるならOKだと思う。
  • 環境変数PATHにJRE/binを入れているせいか、Eclipseが認識している「インストール済みのJRE」にJREのパスが設定されている。後々「tools.jarが見つからないけど?」というようなことを言われるので、JDKのパスに変えてしまう。
    • [ウィンドウ]-[設定]から、「/Java/インストール済みのJRE」に移動
    • 「追加」ボタンを押してJREを追加する。
    • JRE名は適当。「jdk1.5」とした。

Ant編

  • Antを導入する。Eclipseに元々同梱されているAntでいいのかもしれないが、新しいバージョンを入れてみた。
    1. Apache Ant - Welcomeからダウンロードする。今回使ったのは1.6.5。zip版をダウンロードした
    2. 任意の場所にアーカイブを展開する。僕の場合、下のようにしている。
      • c:\java\
        • apache-ant\
          • bin\
          • docs\
          • etc\
          • lib\
          • ・・・・
  • Eclipseから使えるようにする。
    1. [ウィンドウ]-[設定]から、「/Ant/ランタイム」へ移動
    2. 「Antホーム」ボタンから、上記でAntを導入したディレクトリを指定する。

Tomcat編

  • Tomcatを導入する。
    1. Apache Tomcat - Apache Tomcatからダウンロードする。今回使ったのは5.5.15。Binary Distributions→Core→zipをダウンロード
    2. 任意の場所にアーカイブを展開する。僕の場合、下のようにしている。
      • c:\java\
        • apache-tomcat\
          • bin\
          • common\
          • conf\
          • logs\
          • server\
          • shared\
          • temp\
          • webapps\
          • work\
          • ・・・・
  • Eclipseから使えるようにする
    1. [ウィンドウ]-[設定]から、「/サーバー/インストール済みランタイム」へ移動
      • 「追加」ボタンを押して新規サーバを登録。
      • ランタイムのタイプに「Apache Tomcat v5.5」を選択して「次へ」ボタン
      • インストールディレクトリに上記で導入したディレクトリを指定。名前、JREをてきとうに指定して「終了」ボタン
    2. [ウィンドウ]-[ビューの表示]-[その他]から、「/サーバー/サーバー」を選択してOKボタン。
      • 表示されたサーバービューにフォーカスを移動して、ペイン内のコンテキストメニューから[新規]-[サーバー]
      • サーバーランタイムをてきとうに選択する。
      • サーバービュー内にTomcatインスタンスの状態が表示されるはず。

Axis編

  • Axisを導入する。
    1. WebServices - Axisからダウンロードする。今回使ったのは1.3。バイナリパッケージをダウンロード
    2. 任意の場所にアーカイブを展開する。僕の場合、下のようにしている。
      • c:\java\
        • axis\
          • docs\
          • lib\
          • samples\
          • webapps\
          • xmls\
          • ・・・・
  • Axisの動作に必要なライブラリを入手する。
    1. JavaBeans Activation FrameworkからJAFをダウンロードする。今回使用したのは、1.0.2。
    2. ダウンロードしたアーカイブの中から「activation.jar」を取り出し、Tomcatがロードするjar群の中に放り込む。コンテキストの管理下でもいいと思ったが、共通に使われるものだからTomcatの配下にした。
      • c:\java\apache-tomcat\common\lib\
  • AxisのライブラリをEclipse上で一度に参照できるようにユーザライブラリを定義する。
    1. [ウィンドウ]-[設定]から、「/Java/ビルド・パス/ユーザー・ライブラリ」へ移動
    2. 「新規」ボタンを押す
      • ユーザライブラリ名=AXIS_LIB
    3. 「AXIS_LIB」を選択して「JARの追加」。Axis導入ディレクトリ/lib/配下のjar全部を選択する。

sen編

  • senを導入する。
    1. Sen Project - Sen Projectからダウンロードする。今回使ったのは1.2.1
    2. 任意の場所にアーカイブを展開する。僕の場合、下のようにしている。
      • c:\java\
        • sen\
          • bin\
          • conf\
          • demo\
          • dic\
          • docs\
          • lib\
          • src\
          • ・・・・
  • 辞書を用意する
    1. perlとantが動く環境を用意する
    2. sen導入ディレクトリ/dic/に移動し、build.xmlをantでビルドする。
      c:\java\apache-ant\bin\ant.bat
    3. 辞書のダウンロードと構築が自動で行われる。
    4. 一度どこかで辞書の構築を行えば、その環境をまるごとコピーしてきてもいい。
  • 動作確認する。
    1. sen導入ディレクトリ/bin/に移動
    2. デモプログラムを実行し、標準入力に適当な文章を与える。
      > cd c:\java\sen\bin
      > set SEN_HOME=c:\java\sen
      > set JAVA_HOME="c:\Program Files\Java\jdk1.5.0"
      > sen.bat
      (中略)
      明日は明日の風が吹く
      明日 (明日) 名詞-副詞可能(0,2,2) アシタ アシタ
      は (は) 助詞-係助詞(2,3,1) ハ ワ
      明日 (明日) 名詞-副詞可能(3,5,2) アシタ アシタ
      の (の) 助詞-連体化(5,6,1) ノ ノ
      風 (風) 名詞-一般(6,7,1) カゼ カゼ
      が (が) 助詞-格助詞-一般(7,8,1) ガ ガ
      吹く (吹く) 動詞-自立(8,10,2) フク フク
>>サイトトップへ

address

このアーカイブについて

このページには、過去に書かれたブログ記事のうちtomcatカテゴリに属しているものが含まれています。

前のカテゴリはsubversionです。

次のカテゴリはtracです。

最近のコンテンツはインデックスページで見られます。過去に書かれたものはアーカイブのページで見られます。

Powered by Movable Type 4.261