The QValueSpacePublisher class allows applications to publish values in the Value Space. More...
#include <QValueSpacePublisher>
Inherits: QObject.
This class was introduced in Qt Mobility 1.0.
QValueSpacePublisher ( const QString & path, QObject * parent = 0 ) | |
QValueSpacePublisher ( QValueSpace::LayerOptions filter, const QString & path, QObject * parent = 0 ) | |
QValueSpacePublisher ( const QUuid & uuid, const QString & path, QObject * parent = 0 ) | |
virtual | ~QValueSpacePublisher () |
bool | isConnected () const |
QString | path () const |
void | sync () |
void | resetValue ( const QString & name ) |
void | setValue ( const QString & name, const QVariant & data ) |
void | interestChanged ( const QString & attribute, bool interested ) |
virtual void | connectNotify ( const char * member ) |
The QValueSpacePublisher class allows applications to publish values in the Value Space.
When multiple Value Space layers are available QValueSpacePublisher only publishes values to the layer with the highest order. The layers that QValueSpacePublisher can access can be limited by specifying either a filter or a QUuid at construction time.
The lifetime of values published in the Value Space is specified by the particular Value Space layer that the value is published in. For details on the different behaviors see QValueSpace::LayerOption.
Once a value is published all applications in the system will have read access to it via the QValueSpaceSubscriber class.
Although, logically, the Value Space is a simple collection of hierarchical paths, these paths can conceptually be visualized as a set of objects with attributes. For example, rather than viewing the following list as 12 distinct Value Space paths:
/Device/Network/Interfaces/eth0/Name /Device/Network/Interfaces/eth0/Type /Device/Network/Interfaces/eth0/Status /Device/Network/Interfaces/eth0/BytesSent /Device/Network/Interfaces/eth0/BytesReceived /Device/Network/Interfaces/eth0/Time /Device/Network/Interfaces/ppp0/Name /Device/Network/Interfaces/ppp0/Type /Device/Network/Interfaces/ppp0/Status /Device/Network/Interfaces/ppp0/BytesSent /Device/Network/Interfaces/ppp0/BytesReceived /Device/Network/Interfaces/ppp0/Time
it can be thought of as describing two Value Space objects, { /Device/Network/Interfaces/eth0, /Device/Network/Interfaces/ppp0 }, each with the six attributes {Name, Type, Status, BytesSent, BytesReceived, Time}. The QValueSpacePublisher class encapsulates this abstraction.
For performance reasons the setting of and removing of attributes is buffered internally by the QValueSpacePublisher and applied as a batch sometime later. Normally this occurs the next time the application enters the Qt event loop, but this behavior should not be relied upon. If an application must synchronize with others, the QValueSpacePublisher::sync() and QValueSpacePublisher::syncAll() functions can be used to force the application of changes. This call is generally unnecessary, and should be used sparingly to prevent unnecessary load on the system.
See also QValueSpaceSubscriber.
Constructs a QValueSpacePublisher with the specified parent that publishes values under path.
This function was introduced in Qt Mobility 1.0.
Constructs a QValueSpacePublisher with the specified parent that publishes values under path. The filter parameter is used to limit which layer this QValueSpacePublisher will access.
The constructed Value Space publisher will access the layer with the highest order that matches filter and for which path is a valid path.
If no suitable layer is found, the constructed QValueSpacePublisher will be unconnected.
This function was introduced in Qt Mobility 1.0.
See also isConnected().
Constructs a QValueSpacePublisher with the specified parent that publishes values under path. Only the layer identified by uuid will be accessed by this publisher.
Use of this constructor is not platform agnostic. If possible use one of the constructors that take a QValueSpace::LayerOptions parameter instead.
If a layer with a matching uuid is not found, the constructed QValueSpacePublisher will be unconnected.
This function was introduced in Qt Mobility 1.0.
See also isConnected().
Destroys the QValueSpacePublisher. This will remove all values published by this publisher in non-permanent layers.
This function was introduced in Qt Mobility 1.0.
Reimplemented from QObject::connectNotify().
Registers this QValueSpacePublisher for notifications when QValueSpaceSubscribers are interested in values under path().
Generally you do not need to call this function as it is automatically called when connections are made to this classes signals. member is the signal that has been connected.
If you reimplement this virtual function it is important that you call this implementation from your implementation.
This function was introduced in Qt Mobility 1.0.
See also interestChanged().
Signal that is emitted when interest in attribute changes. If interested is true at least on QValueSpaceSubscriber is interested in the value of attribute.
This function was introduced in Qt Mobility 1.0.
Returns true if this QValueSpacePublisher is connected to an available layer; otherwise returns false.
This function was introduced in Qt Mobility 1.0.
Returns the path that this QValueSpacePublisher refers to.
This function was introduced in Qt Mobility 1.0.
Removes the value name and all sub-attributes from the system.
For example:
QValueSpacePublisher publisher("/Device"); publisher.setValue("State", "Starting"); publisher.setValue("State/Memory", "1000"); publisher.sync(); // QValueSpaceSubscriber("/Device/State").value() == QVariant("Starting") // QValueSpaceSubscriber("/Device/State/Memory").value() == QVariant("1000") publisher.resetValue("State"); publisher.sync(); // QValueSpaceSubscriber("/Device/State").value() == QVariant(); // QValueSpaceSubscriber("/Device/State/Memory").value() == QVariant();
This function was introduced in Qt Mobility 1.0.
Sets the value name on the publisher to data. If name is empty, this call will set the value of this publisher's path.
For example:
QValueSpacePublisher publisher("/Device"); publisher.setValue("State", "Starting"); publisher.sync(); // QValueSpaceSubscriber("/Device/State").value() == QVariant("Starting")
This function was introduced in Qt Mobility 1.0.
Forcibly sync all Value Space publisher using the same layer as this publisher.
For performance reasons attribute changes are batched internally by QValueSpacePublisher instances. In cases where the visibility of changes must be synchronized with other processes, calling this function will flush these batches. By the time this function returns, all other processes in the system will be able to see the attribute changes.
Generally, calling this function is unnecessary.
This function was introduced in Qt Mobility 1.0.
© 2008-2011 Nokia Corporation and/or its subsidiaries. Nokia, Qt and their respective logos are trademarks of Nokia Corporation in Finland and/or other countries worldwide.
All other trademarks are property of their respective owners. Privacy Policy
Licensees holding valid Qt Commercial licenses may use this document in accordance with the Qt Commercial License Agreement provided with the Software or, alternatively, in accordance with the terms contained in a written agreement between you and Nokia.
Alternatively, this document may be used under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation.