SocketServer.TCPServer

Module SocketServer :: Class TCPServer

[show private | hide private]

Class TCPServer

BaseServer --+
             |
            TCPServer

Known Subclasses:: SimpleXMLRPCServer

Base class for various socket-based server classes.

Defaults to synchronous IP stream (i.e., TCP).

Methods for the caller:

- __init__(server_address, RequestHandlerClass)
- serve_forever()
- handle_request()  # if you don't use serve_forever()
- fileno() -> int   # for select()

Methods that may be overridden:

- server_bind()
- server_activate()
- get_request() -> request, client_address
- verify_request(request, client_address)
- process_request(request, client_address)
- close_request(request)
- handle_error()

Methods for derived classes:

- finish_request(request, client_address)

Class variables that may be overridden by derived classes or
instances:

- address_family
- socket_type
- request_queue_size (only for stream sockets)
- reuse_address

Instance variables:

- server_address
- RequestHandlerClass
- socket

Method Summary
	`__init__(self, server_address, RequestHandlerClass)` Constructor.
	`close_request(self, request)` Called to clean up an individual request.
	`fileno(self)` Return socket file number.
	`finish_request(self, request, client_address)` Finish one request by instantiating RequestHandlerClass. (inherited from `BaseServer`)
	`get_request(self)` Get the request and client address from the socket.
	`handle_error(self, request, client_address)` Handle an error gracefully. (inherited from `BaseServer`)
	`handle_request(self)` Handle one request, possibly blocking. (inherited from `BaseServer`)
	`process_request(self, request, client_address)` Call finish_request. (inherited from `BaseServer`)
	`serve_forever(self)` Handle one request at a time until doomsday. (inherited from `BaseServer`)
	`server_activate(self)` Called by constructor to activate the server.
	`server_bind(self)` Called by constructor to bind the socket.
	`server_close(self)` Called to clean-up the server.
	`verify_request(self, request, client_address)` Verify the request. (inherited from `BaseServer`)

Class Variable Summary
`int`	`address_family`
`bool`	`allow_reuse_address`
`int`	`request_queue_size`
`int`	`socket_type`

Method Details

init(self, server_address, RequestHandlerClass)
(Constructor)

Constructor. May be extended, do not override.

close_request(self, request)

Called to clean up an individual request.

fileno(self)

Return socket file number.

Interface required by select().

get_request(self)

Get the request and client address from the socket.

May be overridden.

server_activate(self)

Called by constructor to activate the server.

May be overridden.

server_bind(self)

Called by constructor to bind the socket.

May be overridden.

server_close(self)

Called to clean-up the server.

May be overridden.

Class Variable Details

address_family

Type:

int

Value:

allow_reuse_address

Type:

bool

Value:

False

request_queue_size

Type:

int

Value:

socket_type

Type:

int

Value:

Generated by Epydoc 1.1 on Thu Oct 16 16:37:23 2003

http://epydoc.sf.net

Class TCPServer

__init__(self, server_address, RequestHandlerClass) (Constructor)

close_request(self, request)

fileno(self)

get_request(self)

server_activate(self)

server_bind(self)

server_close(self)

address_family

allow_reuse_address

request_queue_size

socket_type

init(self, server_address, RequestHandlerClass)
(Constructor)