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

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

バージョン 2.3 で追加.

The "DocXMLRPCServer" module extends the classes found in
"SimpleXMLRPCServer" to serve HTML documentation in response to HTTP
GET requests. Servers can either be free standing, using
"DocXMLRPCServer", or embedded in a CGI environment, using
"DocCGIXMLRPCRequestHandler".

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

   Create a new request handler instance. This request handler
   supports XML-RPC POST requests, documentation GET requests, and
   modifies logging so that the *logRequests* parameter to the
   "DocXMLRPCServer" constructor parameter is honored.


20.25.1. DocXMLRPCServer オブジェクト
=====================================

The "DocXMLRPCServer" class is derived from
"SimpleXMLRPCServer.SimpleXMLRPCServer" and provides a means of
creating self-documenting, stand alone XML-RPC servers. HTTP POST
requests are handled as XML-RPC method calls. HTTP GET requests are
handled by generating pydoc-style HTML documentation. This allows a
server to provide its own web-based documentation.

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 ドキュメントの本文をセットします。この本文はドキュメ
   ント中の名前の下にパラグラフとして出力されます。
