Commit 51b8225e authored by Yoshiki Hayashi's avatar Yoshiki Hayashi
Browse files

Update transformations. 


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/APACHE_2_0_BRANCH@104962 13f79535-47bb-0310-9956-ffa450edef68
parent a0d842ae

docs/manual/content-negotiation.html.ja.euc-jp

+0 −2
Changes for docs/manual/content-negotiation.html.ja.euc-jp: 0 added lines, 2 removed lines.
Original line number Diff line number Diff line
@@ -22,8 +22,6 @@ 
<a href="./ja/content-negotiation.html" title="Japanese">&nbsp;ja&nbsp;</a> |

<a href="./ko/content-negotiation.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>

</div>

<div class="outofdate">This translation may be out of date. Check the

            English version for recent changes.</div>





    <p>Apache は HTTP/1.1 の規格に記述されているコンテントネゴシエーションを

docs/manual/content-negotiation.xml.meta

+1 −1
Changes for docs/manual/content-negotiation.xml.meta: 1 added line, 1 removed line.
Original line number Diff line number Diff line
@@ -7,7 +7,7 @@ 


  <variants>

    <variant>en</variant>

    <variant outdated="yes">ja</variant>

    <variant>ja</variant>

    <variant>ko</variant>

  </variants>

</metafile>

docs/manual/developer/modules.html.ja.euc-jp

+169 −148
Changes for docs/manual/developer/modules.html.ja.euc-jp: 169 added lines, 148 removed lines.
Original line number Diff line number Diff line 
<?xml version="1.0" encoding="EUC-JP"?>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"

    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">



<html xmlns="http://www.w3.org/1999/xhtml">

  <head>



    <title>モジュールの Apache 1.3 から Apache 2.0 への移植</title>

  </head>

  <!-- English revision: 1.8 -->

  <!-- Background white, links blue (unvisited), navy (visited), red (active) -->



  <body bgcolor="#FFFFFF" text="#000000" link="#0000FF"

  vlink="#000080" alink="#FF0000">

        <div align="center">

      <img src="../images/sub.gif" alt="[APACHE DOCUMENTATION]" /> 



      <h3>Apache HTTP Server Version 2.0</h3>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja"><head><!--

        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

              This file is generated from xml source: DO NOT EDIT

        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

      -->

<title>モジュールの Apache 1.3 から Apache 2.0 への移植 - Apache HTTP サーバ</title>

<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />

<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />

<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />

<link href="../images/favicon.ico" rel="shortcut icon" /></head>

<body id="manual-page"><div id="page-header">

<p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/directives.html">ディレクティブ</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p>

<p class="apache">Apache HTTP サーバ バージョン 2.0</p>

<img alt="" src="../images/feather.gif" /></div>

<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>

<div id="path">

<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP サーバ</a> &gt; <a href="http://httpd.apache.org/docs-project/">ドキュメンテーション</a> &gt; <a href="../">バージョン 2.0</a> &gt; <a href="./">Developer Documentation</a></div><div id="page-content"><div id="preamble"><h1>モジュールの Apache 1.3 から Apache 2.0 への移植</h1>

<div class="toplang">

<p><span>Available Languages: </span><a href="../en/developer/modules.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |

<a href="../ja/developer/modules.html" title="Japanese">&nbsp;ja&nbsp;</a></p>

</div>







    <h1 align="center">モジュールを Apache 1.3 から Apache 2.0 へ</h1>



    <p>この文書は mod_mmap_static モジュールを Apache 2.0 用に移植した時に

    <p>この文書は <code>mod_mmap_static</code> モジュールを Apache 2.0 用に移植した時に

    学んだ経験をもとに書いた、最初の手引き書です。まだまだ完全じゃないし、

    ひょっとすると間違っている部分もあるかもしれませんが、

    取っ掛りにはなるでしょう。</p>

    <hr />



    <h2>簡単な変更点…</h2>



    <h3>クリーンナップ ルーチン</h3>



   <p>クリーンナップルーチンは apr_status_t 型である必要があります。

</div>

<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#easy">簡単な変更点</a></li>

<li><img alt="" src="../images/down.gif" /> <a href="#messy">もっと厄介な変更点…</a></li>

</ul></div>

<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>

<div class="section">

<h2><a name="easy" id="easy">簡単な変更点</a></h2>



    <h3><a name="cleanup" id="cleanup">クリーンナップ ルーチン</a></h3>

      <p>クリーンナップルーチンは <code>apr_status_t</code> 型である必要があります。

      そして、apr_status_t 型の値を返さなくてはなりません。

      クリーンナップ中のエラーを通知する必要がなければ、返り値は普通、

   ARP_SUCCESS です。たとえエラーを通知したとしても、

      <code>ARP_SUCCESS</code> です。たとえエラーを通知したとしても、

      すべてのコードがその通知をチェックしたり、

      エラーに応じた動作をするわけではないことに気をつけてください。</p>

    

    <h3>初期化ルーチン</h3>





    <h3><a name="init" id="init">初期化ルーチン</a></h3>



    <p>初期化ルーチンは処理全体から見てしっくりくるような意味を表すように、

    名前が変更されました。ですから、mmap_init から mmap_post_config

    名前が変更されました。ですから、<code>mmap_init</code> から <code>mmap_post_config</code>

    のようにちょっと変更されました。

    渡される引数は大幅に変更され、次のようになりました。</p>



    <ul style="list-style:none">

      <li>apr_pool_t *p,</li>



      <li>apr_pool_t *plog,</li>



      <li>apr_pool_t *ptemp,</li>



      <li>server_rec *s</li>

      <ul>

        <li><code>apr_pool_t *p</code></li>

        <li><code>apr_pool_t *plog</code></li>

        <li><code>apr_pool_t *ptemp</code></li>

        <li><code>server_rec *s</code></li>

      </ul>

    

    <h3>データ型</h3>



    <p>データ型のほとんどは APR に移されました。つまり、

    <h3><a name="datatypes" id="datatypes">データ型</a></h3>

      <p>データ型のほとんどは <a href="http://apr.apache.org/">APR</a> に移されました。つまり、

      いくつかの名前が前述のように変更されています。

      施すべき変更点の簡単な一覧を以下に示します。</p>



    <ul style="list-style:none">

      <li>pool は apr_pool_t になります</li>



      <li>table は apr_table_t になります</li>

      <ul>

        <li><code>pool</code> becomes <code>apr_pool_t</code></li>

        <li><code>table</code> becomes <code>apr_table_t</code></li>

      </ul>

    

    <hr />



    <h2><em>もっと厄介な</em>変更点…</h2>



    <h3>フックの登録</h3>

</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>

<div class="section">

<h2><a name="messy" id="messy">もっと厄介な変更点…</a></h2>



    <h3><a name="register-hooks" id="register-hooks">フックの登録</a></h3>

      <p>新しいアーキテクチャでは作成した関数を呼び出すのに

      一連のフックを使用します。このフックは、新しい関数

    static void register_hooks(void) を使って登録するよう、

      <code>static void register_hooks(void)</code> を使って登録するよう、

      モジュールに書き足さなくてはなりません。

      この関数は、なにをすべきか一旦理解してしまえば、

      十分にわかりやすいものです。
@@ -86,33 +86,33 @@ 
      それぞれのフェーズで、関数を呼び出す相対的な順番は、

      かなりの程度制御できます。</p>



    <p>以下は、mod_mmap_static に追加したコードです:</p>

    <p>以下は、<code>mod_mmap_static</code> に追加したコードです:</p>



<pre>

      <div class="example"><pre>

static void register_hooks(void)

{

    static const char * const aszPre[]={ "http_core.c",NULL };

    ap_hook_post_config(mmap_post_config,NULL,NULL,HOOK_MIDDLE);

    ap_hook_translate_name(mmap_static_xlat,aszPre,NULL,HOOK_LAST);

};

</pre>

};</pre></div>



    <p>ここでは呼びだすべき二つの関数を登録しています。一つは

    post_config ステージ用 (ほとんどすべてのモジュールはこれが必要です) で、

    もう一つは translate_name フェーズ用です。

    <code>post_config</code> ステージ用 (ほとんどすべてのモジュール

    はこれが必要です) で、もう一つは <code>translate_name</code> フェーズ用です。

    それぞれの関数は名前は違うけれども形式は同じであることに注意してください。

    それでは、形式はどのようになっているでしょうか?</p>



    <p><code><strong>ap_hook_[フェーズ名](関数名, 先行, 後行, 位置);</strong></code></p>



    <p>3つの位置が定義されています…</p>



    <ul style="list-style:none">

      <li>HOOK_FIRST</li>

      <div class="example"><p><code>

        ap_hook_<var>phase_name</var>(<var>function_name</var>,

        <var>predecessors</var>, <var>successors</var>, <var>position</var>);

      </code></p></div>



      <li>HOOK_MIDDLE</li>

    <p>三つの位置が定義されています…</p>



      <li>HOOK_LAST</li>

      <ul>

        <li><code>HOOK_FIRST</code></li>

        <li><code>HOOK_MIDDLE</code></li>

        <li><code>HOOK_LAST</code></li>

      </ul>



    <p>位置を定義するには、上記の「位置」を指定し、
@@ -121,133 +121,154 @@ static void register_hooks(void) 
   「先行」は関数の実行前に呼ばれるもので、

   「後行」は実行後に呼ばれるものです。</p>



    <p>mod_mmap_static の場合、post_config ステージでは必要ありませんが、

    mmap_static_xlat が core モジュールが名前の変換を実行した後に

    呼ばれなければなりません。

    そこで aszPre を使って HOOK_LAST の修飾子を定義しています。</p>

    <p><code>mod_mmap_static</code> の場合、<code>post_config</code>

    ステージでは必要ありませんが、

    <code>mmap_static_xlat</code> が core モジュールが名前の変換を実行した後に

    <strong>呼ばれなければなりません</strong>。

    そこで aszPre を使って <code>HOOK_LAST</code> の修飾子を定義しています。</p>

  

    <h3>モジュールの定義</h3>



    <h3><a name="moddef" id="moddef">モジュールの定義</a></h3>

      <p>モジュールの定義を作成する際に注意しなければならない

      ステージの数は激減しています。古い定義は次のようになっていました。</p>



<pre>

module MODULE_VAR_EXPORT [モジュール名]_module =

      <div class="example"><pre>

module MODULE_VAR_EXPORT <var>module_name</var>_module =

{

    STANDARD_MODULE_STUFF,

    /* 初期化関数 */

    /* ディレクトリ設定作成関数 */

    /* ディレクトリ設定マージ関数 — デフォルトは「上書き」 */

    /* サーバ設定作成関数 */

    /* サーバ設定マージ関数 */

    /* コマンド・ハンドラ */

    /* ハンドラ */

    /* ファイル名変換 */

    /* initializer */

    /* dir config creater */

    /* dir merger --- default is to override */

    /* server config */

    /* merge server config */

    /* command handlers */

    /* handlers */

    /* filename translation */

    /* check_user_id */

    /* 認証チェック */

    /* アクセス制限チェック */

    /* MIME 型チェック */

    /* 調整 */

    /* ログ出力 */

    /* ヘッダパーサ */

    /* 子プロセス初期化 */

    /* 子プロセス終了 */

    /* read-request 後 */

};

</pre>

    /* check auth */

    /* check access */

    /* type_checker */

    /* fixups */

    /* logger */

    /* header parser */

    /* child_init */

    /* child_exit */

    /* post read-request */

};</pre></div>



    <p>新しい構造体はとってもシンプルです…</p>



<pre>

module MODULE_VAR_EXPORT [モジュール名]_module =

      <div class="example"><pre>

module MODULE_VAR_EXPORT <var>module_name</var>_module =

{

    STANDARD20_MODULE_STUFF,

    /* ディレクトリ毎設定構造体作成 */

    /* ディレクトリ毎設定構造体マージ */

    /* サーバ毎設定構造体作成 */

    /* サーバ毎設定構造体作成マージ */

    /* コマンド・ハンドラ */

    /* ハンドラ */

    /* フック登録 */

 };

</pre>

    /* create per-directory config structures */

    /* merge per-directory config structures  */

    /* create per-server config structures    */

    /* merge per-server config structures     */

    /* command handlers */

    /* handlers */

    /* register hooks */

};</pre></div>



    <p>このうちのいくつかは古いものから新しいものに直接読み替えられるもので、

    いくつかはそうではありません。どうすればいいのかを要約してみます。</p>



    <p>直接読み替えられるステージ:</p>



    <ul style="list-style:none">

      <li>/* ディレクトリ設定作成関数 */ ==&gt;

	/* ディレクトリ毎設定構造体作成 */</li>

    <dl>

      <dt><code>/* ディレクトリ設定作成関数 */</code></dt>

      <dd><code>/* ディレクトリ毎設定構造体作成 */</code></dd>



      <li>/* サーバ設定作成関数 */ ==&gt; /* サーバ毎設定構造体作成 */</li>

      <dt><code>/* サーバ設定作成関数 */</code></dt>

      <dd><code>/* サーバ毎設定構造体作成 */</code></dd>



      <li>/* ディレクトリ設定マージ関数 */ ==&gt;

	/* ディレクトリ毎設定構造体マージ */</li>

      <dt><code>/* ディレクトリ設定マージ関数 */</code></dt>

      <dd><code>/* ディレクトリ毎設定構造体マージ */</code></dd>



      <li>/* サーバ設定マージ関数 */ ==&gt;

	/* サーバ毎設定構造体作成マージ */</li>

      <dt><code>/* サーバ設定マージ関数 */</code></dt>

      <dd><code>/* サーバ毎設定構造体作成マージ */</code></dd>



      <li>/* コマンド・テーブル */ ==&gt; /* コマンド apr_table_t */</li>

      <dt><code>/* コマンド・テーブル */</code></dt>

      <dd><code>/* コマンド apr_table_t */</code></dd>



      <li>/* ハンドラ */ ==&gt; /* ハンドラ */</li>

    </ul>

      <dt><code>/* ハンドラ */</code></dt>

      <dd><code>/* ハンドラ */</code></dd>

    </dl>



    <p>古い関数の残りのものはフックとして登録されるべきです。

    現時点で次のようなフック・ステージが定義されています…</p>



    <ul style="list-style:none">

      <li>ap_hook_post_config <em>(以前の _init ルーチンが登録されるべき場所です)</em></li>



      <li>ap_hook_http_method <em>(リクエストから HTTP メソッドを取得します (互換用))</em></li>



      <li>ap_hook_open_logs <em>(特定のログのオープン)</em></li>

    <dl>

      <dt><code>ap_hook_post_config</code></dt>

      <dd>(以前の <code>_init</code> ルーチンが登録されるべき場所です)</dd>



      <li>ap_hook_auth_checker <em>(リソースが権限を必要とするかどうかの確認)</em></li>

      <dt><code>ap_hook_http_method</code></dt>

      <dd>(リクエストから HTTP メソッドを取得します (互換用))</dd>



      <li>ap_hook_access_checker <em>(モジュール固有の制約の確認)</em></li>

      <dt><code>ap_hook_open_logs</code></dt>

      <dd>(特定のログのオープン)</dd>



      <li>ap_hook_check_user_id <em>(ユーザ ID とパスワードの確認)</em></li>

      <dt><code>ap_hook_auth_checker</code></dt>

      <dd>(リソースが権限を必要とするかどうかの確認)</dd>



      <li>ap_hook_default_port <em>(サーバのデフォルト・ポートの取得)</em></li>

      <dt><code>ap_hook_access_checker</code></dt>

      <dd>(モジュール固有の制約の確認)</dd>



      <li>ap_hook_pre_connection <em>(処理の直前に必要なことを実行。ただし accept 直後に呼ばれる)</em></li>

      <dt><code>ap_hook_check_user_id</code></dt>

      <dd>(ユーザ ID とパスワードの確認)</dd>



      <li>ap_hook_process_connection <em>(プロトコルの処理)</em></li>

      <dt><code>ap_hook_default_port</code></dt>

      <dd>(サーバのデフォルト・ポートの取得)</dd>



      <li>ap_hook_child_init <em>(子プロセル起動直後)</em></li>

      <dt><code>ap_hook_pre_connection</code></dt>

      <dd>(処理の直前に必要なことを実行。ただし accept 直後に呼ばれる)</dd>



      <li>ap_hook_create_request <em>(??)</em></li>

      <dt><code>ap_hook_process_connection</code></dt>

      <dd>(プロトコルの処理)</dd>



      <li>ap_hook_fixups <em>(応答内容の生成を変更するラスト・チャンス)</em></li>

      <dt><code>ap_hook_child_init</code></dt>

      <dd>(子プロセル起動直後)</dd>



      <li>ap_hook_handler <em>(応答内容の生成)</em></li>

      <dt><code>ap_hook_create_request</code></dt>

      <dd>(??)</dd>



      <li>ap_hook_header_parser <em>(モジュールにヘッダの照会をさせる。ほとんどのモジュールでは使われません。post_read_request を使います)</em></li>

      <dt><code>ap_hook_fixups</code></dt>

      <dd>(応答内容の生成を変更するラスト・チャンス)</dd>



      <li>ap_hook_insert_filter <em>(フィルタ・チェインにフィルタを挿入)</em></li>

      <dt><code>ap_hook_handler</code></dt>

      <dd>(応答内容の生成)</dd>



      <li>ap_hook_log_transaction <em>(リクエストについての情報を記録する)</em></li>

      <dt><code>ap_hook_header_parser</code></dt>

      <dd>(モジュールにヘッダの照会をさせる。ほとんどのモジュールでは使われません。post_read_request を使います)</dd>



      <li>ap_hook_optional_fn_retrieve <em>(オプションとして登録された関数の取得)</em></li>

      <dt><code>ap_hook_insert_filter</code></dt>

      <dd>(フィルタ・チェインにフィルタを挿入)</dd>



      <li>ap_hook_post_read_request <em>(リクエストを読みこんだ後、他のフェーズの前に呼ばれる)</em></li>

      <dt><code>ap_hook_log_transaction</code></dt>

      <dd>(リクエストについての情報を記録する)</dd>



      <li>ap_hook_quick_handler <em>(??)</em></li>



      <li>ap_hook_translate_name <em>(URI をファイル名に変換する)</em></li>



      <li>ap_hook_type_checker <em>(文書型の決定と設定。あるいはその片方)</em></li>

    </ul>

        <hr />

      <dt><code>ap_hook_optional_fn_retrieve</code></dt>

      <dd>(オプションとして登録された関数の取得)</dd>



    <h3 align="center">Apache HTTP Server Version 2.0</h3>

    <a href="./"><img src="../images/index.gif" alt="Index" /></a>

    <a href="../"><img src="../images/home.gif" alt="Home" /></a>

      <dt><code>ap_hook_post_read_request</code></dt>

      <dd>(リクエストを読みこんだ後、他のフェーズの前に呼ばれる)</dd>



      <dt><code>ap_hook_quick_handler</code></dt>

      <dd>リクエストの処理が始まる前に呼ばれる。キャッシュモジュールが

      使用している</dd>



      <dt><code>ap_hook_translate_name</code></dt>

      <dd>(URI をファイル名に変換する)</dd>



  </body>

</html>

      <dt><code>ap_hook_type_checker</code></dt>

      <dd>(文書型の決定と設定。あるいはその片方)</dd>

    </dl>

  

</div></div>

<div class="bottomlang">

<p><span>Available Languages: </span><a href="../en/developer/modules.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |

<a href="../ja/developer/modules.html" title="Japanese">&nbsp;ja&nbsp;</a></p>

</div><div id="footer">

<p class="apache">Copyright 1999-2004 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>

<p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/directives.html">ディレクティブ</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p></div>

</body></html>
 
 No newline at end of file

docs/manual/developer/modules.xml.meta

+1 −1
Changes for docs/manual/developer/modules.xml.meta: 1 added line, 1 removed line.
Original line number Diff line number Diff line
@@ -7,6 +7,6 @@ 


  <variants>

    <variant>en</variant>

    <variant htmlonly="yes">ja</variant>

    <variant>ja</variant>

  </variants>

</metafile>

docs/manual/howto/auth.html.ja.euc-jp

+187 −210

File changed.

Preview size limit exceeded, changes collapsed.