DynamicDocument セットアップ

この資料では、次の環境で DynamicDocument をセットアップするための手順について説明します。

CD-ROM またはダウンロードしたファイルから dyndoc.war をコピーします。
コピー先は Tomcat の webapps ディレクトリです。

• Windows の場合
  今回の例では、c:\Tomcat4.1\webapps ディレクトリに dyndoc.war をコピーします。
  
• Linux の場合
  今回の例では、/opt/jakarta-tomcat-4.1.30/webapps ディレクトリに dyndoc.war をコピーします。
  

dyndoc.war のコピー後、Tomcatを起動、または再起動してください。
DynamicDocument は Tomcat の webapps ディレクトリ以下に dyndoc というディレクトリ名で展開されます。

注意
お使いの JDK のバージョンが 1.4 以降で Tomcat のバージョンが 4.1 以降の場合は、XML パーサー、XSLT のセットアップは必要ありません。JDK のバージョンが 1.3.1 以前の場合に必要となります。
お使いの JDK のバージョンが 1.4 以降の場合は、この章の作業をスキップしてください。

まず、Xalan - XSLT stylesheet processors を Internet等から取得してください。

URL：http://archive.apache.org/dist/xml/xalan-j/binaries/

Point

DynamicDocument では、Xalan - XSLT stylesheet processorsに含まれる以下の JAR ファイルが必要になります。

1. xalan.jar
   
2. xml-apis.jar
   
3. xercesImpl.jar （Tomcat 3.x のみ必要）
   

• Windowsの場合
  

  xalan-j_2_6_0-bin-2jars.zip を取得してを展開してください。
  展開したディレクトリ以下にある bin ディレクトリに上記のファイルがあります。

  1. Tomcat4.xを使用している場合
     プロジェクト(dyndoc) の lib ディレクトリ(c:\Tomcat4.1\webapps\dyndoc\lib)に上記のJARファイルをコピーします。
     
  2. Tomcat3.xを使用している場合
     Tomcat の lib ディレクトリ(c:\jakarta-tomcat-3.2.4\lib)に上記のJARファイルをコピーします。
     
  
  
• Linuxの場合
  

  xalan-j_2_6_0-bin.tar.gz を取得して展開してください。
  展開したディレクトリ以下にある ディレクトリに上記のファイルがあります。

  1. Tomcat4.xを使用している場合
     プロジェクト(dyndoc) の lib ディレクトリ(/opt/jakarta-tomcat-4.1.30/webapps/dyndoc/lib)に上記のJARファイルをコピーします。
     
  2. Tomcat3.xを使用している場合
     Tomcat の lib ディレクトリ(/opt/jakarta-tomcat-3.2.4/lib)に上記のJARファイルをコピーします。
     
  
  

注意

• Tomcat 4 の注意点
  対象 : J2SDK 1.3.1_xx をお使いの場合のみ
  Tomcat 4. x では、xalan-j_2_6_0-bin-2jars.zip 、xalan-j_2_6_0-bin.tar.gz の xercesImpl.jar が WEB-INF/lib ディレクトリにあると正しく動作しません。
  xalan.jar、xml-apis.jar のみをWEB-INF/lib ディレクトリにコピーしてください。
  WEB-INF/lib ディレクトリにある Xalanの JARファイルが正しく動作しない場合は
  新しいバージョンの Tomcat を使用することをお勧めします。
  Tomcat 4.1.x 系の場合は 4.1.12 以降
  Tomcat 4.0.x 系の場合は 4.0.6 以降
  
  

• Tomcat 3 の注意点
  上記のJARファイルは、Tomcat 3. x の lib ディレクトリに含まれている以下のファイルの上位互換に相当します。
  衝突しないように、以下のファイルを一階層上のディレクトリ（TomcatのCLASSPATHに含まれないディレクトリ）に移動しておいてください。
  • crimson.jar
    
  • jaxp.jar
    
  Windows の場合 c:\jakarta-tomcat-3.2.4 ディレクトリなどに crimson.jar と jaxp.jar を移動してください。
  Linux の場合 /opt/jakarta-tomcat-3.2.4 ディレクトリなどに crimson.jar と jaxp.jar を移動してください。
  

• Windows + Oracle の場合
  c:\Tomcat4.1\webapps\dyndoc\WEB-INF ディレクトリに classes ディレクトリを作成します。
  classes12.zip を c:\Tomcat4.1\webapps\dyndoc\WEB-INF\classes ディレクトリに解凍します。
  
• Windows + DB2 の場合
  c:\Tomcat4.1\webapps\dyndoc\WEB-INF ディレクトリに classes ディレクトリを作成します。
  db2java.zip を c:\Tomcat4.1\webapps\dyndoc\WEB-INF\classes ディレクトリに解凍します。
  
• Linux + PostgreSQL の場合
  postgresql.jar を /opt/jakarta-tomcat-4.1.30/webapps/dyndoc/WEB-INF/lib ディレクトリにコピーします。
  

Point

通常 JAR ファイルはアプリケーションの WEB-INF\lib ディレクトリに配置しますが、Oracle 用, DB2用の JDBC ドライバは ZIP として提供されているため、
そのままではサーブレットから使用することができません。JDBC ドライバにサーブレットからアクセスできるようにするために、class ファイルに展開します。

※classes12.zip、db2java.zipを classes12.jar、db2java.jar とそれぞれリネームして、lib ディレクトリにコピーする方法でも動作します。

dyndoc/WEB-INF ディレクトリにある index.htlm をテキストエディタで開き以下の項目を編集します。

• Windows + Oracle の場合
  今回の例では c:\Tomcat4.1\webapps\dyndoc\WEB-INF\web.xml を編集します

  
  <web-app>
    <display-name>Dynamic Document</display-name>
    <servlet>
  	<servlet-name>jp.ne.mki.wedge.dyndoc.CreateXml</servlet-name>
  	<servlet-class>jp.ne.mki.wedge.dyndoc.CreateXml</servlet-class>
  
  	<!--
  		dbtype_ データベースの種類を定義して下さい。
  
  		PostgeSQL:pgsql
  		Oracle   :ora
  		DB2      :db2
  		HSQLDB   :hsql
  	-->
  	<init-param>
  		<param-name>dbtype_</param-name>
  		<param-value>ora</param-value>
  	</init-param>
  
  
  	<!--
  		driver_ JDBCドライバのクラス名を指定して下さい。
  
  		PostgeSQL:org.postgresql.Driver
  		Oracle   :oracle.jdbc.driver.OracleDriver
  		DB2      :COM.ibm.db2.jdbc.net.DB2Driver
  		HSQLDB   :org.hsqldb.jdbcDriver
  	-->
  	<init-param>
  		<param-name>driver_</param-name>
  		<param-value>oracle.jdbc.driver.OracleDriver</param-value>
  	</init-param>
  
  
  	<!--
  		connectinfo_ データベースとの接続文字列を設定して下さい。
  
  		PostgeSQL:jdbc:postgresql://hostname/dbname?encoding=EUC_JP
  		Oracle   :jdbc:oracle:thin:@hostname:1521:ORCL
  		DB2      :jdbc:db2://hostname:6789/dbname
  		HSQLDB   :jdbc:hsqldb:hsql://localhost:9002:dbname
  	-->
  	<init-param>
  		<param-name>connectinfo_</param-name>
  		<param-value>jdbc:oracle:thin:@localhost:1521:ORCL</param-value>
  	</init-param>
  
  
  	<!--
  		dbuser_ データベース接続のユーザ名を設定して下さい。
  	-->
  	<init-param>
  		<param-name>dbuser_</param-name>
  		<param-value>user</param-value>
  	</init-param>
  
  
  	<!--
  		dbpassword_ データベース接続のパスワードを設定して下さい。
  	-->
  	<init-param>
  		<param-name>dbpassword_</param-name>
  		<param-value>password</param-value>
  	</init-param>
  
  
  	<!--
  		serverurl_ DynamicDocumentが稼動しているＵＲＬのうち、サーバ名とポート番号を指定して下さい。
  	-->
  	<init-param>
  		<param-name>serverurl_</param-name>
  		<param-value>http://192.168.1.1:8080/</param-value>
  	</init-param>
  
  
  	<!--
  		webcontext_ DynamicDocumentが稼動しているＵＲＬのうち、WebContextを指定して下さい。
  	-->
  	<init-param>
  		<param-name>webcontext_</param-name>
  		<param-value>dyndoc</param-value>
  	</init-param>
  
  
  	<!--
  		servletalias_ WebContextからみて、サーブレット稼動エイリアスの位置を指定して下さい。
  	-->
  	<init-param>
  		<param-name>servletalias_</param-name>
  		<param-value>servlet</param-value>
  	</init-param>
  
  
  
  
  	<!--
  		xsl_path_
  		sql_path_
  		image_path_
  		xslファイルのパス、sqlファイルのパス、画像ファイルのパスを指定して下さい。
  		通常は変更をする必要はありません。
  	-->
  	<init-param>
  		<param-name>xsl_path_</param-name>
  		<param-value>xsl/</param-value>
  	</init-param>
  	<init-param>
  		<param-name>sql_path_</param-name>
  		<param-value>sql/</param-value>
  	</init-param>
  	<init-param>
  		<param-name>image_path_</param-name>
  		<param-value>image/</param-value>
  	</init-param>
  
  
  	<!--
  		javadoc_ ビジネスルール・チェッククラス・フォーマットクラスのJavaDocが存在するURLを指定して下さい。
  	-->
  	<init-param>
  		<param-name>javadoc_</param-name>
  		<param-value>http://www.mki.ne.jp/developer/docs/webtribe/release110/javadoc/</param-value>
  	</init-param>
  
  
  	<!--
  		datatype_ 初期起動時に表示される画面を設定して下さい。
  	-->
  	<init-param>
  		<param-name>datatype_</param-name>
  		<param-value>javaclient</param-value>
  	</init-param>
  
  
  	<!--
  		charsetoff_ この項目を1にした場合は、HttpResponseHeaderのContetnTypeの項目に"charset=UTF-8"を表示しません。
  	-->
  	<init-param>
  		<param-name>charsetoff_</param-name>
  		<param-value>0</param-value>
  	</init-param>
  
  
  	<!--
  		prodtype_ 製品種別を指定してください。
  		
  		0:Webtribe
  		1:VisualFrame
  	-->
  	<init-param>
  		<param-name>prodtype_</param-name>
  		<param-value>1</param-value>
  	</init-param>
  
  
  	<!--
  		contenttype_ 出力形式を指定してください。
  		
  		xml :xml形式でデータを出力
  		html:データをHTMLに変換して出力
  	-->
  	<init-param>
  		<param-name>contenttype_</param-name>
  		<param-value>html</param-value>
  	</init-param>
  
  
    </servlet>
    <servlet-mapping>
  	<servlet-name>jp.ne.mki.wedge.dyndoc.CreateXml</servlet-name>
  	<url-pattern>/servlet/jp.ne.mki.wedge.dyndoc.CreateXml/*</url-pattern>
    </servlet-mapping>
  </web-app>
  
  

  
  
• Windows + DB2 の場合
  今回の例では c:\Tomcat4.1\webapps\dyndoc\WEB-INF\web.xml を編集します

  <web-app>
    <display-name>Dynamic Document</display-name>
    <servlet>
  	<servlet-name>jp.ne.mki.wedge.dyndoc.CreateXml</servlet-name>
  	<servlet-class>jp.ne.mki.wedge.dyndoc.CreateXml</servlet-class>
  
  	<!--
  		dbtype_ データベースの種類を定義して下さい。
  
  		PostgeSQL:pgsql
  		Oracle   :ora
  		DB2      :db2
  		HSQLDB   :hsql
  	-->
  	<init-param>
  		<param-name>dbtype_</param-name>
  		<param-value>db2</param-value>
  	</init-param>
  
  
  	<!--
  		driver_ JDBCドライバのクラス名を指定して下さい。
  
  		PostgeSQL:org.postgresql.Driver
  		Oracle   :oracle.jdbc.driver.OracleDriver
  		DB2      :COM.ibm.db2.jdbc.net.DB2Driver
  		HSQLDB   :org.hsqldb.jdbcDriver
  	-->
  	<init-param>
  		<param-name>driver_</param-name>
  		<param-value>COM.ibm.db2.jdbc.net.DB2Driver</param-value>
  	</init-param>
  
  
  	<!--
  		connectinfo_ データベースとの接続文字列を設定して下さい。
  
  		PostgeSQL:jdbc:postgresql://hostname/dbname?encoding=EUC_JP
  		Oracle   :jdbc:oracle:thin:@hostname:1521:ORCL
  		DB2      :jdbc:db2://hostname:6789/dbname
  		HSQLDB   :jdbc:hsqldb:hsql://localhost:9002:dbname
  	-->
  	<init-param>
  		<param-name>connectinfo_</param-name>
  		<param-value>jdbc:db2://localhost:6789/myprjrp</param-value>
  	</init-param>
  
  
  	<!--
  		dbuser_ データベース接続のユーザ名を設定して下さい。
  	-->
  	<init-param>
  		<param-name>dbuser_</param-name>
  		<param-value>user</param-value>
  	</init-param>
  
  
  	<!--
  		dbpassword_ データベース接続のパスワードを設定して下さい。
  	-->
  	<init-param>
  		<param-name>dbpassword_</param-name>
  		<param-value>password</param-value>
  	</init-param>
  
  
  	<!--
  		serverurl_ DynamicDocumentが稼動しているＵＲＬのうち、サーバ名とポート番号を指定して下さい。
  	-->
  	<init-param>
  		<param-name>serverurl_</param-name>
  		<param-value>http://192.168.1.1:8080/</param-value>
  	</init-param>
  
  
  	<!--
  		webcontext_ DynamicDocumentが稼動しているＵＲＬのうち、WebContextを指定して下さい。
  	-->
  	<init-param>
  		<param-name>webcontext_</param-name>
  		<param-value>dyndoc</param-value>
  	</init-param>
  
  
  	<!--
  		servletalias_ WebContextからみて、サーブレット稼動エイリアスの位置を指定して下さい。
  	-->
  	<init-param>
  		<param-name>servletalias_</param-name>
  		<param-value>servlet</param-value>
  	</init-param>
  
  
  
  
  	<!--
  		xsl_path_
  		sql_path_
  		image_path_
  		xslファイルのパス、sqlファイルのパス、画像ファイルのパスを指定して下さい。
  		通常は変更をする必要はありません。
  	-->
  	<init-param>
  		<param-name>xsl_path_</param-name>
  		<param-value>xsl/</param-value>
  	</init-param>
  	<init-param>
  		<param-name>sql_path_</param-name>
  		<param-value>sql/</param-value>
  	</init-param>
  	<init-param>
  		<param-name>image_path_</param-name>
  		<param-value>image/</param-value>
  	</init-param>
  
  
  	<!--
  		javadoc_ ビジネスルール・チェッククラス・フォーマットクラスのJavaDocが存在するURLを指定して下さい。
  	-->
  	<init-param>
  		<param-name>javadoc_</param-name>
  		<param-value>http://www.mki.ne.jp/developer/docs/webtribe/release110/javadoc/</param-value>
  	</init-param>
  
  
  	<!--
  		datatype_ 初期起動時に表示される画面を設定して下さい。
  	-->
  	<init-param>
  		<param-name>datatype_</param-name>
  		<param-value>javaclient</param-value>
  	</init-param>
  
  
  	<!--
  		charsetoff_ この項目を1にした場合は、HttpResponseHeaderのContetnTypeの項目に"charset=UTF-8"を表示しません。
  	-->
  	<init-param>
  		<param-name>charsetoff_</param-name>
  		<param-value>0</param-value>
  	</init-param>
  
  
  	<!--
  		prodtype_ 製品種別を指定してください。
  		
  		0:Webtribe
  		1:VisualFrame
  	-->
  	<init-param>
  		<param-name>prodtype_</param-name>
  		<param-value>1</param-value>
  	</init-param>
  
  
  	<!--
  		contenttype_ 出力形式を指定してください。
  		
  		xml :xml形式でデータを出力
  		html:データをHTMLに変換して出力
  	-->
  	<init-param>
  		<param-name>contenttype_</param-name>
  		<param-value>html</param-value>
  	</init-param>
  
  
    </servlet>
    <servlet-mapping>
  	<servlet-name>jp.ne.mki.wedge.dyndoc.CreateXml</servlet-name>
  	<url-pattern>/servlet/jp.ne.mki.wedge.dyndoc.CreateXml/*</url-pattern>
    </servlet-mapping>
  </web-app>
  
  

  
  
• Linux + PostgreSQL の場合
  今回の例では /opt/jakarta-tomcat-4.1.30/webapps/dyndoc/WEB-INF/web.xml を編集します。

  
  <web-app>
    <display-name>Dynamic Document</display-name>
    <servlet>
  	<servlet-name>jp.ne.mki.wedge.dyndoc.CreateXml</servlet-name>
  	<servlet-class>jp.ne.mki.wedge.dyndoc.CreateXml</servlet-class>
  
  	<!--
  		dbtype_ データベースの種類を定義して下さい。
  
  		PostgeSQL:pgsql
  		Oracle   :ora
  		DB2      :db2
  		HSQLDB   :hsql
  	-->
  	<init-param>
  		<param-name>dbtype_</param-name>
  		<param-value>pgsql</param-value>
  	</init-param>
  
  
  	<!--
  		driver_ JDBCドライバのクラス名を指定して下さい。
  
  		PostgeSQL:org.postgresql.Driver
  		Oracle   :oracle.jdbc.driver.OracleDriver
  		DB2      :COM.ibm.db2.jdbc.net.DB2Driver
  		HSQLDB   :org.hsqldb.jdbcDriver
  	-->
  	<init-param>
  		<param-name>driver_</param-name>
  		<param-value>org.postgresql.Driver</param-value>
  	</init-param>
  
  
  	<!--
  		connectinfo_ データベースとの接続文字列を設定して下さい。
  
  		PostgeSQL:jdbc:postgresql://hostname/dbname?encoding=EUC_JP
  		Oracle   :jdbc:oracle:thin:@hostname:1521:ORCL
  		DB2      :jdbc:db2://hostname:6789/dbname
  		HSQLDB   :jdbc:hsqldb:hsql://localhost:9002:dbname
  	-->
  	<init-param>
  		<param-name>connectinfo_</param-name>
  		<param-value>jdbc:postgresql://localhost/myprjrp?encoding=EUC_JP</param-value>
  	</init-param>
  
  
  	<!--
  		dbuser_ データベース接続のユーザ名を設定して下さい。
  	-->
  	<init-param>
  		<param-name>dbuser_</param-name>
  		<param-value>user</param-value>
  	</init-param>
  
  
  	<!--
  		dbpassword_ データベース接続のパスワードを設定して下さい。
  	-->
  	<init-param>
  		<param-name>dbpassword_</param-name>
  		<param-value>password</param-value>
  	</init-param>
  
  
  	<!--
  		serverurl_ DynamicDocumentが稼動しているＵＲＬのうち、サーバ名とポート番号を指定して下さい。
  	-->
  	<init-param>
  		<param-name>serverurl_</param-name>
  		<param-value>http://192.168.1.1:8080/</param-value>
  	</init-param>
  
  
  	<!--
  		webcontext_ DynamicDocumentが稼動しているＵＲＬのうち、WebContextを指定して下さい。
  	-->
  	<init-param>
  		<param-name>webcontext_</param-name>
  		<param-value>dyndoc</param-value>
  	</init-param>
  
  
  	<!--
  		servletalias_ WebContextからみて、サーブレット稼動エイリアスの位置を指定して下さい。
  	-->
  	<init-param>
  		<param-name>servletalias_</param-name>
  		<param-value>servlet</param-value>
  	</init-param>
  
  
  
  
  	<!--
  		xsl_path_
  		sql_path_
  		image_path_
  		xslファイルのパス、sqlファイルのパス、画像ファイルのパスを指定して下さい。
  		通常は変更をする必要はありません。
  	-->
  	<init-param>
  		<param-name>xsl_path_</param-name>
  		<param-value>xsl/</param-value>
  	</init-param>
  	<init-param>
  		<param-name>sql_path_</param-name>
  		<param-value>sql/</param-value>
  	</init-param>
  	<init-param>
  		<param-name>image_path_</param-name>
  		<param-value>image/</param-value>
  	</init-param>
  
  
  	<!--
  		javadoc_ ビジネスルール・チェッククラス・フォーマットクラスのJavaDocが存在するURLを指定して下さい。
  	-->
  	<init-param>
  		<param-name>javadoc_</param-name>
  		<param-value>http://www.mki.ne.jp/developer/docs/webtribe/release110/javadoc/</param-value>
  	</init-param>
  
  
  	<!--
  		datatype_ 初期起動時に表示される画面を設定して下さい。
  	-->
  	<init-param>
  		<param-name>datatype_</param-name>
  		<param-value>javaclient</param-value>
  	</init-param>
  
  
  	<!--
  		charsetoff_ この項目を1にした場合は、HttpResponseHeaderのContetnTypeの項目に"charset=UTF-8"を表示しません。
  	-->
  	<init-param>
  		<param-name>charsetoff_</param-name>
  		<param-value>0</param-value>
  	</init-param>
  
  
  	<!--
  		prodtype_ 製品種別を指定してください。
  		
  		0:Webtribe
  		1:VisualFrame
  	-->
  	<init-param>
  		<param-name>prodtype_</param-name>
  		<param-value>1</param-value>
  	</init-param>
  
  
  	<!--
  		contenttype_ 出力形式を指定してください。
  		
  		xml :xml形式でデータを出力
  		html:データをHTMLに変換して出力
  	-->
  	<init-param>
  		<param-name>contenttype_</param-name>
  		<param-value>html</param-value>
  	</init-param>
  
  
    </servlet>
    <servlet-mapping>
  	<servlet-name>jp.ne.mki.wedge.dyndoc.CreateXml</servlet-name>
  	<url-pattern>/servlet/jp.ne.mki.wedge.dyndoc.CreateXml/*</url-pattern>
    </servlet-mapping>
  </web-app>
  
  

  
  

index.html を編集したら、Tomcat を再起動（もしくは、dyndocをリロード）してください。

ブラウザを起動し、http:// ホスト名 : ポート番号 /dyndoc/ の形式でURLを入力してください。

今回の例では http://192.168.1.1:8080/dyndoc/index.html を指定します。

Point

ブラウザにURLを入力すると「VisualFrame DynamicDocument」という画面が、ブラウザに表示されます。
『Web.xmlの情報を使用』の項目にある『表示』ボタンを押してください。
画面が切り替わって、web.xmlの"初期起動時の表示情報"で設定した情報の画面が表示されれば動作確認は完了です。

以降の操作については、その他→付属TOOL→DynamicDocumentを参照してください。