granicus.if.org Git - apache/blob - docs/manual/mod/mod_proxy_ajp.html.ja.utf8

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja"><head><!--
   4         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   5               This file is generated from xml source: DO NOT EDIT
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7       -->
   8 <title>mod_proxy_ajp - Apache HTTP サーバ</title>
   9 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  10 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  11 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
  12 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  13 <body>
  14 <div id="page-header">
  15 <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>
  16 <p class="apache">Apache HTTP サーバ バージョン 2.3</p>
  17 <img alt="" src="../images/feather.gif" /></div>
  18 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  19 <div id="path">
  20 <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/">ドキュメンテーション</a> &gt; <a href="../">バージョン
  21             2.3</a> &gt; <a href="./">モジュール</a></div>
  22 <div id="page-content">
  23 <div id="preamble"><h1>Apache モジュール mod_proxy_ajp</h1>
  24 <div class="toplang">
  25 <p><span>言語: </span><a href="../en/mod/mod_proxy_ajp.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  26 <a href="../ja/mod/mod_proxy_ajp.html" title="Japanese">&nbsp;ja&nbsp;</a></p>
  27 </div>
  28 <table class="module"><tr><th><a href="module-dict.html#Description">説明:</a></th><td><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> で AJP
  29 をサポートするためのモジュール</td></tr>
  30 <tr><th><a href="module-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
  31 <tr><th><a href="module-dict.html#ModuleIdentifier">モジュール識別子:</a></th><td>proxy_ajp_module</td></tr>
  32 <tr><th><a href="module-dict.html#SourceFile">ソースファイル:</a></th><td>mod_proxy_ajp.c</td></tr></table>
  33 <h3>概要</h3>
  34
  35     <p>本モジュールには <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> が<em>必要です</em>。
  36     <code>Apache JServ Protocol version 1.3</code> (以降 <em>AJP13</em>)
  37     をサポートします。</p>
  38
  39     <p><code>AJP13</code> プロトコルを扱えるようにするには
  40     <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> と <code class="module"><a href="../mod/mod_proxy_ajp.html">mod_proxy_ajp</a></code>
  41     をサーバに組み込む必要があります。</p>
  42
  43     <div class="warning"><h3>警告</h3>
  44       <p><a href="#access">安全なサーバにする</a>までプロクシ機能は有効にしないでください。
  45       オープンプロキシサーバはあなた自身のネットワークにとっても、
  46       インターネット全体にとっても危険です。</p>
  47     </div>
  48 </div>
  49 <div id="quickview"><h3 class="directives">ディレクティブ</h3>
  50 <p>このモジュールにディレクティブはありません。</p>
  51 <h3>トピック</h3>
  52 <ul id="topics">
  53 <li><img alt="" src="../images/down.gif" /> <a href="#overviewprotocol">プロトコルの概要</a></li>
  54 <li><img alt="" src="../images/down.gif" /> <a href="#basppacketstruct">基本パケット構造</a></li>
  55 <li><img alt="" src="../images/down.gif" /> <a href="#rpacetstruct">リクエストパケット構造</a></li>
  56 <li><img alt="" src="../images/down.gif" /> <a href="#resppacketstruct">レスポンスパケット構造</a></li>
  57 </ul><h3>参照</h3>
  58 <ul class="seealso">
  59 <li><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></li>
  60 </ul></div>
  61 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  62 <div class="section">
  63 <h2><a name="overviewprotocol" id="overviewprotocol">プロトコルの概要</a></h2>
  64     <p><code>AJP13</code> プロトコルはパケット指向です。
  65     可読なプレーンテキスト形式ではなくバイナリ形式になったのは、
  66     おそらくパフォーマンス上の理由によります。
  67     ウェブサーバはサーブレットコンテナと TCP コネクションで通信します。
  68     ソケット生成は重い処理なので、負荷を減らすために、サーブレットコンテナとの
  69     TCP 接続を維持し、複数のリクエスト・レスポンス処理サイクルに対して一つの
  70     コネクションを使いまわすようになっています。</p>
  71     <p>あるリクエストにコネクションが割り当てられると、その処理サイクルが
  72     完了するまで他のものに使われることはありません。
  73     つまりコネクション上では、リクエストの同時処理は行われません。
  74     このため、コネクション両端での実行するコードを簡潔にできる一方で、
  75     同時に開くコネクションは多くなっています。</p>
  76     <p>サーブレットコンテナへのコネクションを開いた後は、コネクションの状態は
  77     次のどれかになります:</p>
  78     <ul>
  79     <li> Idle <br />コネクション上で処理されているリクエストはありません。</li>
  80     <li> Assigned <br />コネクションはリクエストを処理中です。</li>
  81     </ul>
  82     <p>コネクションが特定のリクエストにアサインされると、基本的な情報 (例えば
  83     HTTP ヘッダ等) が圧縮された形 (例えば通常の文字列は整数にエンコードされます)
  84     で転送されます。詳細は下記の「リクエストパケットの構造」を参照してください。
  85     リクエストにボディが存在 <code>(content-length &gt; 0)</code> すれば、
  86     基本的な情報の直後に別パケットで転送されます。</p>
  87     <p>この時点でおそらく、サーブレットコンテナは処理を開始できるようになります。
  88     ですので、次のメッセージをウェブサーバに戻して知らせられるようになります。</p>
  89     <ul>
  90     <li>SEND_HEADERS <br />ブラウザにヘッダを送信します。</li>
  91     <li>SEND_BODY_CHUNK <br />ブラウザにボディデータのチャンクを送ります。
  92     </li>
  93     <li>GET_BODY_CHUNK <br />リクエストのデータを全て受け取り終わっていないときに、
  94     残っているデータを受け取ります。パケットにある定まった最大長があり、任意の
  95     大きさのデータがリクエストのボディとして含まれうる場合
  96     (例えばファイルのアップロードの場合) に必要となります。
  97     (注: HTTP のチャンク転送とは関連ありません。)</li>
  98     <li>END_RESPONSE <br />リクエスト処理サイクルを終了します。</li>
  99     </ul>
 100     <p>個々のメッセージはそれぞれ異なるデータパケット形式になっています。
 101     後述の「レスポンスパケットの構造」を参照してください。</p>
 102 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 103 <div class="section">
 104 <h2><a name="basppacketstruct" id="basppacketstruct">基本パケット構造</a></h2>
 105     <p>このプロトコルには XDR から受け継いだ部分が少しありますが、多くの点で
 106     異なります (例えば 4 バイトアライメントでないことなど) 。</p>
 107     <p>バイトオーダー: 個々のバイトのエンディアンがどうなっているかは、
 108     私は詳しくないのですが、リトルエンディアンになっていると思います。
 109     XDR 仕様でそうなっているのと、素晴らしいことに sys/socket ライブラリが
 110     (C で) そういう風にできているのでそうなのだと思いました。
 111     ソケット呼び出しの内部についてより詳しい方がいらっしゃいましたら、
 112     ご教授ください。</p>
 113     <p>プロトコルには 4 つのデータタイプがあります: byte, boolean,
 114     integer, string です。</p>
 115     <dl>
 116     <dt><strong>Byte</strong></dt><dd>バイト一つです。</dd>
 117     <dt><strong>Boolean</strong></dt>
 118       <dd>バイト一つで、<code>1 = true</code>, <code>0 = false</code> です。
 119       (C のように) 非零を真として扱ってしまうと、ある場合は動くかもしれませんし、
 120       動かないかもしれません。</dd>
 121     <dt><strong>Integer</strong></dt>
 122       <dd><code>0 から 2^16 (32768)</code> の範囲の数字。高次の 2 バイトが
 123       先に格納されます。</dd>
 124     <dt><strong>String</strong></dt>
 125       <dd>可変長の文字列 (2^16 が長さの上限) 。長さ情報のパケット 2 バイトの後に
 126       文字列 (終端文字 '\0' を含む) が続く形式でエンコードされます。
 127       エンコードされている長さ情報は最後の '\0' を<strong>カウントしない</strong>
 128       ことに注意してください――これは <code>strlen</code> と同様です。
 129       これらの終端文字をスキップするために、あまり意味の無いインクリメント文
 130       をたくさん書かないといけないのは、
 131       Java の側から見ると少し紛らわしく感じられるかもしれません。
 132       こうなった理由はおそらく、Servlet コンテナから返される文字列を読み出す時に、
 133       効率よく C のコードを書けるようにする――サーブレットから返される
 134       文字列は \0 文字で終端されているので、C のコードではわざわざコピーをせずに、
 135       一つのバッファへのリファレンスを取り回すように書くことができる――
 136       ためだと思われます。
 137       '\0' 文字がない場合は、C では文字列の規則に合うようにコピーしなければ
 138       いけなくなってしまいます。</dd>
 139     </dl>
 140
 141   <h3>パケットサイズ</h3>
 142     <p>多くのコードでそうなっているのですが、パケットサイズの最大サイズは
 143     <code>8 * 1024 (8K)</code> です。パケットの実際の長さはヘッダに
 144     エンコードされて入っています。</p>
 145
 146   <h3>パケットヘッダ</h3>
 147     <p>サーバからコンテナに送出されるパケットは <code>0x1234</code> で始まります。
 148     コンテナからサーバに送られるパケットは <code>AB</code> (ASCII コード A と
 149     ASCII コード B) で始まります。この二バイトの後に、ペイロード長が (上記の形式で)
 150     続きます。このため、ペイロード長の最大値は 2^16 にできるように思えますが、
 151     実際にはコードでは最大値は 8K に設定されています。</p>
 152     <table>
 153       <tr>
 154         <td colspan="6"><em>パケット形式 (Server-&gt;Container)</em></td>
 155       </tr>
 156       <tr>
 157         <td>Byte</td>
 158         <td>0</td>
 159         <td>1</td>
 160         <td>2</td>
 161         <td>3</td>
 162         <td>4...(n+3)</td>
 163       </tr>
 164       <tr>
 165         <td>Contents</td>
 166         <td>0x12</td>
 167         <td>0x34</td>
 168         <td colspan="2">データ長 (n)</td>
 169         <td>Data</td>
 170       </tr>
 171     </table>
 172     <table>
 173       <tr>
 174         <td colspan="6"><em>パケット形式 (Container-&gt;Server)</em></td>
 175       </tr>
 176       <tr>
 177         <td>Byte</td>
 178         <td>0</td>
 179         <td>1</td>
 180         <td>2</td>
 181         <td>3</td>
 182         <td>4...(n+3)</td>
 183       </tr>
 184       <tr>
 185         <td>Contents</td>
 186         <td>A</td>
 187         <td>B</td>
 188         <td colspan="2">データ長 (n)</td>
 189         <td>Data</td>
 190       </tr>
 191     </table>
 192     <p>ほとんどのパケットで、ペイロードの最初のバイトがメッセージの型をエンコード
 193      しています。例外はサーバからコンテナに送られるリクエストボディパケットです
 194      ――これらは標準的なパケット形式 (<code>0x1234</code> とパケット長)
 195      ですが、その後に続くプレフィックスコードがありません。</p>
 196      <p>ウェブサーバは次のメッセージをサーブレットコンテナに送出できます。</p>
 197     <table>
 198       <tr>
 199         <td>コード</td>
 200         <td>パケットの型</td>
 201         <td>意味</td>
 202       </tr>
 203       <tr>
 204         <td>2</td>
 205         <td>Forward Request</td>
 206         <td>リクエスト処理サイクルを後続のデータとともに開始する。</td>
 207       </tr>
 208       <tr>
 209         <td>7</td>
 210         <td>Shutdown</td>
 211         <td>ウェブサーバがコンテナに、コンテナを終了するように伝える。</td>
 212       </tr>
 213       <tr>
 214         <td>8</td>
 215         <td>Ping</td>
 216         <td>ウェブサーバがコンテナに制御を受け持つように伝える
 217         (セキュアログインフェーズ) 。</td>
 218       </tr>
 219       <tr>
 220         <td>10</td>
 221         <td>CPing</td>
 222         <td>ウェブサーバがコンテナに CPong で即座に応答するように伝える。</td>
 223       </tr>
 224       <tr>
 225         <td>none</td>
 226         <td>Data</td>
 227         <td>サイズ (2 バイト) とそれに続くボディデータ。</td>
 228       </tr>
 229     </table>
 230     <p>基本的なセキュリティを確保するため、ホストされているマシンと同一の
 231     マシンからのリクエストに対してのみ、コンテナは実際に <code>Shutdown</code>
 232     を実行します。</p>
 233     <p>最初の <code>Data</code> パケットは、<code>Forward Request</code>
 234     の直後にウェブサーバから送られます。</p>
 235     <p>サーブレットコンテナはウェブサーバに、次のタイプのメッセージを送ることが
 236     できます :</p>
 237     <table>
 238       <tr>
 239         <td>コード</td>
 240         <td>パケットの型</td>
 241         <td>意味</td>
 242       </tr>
 243       <tr>
 244         <td>3</td>
 245         <td>Send Body Chunk</td>
 246         <td>サーブレットコンテナからウェブサーバに
 247         (そしておそらくそのままブラウザに)、ボディのチャンクを送る。</td>
 248       </tr>
 249       <tr>
 250         <td>4</td>
 251         <td>Send Headers</td>
 252         <td>サーブレットコンテナからウェブサーバに (そしておそらくそのままブラウザに)
 253         レスポンスヘッダを送る。</td>
 254       </tr>
 255       <tr>
 256         <td>5</td>
 257         <td>End Response</td>
 258         <td>レスポンス (つまりリクエスト処理サイクル) 終了の目印を送る。
 259         </td>
 260       </tr>
 261       <tr>
 262         <td>6</td>
 263         <td>Get Body Chunk</td>
 264         <td>まだ全て転送されていない場合、残っているリクエストのデータを受け取る。
 265         </td>
 266       </tr>
 267       <tr>
 268         <td>9</td>
 269         <td>CPong 応答</td>
 270         <td>CPing リクエストに応答する。</td>
 271       </tr>
 272     </table>
 273     <p>上記メッセージは、それぞれ内部構造が異なっています。詳細は下記をご覧ください。
 274     </p>
 275
 276 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 277 <div class="section">
 278 <h2><a name="rpacetstruct" id="rpacetstruct">リクエストパケット構造</a></h2>
 279     <p>サーバからコンテナへ送られるメッセージが
 280     <em>Forward Request</em> 型の場合 :</p>
 281     <div class="example"><pre>
 282 AJP13_FORWARD_REQUEST :=
 283     prefix_code      (byte) 0x02 = JK_AJP13_FORWARD_REQUEST
 284     method           (byte)
 285     protocol         (string)
 286     req_uri          (string)
 287     remote_addr      (string)
 288     remote_host      (string)
 289     server_name      (string)
 290     server_port      (integer)
 291     is_ssl           (boolean)
 292     num_headers      (integer)
 293     request_headers *(req_header_name req_header_value)
 294     attributes      *(attribut_name attribute_value)
 295     request_terminator (byte) OxFF
 296     </pre></div>
 297     <p><code>request_headers</code> は次のような構造になっています :
 298     </p><div class="example"><pre>
 299 req_header_name :=
 300     sc_req_header_name | (string)  [see below for how this is parsed]
 301
 302 sc_req_header_name := 0xA0xx (integer)
 303
 304 req_header_value := (string)
 305 </pre></div>
 306     <p><code>属性</code> はオプションで、次のような構造をしています :</p>
 307     <div class="example"><pre>
 308 attribute_name := sc_a_name | (sc_a_req_attribute string)
 309
 310 attribute_value := (string)
 311
 312     </pre></div>
 313     <p>もっとも重要なヘッダは <code>content-length</code> だということに
 314     注意してください。コンテナは次のパケットを探すかどうかを、
 315     それを見て決めるからです。</p>
 316   <h3>Forward Request 要素の詳細な説明
 317   </h3>
 318   <h3>Request prefix</h3>
 319     <p>リクエストについては全て、この値は 2 になります。他の Prefix コードの詳細は
 320     上記をご覧ください。</p>
 321
 322   <h3>Method</h3>
 323     <p>HTTP メソッドは 1 バイトにエンコードされます :</p>
 324     <table>
 325       <tr><td>Command Name</td><td>Code</td></tr>
 326       <tr><td>OPTIONS</td><td>1</td></tr>
 327       <tr><td>GET</td><td>2</td></tr>
 328       <tr><td>HEAD</td><td>3</td></tr>
 329       <tr><td>POST</td><td>4</td></tr>
 330       <tr><td>PUT</td><td>5</td></tr>
 331       <tr><td>DELETE</td><td>6</td></tr>
 332       <tr><td>TRACE</td><td>7</td></tr>
 333       <tr><td>PROPFIND</td><td>8</td></tr>
 334       <tr><td>PROPPATCH</td><td>9</td></tr>
 335       <tr><td>MKCOL</td><td>10</td></tr>
 336       <tr><td>COPY</td><td>11</td></tr>
 337       <tr><td>MOVE</td><td>12</td></tr>
 338       <tr><td>LOCK</td><td>13</td></tr>
 339       <tr><td>UNLOCK</td><td>14</td></tr>
 340       <tr><td>ACL</td><td>15</td></tr>
 341       <tr><td>REPORT</td><td>16</td></tr>
 342       <tr><td>VERSION-CONTROL</td><td>17</td></tr>
 343       <tr><td>CHECKIN</td><td>18</td></tr>
 344       <tr><td>CHECKOUT</td><td>19</td></tr>
 345       <tr><td>UNCHECKOUT</td><td>20</td></tr>
 346       <tr><td>SEARCH</td><td>21</td></tr>
 347       <tr><td>MKWORKSPACE</td><td>22</td></tr>
 348       <tr><td>UPDATE</td><td>23</td></tr>
 349       <tr><td>LABEL</td><td>24</td></tr>
 350       <tr><td>MERGE</td><td>25</td></tr>
 351       <tr><td>BASELINE_CONTROL</td><td>26</td></tr>
 352       <tr><td>MKACTIVITY</td><td>27</td></tr>
 353     </table>
 354     <p>今後の ajp13 バージョンでは、この一覧にない、今後追加されるメソッドを
 355     送るかもしれません。</p>
 356
 357   <h3>protocol, req_uri, remote_addr, remote_host, server_name,
 358   server_port, is_ssl</h3>
 359     <p>これらはまさに文字通りのものです。どれも必要で、リクエストの毎回につき
 360     送られます。</p>
 361
 362   <h3>Headers</h3>
 363     <p><code>request_headers</code> の構造は次のようなものです :
 364     まずヘッダの数 <code>num_headers</code> がエンコードされます。
 365     次にヘッダ名 <code>req_header_name</code> / 値 <code>req_header_value</code>
 366     の組が続きます。効率のため、一般的なヘッダは整数でエンコードして転送します。
 367     ヘッダ名が基本ヘッダの一覧に無い場合は、通常通り (文字列として、長さ
 368     プレフィックス付きで) 転送されます。一般的なヘッダ
 369     <code>sc_req_header_name</code> の一覧とそのコードは次の通りです
 370     (どれも大文字小文字を区別します) :</p>
 371     <table>
 372       <tr><td>名前</td><td>コードの値</td><td>コード名</td></tr>
 373       <tr><td>accept</td><td>0xA001</td><td>SC_REQ_ACCEPT</td></tr>
 374       <tr><td>accept-charset</td><td>0xA002</td><td>SC_REQ_ACCEPT_CHARSET
 375       </td></tr>
 376       <tr><td>accept-encoding</td><td>0xA003</td><td>SC_REQ_ACCEPT_ENCODING
 377       </td></tr>
 378       <tr><td>accept-language</td><td>0xA004</td><td>SC_REQ_ACCEPT_LANGUAGE
 379       </td></tr>
 380       <tr><td>authorization</td><td>0xA005</td><td>SC_REQ_AUTHORIZATION</td>
 381       </tr>
 382       <tr><td>connection</td><td>0xA006</td><td>SC_REQ_CONNECTION</td></tr>
 383       <tr><td>content-type</td><td>0xA007</td><td>SC_REQ_CONTENT_TYPE</td>
 384       </tr>
 385       <tr><td>content-length</td><td>0xA008</td><td>SC_REQ_CONTENT_LENGTH</td>
 386       </tr>
 387       <tr><td>cookie</td><td>0xA009</td><td>SC_REQ_COOKIE</td></tr>
 388       <tr><td>cookie2</td><td>0xA00A</td><td>SC_REQ_COOKIE2</td></tr>
 389       <tr><td>host</td><td>0xA00B</td><td>SC_REQ_HOST</td></tr>
 390       <tr><td>pragma</td><td>0xA00C</td><td>SC_REQ_PRAGMA</td></tr>
 391       <tr><td>referer</td><td>0xA00D</td><td>SC_REQ_REFERER</td></tr>
 392       <tr><td>user-agent</td><td>0xA00E</td><td>SC_REQ_USER_AGENT</td></tr>
 393     </table>
 394     <p>これを読み込む Java のコードでは、最初の 2 バイト整数を取り込み、
 395     目印になるバイト <code>'0xA0'</code> であれば、ヘッダ名の配列の
 396     インデックスを使います。先頭バイトが <code>0xA0</code> でない場合は、
 397     先頭 2 バイトは文字列長を表す整数であると解釈し、読み込みはじめます。</p>
 398     <p>ヘッダ名の長さは <code>0x9999 (==0xA000 -1)</code> 以上にならないという
 399     仮定の下に動いていて、少しあいまいですが合理的な挙動になっています。</p>
 400     <div class="note"><h3>注:</h3>
 401     <code>content-length</code> ヘッダはとても重要です。
 402     存在していて非ゼロであれば、リクエストにはボディがある (例えば POST
 403     リクエスト) と推測し、そのボディを取り込むために
 404     直後のパケットを入力ストリームから読み込みはじめます。
 405     </div>
 406
 407   <h3>属性</h3>
 408     <p><code>?</code> プレフィックスで始まる属性 (例 <code>?context</code>)
 409     は。省略可能です。それぞれ属性の型を示す 1 バイトのコードと、
 410     値(文字列か整数)が続きます。
 411     これらは順不同で送ることができます (C のコードは常に下の一覧順に
 412     送るようですが) 。
 413     オプションの属性のリストの最後には、特別な終了コードが送られます。
 414     コードの一覧は : </p>
 415     <table>
 416       <tr><td>Information</td><td>Code Value</td><td>Type Of Value</td><td>Note</td></tr>
 417       <tr><td>?context</td><td>0x01</td><td>-</td><td>未実装
 418       </td></tr>
 419       <tr><td>?servlet_path</td><td>0x02</td><td>-</td><td>未実装
 420       </td></tr>
 421       <tr><td>?remote_user</td><td>0x03</td><td>String</td><td /></tr>
 422       <tr><td>?auth_type</td><td>0x04</td><td>String</td><td /></tr>
 423       <tr><td>?query_string</td><td>0x05</td><td>String</td><td /></tr>
 424       <tr><td>?jvm_route</td><td>0x06</td><td>String</td><td /></tr>
 425       <tr><td>?ssl_cert</td><td>0x07</td><td>String</td><td /></tr>
 426       <tr><td>?ssl_cipher</td><td>0x08</td><td>String</td><td /></tr>
 427       <tr><td>?ssl_session</td><td>0x09</td><td>String</td><td /></tr>
 428       <tr><td>?req_attribute</td><td>0x0A</td><td>String</td><td>Name (the name of the
 429       attribute follows)</td></tr>
 430       <tr><td>?ssl_key_size</td><td>0x0B</td><td>Integer</td><td /></tr>
 431       <tr><td>are_done</td><td>0xFF</td><td>-</td><td>request_terminator</td></tr>
 432     </table>
 433     <p><code>context</code> と <code>servlet_path</code> は現在の C の
 434     コードではセットされていません。また、ほとんどの Java のコードでも、
 435     このフィールドで何が送られても無視されます (これらのコードの後に文字列が
 436     送られると壊れるものもあります)。
 437     これがバグなのか、単に未実装なのか、歴史的経緯で残っているコードなのか
 438     分かりませんが、コネクションの両側ともで見当たりません。</p>
 439     <p><code>remote_user</code> と <code>auth_type</code> はおそらく
 440     HTTP レベルの認証を参照していて、リモートユーザのユーザ名と認証に使用した
 441     タイプ (例 Basic, Digest) についてやり取りします。</p>
 442     <p><code>query_string</code>, <code>ssl_cert</code>,
 443     <code>ssl_cipher</code>, <code>ssl_session</code>
 444     は HTTP と HTTPS の対応する部分を参照します。</p>
 445     <p><code>jvm_route</code> はスティッキーセッションのサポート――
 446     ロードバランスしている複数のサーバ中の特定の Tomcat インスタンスと、
 447     ユーザのセッションとを紐付ける機能――に使われます。</p>
 448     <p>この基本属性一覧に無いものについては、<code>req_attribute</code>
 449     コード <code>0x0A</code> 経由で属性を何個でも送ることができます。
 450     属性の名前と値の文字列の組を、それぞれこのコードの直後に送ります。
 451     環境変数はこの方法で伝えられます。</p>
 452     <p>最後に属性が全て送信された後に、属性の終端を示す <code>0xFF</code>
 453     が送出されます。この信号は属性の一覧の終わりを示すと同時に、リクエスト
 454     パケットの終端をも示しています。</p>
 455
 456 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 457 <div class="section">
 458 <h2><a name="resppacketstruct" id="resppacketstruct">レスポンスパケット構造</a></h2>
 459     <p>コンテナがサーバに送り返すことのできるメッセージ:</p>
 460     <div class="example"><pre>
 461 AJP13_SEND_BODY_CHUNK :=
 462   prefix_code   3
 463   chunk_length  (integer)
 464   chunk        *(byte)
 465   chunk_terminator (byte) Ox00
 466
 467 AJP13_SEND_HEADERS :=
 468   prefix_code       4
 469   http_status_code  (integer)
 470   http_status_msg   (string)
 471   num_headers       (integer)
 472   response_headers *(res_header_name header_value)
 473
 474 res_header_name :=
 475     sc_res_header_name | (string)   [see below for how this is parsed]
 476
 477 sc_res_header_name := 0xA0 (byte)
 478
 479 header_value := (string)
 480
 481 AJP13_END_RESPONSE :=
 482   prefix_code       5
 483   reuse             (boolean)
 484
 485
 486 AJP13_GET_BODY_CHUNK :=
 487   prefix_code       6
 488   requested_length  (integer)
 489     </pre></div>
 490   <h3>詳細 :</h3>
 491   <h3>Send Body Chunk</h3>
 492     <p>チャンクは基本的にはバイナリデータで、ブラウザに直接送られます。</p>
 493
 494   <h3>Send Headers</h3>
 495     <p>ステータスコードとメッセージが通常の HTTP の通信にはあります (例
 496     <code>200</code> と <code>OK</code>)。レスポンスヘッダ名は、
 497     リクエストヘッダ名と同様の方法でエンコードされます。
 498     コードと文字列の判別方法の詳細に関しては、上記の header_encoding
 499     を参照してください。
 500     一般的なヘッダのコードは :</p>
 501     <table>
 502       <tr><td>名前</td><td>コードの値</td></tr>
 503       <tr><td>Content-Type</td><td>0xA001</td></tr>
 504       <tr><td>Content-Language</td><td>0xA002</td></tr>
 505       <tr><td>Content-Length</td><td>0xA003</td></tr>
 506       <tr><td>Date</td><td>0xA004</td></tr>
 507       <tr><td>Last-Modified</td><td>0xA005</td></tr>
 508       <tr><td>Location</td><td>0xA006</td></tr>
 509       <tr><td>Set-Cookie</td><td>0xA007</td></tr>
 510       <tr><td>Set-Cookie2</td><td>0xA008</td></tr>
 511       <tr><td>Servlet-Engine</td><td>0xA009</td></tr>
 512       <tr><td>Status</td><td>0xA00A</td></tr>
 513       <tr><td>WWW-Authenticate</td><td>0xA00B</td></tr>
 514     </table>
 515     <p>コードかヘッダ文字列の直後には、ヘッダの値がエンコードされます。</p>
 516
 517   <h3>End Response</h3>
 518     <p>リクエスト処理サイクルの終了を知らせます。<code>reuse</code> フラグが真
 519     <code>(==1)</code> の場合、現在使用している TCP コネクションは次の新しい
 520     リクエストに使えるようになります。<code>reuse</code> が偽 (C のコードでは
 521     1 以外の全て) の場合は、コネクションを閉じることになります。</p>
 522
 523   <h3>Get Body Chunk</h3>
 524     <p>(ボディのサイズが大きすぎて最初のパケットに収まらない場合や、
 525     リクエストがチャンク転送された場合などには、) コンテナはリクエストからの
 526     データ読み込み要求をします。サーバ側はそれに対して、最小
 527     <code>request_length</code> 最大 <code>(8186 (8 Kbytes - 6))</code>
 528     の範囲で、未転送で残っているリクエストボディの大きさのデータを
 529     送り返します。<br />
 530     ボディにそれ以上データが残っていない場合 (つまりサーブレットが
 531     ボディの最後を超えて読み込もうとした場合) 、サーバは
 532     ペイロード長 0 の<em>空パケット</em><code>(0x12,0x34,0x00,0x00)</code>
 533     を送り返します。</p>
 534
 535 </div>
 536 </div>
 537 <div class="bottomlang">
 538 <p><span>言語: </span><a href="../en/mod/mod_proxy_ajp.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 539 <a href="../ja/mod/mod_proxy_ajp.html" title="Japanese">&nbsp;ja&nbsp;</a></p>
 540 </div><div id="footer">
 541 <p class="apache">Copyright 2010 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>
 542 <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>
 543 </body></html>