|
|
              
QServiceInterfaceDescriptor ClassThe QServiceInterfaceDescriptor class identifies a service implementation. More... #include <QServiceInterfaceDescriptor>
Public Types
Public Functions
Detailed DescriptionThe QServiceInterfaceDescriptor class identifies a service implementation. A service can implement multiple interfaces and each interface can have multiple implementations. The QServiceInterfaceDescriptor class enscapsulates this information, as illustrated by the diagram below. [Missing image qserviceinterfacedescriptor.png] The major version tag indicates the interface version and the minor version tag identifies the implementation version. Subsequent versions of the same interface must be binary compatible to previous versions of the same interface. In the above example service A and B implement the interface com.nokia.qt.x. In fact Service A provides two different implementations for the very same interface. This is indicated by the changed minor version number. Although Service B is using the same interface it's implementation actually utilizes the second version of the interface com.nokia.qt.x. Binary compatibility guarantees that clients who know version 1 can utilize version 2. If an existing interface has to be changed in a non-compatible way a new interface (name) is required. NamespacesA QServiceInterfaceDescriptor (the quadruble of service name, interface name, interface version and implementation version) uniquely identifies a service implementation on a device. Interface names follow the java namespace convention. The namespace com.nokia.qt.* is reserved for future Qt development. See also QServiceFilter and QServiceManager. Member Type Documentation
|
| Constant | Value | Description |
|---|---|---|
| QServiceInterfaceDescriptor::Capabilities | 0 | The capabilities attribute is a QStringList and describes the capabilities that a service client would require to use the service if capability checks are enforced. |
| QServiceInterfaceDescriptor::Location | 1 | This attribute points to either the location where the plug-in providing this service is stored or where the name of the service IPC path is found. If the service is plug-in based the location is the name and/or path of the plugin. If the service is IPC based the location is the name of the socket address. |
| QServiceInterfaceDescriptor::ServiceDescription | 2 | This attribute provides a general description for the service. |
| QServiceInterfaceDescriptor::InterfaceDescription | 3 | This attribute provides a description for the interface implementation. |
| QServiceInterfaceDescriptor::ServiceType | 4 | This attribute specifies the QService::Type that the service is being provided. |
Member Function Documentation
QServiceInterfaceDescriptor::QServiceInterfaceDescriptor()
Creates a new QServiceInterfaceDescriptor.
QServiceInterfaceDescriptor::QServiceInterfaceDescriptor(const QServiceInterfaceDescriptor & other)
Creates a copy of QServiceInterfaceDescriptor contained in other.
QServiceInterfaceDescriptor::QServiceInterfaceDescriptor(const QVariantMap & map)
Create a minimum QServiceInterfaceDescriptor from a hard coded serivce. Useful if no database/metadata storage is available. Different platforms may have different requirements
QServiceInterfaceDescriptor::~QServiceInterfaceDescriptor()
Destroys the QServiceInterfaceDescriptor object.
QVariant QServiceInterfaceDescriptor::attribute(QServiceInterfaceDescriptor::Attribute which) const
Returns the value for the attribute which; otherwise returns an invalid QVariant.
QString QServiceInterfaceDescriptor::customAttribute(const QString & which) const
Returns the value for the custom attribute which; otherwise returns a null string.
QStringList QServiceInterfaceDescriptor::customAttributes() const
Returns a list of custom attributes attached to the service.
QString QServiceInterfaceDescriptor::interfaceName() const
Returns the name of the interface that is implemented.
bool QServiceInterfaceDescriptor::isValid() const
Returns true if this descriptor is valid; otherwise returns false.
int QServiceInterfaceDescriptor::majorVersion() const
Returns the version of the interface.
Subsequent versions of an interface are binary compatible to previous versions of the same interface. If an interface is broken it must use a new interface name.
int QServiceInterfaceDescriptor::minorVersion() const
Returns the version of the implementation.
QService::Scope QServiceInterfaceDescriptor::scope() const
Returns true if this implementation is provided for all users on the system.
See also QService::Scope.
QString QServiceInterfaceDescriptor::serviceName() const
Returns the name of service that provides this implementation.
bool QServiceInterfaceDescriptor::operator!=(const QServiceInterfaceDescriptor & other) const
Compares a QServiceInterfaceDescriptor to other. Returns true if they are not equal and false otherwise.
QServiceInterfaceDescriptor & QServiceInterfaceDescriptor::operator=(const QServiceInterfaceDescriptor & other)
Copies the content of the QServiceInterfaceDescriptor object contained in other into this one.
bool QServiceInterfaceDescriptor::operator==(const QServiceInterfaceDescriptor & other) const
Compares a QServiceInterfaceDescriptor to other. Returns true if they are equal and false otherwise.