新規ネットワーク・プロトコルを作成するには、「新規プロトコル」ページを使用します。
プロトコルを作成した後、通常はネットワーク・リスナーを同じ名前で作成し、ネットワーク・リスナーをプロトコルに関連付けます。または、ネットワーク・リスナーを作成するときに、デフォルト設定のプロトコルを同時に作成することもできます。
「新規プロトコル」ページには、次のオプションが含まれます。
このページの設定が適用される構成の名前。このフィールドは読取り専用です。
プロトコルの一意の名前。プロトコル名の先頭に数字を使用することはできません。
このオプションが選択されている場合、プロトコルに対してセキュリティは有効です。このオプションは、デフォルトでは無効になっています。セキュリティを有効にすると、「プロトコルを編集」ページの「SSL」タブを使用してセキュリティ設定を変更できます。
このオプションを選択すると、ファイル・キャッシュが有効になります。このオプションはデフォルトで有効になっています。
秒単位の有効なキャッシュ・エントリの最長有効期間。
このパラメータは、ファイルをキャッシュに書き込んだ後に、キャッシュに書き込んだ情報を使用する期間を制御します。最長有効期間より古いエントリは、同じファイルの新しいエントリに置き換えられます。内容の変更が頻繁でない場合は、この値を大きくするとパフォーマンスが向上します。
最適な最長有効期間は、既存のファイルが定期的に変更されるかどうかに依存します。たとえば、ファイルが1日に4回一定間隔で変更される場合は、最長有効期間を21600秒(6時間)に設定できます。そうでない場合は、最長有効期間を、ファイルの変更後に内容が前のバージョンのファイルを提供する最長の時間に設定することを考慮してください。
デフォルト値は30です。
ディスク上のファイル・キャッシュの最大合計サイズ(バイト単位)。デフォルト値は10485760です。
ファイル・キャッシュに保持できるファイルの最大数。
この値が大きすぎると、サーバーはほとんど必要のないファイルもキャッシュに書き込むため、メモリーの浪費になります。この値が小さすぎると、キャッシュの利点が失われます。この属性については、様々な値を試してみて、特定のアプリケーションに最適な値を見つけてください。
デフォルト値は1024です。
サーバーがクライアントに送信するURLで使用されるホスト名。サーバーがエイリアスを使用している場合、この名前はエイリアスです。サーバーがエイリアスを使用していない場合は、このフィールドを空のまま残します。
この値は、サーバーが自動的に生成するURLには影響しますが、サーバーに格納されているディレクトリやファイルのURLには影響しません。サーバーがエイリアスを使用している場合は、サーバー名をエイリアスにしてください。コロンとポート番号を付加すると、サーバーは指定したポートを使用してクライアントにURLを送信します。
プロトコルに関連付けられる仮想サーバー。仮想サーバーを定義するには、「仮想サーバー」ページを使用します。
リクエストを別のポートにリダイレクトするポート値。GlassFish Serverは、次の2つの条件が存在する場合、リクエストを自動的にリダイレクトします。
このプロトコルを参照するネットワーク・リスナーは、非SSLリクエストをサポートしています。
一致したセキュリティ制約がSSLトランスポートを必要とするリクエストが受信されます。
リダイレクト・ポートが指定されていない場合、GlassFish Serverは元のリクエストで指定されていたポート番号を使用します。デフォルトでは、ポートは指定されていません。
サーバーによって接続がクローズされるまでの、パイプラインできるリクエストの最大数を指定します。キープアライブ・サブシステムは定期的にアイドル接続をポーリングします。デフォルト値は256です。
HTTP/1.0キープアライブ、HTTP/1.1キープアライブ、およびパイプラインを無効にするには、このプロパティを1に設定します。0を設定すると、リクエストは常に拒否されます。-1を設定すると、キープアライブ接続の数は制限されません。
接続をアイドルとみなしてキープアライブ状態を保持できる最大時間(秒単位)。0以下の値を設定すると、キープアライブ接続は開いたままになります。デフォルト値は30秒です。
このオプションを選択すると、低速で読取りを行うサーブレットの接続が、「接続アップロード・タイムアウト」の制限に達した後にクローズされます。このオプションが無効の場合、サーブレットの接続はタイムアウトしません。このオプションは、デフォルトでは無効になっています。
アップロードのタイムアウト(ミリ秒単位)。このフィールドは、「アップロード・タイムアウト」の「有効」チェック・ボックスが選択されている場合にのみ適用されます。デフォルト値は300000ミリ秒です。
リクエスト・タイムアウトまでの秒数。タイムアウト値に達するまでにリクエストが処理されない場合、リクエストは無視されます。デフォルト値は30秒です。
送信バッファのサイズ(バイト単位)。デフォルト値は8192バイトです。
リクエスト処理スレッドがリクエスト・データの読取り時に使用するバッファのサイズ(バイト単位)。デフォルト値は8192バイトです。
POSTアクションの最大サイズ(バイト単位)。デフォルト値は2097152バイトです。
受信したリクエストURIのデコードに使用する文字セットの名前。有効なIANA文字セット名を指定する必要があります。デフォルト値はUTF-8です。
使用するHTTPプロトコルのバージョン。デフォルト値はHTTP/1.1です。
HTTP/1.1 GZIP圧縮を使用してサーバー帯域幅を節約することを指定します。選択可能な値は次のとおりです:
on
データを圧縮します。
off
圧縮を無効にします。
force
いつでも強制的にデータ圧縮を行います。
デフォルト値は「off
」です。
HTTP圧縮を使用するMIMEタイプのカンマ区切りリスト。デフォルト値は、text/html,text/xml,text/plain
です。
圧縮を適用するファイルの最小サイズ。圧縮を「on
」または「force
」に設定している場合は、この値を設定する必要があります。デフォルト値は2048バイトです。
圧縮を使用しないHTTPクライアントのユーザー・エージェントに一致する正規表現のカンマ区切りリスト。デフォルトでは、この値は空の文字列です。
HTTP圧縮適用対象の制限されたユーザー・エージェントのリスト。ユーザー・エージェントを指定しない場合は、すべてのユーザー・エージェントにHTTP圧縮が適用されます。デフォルトでは、ユーザー・エージェントは指定されていません。
デフォルト・レスポンス・タイプを指定する文字列。形式は、コンテンツ・タイプ、エンコーディング、言語、および文字セットで構成される、セミコロンで区切られた文字列になります。デフォルト値は、text/html; charset=iso-8859-1
です。
ファイル拡張子に一致するMIMEマッピングがない場合に使用される、リクエスト・タイプを指定する文字列。形式は、コンテンツ・タイプ、エンコーディング、言語、および文字セットで構成される、セミコロンで区切られた文字列になります。デフォルト値は、text/html; charset=iso-8859-1
です。
静的なリソース・アダプタのクラス名。デフォルト値は、com.sun.grizzly.tcp.StaticResourcesAdapter
です。
このオプションを選択すると、このプロトコルを参照するネットワーク・リスナーでCometサポートが有効になります。デフォルトでは、このオプションは無効です。サーブレットまたはJSPページでCometテクノロジを使用する場合は、GlassFish Serverの起動時にload-on-startup
要素をweb.xml
ファイルに追加することによって初期化されるようにします。例:
<servlet> <servlet-name>CheckIn</servlet-name> <servlet-class>CheckInServlet</servlet-class> <load-on-startup>0</load-on-startup> </servlet>
このオプションを選択すると、DNS検索が有効になっています。このオプションは、デフォルトでは無効になっています。
このオプションを選択すると、DNS検索が有効になっています。このオプションは、デフォルトでは無効になっています。
このオプションを選択すると、Resource Configuration Management (RCM)が有効になります。このオプションは、デフォルトでは無効になっています。
このオプションを選択すると、TRACE操作が有効になります。このオプションを無効にすると、GlassFish Serverはクロスサイト・スクリプト攻撃の影響を受けにくくなります。このオプションはデフォルトで有効になっています。
このオプションを選択すると、このプロトコルを使用するネットワーク・リスナーがSSLの終端プロキシ・サーバーからのトラフィックを受信することを指定します。このオプションは、デフォルトでは無効になっています。
このオプションを選択すると、HTTPレスポンスのチャンクが有効になります。このオプションはデフォルトで有効になっています。
このオプションを選択すると、Java Servlet 3.0およびJava Server Pages 2.0の仕様に従ってX-Powered-By
ヘッダーを使用します。このオプションはデフォルトで有効になっています。
このオプションを選択すると、URIにエンコードされたスラッシュを含めることができます。このオプションは、デフォルトでは無効になっています。
このオプションを選択すると、WebSocketプロトコルがサポートされます。このオプションは、デフォルトでは無効になっています。