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" /><link rel="stylesheet" type="text/css" href="/style/css/prettify.css" /> 12<script src="/style/scripts/prettify.min.js" type="text/javascript"> 13</script> 14 15<link href="/images/favicon.ico" rel="shortcut icon" /></head> 16<body> 17<div id="page-header"> 18<p class="menu"><a href="/mod/">モジュール</a> | <a href="/mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">用語</a> | <a href="/sitemap.html">サイトマップ</a></p> 19<p class="apache">Apache HTTP サーバ バージョン 2.4</p> 20<img alt="" src="/images/feather.gif" /></div> 21<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div> 22<div id="path"> 23<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP サーバ</a> > <a href="http://httpd.apache.org/docs/">ドキュメンテーション</a> > <a href="../">バージョン 2.4</a> > <a href="./">モジュール</a></div> 24<div id="page-content"> 25<div id="preamble"><h1>Apache モジュール mod_proxy_ajp</h1> 26<div class="toplang"> 27<p><span>翻訳済み言語: </span><a href="/en/mod/mod_proxy_ajp.html" hreflang="en" rel="alternate" title="English"> en </a> | 28<a href="/fr/mod/mod_proxy_ajp.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | 29<a href="/ja/mod/mod_proxy_ajp.html" title="Japanese"> ja </a></p> 30</div> 31<div class="outofdate">この日本語訳はすでに古くなっている 32 可能性があります。 33 最近更新された内容を見るには英語版をご覧下さい。 34 </div> 35<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 36をサポートするためのモジュール</td></tr> 37<tr><th><a href="module-dict.html#Status">ステータス:</a></th><td>Extension</td></tr> 38<tr><th><a href="module-dict.html#ModuleIdentifier">モジュール識別子:</a></th><td>proxy_ajp_module</td></tr> 39<tr><th><a href="module-dict.html#SourceFile">ソースファイル:</a></th><td>mod_proxy_ajp.c</td></tr></table> 40<h3>概要</h3> 41 42 <p>本モジュールには <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> が<em>必要です</em>。 43 <code>Apache JServ Protocol version 1.3</code> (以降 <em>AJP13</em>) 44 をサポートします。</p> 45 46 <p><code>AJP13</code> プロトコルを扱えるようにするには 47 <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> 48 をサーバに組み込む必要があります。</p> 49 50 <div class="warning"><h3>警告</h3> 51 <p><a href="#access">安全なサーバにする</a>までプロクシ機能は有効にしないでください。 52 オープンプロキシサーバはあなた自身のネットワークにとっても、 53 インターネット全体にとっても危険です。</p> 54 </div> 55</div> 56<div id="quickview"><h3 class="directives">ディレクティブ</h3> 57<p>このモジュールにディレクティブはありません。</p> 58<h3>トピック</h3> 59<ul id="topics"> 60<li><img alt="" src="/images/down.gif" /> <a href="#overviewprotocol">プロトコルの概要</a></li> 61<li><img alt="" src="/images/down.gif" /> <a href="#basppacketstruct">基本パケット構造</a></li> 62<li><img alt="" src="/images/down.gif" /> <a href="#rpacetstruct">リクエストパケット構造</a></li> 63<li><img alt="" src="/images/down.gif" /> <a href="#resppacketstruct">レスポンスパケット構造</a></li> 64</ul><h3>参照</h3> 65<ul class="seealso"> 66<li><code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code></li> 67</ul><ul class="seealso"><li><a href="#comments_section">コメント</a></li></ul></div> 68<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 69<div class="section"> 70<h2><a name="overviewprotocol" id="overviewprotocol">プロトコルの概要</a></h2> 71 <p><code>AJP13</code> プロトコルはパケット指向です。 72 可読なプレーンテキスト形式ではなくバイナリ形式になったのは、 73 おそらくパフォーマンス上の理由によります。 74 ウェブサーバはサーブレットコンテナと TCP コネクションで通信します。 75 ソケット生成は重い処理なので、負荷を減らすために、サーブレットコンテナとの 76 TCP 接続を維持し、複数のリクエスト・レスポンス処理サイクルに対して一つの 77 コネクションを使いまわすようになっています。</p> 78 <p>あるリクエストにコネクションが割り当てられると、その処理サイクルが 79 完了するまで他のものに使われることはありません。 80 つまりコネクション上では、リクエストの同時処理は行われません。 81 このため、コネクション両端での実行するコードを簡潔にできる一方で、 82 同時に開くコネクションは多くなっています。</p> 83 <p>サーブレットコンテナへのコネクションを開いた後は、コネクションの状態は 84 次のどれかになります:</p> 85 <ul> 86 <li> Idle <br />コネクション上で処理されているリクエストはありません。</li> 87 <li> Assigned <br />コネクションはリクエストを処理中です。</li> 88 </ul> 89 <p>コネクションが特定のリクエストにアサインされると、基本的な情報 (例えば 90 HTTP ヘッダ等) が圧縮された形 (例えば通常の文字列は整数にエンコードされます) 91 で転送されます。詳細は下記の「リクエストパケットの構造」を参照してください。 92 リクエストにボディが存在 <code>(content-length > 0)</code> すれば、 93 基本的な情報の直後に別パケットで転送されます。</p> 94 <p>この時点でおそらく、サーブレットコンテナは処理を開始できるようになります。 95 ですので、次のメッセージをウェブサーバに戻して知らせられるようになります。</p> 96 <ul> 97 <li>SEND_HEADERS <br />ブラウザにヘッダを送信します。</li> 98 <li>SEND_BODY_CHUNK <br />ブラウザにボディデータのチャンクを送ります。 99 </li> 100 <li>GET_BODY_CHUNK <br />リクエストのデータを全て受け取り終わっていないときに、 101 残っているデータを受け取ります。パケットにある定まった最大長があり、任意の 102 大きさのデータがリクエストのボディとして含まれうる場合 103 (例えばファイルのアップロードの場合) に必要となります。 104 (注: HTTP のチャンク転送とは関連ありません。)</li> 105 <li>END_RESPONSE <br />リクエスト処理サイクルを終了します。</li> 106 </ul> 107 <p>個々のメッセージはそれぞれ異なるデータパケット形式になっています。 108 後述の「レスポンスパケットの構造」を参照してください。</p> 109</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 110<div class="section"> 111<h2><a name="basppacketstruct" id="basppacketstruct">基本パケット構造</a></h2> 112 <p>このプロトコルには XDR から受け継いだ部分が少しありますが、多くの点で 113 異なります (例えば 4 バイトアライメントでないことなど) 。</p> 114 <p>バイトオーダー: 個々のバイトのエンディアンがどうなっているかは、 115 私は詳しくないのですが、リトルエンディアンになっていると思います。 116 XDR 仕様でそうなっているのと、素晴らしいことに sys/socket ライブラリが 117 (C で) そういう風にできているのでそうなのだと思いました。 118 ソケット呼び出しの内部についてより詳しい方がいらっしゃいましたら、 119 ご教授ください。</p> 120 <p>プロトコルには 4 つのデータタイプがあります: byte, boolean, 121 integer, string です。</p> 122 <dl> 123 <dt><strong>Byte</strong></dt><dd>バイト一つです。</dd> 124 <dt><strong>Boolean</strong></dt> 125 <dd>バイト一つで、<code>1 = true</code>, <code>0 = false</code> です。 126 (C のように) 非零を真として扱ってしまうと、ある場合は動くかもしれませんし、 127 動かないかもしれません。</dd> 128 <dt><strong>Integer</strong></dt> 129 <dd><code>0 から 2^16 (32768)</code> の範囲の数字。高次の 2 バイトが 130 先に格納されます。</dd> 131 <dt><strong>String</strong></dt> 132 <dd>可変長の文字列 (2^16 が長さの上限) 。長さ情報のパケット 2 バイトの後に 133 文字列 (終端文字 '\0' を含む) が続く形式でエンコードされます。 134 エンコードされている長さ情報は最後の '\0' を<strong>カウントしない</strong> 135 ことに注意してください――これは <code>strlen</code> と同様です。 136 これらの終端文字をスキップするために、あまり意味の無いインクリメント文 137 をたくさん書かないといけないのは、 138 Java の側から見ると少し紛らわしく感じられるかもしれません。 139 こうなった理由はおそらく、Servlet コンテナから返される文字列を読み出す時に、 140 効率よく C のコードを書けるようにする――サーブレットから返される 141 文字列は \0 文字で終端されているので、C のコードではわざわざコピーをせずに、 142 一つのバッファへのリファレンスを取り回すように書くことができる―― 143 ためだと思われます。 144 '\0' 文字がない場合は、C では文字列の規則に合うようにコピーしなければ 145 いけなくなってしまいます。</dd> 146 </dl> 147 148 <h3>パケットサイズ</h3> 149 <p>多くのコードでそうなっているのですが、パケットサイズの最大サイズは 150 <code>8 * 1024 (8K)</code> です。パケットの実際の長さはヘッダに 151 エンコードされて入っています。</p> 152 153 <h3>パケットヘッダ</h3> 154 <p>サーバからコンテナに送出されるパケットは <code>0x1234</code> で始まります。 155 コンテナからサーバに送られるパケットは <code>AB</code> (ASCII コード A と 156 ASCII コード B) で始まります。この二バイトの後に、ペイロード長が (上記の形式で) 157 続きます。このため、ペイロード長の最大値は 2^16 にできるように思えますが、 158 実際にはコードでは最大値は 8K に設定されています。</p> 159 <table> 160 <tr> 161 <td colspan="6"><em>パケット形式 (Server->Container)</em></td> 162 </tr> 163 <tr> 164 <td>Byte</td> 165 <td>0</td> 166 <td>1</td> 167 <td>2</td> 168 <td>3</td> 169 <td>4...(n+3)</td> 170 </tr> 171 <tr> 172 <td>Contents</td> 173 <td>0x12</td> 174 <td>0x34</td> 175 <td colspan="2">データ長 (n)</td> 176 <td>Data</td> 177 </tr> 178 </table> 179 <table> 180 <tr> 181 <td colspan="6"><em>パケット形式 (Container->Server)</em></td> 182 </tr> 183 <tr> 184 <td>Byte</td> 185 <td>0</td> 186 <td>1</td> 187 <td>2</td> 188 <td>3</td> 189 <td>4...(n+3)</td> 190 </tr> 191 <tr> 192 <td>Contents</td> 193 <td>A</td> 194 <td>B</td> 195 <td colspan="2">データ長 (n)</td> 196 <td>Data</td> 197 </tr> 198 </table> 199 <p>ほとんどのパケットで、ペイロードの最初のバイトがメッセージの型をエンコード 200 しています。例外はサーバからコンテナに送られるリクエストボディパケットです 201 ――これらは標準的なパケット形式 (<code>0x1234</code> とパケット長) 202 ですが、その後に続くプレフィックスコードがありません。</p> 203 <p>ウェブサーバは次のメッセージをサーブレットコンテナに送出できます。</p> 204 <table> 205 <tr> 206 <td>コード</td> 207 <td>パケットの型</td> 208 <td>意味</td> 209 </tr> 210 <tr> 211 <td>2</td> 212 <td>Forward Request</td> 213 <td>リクエスト処理サイクルを後続のデータとともに開始する。</td> 214 </tr> 215 <tr> 216 <td>7</td> 217 <td>Shutdown</td> 218 <td>ウェブサーバがコンテナに、コンテナを終了するように伝える。</td> 219 </tr> 220 <tr> 221 <td>8</td> 222 <td>Ping</td> 223 <td>ウェブサーバがコンテナに制御を受け持つように伝える 224 (セキュアログインフェーズ) 。</td> 225 </tr> 226 <tr> 227 <td>10</td> 228 <td>CPing</td> 229 <td>ウェブサーバがコンテナに CPong で即座に応答するように伝える。</td> 230 </tr> 231 <tr> 232 <td>none</td> 233 <td>Data</td> 234 <td>サイズ (2 バイト) とそれに続くボディデータ。</td> 235 </tr> 236 </table> 237 <p>基本的なセキュリティを確保するため、ホストされているマシンと同一の 238 マシンからのリクエストに対してのみ、コンテナは実際に <code>Shutdown</code> 239 を実行します。</p> 240 <p>最初の <code>Data</code> パケットは、<code>Forward Request</code> 241 の直後にウェブサーバから送られます。</p> 242 <p>サーブレットコンテナはウェブサーバに、次のタイプのメッセージを送ることが 243 できます :</p> 244 <table> 245 <tr> 246 <td>コード</td> 247 <td>パケットの型</td> 248 <td>意味</td> 249 </tr> 250 <tr> 251 <td>3</td> 252 <td>Send Body Chunk</td> 253 <td>サーブレットコンテナからウェブサーバに 254 (そしておそらくそのままブラウザに)、ボディのチャンクを送る。</td> 255 </tr> 256 <tr> 257 <td>4</td> 258 <td>Send Headers</td> 259 <td>サーブレットコンテナからウェブサーバに (そしておそらくそのままブラウザに) 260 レスポンスヘッダを送る。</td> 261 </tr> 262 <tr> 263 <td>5</td> 264 <td>End Response</td> 265 <td>レスポンス (つまりリクエスト処理サイクル) 終了の目印を送る。 266 </td> 267 </tr> 268 <tr> 269 <td>6</td> 270 <td>Get Body Chunk</td> 271 <td>まだ全て転送されていない場合、残っているリクエストのデータを受け取る。 272 </td> 273 </tr> 274 <tr> 275 <td>9</td> 276 <td>CPong 応答</td> 277 <td>CPing リクエストに応答する。</td> 278 </tr> 279 </table> 280 <p>上記メッセージは、それぞれ内部構造が異なっています。詳細は下記をご覧ください。 281 </p> 282 283</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 284<div class="section"> 285<h2><a name="rpacetstruct" id="rpacetstruct">リクエストパケット構造</a></h2> 286 <p>サーバからコンテナへ送られるメッセージが 287 <em>Forward Request</em> 型の場合 :</p> 288 <div class="example"><pre>AJP13_FORWARD_REQUEST := 289 prefix_code (byte) 0x02 = JK_AJP13_FORWARD_REQUEST 290 method (byte) 291 protocol (string) 292 req_uri (string) 293 remote_addr (string) 294 remote_host (string) 295 server_name (string) 296 server_port (integer) 297 is_ssl (boolean) 298 num_headers (integer) 299 request_headers *(req_header_name req_header_value) 300 attributes *(attribut_name attribute_value) 301 request_terminator (byte) OxFF</pre></div> 302 <p><code>request_headers</code> は次のような構造になっています : 303 </p><div class="example"><pre>req_header_name := 304 sc_req_header_name | (string) [see below for how this is parsed] 305 306sc_req_header_name := 0xA0xx (integer) 307 308req_header_value := (string)</pre></div> 309 <p><code>属性</code> はオプションで、次のような構造をしています :</p> 310 <div class="example"><pre>attribute_name := sc_a_name | (sc_a_req_attribute string) 311 312attribute_value := (string)</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>AJP13_SEND_BODY_CHUNK := 461 prefix_code 3 462 chunk_length (integer) 463 chunk *(byte) 464 chunk_terminator (byte) Ox00 465 466AJP13_SEND_HEADERS := 467 prefix_code 4 468 http_status_code (integer) 469 http_status_msg (string) 470 num_headers (integer) 471 response_headers *(res_header_name header_value) 472 473res_header_name := 474 sc_res_header_name | (string) [see below for how this is parsed] 475 476sc_res_header_name := 0xA0 (byte) 477 478header_value := (string) 479 480AJP13_END_RESPONSE := 481 prefix_code 5 482 reuse (boolean) 483 484 485AJP13_GET_BODY_CHUNK := 486 prefix_code 6 487 requested_length (integer)</pre></div> 488 <h3>詳細 :</h3> 489 <h3>Send Body Chunk</h3> 490 <p>チャンクは基本的にはバイナリデータで、ブラウザに直接送られます。</p> 491 492 <h3>Send Headers</h3> 493 <p>ステータスコードとメッセージが通常の HTTP の通信にはあります (例 494 <code>200</code> と <code>OK</code>)。レスポンスヘッダ名は、 495 リクエストヘッダ名と同様の方法でエンコードされます。 496 コードと文字列の判別方法の詳細に関しては、上記の header_encoding 497 を参照してください。 498 一般的なヘッダのコードは :</p> 499 <table> 500 <tr><td>名前</td><td>コードの値</td></tr> 501 <tr><td>Content-Type</td><td>0xA001</td></tr> 502 <tr><td>Content-Language</td><td>0xA002</td></tr> 503 <tr><td>Content-Length</td><td>0xA003</td></tr> 504 <tr><td>Date</td><td>0xA004</td></tr> 505 <tr><td>Last-Modified</td><td>0xA005</td></tr> 506 <tr><td>Location</td><td>0xA006</td></tr> 507 <tr><td>Set-Cookie</td><td>0xA007</td></tr> 508 <tr><td>Set-Cookie2</td><td>0xA008</td></tr> 509 <tr><td>Servlet-Engine</td><td>0xA009</td></tr> 510 <tr><td>Status</td><td>0xA00A</td></tr> 511 <tr><td>WWW-Authenticate</td><td>0xA00B</td></tr> 512 </table> 513 <p>コードかヘッダ文字列の直後には、ヘッダの値がエンコードされます。</p> 514 515 <h3>End Response</h3> 516 <p>リクエスト処理サイクルの終了を知らせます。<code>reuse</code> フラグが真 517 <code>(==1)</code> の場合、現在使用している TCP コネクションは次の新しい 518 リクエストに使えるようになります。<code>reuse</code> が偽 (C のコードでは 519 1 以外の全て) の場合は、コネクションを閉じることになります。</p> 520 521 <h3>Get Body Chunk</h3> 522 <p>(ボディのサイズが大きすぎて最初のパケットに収まらない場合や、 523 リクエストがチャンク転送された場合などには、) コンテナはリクエストからの 524 データ読み込み要求をします。サーバ側はそれに対して、最小 525 <code>request_length</code> 最大 <code>(8186 (8 Kbytes - 6))</code> 526 の範囲で、未転送で残っているリクエストボディの大きさのデータを 527 送り返します。<br /> 528 ボディにそれ以上データが残っていない場合 (つまりサーブレットが 529 ボディの最後を超えて読み込もうとした場合) 、サーバは 530 ペイロード長 0 の<em>空パケット</em><code>(0x12,0x34,0x00,0x00)</code> 531 を送り返します。</p> 532 533</div> 534</div> 535<div class="bottomlang"> 536<p><span>翻訳済み言語: </span><a href="/en/mod/mod_proxy_ajp.html" hreflang="en" rel="alternate" title="English"> en </a> | 537<a href="/fr/mod/mod_proxy_ajp.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | 538<a href="/ja/mod/mod_proxy_ajp.html" title="Japanese"> ja </a></p> 539</div><div class="top"><a href="#page-header"><img src="/images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> 540<script type="text/javascript"><!--//--><![CDATA[//><!-- 541var comments_shortname = 'httpd'; 542var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/mod_proxy_ajp.html'; 543(function(w, d) { 544 if (w.location.hostname.toLowerCase() == "httpd.apache.org") { 545 d.write('<div id="comments_thread"><\/div>'); 546 var s = d.createElement('script'); 547 s.type = 'text/javascript'; 548 s.async = true; 549 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; 550 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); 551 } 552 else { 553 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); 554 } 555})(window, document); 556//--><!]]></script></div><div id="footer"> 557<p class="apache">Copyright 2014 The Apache Software Foundation.<br />この文書は <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> のライセンスで提供されています。.</p> 558<p class="menu"><a href="/mod/">モジュール</a> | <a href="/mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">用語</a> | <a href="/sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- 559if (typeof(prettyPrint) !== 'undefined') { 560 prettyPrint(); 561} 562//--><!]]></script> 563</body></html>