HttpFile (クラス)
public sealed HttpFile {inherits File}
インポート元: CURL.GUI.STANDARD. package 内で定義されています CURL.IO.HTTP.

HTTP サーバー上に存在する File


プロパティ
url:この File を識別する Url オブジェクトを返します。
アクセサ public HttpFile.url:Url
when-last-accessed:該当する場合は最終アクセス日時を返し、そうでない場合は null を返します。
アクセサ public HttpFile.when-last-accessed:#DateTime
when-last-modified:該当する場合は最終変更日時を返し、そうでない場合は null を返します。
アクセサ public HttpFile.when-last-modified:#DateTime
プロパティ 継承 File: name, parent-dir

メソッド
append-open:このメソッドは、このクラスではサポートされません。
public {HttpFile.append-open
create?:bool = true,
create-mode:int = 0o666,
character-encoding:CharEncoding = CharEncoding.none-specified,
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, char }
}:TextOutputStream
append-open-byte:このメソッドは、このクラスではサポートされません。
public {HttpFile.append-open-byte
create?:bool = true,
create-mode:int = 0o666,
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, byte }
}:ByteOutputStream
async-read-open:テキスト入力用に self を非同期に開き、開いた TextInputStream または例外を含む AsyncFileOpenEvent で指定されたイベント ハンドラを呼び出します。
public {HttpFile.async-read-open
character-encoding:CharEncoding = CharEncoding.none-specified,
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, char },
unread-size:int = {min 4, buffer-size div 4},
event-handler:EventHandler,
...:EventHandler
}:AsyncFileOpener
async-read-open-byte:バイト入力用に self を非同期に開き、開いた ByteInputStream または例外を含む AsyncFileOpenEvent に対するイベント ハンドラを呼び出します。
public {HttpFile.async-read-open-byte
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, byte },
unread-size:int = {min 4, buffer-size div 4},
event-handler:EventHandler,
...:EventHandler
}:AsyncFileOpener
clone:このメソッドは、このクラスではサポートされません。
public {HttpFile.clone}:HttpFile
http-async-read-open:テキスト入力用の HttpFile を非同期に開き、例外または開かれた HttpTextInputStream を含む AsyncFileOpenEvent で指定されたイベント ハンドラを呼び出します。
public {HttpFile.http-async-read-open
character-encoding:CharEncoding = CharEncoding.none-specified,
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, char },
unread-size:int = {min 4, buffer-size div 4},
request-data:#HttpRequestData = null,
request-headers:#HttpRequestHeaders = null,
request-method:HttpRequestMethod = HttpRequestMethod.get,
auto-redirect?:bool = true,
always-return-response-headers?:bool = false,
event-handler:EventHandler,
...:EventHandler
}:AsyncFileOpener
http-async-read-open-byte:バイト入力用の HttpFile を非同期に開き、例外または開かれた HttpByteInputStream を含む AsyncFileOpenEvent で指定されたイベント ハンドラを呼び出します。
public {HttpFile.http-async-read-open-byte
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, byte },
unread-size:int = {min 4, buffer-size div 4},
request-data:#HttpRequestData = null,
request-headers:#HttpRequestHeaders = null,
request-method:HttpRequestMethod = HttpRequestMethod.get,
auto-redirect?:bool = true,
always-return-response-headers?:bool = false,
event-handler:EventHandler,
...:EventHandler
}:AsyncFileOpener
http-read-open:読み込み用の HttpFile を開き、HttpTextInputStream を返します。
public {HttpFile.http-read-open
character-encoding:CharEncoding = CharEncoding.none-specified,
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, char },
unread-size:int = {min 4, buffer-size div 4},
request-data:#HttpRequestData = null,
request-headers:#HttpRequestHeaders = null,
request-method:HttpRequestMethod = HttpRequestMethod.get,
auto-redirect?:bool = true,
always-return-response-headers?:bool = false
}:HttpTextInputStream
http-read-open-byte:読み込み用の HttpFile を開き、HttpByteInputStream を返します。
public {HttpFile.http-read-open-byte
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, byte },
unread-size:int = {min 4, buffer-size div 4},
request-data:#HttpRequestData = null,
request-headers:#HttpRequestHeaders = null,
request-method:HttpRequestMethod = HttpRequestMethod.get,
auto-redirect?:bool = true,
always-return-response-headers?:bool = false
}:HttpByteInputStream
read-open:入力用の self を開きます。
public {HttpFile.read-open
character-encoding:CharEncoding = CharEncoding.none-specified,
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, char },
unread-size:int = {min 4, buffer-size div 4}
}:TextInputStream
read-open-byte:バイト ストリーム入力用に self を開きます。
public {HttpFile.read-open-byte
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, byte },
unread-size:int = {min 4, buffer-size div 4}
}:ByteInputStream
write-open:このメソッドは、このクラスではサポートされません。
public {HttpFile.write-open
create?:bool = true,
create-mode:int = 0o666,
error-if-exists?:bool = false,
truncate-if-exists?:bool = true,
character-encoding:CharEncoding = CharEncoding.none-specified,
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, byte }
}:TextOutputStream
write-open-byte:このメソッドは、このクラスではサポートされません。
public {HttpFile.write-open-byte
create?:bool = true,
create-mode:int = 0o666,
error-if-exists?:bool = false,
truncate-if-exists?:bool = true,
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, byte }
}:ByteOutputStream
メソッド 継承 Object: object-describe, object-describe-for-debugging, object-serialize




プロパティ詳細
url (アクセサ)
アクセサ public HttpFile.url:Url

この File を識別する Url オブジェクトを返します。



when-last-accessed (アクセサ)
アクセサ public HttpFile.when-last-accessed:#DateTime

該当する場合は最終アクセス日時を返し、そうでない場合は null を返します。



when-last-modified (アクセサ)
アクセサ public HttpFile.when-last-modified:#DateTime

該当する場合は最終変更日時を返し、そうでない場合は null を返します。






メソッド詳細
append-open (メソッド)
public {HttpFile.append-open
create?:bool = true,
create-mode:int = 0o666,
character-encoding:CharEncoding = CharEncoding.none-specified,
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, char }
}:TextOutputStream

このメソッドは、このクラスではサポートされません。



append-open-byte (メソッド)
public {HttpFile.append-open-byte
create?:bool = true,
create-mode:int = 0o666,
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, byte }
}:ByteOutputStream

このメソッドは、このクラスではサポートされません。



async-read-open (メソッド)
public {HttpFile.async-read-open
character-encoding:CharEncoding = CharEncoding.none-specified,
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, char },
unread-size:int = {min 4, buffer-size div 4},
event-handler:EventHandler,
...:EventHandler
}:AsyncFileOpener

テキスト入力用に self を非同期に開き、開いた TextInputStream または例外を含む AsyncFileOpenEvent で指定されたイベント ハンドラを呼び出します。

character-encoding: ファイルの読み込み時に使用する文字エンコーディング。CharEncoding を参照してください。指定されていない場合、HttpHeaders.content-type に HTTP "charset" パラメータが存在すればそれが使用されます。存在しない場合、可能であれば文字エンコーディングはストリームの最初の数バイトから判断されます。このような解釈ができない場合は、既定の CharEncoding.utf8 文字エンコーディングが使用されます。
buffer-size: バッファに格納される char の最小数。buffer-sizeunread-size がどちらも 0 の場合、アンバッファ ストリームの作成が可能であればこれを行います。
unread-size: 効果的に読み取り不可能な char の最小数。buffer-sizeunread-size がどちらも 0 の場合、アンバッファ ストリームの作成が可能であればこれを行います。
event-handler: AsyncFileOpenEvent を受け取る EventHandler。少なくとも 1 つを指定する必要があります。
...: AsyncFileOpenEvent を受け取るオプションの EventHandler

戻り値

非同期オープンを制御できる AsyncFileOpener を返します。


async-read-open-byte (メソッド)
public {HttpFile.async-read-open-byte
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, byte },
unread-size:int = {min 4, buffer-size div 4},
event-handler:EventHandler,
...:EventHandler
}:AsyncFileOpener

バイト入力用に self を非同期に開き、開いた ByteInputStream または例外を含む AsyncFileOpenEvent に対するイベント ハンドラを呼び出します。

buffer-size: バッファに格納される char の最小数。buffer-sizeunread-size がどちらも 0 の場合、アンバッファ ストリームの作成が可能であればこれを行います。どちらも 0 でない場合、BufferedByteInputStream が作成されます。
unread-size: 効率よく読み込むことができない char の最小数。buffer-sizeunread-size がどちらも 0 の場合、できるだけバッファに格納されないストリームの作成を試みます。一方が 0 でない場合には BufferedByteInputStream が作成されます。
event-handler: AsyncFileOpenEvent を受け取る EventHandler。少なくとも 1 つを指定する必要があります。
...: AsyncFileOpenEvent を受け取るオプションの EventHandler

戻り値

非同期オープンを制御できる AsyncFileOpener を返します。


clone (メソッド)
public {HttpFile.clone}:HttpFile

このメソッドは、このクラスではサポートされません。



http-async-read-open (メソッド)
public {HttpFile.http-async-read-open
character-encoding:CharEncoding = CharEncoding.none-specified,
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, char },
unread-size:int = {min 4, buffer-size div 4},
request-data:#HttpRequestData = null,
request-headers:#HttpRequestHeaders = null,
request-method:HttpRequestMethod = HttpRequestMethod.get,
auto-redirect?:bool = true,
always-return-response-headers?:bool = false,
event-handler:EventHandler,
...:EventHandler
}:AsyncFileOpener

テキスト入力用の HttpFile を非同期に開き、例外または開かれた HttpTextInputStream を含む AsyncFileOpenEvent で指定されたイベント ハンドラを呼び出します。

character-encoding: ファイルの読み込み時に使用する文字エンコーディング。CharEncoding を参照してください。指定されていない場合、HttpHeaders.content-type に HTTP "charset" パラメータが存在すればそれが使用されます。存在しない場合、可能であれば文字エンコーディングはストリームの最初の数バイトから判断されます。このような解釈ができない場合は、既定の CharEncoding.utf8 文字エンコーディングが使用されます。
buffer-size: バッファに格納される char の最小数。buffer-sizeunread-size がどちらも 0 の場合、アンバッファ ストリームの作成が可能であればこれを行います。
unread-size: 効果的に読み取り不可能な char の最小数。buffer-sizeunread-size がどちらも 0 の場合、アンバッファ ストリームの作成が可能であればこれを行います。
request-data: リクエストと共に送信されるデータ。POST リクエストの場合、このパラメータは必須になります。GET リクエストで使用する場合は、このパラメータは HttpFormData でなければなりません。
request-headers: リクエストと共に送信されるヘッダー。
request-method: Get、Head、または Post の各リクエスト メソッド。
auto-redirect?: true の場合、リクエストは応答のステータスによって自動的にリダイレクトされます。
always-return-response-headers?: 応答ヘッダー内のステータスが status-ok でない場合、既定の動作をオーバーライドします。例外をスローする代わりに、応答ヘッダーにアクセスできるストリームを返します。HTTP トランザクションを完了できない場合にも例外がスローされます。返されるストリームにより、応答ヘッダーだけでなく応答の本文にもアクセスできます。したがって、呼び出し元は終了時に HttpTextInputStream.close を呼び出して、接続に関連付けられたリソースを解放する必要があります。
event-handler: AsyncFileOpenEvent を受け取る EventHandler。少なくとも 1 つを指定する必要があります。
...: AsyncFileOpenEvent を受け取るオプションの EventHandler

戻り値

非同期オープンを制御できる AsyncFileOpener を返します。


http-async-read-open-byte (メソッド)
public {HttpFile.http-async-read-open-byte
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, byte },
unread-size:int = {min 4, buffer-size div 4},
request-data:#HttpRequestData = null,
request-headers:#HttpRequestHeaders = null,
request-method:HttpRequestMethod = HttpRequestMethod.get,
auto-redirect?:bool = true,
always-return-response-headers?:bool = false,
event-handler:EventHandler,
...:EventHandler
}:AsyncFileOpener

バイト入力用の HttpFile を非同期に開き、例外または開かれた HttpByteInputStream を含む AsyncFileOpenEvent で指定されたイベント ハンドラを呼び出します。

buffer-size: バッファに格納される char の最小数。buffer-sizeunread-size がどちらも 0 の場合、アンバッファ ストリームの作成が可能であればこれを行います。どちらも 0 でない場合、BufferedByteInputStream が返されます。
unread-size: 効率よく読み取ることができない char の最小数。buffer-sizeunread-size が両方とも 0 の場合は、できるかぎりバッファリングしないストリームの作成を試みます。どちらかが 0 でない場合、BufferedByteInputStream が返されます。
request-data: リクエストと共に送信されるデータ。POST リクエストの場合、このパラメータは必須になります。GET リクエストで使用する場合は、このパラメータは HttpFormData でなければなりません。
request-headers: リクエストと共に送信されるヘッダー。
request-method: Get、Head、または Post の各リクエスト メソッド。
auto-redirect?: true の場合、リクエストは応答のステータスによって自動的にリダイレクトされます。
always-return-response-headers?: 応答ヘッダー内のステータスが status-ok でない場合、既定の動作をオーバーライドします。例外をスローする代わりに、応答ヘッダーにアクセスできるストリームを返します。HTTP トランザクションを完了できない場合にも例外がスローされます。返されるストリームにより、応答ヘッダーだけでなく応答の本文にもアクセスできます。したがって、呼び出し元は終了時に HttpByteInputStream.close を呼び出して、接続に関連付けられたリソースを解放する必要があります。
event-handler: AsyncFileOpenEvent を受け取る EventHandler で、少なくとも 1 つ指定する必要があります。
...: AsyncFileOpenEvent を受け取るオプションの EventHandler

戻り値

非同期オープンを制御できる AsyncFileOpener を返します。


http-read-open (メソッド)
public {HttpFile.http-read-open
character-encoding:CharEncoding = CharEncoding.none-specified,
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, char },
unread-size:int = {min 4, buffer-size div 4},
request-data:#HttpRequestData = null,
request-headers:#HttpRequestHeaders = null,
request-method:HttpRequestMethod = HttpRequestMethod.get,
auto-redirect?:bool = true,
always-return-response-headers?:bool = false
}:HttpTextInputStream

読み込み用の HttpFile を開き、HttpTextInputStream を返します。

character-encoding: ファイルの読み込み時に使用する文字エンコーディング。CharEncoding を参照してください。指定されていない場合、HttpHeaders.content-type に HTTP "charset" パラメータが存在すればそれが使用されます。存在しない場合、可能であれば文字エンコーディングはストリームの最初の数バイトから判断されます。このような解釈ができない場合は、既定の CharEncoding.utf8 文字エンコーディングが使用されます。
buffer-size: バッファに格納される char の最小数。buffer-sizeunread-size がどちらも 0 の場合、アンバッファ ストリームの作成が可能であればこれを行います。
unread-size: 効果的に読み取り不可能な char の最小数。buffer-sizeunread-size がどちらも 0 の場合、アンバッファ ストリームの作成が可能であればこれを行います。
request-data: リクエストと共に送信されるデータ。POST リクエストの場合、このパラメータは必須になります。GET リクエストで使用する場合は、このパラメータは HttpFormData でなければなりません。
request-headers: リクエストと共に送信されるヘッダー。
request-method: HTTP リクエストメソッド。
auto-redirect?: true の場合、リクエストは応答のステータスによって自動的にリダイレクトされます。
always-return-response-headers?: 応答ヘッダー内のステータスが status-ok でない場合、既定の動作をオーバーライドします。例外をスローする代わりに、応答ヘッダーにアクセスできるストリームを返します。HTTP トランザクションを完了できない場合にも例外がスローされます。返されるストリームにより、応答ヘッダーだけでなく応答の本文にもアクセスできます。したがって、呼び出し元は終了時に HttpTextInputStream.close を呼び出して、接続に関連付けられたリソースを解放する必要があります。

戻り値

このメソッドがオープンする HttpTextInputStream を返します。

説明

返されたストリームは、HttpInputStreamInfo を継承しています。HttpInputStreamInfo は、応答ヘッダーにアクセスするためのインターフェイスを提供しています。


http-read-open-byte (メソッド)
public {HttpFile.http-read-open-byte
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, byte },
unread-size:int = {min 4, buffer-size div 4},
request-data:#HttpRequestData = null,
request-headers:#HttpRequestHeaders = null,
request-method:HttpRequestMethod = HttpRequestMethod.get,
auto-redirect?:bool = true,
always-return-response-headers?:bool = false
}:HttpByteInputStream

読み込み用の HttpFile を開き、HttpByteInputStream を返します。

buffer-size: バッファに格納される char の最小数。buffer-sizeunread-size がどちらも 0 の場合、アンバッファ ストリームの作成が可能であればこれを行います。どちらも 0 でない場合、BufferedByteInputStream が返されます。
unread-size: 効率よく読み取ることができない char の最小数。buffer-sizeunread-size が両方とも 0 の場合は、できるかぎりバッファリングしないストリームの作成を試みます。どちらかが 0 でない場合、BufferedByteInputStream が返されます。
request-data: リクエストと共に送信されるデータ。POST リクエストの場合、このパラメータは必須になります。GET リクエストで使用する場合は、このパラメータは HttpFormData でなければなりません。
request-headers: リクエストと共に送信されるヘッダー。
request-method: Get、Head、または Post の各リクエスト メソッド。
auto-redirect?: true の場合、リクエストは応答のステータスによって自動的にリダイレクトされます。
always-return-response-headers?: 応答ヘッダー内のステータスが status-ok でない場合、既定の動作をオーバーライドします。例外をスローする代わりに、応答ヘッダーにアクセスできるストリームを返します。HTTP トランザクションを完了できない場合にも例外がスローされます。返されるストリームにより、応答ヘッダーだけでなく応答の本文にもアクセスできます。したがって、呼び出し元は終了時に HttpByteInputStream.close を呼び出して、接続に関連付けられたリソースを解放する必要があります。

戻り値

このメソッドが開く HttpByteInputStream を返します。

説明

返されたストリームは、HttpInputStreamInfo を継承しています。HttpInputStreamInfo は、応答ヘッダーにアクセスするためのインターフェイスを提供しています。


read-open (メソッド)
public {HttpFile.read-open
character-encoding:CharEncoding = CharEncoding.none-specified,
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, char },
unread-size:int = {min 4, buffer-size div 4}
}:TextInputStream

入力用の self を開きます。

character-encoding: ファイルの読み込み時に使用する文字エンコーディング。CharEncoding を参照してください。指定されていない場合、HttpHeaders.content-type に HTTP "charset" パラメータが存在すればそれが使用されます。存在しない場合、可能であれば文字エンコーディングはストリームの最初の数バイトから判断されます。このような解釈ができない場合は、既定の CharEncoding.utf8 文字エンコーディングが使用されます。
buffer-size: バッファに格納される char の最小数。buffer-sizeunread-size がどちらも 0 の場合、アンバッファ ストリームの作成が可能であればこれを行います。
unread-size: 効果的に読み取り不可能な char の最小数。buffer-sizeunread-size がどちらも 0 の場合、アンバッファ ストリームの作成が可能であればこれを行います。

戻り値

このメソッドがオープンする TextInputStream を返します。

注意事項

返されるストリームは、いかなる改行処理も実行しません。改行処理が必要な場合は、NewlineFilterTextInputStream または SeekableNewlineFilterTextInputStream を使い、返されるストリームを改行することができます。


read-open-byte (メソッド)
public {HttpFile.read-open-byte
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, byte },
unread-size:int = {min 4, buffer-size div 4}
}:ByteInputStream

バイト ストリーム入力用に self を開きます。

buffer-size: バッファに格納される char の最小数。buffer-sizeunread-size がどちらも 0 の場合、アンバッファ ストリームの作成が可能であればこれを行います。どちらも 0 でない場合、BufferedByteInputStream が返されます。
unread-size: 効率よく読み込むことができない char の最小数。buffer-sizeunread-size がどちらも 0 の場合は、できるだけバッファに格納されないストリームの作成を試みます。一方が 0 でない場合には BufferedByteInputStream が返されます。

戻り値

このメソッドがオープンする ByteInputStream を返します。


write-open (メソッド)
public {HttpFile.write-open
create?:bool = true,
create-mode:int = 0o666,
error-if-exists?:bool = false,
truncate-if-exists?:bool = true,
character-encoding:CharEncoding = CharEncoding.none-specified,
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, byte }
}:TextOutputStream

このメソッドは、このクラスではサポートされません。



write-open-byte (メソッド)
public {HttpFile.write-open-byte
create?:bool = true,
create-mode:int = 0o666,
error-if-exists?:bool = false,
truncate-if-exists?:bool = true,
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, byte }
}:ByteOutputStream

このメソッドは、このクラスではサポートされません。