Base class for Connection implementations. More...

#include <TelepathyQt/BaseConnection>

Inheritance diagram for Tp::BaseConnection:

Public Types
typedef Callback5< BaseChannelPtr, const QString &, uint, uint, const QVariantMap &, DBusError * >	CreateChannelCallback

typedef Callback3< UIntList, uint, const QStringList &, DBusError * >	RequestHandlesCallback

typedef Callback1< void, DBusError * >	ConnectCallback

typedef Callback3< QStringList, uint, const Tp::UIntList &, DBusError * >	InspectHandlesCallback

Signals
void	disconnected ()

Signals inherited from Tp::Object
void	propertyChanged (const QString &propertyName)

Public Member Functions
virtual	~BaseConnection ()

QString	cmName () const

QString	protocolName () const

QVariantMap	parameters () const

uint	status () const

QVariantMap	immutableProperties () const

void	setStatus (uint newStatus, uint reason)

void	setCreateChannelCallback (const CreateChannelCallback &cb)

Tp::BaseChannelPtr	createChannel (const QString &channelType, uint targetHandleType, uint targetHandle, uint initiatorHandle, bool suppressHandler, const QVariantMap &request, DBusError *error)

void	setRequestHandlesCallback (const RequestHandlesCallback &cb)

UIntList	requestHandles (uint handleType, const QStringList &identifiers, DBusError *error)

void	setSelfHandle (uint selfHandle)

uint	selfHandle () const

void	setConnectCallback (const ConnectCallback &cb)

void	setInspectHandlesCallback (const InspectHandlesCallback &cb)

Tp::ChannelInfoList	channelsInfo ()

Tp::ChannelDetailsList	channelsDetails ()

BaseChannelPtr	ensureChannel (const QString &channelType, uint targetHandleType, uint targetHandle, bool &yours, uint initiatorHandle, bool suppressHandler, const QVariantMap &request, DBusError *error)

void	addChannel (BaseChannelPtr channel)

QList< AbstractConnectionInterfacePtr >	interfaces () const

AbstractConnectionInterfacePtr	interface (const QString &interfaceName) const

bool	plugInterface (const AbstractConnectionInterfacePtr &interface)

virtual QString	uniqueName () const

bool	registerObject (DBusError *error=NULL)

Public Member Functions inherited from Tp::DBusService
	DBusService (const QDBusConnection &dbusConnection)

virtual	~DBusService ()

QDBusConnection	dbusConnection () const

QString	busName () const

QString	objectPath () const

DBusObject *	dbusObject () const

bool	isRegistered () const

Public Member Functions inherited from Tp::Object
virtual	~Object ()

Public Member Functions inherited from QObject
	QObject (QObject *parent)

virtual	~QObject ()

virtual bool	event (QEvent *e)

virtual bool	eventFilter (QObject watched, QEvent event)

virtual const QMetaObject *	metaObject () const

QString	objectName () const

void	setObjectName (const QString &name)

bool	isWidgetType () const

bool	signalsBlocked () const

bool	blockSignals (bool block)

QThread *	thread () const

void	moveToThread (QThread *targetThread)

int	startTimer (int interval)

void	killTimer (int id)

T	findChild (const QString &name) const

QList< T >	findChildren (const QString &name) const

QList< T >	findChildren (const QRegExp &regExp) const

QObject *	child (const char objName, const char inheritsClass, bool recursiveSearch) const

const QObjectList &	children () const

void	setParent (QObject *parent)

void	installEventFilter (QObject *filterObj)

void	removeEventFilter (QObject *obj)

bool	connect (const QObject sender, const char signal, const char *method, Qt::ConnectionType type) const

bool	disconnect (const char signal, const QObject receiver, const char *method)

bool	disconnect (const QObject receiver, const char method)

void	dumpObjectTree ()

void	dumpObjectInfo ()

bool	setProperty (const char *name, const QVariant &value)

QVariant	property (const char *name) const

QList< QByteArray >	dynamicPropertyNames () const

void	destroyed (QObject *obj)

QObject *	parent () const

bool	inherits (const char *className) const

void	deleteLater ()

	QObject (QObject parent, const char name)

void	insertChild (QObject *object)

void	removeChild (QObject *object)

bool	isA (const char *className) const

const char *	className () const

const char *	name () const

const char *	name (const char *defaultName) const

void	setName (const char *name)

Public Member Functions inherited from Tp::RefCounted
	RefCounted ()

virtual	~RefCounted ()

Static Public Member Functions
static BaseConnectionPtr	create (const QString &cmName, const QString &protocolName, const QVariantMap &parameters)

template<typename BaseConnectionSubclass >
static SharedPtr< BaseConnectionSubclass >	create (const QString &cmName, const QString &protocolName, const QVariantMap &parameters)

static BaseConnectionPtr	create (const QDBusConnection &dbusConnection, const QString &cmName, const QString &protocolName, const QVariantMap &parameters)

template<typename BaseConnectionSubclass >
static SharedPtr< BaseConnectionSubclass >	create (const QDBusConnection &dbusConnection, const QString &cmName, const QString &protocolName, const QVariantMap &parameters)

Static Public Member Functions inherited from QObject
QString	tr (const char sourceText, const char disambiguation, int n)

QString	trUtf8 (const char sourceText, const char disambiguation, int n)

bool	connect (const QObject sender, const char signal, const QObject receiver, const char method, Qt::ConnectionType type)

bool	connect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &method, Qt::ConnectionType type)

bool	disconnect (const QObject sender, const char signal, const QObject receiver, const char method)

bool	disconnect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &method)

Protected Member Functions
	BaseConnection (const QDBusConnection &dbusConnection, const QString &cmName, const QString &protocolName, const QVariantMap &parameters)

virtual bool	registerObject (const QString &busName, const QString &objectPath, DBusError *error)

Protected Member Functions inherited from Tp::Object
	Object ()

void	notify (const char *propertyName)

Protected Member Functions inherited from QObject
QObject *	sender () const

int	senderSignalIndex () const

int	receivers (const char *signal) const

virtual void	timerEvent (QTimerEvent *event)

virtual void	childEvent (QChildEvent *event)

virtual void	customEvent (QEvent *event)

virtual void	connectNotify (const char *signal)

virtual void	disconnectNotify (const char *signal)

bool	checkConnectArgs (const char signal, const QObject object, const char *method)

Additional Inherited Members
Static Protected Member Functions inherited from QObject
QByteArray	normalizeSignalSlot (const char *signalSlot)

Properties inherited from QObject
	objectName

Detailed Description

Base class for Connection implementations.

Member Typedef Documentation

typedef Callback5<BaseChannelPtr, const QString&, uint, uint, const QVariantMap&, DBusError*> Tp::BaseConnection::CreateChannelCallback

typedef Callback3<UIntList, uint, const QStringList&, DBusError*> Tp::BaseConnection::RequestHandlesCallback

typedef Callback1<void, DBusError*> Tp::BaseConnection::ConnectCallback

typedef Callback3<QStringList, uint, const Tp::UIntList&, DBusError*> Tp::BaseConnection::InspectHandlesCallback

Constructor & Destructor Documentation

Tp::BaseConnection::~BaseConnection ( )

virtual

Class destructor.

Tp::BaseConnection::BaseConnection	(	const QDBusConnection &	dbusConnection,
		const QString &	cmName,
		const QString &	protocolName,
		const QVariantMap &	parameters
	)

protected

Construct a BaseConnection.

Parameters

dbusConnection	The D-Bus connection that will be used by this object.
cmName	The name of the connection manager associated with this connection.
protocolName	The name of the protocol associated with this connection.
parameters	The parameters of this connection.

Member Function Documentation

static BaseConnectionPtr Tp::BaseConnection::create	(	const QString &	cmName,
		const QString &	protocolName,
		const QVariantMap &	parameters
	)

inlinestatic

template<typename BaseConnectionSubclass >

static SharedPtr<BaseConnectionSubclass> Tp::BaseConnection::create	(	const QString &	cmName,
		const QString &	protocolName,
		const QVariantMap &	parameters
	)

inlinestatic

static BaseConnectionPtr Tp::BaseConnection::create	(	const QDBusConnection &	dbusConnection,
		const QString &	cmName,
		const QString &	protocolName,
		const QVariantMap &	parameters
	)

inlinestatic

template<typename BaseConnectionSubclass >

static SharedPtr<BaseConnectionSubclass> Tp::BaseConnection::create	(	const QDBusConnection &	dbusConnection,
		const QString &	cmName,
		const QString &	protocolName,
		const QVariantMap &	parameters
	)

inlinestatic

QString Tp::BaseConnection::cmName ( ) const

Return the name of the connection manager associated with this connection.

Returns: The name of the connection manager associated with this connection.

QString Tp::BaseConnection::protocolName ( ) const

Return the name of the protocol associated with this connection.

Returns: The name of the protocol associated with this connection.

QVariantMap Tp::BaseConnection::parameters ( ) const

Return the parameters of this connection.

Returns: The parameters of this connection.

uint Tp::BaseConnection::status ( ) const

QVariantMap Tp::BaseConnection::immutableProperties ( ) const

virtual

Return the immutable properties of this connection object.

Immutable properties cannot change after the object has been registered on the bus with registerObject().

Returns: The immutable properties of this connection object.

Implements Tp::DBusService.

void Tp::BaseConnection::setStatus	(	uint	newStatus,
		uint	reason
	)

void Tp::BaseConnection::setCreateChannelCallback ( const CreateChannelCallback & cb )

Tp::BaseChannelPtr Tp::BaseConnection::createChannel	(	const QString &	channelType,
		uint	targetHandleType,
		uint	targetHandle,
		uint	initiatorHandle,
		bool	suppressHandler,
		const QVariantMap &	request,
		DBusError *	error
	)

void Tp::BaseConnection::setRequestHandlesCallback ( const RequestHandlesCallback & cb )

UIntList Tp::BaseConnection::requestHandles	(	uint	handleType,
		const QStringList &	identifiers,
		DBusError *	error
	)

void Tp::BaseConnection::setSelfHandle ( uint selfHandle )

uint Tp::BaseConnection::selfHandle ( ) const

void Tp::BaseConnection::setConnectCallback ( const ConnectCallback & cb )

void Tp::BaseConnection::setInspectHandlesCallback ( const InspectHandlesCallback & cb )

Tp::ChannelInfoList Tp::BaseConnection::channelsInfo ( )

Tp::ChannelDetailsList Tp::BaseConnection::channelsDetails ( )

BaseChannelPtr Tp::BaseConnection::ensureChannel	(	const QString &	channelType,
		uint	targetHandleType,
		uint	targetHandle,
		bool &	yours,
		uint	initiatorHandle,
		bool	suppressHandler,
		const QVariantMap &	request,
		DBusError *	error
	)

void Tp::BaseConnection::addChannel ( BaseChannelPtr channel )

QList< AbstractConnectionInterfacePtr > Tp::BaseConnection::interfaces ( ) const

Return a list of interfaces that have been plugged into this Protocol D-Bus object with plugInterface().

This property is immutable and cannot change after this Protocol object has been registered on the bus with registerObject().

Returns: A list containing all the Protocol interface implementation objects.

See also: plugInterface(), interface()

AbstractConnectionInterfacePtr Tp::BaseConnection::interface ( const QString & interfaceName ) const

Return a pointer to the interface with the given name.

Parameters

interfaceName The D-Bus name of the interface, ex. TP_QT_IFACE_CONNECTION_INTERFACE_ADDRESSING.

Returns: A pointer to the AbstractConnectionInterface object that implements the D-Bus interface with the given name, or a null pointer if such an interface has not been plugged into this object.

See also: plugInterface(), interfaces()

bool Tp::BaseConnection::plugInterface ( const AbstractConnectionInterfacePtr & interface )

Plug a new interface into this Connection D-Bus object.

This property is immutable and cannot change after this Protocol object has been registered on the bus with registerObject().

Parameters

interface An AbstractConnectionInterface instance that implements the interface that is to be plugged.

Returns: true on success or false otherwise

See also: interfaces(), interface()

QString Tp::BaseConnection::uniqueName ( ) const

virtual

Return a unique name for this connection.

Returns: A unique name for this connection.

bool Tp::BaseConnection::registerObject ( DBusError * error = NULL )

Register this connection object on the bus.

If error is passed, any D-Bus error that may occur will be stored there.

Parameters

error A pointer to an empty DBusError where any possible D-Bus error will be stored.

Returns: true on success and false if there was an error or this connection object is already registered.

See also: isRegistered()

void Tp::BaseConnection::disconnected ( )

signal

Emitted when this connection has been disconnected.

bool Tp::BaseConnection::registerObject	(	const QString &	busName,
		const QString &	objectPath,
		DBusError *	error
	)

protectedvirtual

Reimplemented from DBusService.

Reimplemented from Tp::DBusService.

Public Types

Signals

Public Member Functions

Static Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation