pirka 1.00 手順書 20070602

pirkaはモックで作成したHTMLファイルに少しだけ規則を意識して
HTMLを作成したものと、その画面を動作させるためのjavaソースを
一緒に取り込んでWebアプリを動作させるフレームワークです。

HTMLに書く規則とはタグに「name="xxxxxxx"」を記述するもので、
xxxxxはjavaのソースではアクション名又は項目名として使用されます。

詳細はマニュアルを参照してください。


本アーカイブに格納されているファイル

  ・readme.txt          本ドキュメント
  ・PirkaManual.txt     マニュアル
  ・api.zip             APIマニュアル(Javadoc）
  ・pirka.jar           pirka本体
  ・Index.html          初期動作確認用サンプルHTMLファイル
  ・Index.java          初期動作確認用サンプルjavaソース
  ・pirkaSample.zip     サンプルプロジェクト(UTL=http://localhost:8080/pirkaSample/sample)
  ・AddresBookList.zip  その他サンプル（動作しません）


開発環境
  ・JDK5.0以降
  ・Eclipse3.x（推奨）
  ・Tomcat5.x（推奨）
  ・初心者向け支援ツール（koropo：コロポ）（必要に応じて）


実行環境
    ・JavaSE1.5（JRE1.5）以降
    ・Tomcat等のServletコンテナ（WEBサーバー）


環境構築から実行までの流れ 

   Eclipse + TomcatPluginを使用した例です。
   事前にEclipse及びTomcatPluginがインストールされている必要があります。

  【開発環境構築】
    1. EclipseでTomcatプロジェクトを新規作成
    2. pirka.jarファイルをWEB-INF/libへコピー
    3. web.xmlをWEB-INFへコピー
    4. pirka.jarをプロジェクトプロパティのJavaのビルドパスへ追加

  【プログラム作成】
    4. WEB-INF/srcの下の任意のパッケージにHTMLファイルを作成(初画面はIndex.htmlとなります)
    5. HTMLファイルと同パッケージに同名のJavaソースの生成
      （pirkaの概要がわかるまで初心者向け支援ツール（koropo：コロポ）を使用して
       自動的にJavaソースを作成することをお勧めします）
    6. Build（Eclipsの場合はSaveのみ）

  【プログラム実行】
    7. tomcatの実行
    8. ブラウザで確認　http://localhost:8080/projectname/index
       projectnameはプロジェクト名です
       Tomcatの設定によっては:8080は必要ありません
	
  一番最初はサンプルで提供しているIndex.htmlとindex.javaをWEB-INF/srcへコピーして
  動作確認を行ってください。


注意
	Eclipsの設定によってはHTMLファイルがclassesにコピーされないため動作しないことがあります。
	Eclipseのメニューで、ウィンドウ→設定→Java→コンパイラー→ビルドの画面を開き、
	「出力フォルダー」をクリックして、「フィルターするリソース」の欄から、*.htmlを除くことにより
	動作いたします。


初心者向け支援ツール（koropo：コロポ）の使い方

	概要
		koropoはpirkaをはじめて使う人向けのjavaソース生成ツールです。
		koropo自身もpirkaで作成されていてWebアプリです。

	説明
		koropoは画面HTMLファイルを取込（ｱｯﾌﾟﾛｰﾄﾞ）、画面項目定義、アクション定義等を設定し
		最後にjavaソースを出力（ﾀﾞｳﾝﾛｰﾄﾞ）します。
		
		注意、作成されるソースはパッケージとインポートが未設定のままなので
			　Eclipsのプルダウンメニューから「ソースー＞インポートの編成」を選択し
			　自動で挿入願います。

	URL
		http://pirka.dnip.net/koropo/start

	既知の問題
		それとロジック設定画面の選択で、beanの設定と取得は
		サンプルとしての提示なので
		beanを作成しないとそのままでは動作しません
		beanはHTMLのnama属性と同じならば動作します。


以上

感想をお待ちしております。
