AppFuseQuickStart_jp

This is version 26. It is not the current version, and thus it cannot be edited.
[Back to current version]   [Restore this version]

AppFuse主要な目的はウェブアプリ作成の高速化です。新規プロジェクト作成の基本手順は下記のとおりです。

1. J2SE 1.4.2+をインストールし、JAVA_HOMEをインストールフォルダに指定する。
2. ソースバージョンをダウンロードするか、 Subversion (svn co https://appfuse.dev.java.net/svn/appfuse/branches/BRANCH_1-9-x appfuse)から1.9.x ブランチをチェックアウトする。
3. Ant 1.6.5+をインストールし、ANT_HOME環境変数を設定してから、Tomcat 4.1.x+ (recommend 5.0.28) をインストールし、CATALINA_HOME環境変数をTomcatインストールフォルダに設定する。パッケージのリンクと詳しいインストール手順は開発環境の設定 に参考してください。
4. MySQL 3.23.x+ (recommend 5.0+)をインストールする。
   NOTE: MySQL 4.1.7を使う場合, UTF-8 キャラクタセットとInnoDB テーブルタイプを設定して下さい。 詳しくは.
5. ローカルSMTPサーバを設定 するかmail.properties (web/WEB-INF/classes フォルダの中に)とbuild.properties (ルートフォルダ -- log4j メッセージのため)を存在する場所に指定してください。 - ディフォルトはlocalhostとなってる。
6. lib/junit3.8.1/junit.jarを$ANT_HOME/libにコピーする。
   NOTE: ant-junit.jarというファイルは$ANT_HOME/libに既に存在するが、このjarはJUnitライブラリではなくて、のフォルダにおかれるjunit.jarを利用するAntのJUnitタスクを機能するためのライブラリである。
7. iBATIS (Hibernateの替わりに)或いはStruts以外のウェフレームワークを利用するなら、このステップで下記のガイドを従ってインストールして下さい。
8. appfuseの直下にてant newを実行する。アプリ名、データベース名とパッケージ名を順番に入力してから, 新規作成されたアプリを含むフォルダはappfuseのフォルダ階層に作成される。
   WARNING: "test"、 "appfuse"を含む名称、二つのダッシュ (-) のある名称或いは数字始まる名称を使う場合は一部のアプリ機能に支障があるから、使用しないで下さい。
9. 新規作成されたアプリフォルダに遷移して、ant setup (或いは ant setup-db setup-tomcat deploy) を実行してデータベースを作成してから、Tomcat を設定しアプリを配布する. ディフォルトでルートユーザのパスワードがない場合のみデータベースのセットアップが正常に実行できるから、build.propertiesをニーズに合わせて修正して下さい。mysqlセットアップアシスタンスは役に立つ。
10. 全ての機能正常稼動を確認する場合、ant test-allを実行する - 予めTomcatを止めて下さい。そしてant test-reportsを実行する - 正常終了した場合作成されたレポート閲覧方法についてメッセージが表示される。

上記の手順でインストールが確認できたら - どのようにAppFuseを活用して開発するのはTutorialsに参考して下さい。

オプションアル・インストール

• iBATISを永続化フレームワークとして利用する場合、extras/ibatis下のREADME.txtを参考して下さい。
• Springをウェブフレームワークとして利用する場合、extras/spring下のREADME.txtを参考して下さい。
• WebWorkをウェブフレームワークとして利用する場合、extras/webwork下のREADME.txtを参考して下さい。
• JSFをウェブフレームワークとして利用する場合、extras/jsf下のREADME.txtを参考して下さい。
• Tapestry をウェブフレームワークとして利用する場合、extras/tapestry下のREADME.txtを参考して下さい。

• AppFuseプロジェクトの作成、テストを自動化するスクリプトの作成ができます。いくつ私のテストに使ったスクリプトはCVSにあります: spring+ibatis と webwork. 注意：実用の場合"appfuse"をプロジェクト名称にすると検索・リプレース処理は失敗になりますから、使用しないで下さい。
• iBATIS、 Spring MVC、 WebWork、 JSFとTapestryのインストールが必要なければ - バージョン管理ソフトにインポートする前にextrasフォルダからそれらフレームワークのフォルダを削除して下さい。

1. Install J2SE 1.4.2+ and set a JAVA_HOME environment variable pointing to your installation directory.
2. Download the source version or checkout the 1.9.x branch from Subversion (svn co https://appfuse.dev.java.net/svn/appfuse/branches/BRANCH_1-9-x appfuse).
3. Install Ant 1.6.5+ and set an ANT_HOME environment variable. Install Tomcat 4.1.x+ (recommend 5.0.28) and set a CATALINA_HOME environment variable to point to your Tomcat installation. Checkout my development environment setup to get links for these packages and to see where I usually install them.
4. Install MySQL 3.23.x+ (recommend 5.0+).
   NOTE: If you're using MySQL 4.1.7, make sure to use a UTF-8 character set and an InnoDB table type. Here's how.
5. Setup a local SMTP server or change mail.properties (in the web/WEB-INF/classes directory) and build.properties (in the root -- for log4j messages) to point to an existing one - they default to localhost.
6. Copy lib/junit3.8.1/junit.jar to $ANT_HOME/lib.
   NOTE: You may see an ant-junit.jar file already in $ANT_HOME/lib. This jar is not the JUnit library, rather it is for the Ant junit task which will use the junit.jar that you place here.
7. If you're planning on using iBATIS (instead of Hibernate) or a web framework other than Struts, install that now using the instructions below.
8. Run ant new from the appfuse directory. You will be prompted for an application name, database name and package name. After entering these, a directory containing your new application will be created in the same directory as appfuse.
   WARNING: Some application values will not work - don't use "test", anything with "appfuse" in it or anything that starts with numbers. Also, two dashes (-) in a name will mess things up.
9. Navigate to your new project's directory and run ant setup (or ant setup-db setup-tomcat deploy) to create the database, configure Tomcat and deploy your application. The database setup will only work if your root user has no password. You can change this in build.properties if necessary. Need assistance with mysql setup?
10. If you want to test and make sure everything works, run ant test-all - make sure Tomcat is stopped when you do this. Next, run ant test-reports - there will be a message after it runs telling you how you can view the generated reports.

After you've confirmed your installation using the above steps - take a look at the Tutorials to see how to develop with AppFuse.

Optional Installations

• If you'd like to use iBATIS as a persistence framework option, view the README.txt in extras/ibatis.
• If you'd like to use Spring as the web framework, view the README.txt in extras/spring.
• If you'd like to use WebWork as the web framework, view the README.txt in extras/webwork.
• If you'd like to use JSF as the web framework, view the README.txt in extras/jsf.
• If you'd like to use Tapestry as the web framework, view the README.txt in extras/tapestry.

• If you'd like you can write a script to automate the creation and testing of your project from AppFuse. There are a couple in CVS that I use for testing: spring+ibatis and webwork. Note that using "appfuse" in a real-world project name is a bad idea as it'll find/replace things it shouldn't.
• If you don't want to install iBATIS, Spring MVC, WebWork, JSF or Tapestry - you should delete their installers in the extras folder before checking your project into source control.