Tp::DBusProxy Class Reference

The DBusProxy class is a base class representing a remote object available over D-Bus. More...

#include <TelepathyQt/DBusProxy>

Inheritance diagram for Tp::DBusProxy:

Signals
void	invalidated (Tp::DBusProxy *proxy, const QString &errorName, const QString &errorMessage)
Signals inherited from Tp::Object
void	propertyChanged (const QString &propertyName)

Public Member Functions
	DBusProxy (const QDBusConnection &dbusConnection, const QString &busName, const QString &objectPath, const Feature &featureCore)
virtual	~DBusProxy ()
QDBusConnection	dbusConnection () const
QString	busName () const
QString	objectPath () const
bool	isValid () const
QString	invalidationReason () const
QString	invalidationMessage () 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 ()
Public Member Functions inherited from Tp::ReadyObject
	ReadyObject (RefCounted *object, const Feature &featureCore)
	ReadyObject (DBusProxy *proxy, const Feature &featureCore)
virtual	~ReadyObject ()
virtual bool	isReady (const Features &features=Features()) const
virtual PendingReady *	becomeReady (const Features &requestedFeatures=Features())
virtual Features	requestedFeatures () const
virtual Features	actualFeatures () const
virtual Features	missingFeatures () const

Protected Member Functions
void	setBusName (const QString &busName)
void	invalidate (const QString &reason, const QString &message)
void	invalidate (const QDBusError &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)
Protected Member Functions inherited from Tp::ReadyObject
ReadinessHelper *	readinessHelper () const

Additional Inherited Members
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)
Static Protected Member Functions inherited from QObject
QByteArray	normalizeSignalSlot (const char *signalSlot)
Properties inherited from QObject
	objectName

Detailed Description

The DBusProxy class is a base class representing a remote object available over D-Bus.

All Telepathy-Qt client convenience classes that wrap Telepathy interfaces inherit from this class in order to provide basic D-Bus interface information.

Constructor & Destructor Documentation

DBusProxy()

Tp::DBusProxy::DBusProxy	(	const QDBusConnection &	dbusConnection,
		const QString &	busName,
		const QString &	objectPath,
		const Feature &	featureCore
	)

Construct a new DBusProxy object.

Parameters

dbusConnection	QDBusConnection to use.
busName	D-Bus bus name of the service that provides the remote object.
objectPath	The object path.
featureCore	The object core feature.

~DBusProxy()

Tp::DBusProxy::~DBusProxy ( )

virtual

Class destructor.

Member Function Documentation

dbusConnection()

QDBusConnection Tp::DBusProxy::dbusConnection

(

)

const

Return the D-Bus connection through which the remote object is accessed.

Returns

A QDBusConnection object.

busName()

QString Tp::DBusProxy::busName

(

)

const

Return the D-Bus bus name (either a unique name or a well-known name) of the service that provides the remote object.

Returns

The D-Bus bus name.

objectPath()

QString Tp::DBusProxy::objectPath

(

)

const

Return the D-Bus object path of the remote object within the service.

Returns

The D-Bus object path.

isValid()

bool Tp::DBusProxy::isValid

(

)

const

Return whether this proxy is still valid (has not emitted invalidated()).

Returns

true if still valid, false otherwise.

invalidationReason()

QString Tp::DBusProxy::invalidationReason

(

)

const

Return the error name indicating the reason this proxy became invalid.

Returns

A D-Bus error name, or QString() if this object is still valid.

invalidationMessage()

QString Tp::DBusProxy::invalidationMessage

(

)

const

Return a debugging message indicating the reason this proxy became invalid.

Returns

A debugging message, or QString() if this object is still valid.

invalidated

void Tp::DBusProxy::invalidated ( Tp::DBusProxy *  proxy, const QString &  errorName, const QString &  errorMessage  )

signal

Emitted when this object is no longer usable.

After this signal is emitted, any D-Bus method calls on the object will fail, but it may be possible to retrieve information that has already been retrieved and cached.

Parameters

proxy	This proxy.
errorName	The name of a D-Bus error describing the reason for the invalidation.
errorMessage	A debugging message associated with the error.

setBusName()

void Tp::DBusProxy::setBusName ( const QString &  busName )

protected

Sets the D-Bus bus name. This is used by subclasses after converting well-known names to unique names.

Parameters

busName

The D-Bus bus name to set.

invalidate() [1/2]

void Tp::DBusProxy::invalidate ( const QString &  reason, const QString &  message  )

protected

Called by subclasses when the DBusProxy should become invalid.

This method takes care of setting the invalidationReason, invalidationMessage, and emitting the invalidated signal.

Parameters

reason	A D-Bus error name (a string in a subset of ASCII, prefixed with a reversed domain name)
message	A debugging message associated with the error

invalidate() [2/2]

void Tp::DBusProxy::invalidate ( const QDBusError &  error )

protected