Apache Traffic Server 6.2 - en to ja_JP translation catalogue (47 entries)

en: **Protocol Plugin Overview**
ja_JP: **プロトコルプラグイン概要**

en: **Transaction state machines** that read client requests, process them, and are then destroyed when the transaction is finished.
ja_JP: クライアントリクエストを読込み、処理し、トランザクションが終了した際に破棄される **トランザクションステートマシン**

en: About the Sample Protocol
ja_JP: サンプルプロトコルについて

en: An **accept state machine** that listens for client connections, and then creates transaction state machines whenever Traffic Server accepts a new client connection. The accept state machine lives as long as Traffic Server is running.
ja_JP: クライアントコネクションを listen し、 Traffic Server が新しいクライアントコネクションを accept する度にトランザクションステートマシンを生成する **accept ステートマシン** 。 accept ステートマシンは Traffic Server が動作している限り残ります。

en: Cache the response and send it on to the client
ja_JP: レスポンスをキャッシュし、クライアントに送信する。

en: Continuations in the Protocol Plugin
ja_JP: プロトコルプラグインにおける継続

en: In more specific terms, Traffic Server and the Protocol plugin must:
ja_JP: より具体的には、 Traffic Server とプロトコルプラグインは下記の処理をする必要があります。:

en: Forward the request to the origin server
ja_JP: オリジンサーバーへリクエストを転送する。

en: Keep track of the state of the transaction
ja_JP: トランザクションの状態を追跡し続ける

en: Listen for and accept client connections (on the accept port specified in :file:`plugin.config`)
ja_JP: クライアントコネクションの listen と accept を行う。（サーバーポートは :file:`plugin.config` で指定される）

en: Look up the requested content in the Traffic Server cache
ja_JP: リクエストされたコンテンツを、 Traffic Server キャッシュ内でルックアップする

en: New Protocol Plugins
ja_JP: 新規プロトコルプラグイン

en: **Protocol Plugin Flow of Events**
ja_JP: **プロトコルプラグインのイベントのフロー**

en: **Transaction state machines** (**TSMs**) in the Protocol plugin must do the following:
ja_JP: プロトコルプラグインの **トランザクションステートマシン** （ **TSM** ）は下記のようにする必要があります。

en: Below is a summary of the continuations implemented for the Protocol plugin:
ja_JP: 下記はプロトコルプラグインの為に実装される継続の概要です:

en: Event Flow
ja_JP: イベントフロー

en: Open a connection to the origin server if the request is a cache miss (on the server port specified in :file:`plugin.config`)
ja_JP: リクエストがキャッシュミスした場合、オリジンサーバーとのコネクションを開く。（サーバーポートは :file:`plugin.config` で指定される）

en: Below is a step-by-step walk-through of the code that processes a typical transaction.
ja_JP: 下記は典型的なトランザクションを処理するコードの、段階的なウォークスルーです。

en: Below is one way you can implement TSMs. Details about how the Protocol plugin does this are provided in the next section.
ja_JP: 以下は TSM を実装できる方法の一つです。プロトコルプラグインがこれをどう行っているかの詳細は次の節で説明します。

en: Create a data structure for transactions that contains all of the state data you need to keep track of. In the Protocol plugin this is a struct, ``Txn_SM``.
ja_JP: 追跡し続ける必要のある全ての状態データを含む、トランザクションのデータ構造を作成する。サンプルのプロトコルプラグインにおいてこれは ``Txn_SM`` 構造体。

en: Handle events received (based on the state of the transaction and the event received)
ja_JP: （トランザクションの状態と受け取ったイベントに基づき）受け取ったイベントを処理する

en: If the transaction state machine needs to open a connection to the origin server to fetch content (in the case of a cache miss), then the transaction state machine initiates a DNS lookup of the server name. The transaction state machine is activated by a DNS lookup event from the Traffic Server **Host Database Processor**. If the transaction must connect to the origin server, then the transaction state machine initiates a net connection and waits for an event from the Net Processor.
ja_JP: トランザクションステートマシンがコンテンツを取得するためオリジンサーバーへのコネクションを開く必要がある場合（キャッシュミスした場合）、トランザクションステートマシンはサーバー名の DNS ルックアップを開始します。トランザクションステートマシンは Traffic Server の **ホストデータベースプロセッサー** からの DNS ルックアップイベントによって始動します。トランザクションがオリジンサーバーへ接続しなければならない場合、トランザクションステートマシンはネットコネクションを開始し、ネットプロセッサーからのイベントを待ちます。

en: Implementing the rest of the Protocol plugin requires that you understand the flow of events during the course of a transaction. Unlike HTTP transaction plugins, this plugin must read data from network connections and then read/write data to the Traffic Server cache. This means that its continuations do not receive HTTP state machine events; they receive events from Traffic Server's processor subsystems. For example: the accept state machine is activated by an ``TS_EVENT_NET_ACCEPT`` event from Traffic Server's Net Processor; the handler function for the accept state machine must therefore be able to handle that event.
ja_JP: プロトコルプラグインの残りの実装には、トランザクションの過程の中のイベントのフローの理解が求められます。 HTTP トランザクションプラグインとは異なり、このプラグインはネットワークコネクションからデータを読込み、 Traffic Server キャッシュへデータを読込み/書込みしなければなりません。これは、その継続は HTTP ステートマシンのイベントを受け取らず、 Traffic Server のプロセッサーサブシステムからイベントを受け取ることを意味します。例えば accept ステートマシンは、Traffic Server のネットプロセッサーからのイベント ``TS_EVENT_NET_ACCEPT`` によって始動します。 accept ステートマシンのハンドラー関数はそのため、このイベントを処理できなければなりません。

en: Protocol Plugin Flow of Events
ja_JP: プロトコルプラグインのイベントのフロー

en: Protocol Plugin Overview
ja_JP: プロトコルプラグイン概要

en: Protocol Plugin Structure
ja_JP: プロトコルプラグインの構造

en: Receive the origin server response
ja_JP: オリジンサーバーのレスポンスを受け取る。

en: How Transaction State Machines are Implemented in the Protocol Plugin
ja_JP: プロトコルプラグインにおいてトランザクションステートマシンがどのように実装されるか

en: Notice that this flow of events is independent of the Protocol plugin's design (i.e., whether you build **accept** or **transaction** state machines). Any plugin that supports network connections uses the net vconnection interfaces (``TSNetAccept``, ``TSNetConnect``) and thus receives events from the Net Processor. Any plugin that performs cache lookups or cache writes uses ``TSCacheRead``, ``TSCacheWrite``, ``TSVConnRead``, and ``TSVConnWrite`` and thus receives events from the Cache Processor and Traffic Server event system. Similarly, any plugin that does DNS lookups receives events from the Host Database Processor.
ja_JP: このイベントのフローは、プロトコルプラグインの設計（すなわち、 **accept** ステートマシンや **トランザクション** ステートマシンの組み立て）とは独立していることに注意してください。ネットワークコネクションをサポートするプラグインは net vconnection インタフェース（ ``TSNetAccept``, ``TSNetConnect`` ） を使用し、それによってネットプロセッサーからイベントを受け取ります。キャッシュルックアップやキャッシュ書込みを行うプラグインは、 ``TSCacheRead`` 、 ``TSCacheWrite`` 、 ``TSVConnRead`` 、 そして ``TSVConnWrite`` を使用し、それによってキャッシュプロセッサーと Traffic Server イベントシステムからイベントを受け取ります。同様に DNS ルックアップを行うプラグインはホストデータベースプロセッサーからイベントを受け取ります。

en: One Way to Implement a Transaction State Machine
ja_JP: トランザクションステートマシンを実装する方法の一つ

en: Sample Protocol State Diagram
ja_JP: サンプルプロトコルの状態遷移図

en: Serve content from cache if the request is a cache hit (this simple example does not do freshness checking)
ja_JP: リクエストがキャッシュヒットした場合、キャッシュからコンテンツを配信する。（このシンプルな例では新鮮さのチェックを行わない）

en: The first steps for writing the Protocol plugin are now clear: in ``TSPluginInit``, you must create a continuation that listens for net connections on the client port specified in :file:`plugin.config` (this continuation is the accept state machine).
ja_JP: プロトコルプラグインの記述の最初のステップは明確です。 ``TSPluginInit`` で、 :file:`plugin.config` で指定されたクライアントポートでネットコネクションを listen する継続を生成しなければなりません。（この継続は accept ステートマシンです）

en: The new protocol APIs enable you to extend Traffic Server to be a web proxy for any protocol. This chapter describes new protocol APIs and the plugins that support new protocols. It also provides a detailed review of code for a sample Protocol plugin that supports a very simple artificial HTTP-like protocol.
ja_JP: 新規プロトコルプラグインは Traffic Server を任意のプロトコルのウェブプロキシーに拡張することを可能にします。この章では新規プロトコル API と新規プロトコルをサポートするプラグインについて説明します。また非常にシンプルな模造の HTTP ライクなプロトコルをサポートするサンプルプロトコルプラグインのコードの詳細なレビューも示します。

en: The sample protocol enables a client to ask a server for a file. Clients send requests to a specific Traffic Server port (specified in :file:`plugin.config`); each request has the following structure::
ja_JP: サンプルプロトコルはクライアントがサーバーにファイルを問い合わせることを可能にします。クライアントは特定の Traffic Server ポート（ :file:`plugin.config` で指定される）にリクエストを送信します。各リクエストは下記の構造を持ちます。

en: The transaction state machines are activated when the client connection receives incoming request data. The **Net Processor** notifies the transaction state machine of incoming data. The transaction state machine reads the data; when finished, it initiates a cache lookup of the requested file. When the cache lookup completes, the transaction state machine is activated by the Traffic Server **Cache Processor**.
ja_JP: トランザクションステートマシンはクライアントコネクションがやって来たリクエストデータを受信した際に始動します。 **ネットプロセッサー** はやって来たデータのトランザクションステートマシンに通知します。トランザクションステートマシンはそのデータを読込み、それが終了した際にリクエストされたファイルのキャッシュルックアップを開始します。キャッシュルックアップが完了した際、トランザクションステートマシンは Traffic Server の **キャッシュプロセッサー** によって始動します。

en: Processing a Typical Transaction
ja_JP: 典型的なトランザクションの処理

en: Read incoming client requests
ja_JP: やってきたクライアントリクエストを読込む

en: The ``TSPluginInit`` function is in the ``Protocol.c`` file. It checks the validity of the ``plugin.config`` entries (there must be two: a client accept port and a server port) and runs an initialization routine, ``init``.
ja_JP: ``TSPluginInit`` 関数は ``Protocol.c`` ファイルにあります。これは ``plugin.config`` のエントリの正当性（クライアント accept ポートとサーバーポートの二つが存在しなければならない）をチェックし、初期化ルーチン ``init`` を実行します。

en: The code is contained in the following files:
ja_JP: コードは下記のファイルに含まれます。:

en: Update the state of the transaction as it changes
ja_JP: 変更があったらトランザクションの状態を更新する

en: When you create the TSM's continuation, initialize data of type ``Txn_SM``. Initialize the data to the initial state of a transaction (in this case, a net connection has just been accepted). Associate this data to the TSM continuation using ``TSContDataSet``.
ja_JP: TSM の継続を作成する際、``Txn_SM`` 型のデータを初期化する。データをトランザクションの初期状態に初期化する。（この場合、ネットコネクションはちょうど accept されている）このデータを ``TSContDataSet`` を使って TSM 継続に関連付ける。

en: Write state handler functions that handle the expected events for each state.
ja_JP: 状態ごとに予想されるイベントを処理する、状態ハンドラー関数を記述する。

en: Write the handler for the TSM. Its job is to receive events, examine the current state, and execute the appropriate state handler function. In the Protocol plugin, the handler is ``main_handler``. ``main_handler`` calls the state handler functions to handle each state.
ja_JP: TSM のハンドラーを記述する。そのジョブはイベントを受け取る、現在の状態を検査する、そして適切な状態ハンドラー関数を実行する。プロトコルプラグインにおいて、そのハンドラーは ``main_handler`` である。 ``main_handler`` は各状態を処理するために状態ハンドラー関数を呼び出す。

en: ``Accept.c`` and ``Accept.h``
ja_JP: ``Accept.c`` と ``Accept.h``

en: ``Protocol.c`` and ``Protocol.h``
ja_JP: ``Protocol.c`` と ``Protocol.h``

en: ``TxnSM.c`` and ``TxnSM.h``
ja_JP: ``TxnSM.c`` と ``TxnSM.h``
