Houdini 19.5 hwebserver

hwebserver.webSocket function

HoudiniのウェブサーバーにWebSocketクラスを登録するデコレータ。

webSocket(path, is_prefix=False, ports=[])

Note

WebSocket対応はPython3のみです。

このデコレータでクラスをデコレートすると、そのクラスは、指定したサーバーパスのウェブサーバーに登録されます。

path

"/"で始まる文字列を指定しますが、末尾はスラッシュで終わっても終わらなくても構いません。 pathが登録される時、末尾のスラッシュはサーバーの挙動に何も影響を与えません。 もしpathにスラッシュがなくても、暗黙的に追加され、サーバーがパスとリクエストハンドラーをマッチさせる時には、サーバリクエストに送信されたパスにスラッシュがなければ追加されます。

is_prefix

Falseの場合、リクエストされたパスがpathに一致した場合にのみクラスが作成されます。 しかし、Trueの場合、リクエストされたパスがpathで始まり、その後にスラッシュで、その後に何かになっていればクラスが作成されます。

ports

WebSocketクラスを作成可能なポート。 ポートを指定しなかった場合、クラスはウェブサーバーのメインポートにバインドされます。 ポート名は、空っぽでなく、且つ、main(メインポートに予約済みの名前)でなければ、どのような名前でも構いません。

See also

hwebserver

クラス

  • hwebserver.Request

    Houdiniのウェブサーバーに送信されるリクエスト。

  • hwebserver.Response

    Houdiniのウェブサーバーから送り返されるレスポンス。

  • hwebserver.UploadedFile

    Houdiniのウェブサーバーに送信されるリクエストにアップロードされたファイル。

  • URLHandler

    汎用のHTTPハンドラー。

  • AsyncURLHandler

    汎用の非同期HTTPハンドラー。

  • WebSocket

    組み込みサーバーをWebSocketに対応させるための基本クラス。

開始と停止

  • hwebserver.run

    Houdiniのウェブサーバーを開始します。

  • hwebserver.requestShutdown

    すべてのオープンリクエストが処理された後にシャットダウンするようにHoudiniのウェブサーバーに命令します。

  • hwebserver.isInDebugMode

    Houdiniのウェブサーバーがデバッグモード(でdebug=True)で起動されていればTrueを返します。

ウェブリクエストの処理とレスポンスの返し

  • hwebserver.urlHandler

    Houdiniのウェブサーバーへのリクエストを制御する関数のデコレータ。

  • hwebserver.errorResponse

    HTTPエラーを表現したResponseオブジェクトを生成します。

  • hwebserver.notFoundResponse

    404 Not Found HTTPエラーを表現したResponseオブジェクトを生成します。

  • hwebserver.fileResponse

    ファイルの内容を送信するResponseオブジェクトを生成します。

  • hwebserver.redirect

    301 Movedまたは302 FoundのHTTPレスポンスを表現したResponseオブジェクトを生成します。

  • hwebserver.registerStaticFilesDirectory

    指定したプリフィックスにマッチしたURLに対して自動的にファイルを提供するために、指定したディレクトリをチェックするようにHoudiniのウェブサーバーに命令します。

  • hwebserver.registerOpdefPath

    指定したプリフィックスを、opdefリクエストを送信するハンドラーとして使用するようにHoudiniのウェブサーバーに命令します。

  • hwebserver.registerWSGIApp

    パスプリフィックスで使用するDjangoなどのWSGI準拠のアプリケーションを登録する際に使用する関数。

  • hwebserver.registerASGIApp

    パスプリフィックスで使用するDjangoなどのASGI準拠のアプリケーションを登録する際に使用する関数。

  • hwebserver.setSettingsForPort

    特定のポートの設定を調整します。

ウェブソケット

  • WebSocket

    組み込みサーバーをWebSocketに対応させるための基本クラス。

  • hwebserver.webSocket

    HoudiniのウェブサーバーにWebSocketクラスを登録するデコレータ。

APIコール

  • hwebserver.apiFunction

    Houdiniウェブサーバー上のAPIエンドポイント経由で関数をコールを可能にするデコレータで、JSON形式またはバイナリ形式のレスポンスを返します。

  • hwebserver.APIError

    apiFunctionハンドラー内でこの例外を引き起こしてエラーを示します。