<?xml version="1.0" encoding="Windows-31J"?>

<!DOCTYPE document SYSTEM "./dtd/document-v10.dtd">

<document>
  <header>
    <title>Getting Started</title>
    <authors>
      <person name="Vincent Massol" email="vmassol@apache.org"/>
    </authors>
  </header>

  <body>

    <s1 title="Cactus のインストール">

      <p>
        Cactus のインストールというものは本来存在しないものです。
        Cactus はアプリケーションではなく、フレームワークだからです。
        しかしながら、 あなたは Cactus 
        をどのように作業環境に統合していくかを理解する必要があります。
        ですので、Cactus のインストールとは単に、どの jar 
        ファイルをどこに配置し、どの設定ファイルを編集して、
        どこに置けばよいのかを理解するという意味です。
        ここで解説するのは、そういうことです。

        There is not really an installation of Cactus per see, as Cactus is
        not an application but a framework. However you do need to understand
        how it integrates in your working environment. Thus, installing Cactus
        simply means to understand what jars need to be put where and what are
        the configuration files you need to have and edit. This is discussed
        below.
      </p>
      <p>
        あなたが Cactus を使いたいと思うであろう環境には、
        主に 2つの種類があります。
        
        There are 2 kinds of environments in which you may want to use
        Cactus, mainly :
      </p>
      <ul>
        <li>
          IDE の中で、
          within your IDE,
        </li>
        <li>
          <link href="http://jakarta.apache.org/ant">Ant</link>を使って、
          コマンド・ラインから。
          from the command line, using
          <link href="http://jakarta.apache.org/ant">Ant</link>
        </li>
      </ul>
      <note>
        通常、この 2つの環境は相互補完的なものです。
        日々の開発には IDE を使い、
        IDE の中からテキパキ Cactus のテストを実行しながら、
        日々のビルドは Ant によって実行(Cactus テストの実行を含む)する、
        というのが良い戦略です。

        Usually, these 2 environments are complementary. A good strategy is
        to use an IDE to increase day to day productivity, run quickly the
        Cactus tests in the IDE and use Ant to perform the
        (continuous) builds (including running the Cactus tests).
      </note>

    </s1>

    <s1 title="事前に必要なもの">

      <p>
        Cactus テストを実行するには、
        以下のソフトウェアが事前にインストールされている必要があります:
      
        In order to run Cactus tests you need to have the following
        software already installed on your system :
      </p>

      <ul>
        <li>
          <strong>Java バーチャル・マシン</strong>
          Java 1.2 またはそれ以上と互換性のある JVM が必要です。
          全てのServlet エンジンは JVM を必要としますので、
          もしあなたが現在 Servlet を使用しているのであれば、
          既に JVM はインストールされています。

          A Java 1.2 or greater compatible virtual machine must be present. Note
          that all servlet engines require a JVM to run so if you are already
          using servlets you already have one installed.
        </li>
        <li>
          <strong>Servlet エンジン</strong>
          Cactus テストの実行には Servlet 2.x と互換性のある 
          servlet エンジン(ただし x >= 2.2)が必要です。

          A Servlet 2.x compliant servlet engine (where x >= 2.2) for running
          your Cactus tests must be present.
        </li>
        <li>
          <strong>Ant (オプション)</strong>
          Ant は Cactus をコマンド・ラインから実行したい、
          あるいはテストの実行を自動化したい場合にのみ必要です。
          もし Ant を使用したい場合には、この導入ガイドを読み終わった後に
          <link href="howto_ant.html">Ant Howto</link> を読んでください。

          Ant is only needed if you are working from the command line or if you
          wish to automate the execution of tests. If you wish to use Ant,
          make sure that you read the
          <link href="howto_ant.html">Ant Howto</link> after you finish
          reading this introductory guide.
        </li>
      </ul>

    </s1>

    <s1 title="Cactus のファイル">

      <p>
        ここでは、
        (あなたが使おうとしている J2EE API 用の)Cactus の配布物が既に
        <link href="downloads.html">ダウンロード</link> され、
        <code>[cactus root]</code> 
        ディレクトリに解凍されているものと仮定します。

        At this point, you should have
        <link href="downloads.html">downloaded</link> a Cactus distribution
        (for the J2EE API you intend to use) and unzipped it in a
        <code>[cactus root]</code> directory.
      </p>
      <p>
        Cactus を構成する jar ファイルは
        <code>[cactus root]/lib</code>に存在します。すなわち:

        The jars making up Cactus can be found in
        <code>[cactus root]/lib</code>. Namely, they are :
      </p>
      <ul>
        <li>
          <strong><code>cactus.jar</code></strong> : 
          最も大切な jar ファイルで、フレームワーク・クラスを含んでいます。
          このファイルは <code>[cactus root]/lib</code> にあります。

          <strong><code>cactus.jar</code></strong> : the main jar,
          contains the framework classes. You can find this jar in
          <code>[cactus root]/lib</code>.
        </li>
        <li>
          <strong><code>cactus-ant.jar</code></strong> : 
          Ant との統合を容易にするためのカスタム Ant タスクを含む
          jar ファイルです。これは Cactus テストを Ant 
          によって自動化する場合にのみ必要です。
          Cactus と Ant の統合に関する詳細は、
          <link href="howto_ant.html">Ant Howto</link>
          チュートリアルを参照してください。
          このファイルも <code>[cactus root]/lib</code> にあります。

          <strong><code>cactus-ant.jar</code></strong> : a jar which
          contains some custom Ant tasks to help integrate easily with Ant.
          This is only needed if you wish to use Ant for automating the
          execution of Cactus tests. For more information on how to integrate
          Cactus with Ant, see the
          <link href="howto_ant.html">Ant Howto</link> tutorial. You also
          find this jar in <code>[cactus root]/lib</code>.
        </li>
        <li>
          <strong><code>httpclient.jar</code></strong> :
          Cactus はクッキーの処理を Jakarta Commons の HttpClient 
          フレームワークに依存しています。

          <strong><code>httpclient.jar</code></strong> : Cactus is relying
          on the Jakarta Commons HttpClient framework for Cookie handling.
        </li>
        <li>
          <strong><code>junit.jar</code></strong> : 
          Cactus は JUnit を拡張するものですので、
          JUnit の jar ファイルが必要です。

          <strong><code>junit.jar</code></strong> : Cactus extends JUnit and
          thus needs the JUnit jar.
        </li>
        <li>
          <strong><code>aspectjrt.jar</code></strong> : 
          Cactus はいくつかのタスク(メソッドの開始、終了をログに出力する、
          設定を確認するなど)を実行するのに
          <link href="http://www.aspectj.org">AspectJ</link> を使用しています。

          <strong><code>aspectjrt.jar</code></strong> : Cactus uses
          <link href="http://www.aspectj.org">AspectJ</link> for performing
          several tasks (logging entries and exit of methods, checking
          configuration, etc).
        </li>
        <li>
          <strong><code>log4j.jar</code>(optional)</strong> :
          Cactus は全ての内部ログに log4j を使用しています。
          この jar ファイルはオプションであり、
          もしクラス・パスに含まれていなければ、ログは出力されません。

          <strong><code>log4j.jar</code>(optional)</strong> : Cactus uses
          Log4j for performing all internal logging. This jar is optional and if
          you don't put in the classpaths, no logs will be generated.
        </li>
      </ul>
      <p>
        Cactus の設定ファイルについては、
        <link href="howto_config.html">Configuration Howto</link>
        チュートリアルで解説されています。

        The Cactus configuration files are described in the
        <link href="howto_config.html">Configuration Howto</link> tutorial.
      </p>

    </s1>

    <s1 title="さて次は?">

      <p>
        ここで、Cactus とは何者であり、
        どのように動作するのかを理解する必要があります。

        At this point you should understand what Cactus is and how it works.
      </p>
      <p>
        次のステップは、あなたの環境の中でどのようにして Cactus を
        セットアップするかを理解することです。
        このために、あなたは 
        <link href="howto_classpath.html">Cactus のクラス・パスの設定</link>
        と 
        <link href="howto_config.html">Cactus の設定</link>
        を理解する必要があります。

        The next step is to understand how to set up Cactus in your environment.
        For this you'll need to understand <link href="howto_classpath.html">How
        to setup Cactus classpaths</link> and <link href="howto_config.html">How
        to configure Cactus</link>.
      </p>
      <p>
        そして、どのように Cactus テスト・ケースを記述するかを理解するために、
        <link href="howto_testcase.html">TestCase Howto</link>
        を読んでください。

        Then, you should read the <link href="howto_testcase.html">TestCase
        Howto</link> to understand how to write Cactus Test Cases.
      </p>
      <p>
        最後のステップは、おそらく<link href="howto_sample.html">Cactus 
        のサンプルを実行する</link>を使って
        これまでに学んだことを実践してみることでしょう。

        The last step is probably to put in practice what you've learned so far
        by <link href="howto_sample.html">running the Cactus Samples</link>.
      </p>
      <p>
        Enjoy !
      </p>

    </s1>

  </body>
</document>
