KServiceTypeTrader

#include <KServiceTypeTrader>

Public Member Functions
	~KServiceTypeTrader ()

KService::List	defaultOffers (const QString &serviceType, const QString &constraint=QString()) const

KService::Ptr	preferredService (const QString &serviceType) const

KService::List	query (const QString &servicetype, const QString &constraint=QString()) const

Static Public Member Functions
static void	applyConstraints (KService::List &lst, const QString &constraint)

static KServiceTypeTrader *	self ()

Detailed Description

KDE's trader interface (similar to the CORBA Trader), which provides a way to query the KDE infrastructure for specific applications or components.

Basically, KServiceTypeTrader provides a way for an application to query all KDE services (that is, applications, components, plugins) that match a specific set of requirements. This allows to find specific services at run-time without having to hard-code their names and/or paths.

For anything relating to MIME types (type of files), ignore KServiceTypeTrader and use KMimeTypeTrader instead.

Example

If you want to find all plugins for your application, you would define a KMyApp/Plugin servicetype, and then you can query the trader for it:

KService::List offers =

KServiceTypeTrader::self()->query("KMyApp/Plugin");

You can add a constraint in the "trader query language". For instance:

KServiceTypeTrader::self()->query("KMyApp/Plugin",

"[X-KMyApp-InterfaceVersion] > 15");

Please note that when including property names containing arithmetic operators like - or +, then you have to put brackets around the property name, in order to correctly separate arithmetic operations from the name. So for example a constraint expression like

X-KMyApp-InterfaceVersion > 4 // wrong!

needs to be written as

[X-KMyApp-InterfaceVersion] > 4

otherwise it could also be interpreted as Subtract the numeric value of the property "KMyApp" and "InterfaceVersion" from the property "X" and make sure it is greater than 4. Instead of the other meaning, make sure that the numeric value of "X-KMyApp-InterfaceVersion" is greater than 4.

See also: KMimeTypeTrader, KService

Deprecated:: Since 5.90. For querying plugins use KPluginMetaData::findPlugins. For querying applications use KApplicationTrader. For querying KParts use KParts::PartLoader. For querying desktop files use KFileUtils::findAllUniqueFiles and KDesktopFile.

Definition at line 72 of file kservicetypetrader.h.

Constructor & Destructor Documentation

◆ ~KServiceTypeTrader()

KServiceTypeTrader::~KServiceTypeTrader ( )

Standard destructor.

Definition at line 50 of file kservicetypetrader.cpp.

Member Function Documentation

◆ applyConstraints()

void KServiceTypeTrader::applyConstraints	(	KService::List &	lst,
		const QString &	constraint
	)

static

(public for KMimeTypeTrader)

Definition at line 55 of file kservicetypetrader.cpp.

◆ defaultOffers()

KService::List KServiceTypeTrader::defaultOffers	(	const QString &	serviceType,
		const QString &	constraint = `QString()`
	)		const

Returns all offers associated with a given servicetype, IGNORING the user preference.

The sorting will be the one coming from the InitialPreference in the .desktop files, and services disabled by the user will still be listed here. This is used for "Revert to defaults" buttons in GUIs.

Definition at line 99 of file kservicetypetrader.cpp.

◆ preferredService()

KService::Ptr KServiceTypeTrader::preferredService ( const QString & serviceType ) const

Returns the preferred service for serviceType.

Parameters

serviceType the service type (e.g. "KMyApp/Plugin")

Returns: the preferred service, or nullptr if no service is available

Definition at line 145 of file kservicetypetrader.cpp.

◆ query()

KService::List KServiceTypeTrader::query	(	const QString &	servicetype,
		const QString &	constraint = `QString()`
	)		const

The main function in the KServiceTypeTrader class.

It will return a list of services that match your specifications. The only required parameter is the service type. This is something like 'text/plain' or 'text/html'. The constraint parameter is used to limit the possible choices returned based on the constraints you give it.

The constraint language is rather full. The most common keywords are AND, OR, NOT, IN, and EXIST, all used in an almost spoken-word form. An example is:

(Type == 'Service') and (('KParts/ReadOnlyPart' in ServiceTypes) or (exist Exec))

The keys used in the query (Type, ServiceType, Exec) are all fields found in the .desktop files.

Parameters

servicetype	A service type like 'KMyApp/Plugin' or 'KFilePlugin'.
constraint	A constraint to limit the choices returned, QString() to get all services of the given `servicetype`