Infinityc.RequestManager¶

Subclasses:: None

Methods¶

Inherited:: GObject.Object (37)
Structs:: GObject.ObjectClass (5)

class	`new` (seq_id)
	`clear` ()
	`fail_request` (request, error)
	`finish_request` (request, result)
	`foreach_named_request` (name, func, *user_data)
	`foreach_request` (func, *user_data)
	`get_request_by_seq` (seq)
	`get_request_by_xml` (name, xml)
	`get_request_by_xml_required` (name, xml)
	`remove_request` (request)

Virtual Methods¶

Inherited:: GObject.Object (7)

	`do_request_add` (request)
	`do_request_remove` (request)

Properties¶

Name	Type	Flags	Short Description
`sequence-id`	`int`	r/w/co	The local sequence identifier

Signals¶

Inherited:: GObject.Object (1)

Name	Short Description
`request-add`	This signal is emitted whenever a request was added to the request manager.
`request-remove`	This signal is emitted whenever a request was removed from the request manager.

Fields¶

Inherited:: GObject.Object (1)

Name	Type	Access	Description
parent	`GObject.Object`	r

Class Details¶

class Infinityc.RequestManager(**kwargs)¶

Bases:: GObject.Object
Abstract:: No
Structure:: Infinityc.RequestManagerClass

Infinityc.RequestManager is an opaque data type. You should only access it via the public API functions.

classmethod new(seq_id)¶

Parameters:: seq_id (int) – The local sequence ID.
Returns:: A newly allocated Infinityc.RequestManager.
Return type:: Infinityc.RequestManager

Creates a new Infinityc.RequestManager.

clear()¶: Removes all the requests in self.

fail_request(request, error)¶

Parameters:

request (Infinityc.Request) – A Infinityc.Request that has previously been added to self.
error (GLib.Error) – Error information why the request failed.

Marks request as failed using Infinity.Request.fail() and then removes the request from the manager.

finish_request(request, result)¶

Parameters:

request (Infinityc.Request) – A Infinityc.Request that has previously been added to self.
result (Infinity.RequestResult) – The request result.

Marks request as finished using Infinity.Request.finish() and then removes the request from the manager. The function takes ownership of result.

foreach_named_request(name, func, *user_data)¶

Parameters:

name (str) – The name of the request to look for.
func (Infinityc.RequestManagerForeachFunc) – The function to be called.
user_data (object or None) – Arbitrary data to be passed to func.

Calls the given function for each request that has been added to the request manager that has the name name.

foreach_request(func, *user_data)¶

Parameters:

func (Infinityc.RequestManagerForeachFunc) – The function to be called.
user_data (object or None) – Arbitrary data to be passed to func.

Calls the given function for each request that has been added to the request manager.

get_request_by_seq(seq)¶

Parameters:: seq (int) – The sequence number to which the request should be retrieved.
Returns:: The request with the given seq, or None if there is no such request.
Return type:: Infinityc.Request or None

Returns a previously-added request that has the given seq.

get_request_by_xml(name, xml)¶

Parameters:

name (str) – Name of the expected request. May be None to allow all requests.
xml (libxml2.NodePtr) – XML node that is supposed to contain a “seq” attribute.

Raises:

GLib.Error

Returns:

The resulting request, or None if the “seq” attribute was not present or an error occurred.

Return type:

Infinityc.Request or None

Looks whether there is a “seq” attribute in xml. If not, the function returns None (without setting error). Otherwise, it returns the request with the given seq and name, if the sequence ID matches. If the “seq” attribute is set but the actual request is not present (or has another name), the function returns None and error is set.

get_request_by_xml_required(name, xml)¶

Parameters:

name (str) – Name of the expected request. May be None to allow all requests.
xml (libxml2.NodePtr) – XML node that is supposed to contain a “seq” attribute.

Raises:

GLib.Error

Returns:

The resulting request, or None if an error occurred.

Return type:

Infinityc.Request

Looks whether there is a “seq” attribute in xml. If so, it returns the request with the given seq and name, if the sequence ID matches. If the “seq” attribute is not set or the actual request is not present (or has another name), the function returns None and error is set.

remove_request(request)¶

Parameters:: request (Infinityc.Request) – A Infinityc.Request that has previously been added to self.

Removes a request from the request manager.

do_request_add(request) virtual¶

Parameters:: request (Infinityc.Request) –

do_request_remove(request) virtual¶

Parameters:: request (Infinityc.Request) –

Signal Details¶

Infinityc.RequestManager.signals.request_add(request_manager, request)¶

Signal Name:

request-add

Flags:

RUN_LAST

Parameters:

request_manager (Infinityc.RequestManager) – The object which received the signal
request (Infinityc.Request) – The Infinityc.Request that was added.

This signal is emitted whenever a request was added to the request manager.

Infinityc.RequestManager.signals.request_remove(request_manager, request)¶

Signal Name:

request-remove

Flags:

RUN_LAST

Parameters:

request_manager (Infinityc.RequestManager) – The object which received the signal
request (Infinityc.Request) – The Infinityc.Request that was removed.

This signal is emitted whenever a request was removed from the request manager. Typically this happens when the request has finished (either successfully or unsuccessfully). It can also happen when the client is disconnected from the server while a request was still pending.

Property Details¶

Infinityc.RequestManager.props.sequence_id¶

Name:: sequence-id
Type:: int
Default Value:: 0
Flags:: READABLE, WRITABLE, CONSTRUCT_ONLY

The local sequence identifier