Infinity.CommunicationGroup¶

Subclasses:: Infinity.CommunicationHostedGroup, Infinity.CommunicationJoinedGroup

Methods¶

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

	`cancel_messages` (connection)
	`get_method_for_connection` (conn)
	`get_method_for_network` (network)
	`get_name` ()
	`get_publisher_id` (for_connection)
	`get_target` ()
	`is_member` (connection)
	`send_group_message` (xml)
	`send_message` (connection, xml)
	`set_target` (target)

Virtual Methods¶

Inherited:: GObject.Object (7)

	`do_get_method` (index)
	`do_get_publisher_id` (for_connection)
	`do_member_added` (connection)
	`do_member_removed` (connection)

Properties¶

Name	Type	Flags	Short Description
`communication-manager`	`Infinity.CommunicationManager`	w/co	The communication manager used for sending requests
`communication-registry`	`Infinity.CommunicationRegistry`	w/co	The registry to register connections with
`name`	`str`	r/w/co	The name of the group
`target`	`Infinity.CommunicationObject`	r/w	The communication object to call on received and sent data

Signals¶

Inherited:: GObject.Object (1)

Name	Short Description
`member-added`	This signal is emitted when a connection has been added to the group.
`member-removed`	This signal is emitted when a connection has been removed from the group.

Fields¶

Inherited:: GObject.Object (1)

Name	Type	Access	Description
parent_instance	`GObject.Object`	r

Class Details¶

class Infinity.CommunicationGroup(**kwargs)¶

Bases:: GObject.Object
Abstract:: Yes
Structure:: Infinity.CommunicationGroupClass

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

cancel_messages(connection)¶

Parameters:: connection (Infinity.XmlConnection) – The Infinity.XmlConnection for which to cancel messages.

Stops all messages scheduled to be sent to connection from being sent. Messages for which Infinity.CommunicationObject.enqueued() has already been called cannot be cancelled anymore.

get_method_for_connection(conn)¶

Parameters:: conn (Infinity.XmlConnection) – The Infinity.XmlConnection for which to retrieve the method.
Returns:: A method name. The string is owned by the group, you don’t need to free it.
Return type:: str

Returns the method name of the method used for communication on conn's network within group. conn does not need to be a member of self for this function to be called.

get_method_for_network(network)¶

Parameters:: network (str) – A network specifier, such as “tcp/ip” or “jabber”.
Returns:: A method name. The string is owned by the group, you don’t need to free it.
Return type:: str

Returns the method name of the method used for communication on network within self.

get_name()¶

Returns:: The name of the group. The returned string is owned by the group, you don’t need to free it.
Return type:: str

Returns the name of the group.

get_publisher_id(for_connection)¶

Parameters:: for_connection (Infinity.XmlConnection) – A Infinity.XmlConnection.
Returns:: The publisher’s host ID. Free with GLib.free().
Return type:: str

Returns a host identifier for the group’s publisher (see Infinity.XmlConnection :local-id and Infinity.XmlConnection :remote-id). If the local host is the publisher, then this will simply return for_connection's local ID, otherwise the remote ID of the connection to the publisher on for_connection's network is returned.

get_target()¶

Returns:: A Infinity.CommunicationGroup, or None.
Return type:: Infinity.CommunicationObject or None

Returns the group’s target. The target of a group is the Infinity.CommunicationObject to which received and sent messages are reported.

is_member(connection)¶

Parameters:: connection (Infinity.XmlConnection) – A Infinity.XmlConnection.
Returns:: True if connection is a member of self, False otherwise.
Return type:: bool

Returns whether connection is a member of self.

send_group_message(xml)¶

Parameters:: xml (libxml2.NodePtr) – The message to send.

Sends a message to all members of self. This function takes ownership of xml.

send_message(connection, xml)¶

Parameters:

connection (Infinity.XmlConnection) – The Infinity.XmlConnection to which to send the message.
xml (libxml2.NodePtr) – The message to send.

Sends a message connection which must be a member of self. connection needs to be a member of this group. This function takes ownership of xml.

set_target(target)¶

Parameters:: target (Infinity.CommunicationObject) – A Infinity.CommunicationObject, or None.

Sets the group’s target. The target of a group is the Infinity.CommunicationObject to which received and sent messages are reported. If target is None, then the target will be unset.

You can safely call this function with an object that holds a reference on the group since the Infinity.CommunicationGroup only holds a weak reference to its target. This means that you need to keep a reference on target yourself.

do_get_method(index) virtual¶

Parameters:: index (int) –
Return type:: str

Virtual function to determine the methods to use for the group, in order of priority.

do_get_publisher_id(for_connection) virtual¶

Parameters:: for_connection (Infinity.XmlConnection) – A Infinity.XmlConnection.
Returns:: The publisher’s host ID. Free with GLib.free().
Return type:: str

Returns a host identifier for the group’s publisher (see Infinity.XmlConnection :local-id and Infinity.XmlConnection :remote-id). If the local host is the publisher, then this will simply return for_connection's local ID, otherwise the remote ID of the connection to the publisher on for_connection's network is returned.

do_member_added(connection) virtual¶

Parameters:: connection (Infinity.XmlConnection) –

Default signal handler of the Infinity.CommunicationGroup ::member-added signal.

do_member_removed(connection) virtual¶

Parameters:: connection (Infinity.XmlConnection) –

Default signal handler of the Infinity.CommunicationGroup ::member-removed signal.

Signal Details¶

Infinity.CommunicationGroup.signals.member_added(communication_group, connection)¶

Signal Name:

member-added

Flags:

RUN_LAST

Parameters:

communication_group (Infinity.CommunicationGroup) – The object which received the signal
connection (Infinity.XmlConnection) – The newly joined connection.

This signal is emitted when a connection has been added to the group.

Infinity.CommunicationGroup.signals.member_removed(communication_group, connection)¶

Signal Name:

member-removed

Flags:

RUN_LAST

Parameters:

communication_group (Infinity.CommunicationGroup) – The object which received the signal
connection (Infinity.XmlConnection) – The connection that was removed

This signal is emitted when a connection has been removed from the group.

Property Details¶

Infinity.CommunicationGroup.props.communication_manager¶

Name:: communication-manager
Type:: Infinity.CommunicationManager
Default Value:: None
Flags:: WRITABLE, CONSTRUCT_ONLY

The communication manager used for sending requests

Infinity.CommunicationGroup.props.communication_registry¶

Name:: communication-registry
Type:: Infinity.CommunicationRegistry
Default Value:: None
Flags:: WRITABLE, CONSTRUCT_ONLY

The registry to register connections with

Infinity.CommunicationGroup.props.name¶

Name:: name
Type:: str
Default Value:: None
Flags:: READABLE, WRITABLE, CONSTRUCT_ONLY

The name of the group

Infinity.CommunicationGroup.props.target¶

Name:: target
Type:: Infinity.CommunicationObject
Default Value:: None
Flags:: READABLE, WRITABLE

The communication object to call on received and sent data