MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9
   Home · All Classes · All Namespaces · Modules · Functions · Files

The ChannelFactory class is responsible for constructing Channel objects according to application-defined settings. More...

#include <TelepathyQt4/ChannelFactory>

Inherits Tp::DBusProxyFactory.

List of all members.

Public Member Functions

Static Public Member Functions

Protected Member Functions


Detailed Description

The ChannelFactory class is responsible for constructing Channel objects according to application-defined settings.


Constructor & Destructor Documentation

Tp::ChannelFactory::~ChannelFactory (  )  [virtual]

Class destructor.

Tp::ChannelFactory::ChannelFactory ( const QDBusConnection bus  )  [protected]

Construct a new ChannelFactory object.

The constructed factory will construct channel subclasses provided by TelepathyQt4 as appropriate for the channel immutable properties, but not make any features ready.

Parameters:
bus  The QDBusConnection the proxies constructed using this factory should use.

Member Function Documentation

ChannelFactoryPtr Tp::ChannelFactory::create ( const QDBusConnection bus  )  [static]

Create a new ChannelFactory object.

The returned factory will construct channel subclasses provided by TelepathyQt4 as appropriate for the channel immutable properties, but not make any features ready.

Parameters:
bus  The QDBusConnection the proxies constructed using this factory should use.
Returns:
An ChannelFactoryPtr pointing to the newly created factory.
Features Tp::ChannelFactory::featuresForTextChats ( const QVariantMap &  additionalProps = QVariantMap()  )  const
void Tp::ChannelFactory::addFeaturesForTextChats ( const Features features,
const QVariantMap &  additionalProps = QVariantMap()  
)
ChannelFactory::ConstructorConstPtr Tp::ChannelFactory::constructorForTextChats ( const QVariantMap &  additionalProps = QVariantMap()  )  const
template<typename Subclass >
void Tp::ChannelFactory::setSubclassForTextChats ( const QVariantMap &  additionalProps = QVariantMap()  )  [inline]
void Tp::ChannelFactory::setConstructorForTextChats ( const ConstructorConstPtr &  ctor,
const QVariantMap &  additionalProps = QVariantMap()  
)
Features Tp::ChannelFactory::featuresForTextChatrooms ( const QVariantMap &  additionalProps = QVariantMap()  )  const
void Tp::ChannelFactory::addFeaturesForTextChatrooms ( const Features features,
const QVariantMap &  additionalProps = QVariantMap()  
)
ChannelFactory::ConstructorConstPtr Tp::ChannelFactory::constructorForTextChatrooms ( const QVariantMap &  additionalProps = QVariantMap()  )  const
template<typename Subclass >
void Tp::ChannelFactory::setSubclassForTextChatrooms ( const QVariantMap &  additionalProps = QVariantMap()  )  [inline]
void Tp::ChannelFactory::setConstructorForTextChatrooms ( const ConstructorConstPtr &  ctor,
const QVariantMap &  additionalProps = QVariantMap()  
)
Features Tp::ChannelFactory::featuresForStreamedMediaCalls ( const QVariantMap &  additionalProps = QVariantMap()  )  const
void Tp::ChannelFactory::addFeaturesForStreamedMediaCalls ( const Features features,
const QVariantMap &  additionalProps = QVariantMap()  
)
ChannelFactory::ConstructorConstPtr Tp::ChannelFactory::constructorForStreamedMediaCalls ( const QVariantMap &  additionalProps = QVariantMap()  )  const
template<typename Subclass >
void Tp::ChannelFactory::setSubclassForStreamedMediaCalls ( const QVariantMap &  additionalProps = QVariantMap()  )  [inline]
void Tp::ChannelFactory::setConstructorForStreamedMediaCalls ( const ConstructorConstPtr &  ctor,
const QVariantMap &  additionalProps = QVariantMap()  
)
Features Tp::ChannelFactory::featuresForRoomLists ( const QVariantMap &  additionalProps = QVariantMap()  )  const
void Tp::ChannelFactory::addFeaturesForRoomLists ( const Features features,
const QVariantMap &  additionalProps = QVariantMap()  
)
ChannelFactory::ConstructorConstPtr Tp::ChannelFactory::constructorForRoomLists ( const QVariantMap &  additionalProps = QVariantMap()  )  const
template<typename Subclass >
void Tp::ChannelFactory::setSubclassForRoomLists ( const QVariantMap &  additionalProps = QVariantMap()  )  [inline]
void Tp::ChannelFactory::setConstructorForRoomLists ( const ConstructorConstPtr &  ctor,
const QVariantMap &  additionalProps = QVariantMap()  
)
Features Tp::ChannelFactory::featuresForOutgoingFileTransfers ( const QVariantMap &  additionalProps = QVariantMap()  )  const
void Tp::ChannelFactory::addFeaturesForOutgoingFileTransfers ( const Features features,
const QVariantMap &  additionalProps = QVariantMap()  
)
ChannelFactory::ConstructorConstPtr Tp::ChannelFactory::constructorForOutgoingFileTransfers ( const QVariantMap &  additionalProps = QVariantMap()  )  const
template<typename Subclass >
void Tp::ChannelFactory::setSubclassForOutgoingFileTransfers ( const QVariantMap &  additionalProps = QVariantMap()  )  [inline]
void Tp::ChannelFactory::setConstructorForOutgoingFileTransfers ( const ConstructorConstPtr &  ctor,
const QVariantMap &  additionalProps = QVariantMap()  
)
Features Tp::ChannelFactory::featuresForIncomingFileTransfers ( const QVariantMap &  additionalProps = QVariantMap()  )  const
void Tp::ChannelFactory::addFeaturesForIncomingFileTransfers ( const Features features,
const QVariantMap &  additionalProps = QVariantMap()  
)
ChannelFactory::ConstructorConstPtr Tp::ChannelFactory::constructorForIncomingFileTransfers ( const QVariantMap &  additionalProps = QVariantMap()  )  const
template<typename Subclass >
void Tp::ChannelFactory::setSubclassForIncomingFileTransfers ( const QVariantMap &  additionalProps = QVariantMap()  )  [inline]
void Tp::ChannelFactory::setConstructorForIncomingFileTransfers ( const ConstructorConstPtr &  ctor,
const QVariantMap &  additionalProps = QVariantMap()  
)
Features Tp::ChannelFactory::featuresForOutgoingStreamTubes ( const QVariantMap &  additionalProps = QVariantMap()  )  const
void Tp::ChannelFactory::addFeaturesForOutgoingStreamTubes ( const Features features,
const QVariantMap &  additionalProps = QVariantMap()  
)
ChannelFactory::ConstructorConstPtr Tp::ChannelFactory::constructorForOutgoingStreamTubes ( const QVariantMap &  additionalProps = QVariantMap()  )  const
template<typename Subclass >
void Tp::ChannelFactory::setSubclassForOutgoingStreamTubes ( const QVariantMap &  additionalProps = QVariantMap()  )  [inline]
void Tp::ChannelFactory::setConstructorForOutgoingStreamTubes ( const ConstructorConstPtr &  ctor,
const QVariantMap &  additionalProps = QVariantMap()  
)
Features Tp::ChannelFactory::featuresForIncomingStreamTubes ( const QVariantMap &  additionalProps = QVariantMap()  )  const
void Tp::ChannelFactory::addFeaturesForIncomingStreamTubes ( const Features features,
const QVariantMap &  additionalProps = QVariantMap()  
)
ChannelFactory::ConstructorConstPtr Tp::ChannelFactory::constructorForIncomingStreamTubes ( const QVariantMap &  additionalProps = QVariantMap()  )  const
template<typename Subclass >
void Tp::ChannelFactory::setSubclassForIncomingStreamTubes ( const QVariantMap &  additionalProps = QVariantMap()  )  [inline]
void Tp::ChannelFactory::setConstructorForIncomingStreamTubes ( const ConstructorConstPtr &  ctor,
const QVariantMap &  additionalProps = QVariantMap()  
)
Features Tp::ChannelFactory::featuresForContactSearches ( const QVariantMap &  additionalProps = QVariantMap()  )  const
void Tp::ChannelFactory::addFeaturesForContactSearches ( const Features features,
const QVariantMap &  additionalProps = QVariantMap()  
)
ChannelFactory::ConstructorConstPtr Tp::ChannelFactory::constructorForContactSearches ( const QVariantMap &  additionalProps = QVariantMap()  )  const
template<typename Subclass >
void Tp::ChannelFactory::setSubclassForContactSearches ( const QVariantMap &  additionalProps = QVariantMap()  )  [inline]
void Tp::ChannelFactory::setConstructorForContactSearches ( const ConstructorConstPtr &  ctor,
const QVariantMap &  additionalProps = QVariantMap()  
)
Features Tp::ChannelFactory::commonFeatures (  )  const
void Tp::ChannelFactory::addCommonFeatures ( const Features features  ) 
ChannelFactory::ConstructorConstPtr Tp::ChannelFactory::fallbackConstructor (  )  const
template<typename Subclass >
void Tp::ChannelFactory::setFallbackSubclass (  )  [inline]
void Tp::ChannelFactory::setFallbackConstructor ( const ConstructorConstPtr &  ctor  ) 
Features Tp::ChannelFactory::featuresFor ( const ChannelClassSpec channelClass  )  const
void Tp::ChannelFactory::addFeaturesFor ( const ChannelClassSpec channelClass,
const Features features  
)
template<typename Subclass >
void Tp::ChannelFactory::setSubclassFor ( const ChannelClassSpec channelClass  )  [inline]
ChannelFactory::ConstructorConstPtr Tp::ChannelFactory::constructorFor ( const ChannelClassSpec channelClass  )  const
void Tp::ChannelFactory::setConstructorFor ( const ChannelClassSpec channelClass,
const ConstructorConstPtr &  ctor  
)
PendingReady * Tp::ChannelFactory::proxy ( const ConnectionPtr &  connection,
const QString channelPath,
const QVariantMap &  immutableProperties  
) const

Constructs a Channel proxy and begins making it ready.

If a valid proxy already exists in the factory cache for the given combination of busName and objectPath, it is returned instead. All newly created proxies are automatically cached until they're either DBusProxy::invalidated() or the last reference to them outside the factory has been dropped.

The proxy can be accessed immediately after this function returns using PendingReady::proxy().

Todo:
Make it configurable which subclass is constructed.
Parameters:
connection  Proxy for the owning connection of the channel.
channelPath  The object path of the channel.
immutableProperties  The immutable properties of the channel.
Returns:
A PendingReady operation with the proxy in PendingReady::proxy().
QString Tp::ChannelFactory::finalBusNameFrom ( const QString uniqueOrWellKnown  )  const [protected, virtual]

Transforms well-known names to the corresponding unique names, as is appropriate for Channel

Parameters:
uniqueOrWellKnown  The name to transform.
Returns:
The unique name corresponding to uniqueOrWellKnown (which may be it itself).

Implements Tp::DBusProxyFactory.

Features Tp::ChannelFactory::featuresFor ( const DBusProxyPtr &  proxy  )  const [protected, virtual]

Return features as configured for the channel class given by the Channel::immutableProperties() of proxy.

Todo:
Make the features configurable - currently an empty set is always returned.
Parameters:
proxy  The Channel proxy to determine the features for.
Returns:
A list of Feature objects.

Implements Tp::DBusProxyFactory.


Copyright © 2008-2011 Collabora Ltd. and Nokia Corporation
Telepathy-Qt4 0.6.5