### ナビゲーション

- 索引
- モジュール |
- 次へ |
- 前へ |
- Python 2.7ja1 documentation »
- Python 標準ライブラリ »
- 20. インターネットプロトコルとその支援 »

# 20.25. `DocXMLRPCServer` — セルフ-ドキュメンティング XML-RPC サーバ

`DocXMLRPCServer` モジュールは、Python 3では `xmlrpc.server` モジュールに統合されました。 2to3 ツールは、ソースコード内のimportを自動的にPython 3用に修正します。

バージョン 2.3 で追加.

`DocXMLRPCServer` モジュールは `SimpleXMLRPCServer` クラスを拡張し、HTTP GET リクエストに対し HTML ドキュメントを返します。サーバは `DocXMLRPCServer` を使ったスタンドアロン環境、 `DocCGIXMLRPCRequestHandler` を使った CGI 環境の2つがあります。

class `DocXMLRPCServer.``DocXMLRPCServer`(addr[, requestHandler[, logRequests[, allow_none[, encoding[, bind_and_activate]]]]])

  当たなサーバ・インスタンスを生成します。各パラメータの内容は `SimpleXMLRPCServer.SimpleXMLRPCServer` のものと同じですが、 requestHandler のデフォルトは `DocXMLRPCRequestHandler` になっています。

class `DocXMLRPCServer.``DocCGIXMLRPCRequestHandler`

  CGI環境に XMR-RPC リクエスト・ハンドラの新たなインスタンスを生成します。

class `DocXMLRPCServer.``DocXMLRPCRequestHandler`

  リクエスト・ハンドラの新たなインスタンスを生成します。このリクエスト・ハンドラは XML-RPC POST リクエスト、ドキュメントの GET、そして `DocXMLRPCServer` コンストラクタに与えられた logRequests パラメータ設定を優先するため、ロギングの変更をサポートします。

## 20.25.1. DocXMLRPCServer オブジェクト

`DocXMLRPCServer` は `SimpleXMLRPCServer.SimpleXMLRPCServer` の派生クラスで、セルフ- ドキュメンティングの手段と XML-RPC サーバ機能を提供します。HTTP POST リクエストは XML-RPC メソッドの呼び出しとして扱われます。HTTP GET リクエストは pydoc スタイルの HTML ドキュメント生成のリクエストとして扱われます。これはサーバが自分自身のドキュメントを Web ベースで提供可能であることを意味します。

`DocXMLRPCServer.``set_server_title`(server_title)

  生成する HTML ドキュメントのタイトルをセットします。このタイトルは HTML の title 要素として使われます。

`DocXMLRPCServer.``set_server_name`(server_name)

  生成する HTML ドキュメントの名前をセットします。この名前は HTML 冒頭の h1 要素に使われます。

`DocXMLRPCServer.``set_server_documentation`(server_documentation)

  生成する HTML ドキュメントの本文をセットします。この本文はドキュメント中の名前の下にパラグラフとして出力されます。

## 20.25.2. DocCGIXMLRPCRequestHandler

`DocCGIXMLRPCRequestHandler` は `SimpleXMLRPCServer.CGIXMLRPCRequestHandler` の派生クラスで、セルフ- ドキュメンティングの手段と XML-RPC CGI スクリプト機能を提供します。HTTP POST リクエストは XML-RCP メソッドの呼び出しとして扱われます。 HTTP GET リクエストは pydoc スタイルの HTML ドキュメント生成のリクエストとして扱われます。これはサーバが自分自身のドキュメントを Web ベースで提供可能であることを意味します。

`DocCGIXMLRPCRequestHandler.``set_server_title`(server_title)

  生成する HTML ドキュメントのタイトルをセットします。このタイトルは HTML の title 要素として使われます。

`DocCGIXMLRPCRequestHandler.``set_server_name`(server_name)

  生成する HTML ドキュメントの名前をセットします。この名前は HTML 冒頭の h1 要素に使われます。

`DocCGIXMLRPCRequestHandler.``set_server_documentation`(server_documentation)

  生成する HTML ドキュメントの本文をセットします。この本文はドキュメント中の名前の下にパラグラフとして出力されます。

### ナビゲーション

- 索引
- モジュール |
- 次へ |
- 前へ |
- Python 2.7ja1 documentation »
- Python 標準ライブラリ »
- 20. インターネットプロトコルとその支援 »