Soprano  2.7.56
Public Member Functions | Static Public Attributes | Protected Member Functions
Soprano::Server::ServerCore Class Reference

Central Soprano server class. More...

#include <Soprano/Server/ServerCore>

+ Inheritance diagram for Soprano::Server::ServerCore:

List of all members.

Public Member Functions

 ServerCore (QObject *parent=0)
virtual ~ServerCore ()
void setBackend (const Backend *backend)
const Backendbackend () const
void setBackendSettings (const QList< BackendSetting > &settings)
QList< BackendSettingbackendSettings () const
void setMaximumConnectionCount (int max)
int maximumConnectionCount () const
virtual Modelmodel (const QString &name)
virtual void removeModel (const QString &name)
virtual QStringList allModels () const
bool start (const QString &socketPath=QString())
bool listen (quint16 port=DEFAULT_PORT)
quint16 serverPort () const
void registerAsDBusObject (const QString &objectPath=QString())

Static Public Attributes

static const quint16 DEFAULT_PORT

Protected Member Functions

virtual ModelcreateModel (const QList< BackendSetting > &settings)

Detailed Description

Central Soprano server class.

The ServerCore provides a Soprano server which maintains a set of named Model instances that can be accessed by clients over a tcp connection through Server::BackendPlugin.

Creating a server is very simple: Either derive from ServerCore or create an instance and then call start() to make the server listen for incoming connections.

Optionally ServerCore can be configured using normal BackendSetting settings through setBackendSettings().

Be aware the ServerCode supports multiple ways of communication. start() opens a TCP socket to accept new connections, registerAsDBusObject() registers a DBus interface on the DBus session bus. Both ways of communication can be used simultaneously.

ServerCore will spawn a new thread for each incoming TCP or local socket connection. In addition the D-Bus interface is running in its own thread. The maximum number of threads that are spawned can be set via setMaximumConnectionCount(). By default there is no restriction on the maximum thread count to keep backwards compatibility.

Author:
Sebastian Trueg trueg.nosp@m.@kde.nosp@m..org

Definition at line 74 of file servercore.h.


Constructor & Destructor Documentation


Member Function Documentation

Set the Backend used in the Server to create Models.

The Backend used by the Server to create Model instances.

Set the settings that are to be used by createModel() to create new Model instances. Be aware that Soprano::BackendOptionStorageDir will be changed to include a subdir which is the Model's name.

Parameters:
settingsThe settings to use for new Models.

Retrieve the backend settings configured via setBackendSettings().

Returns:
A list of BackendSetting objects.

Set the maximum number of TCP and local socket connections. If the max is reached new incoming connections are refused.

This makes sense to restrict the number of threads the server spawns.

A typical usage would be to server a max number of clients via a local socket connection and let the rest share the one D-Bus interface.

Parameters:
maxThe maximum number of connections. Using a value of 0 means no restriction.
Since:
2.4

The maximum number of incoming connections that are served.

Returns:
The maxium number of connections the server will handle or 0 if there is no restriction.
See also:
setMaximumConnectionCount.
Since:
2.4
virtual Model* Soprano::Server::ServerCore::model ( const QString name) [virtual]

Get or create Model with the specific name. The default implementation will use createModel() to create a new Model if none with the specified name exists and protect it against deadlocks with a Util::AsyncModel.

Parameters:
nameThe name of the requested Model.
virtual void Soprano::Server::ServerCore::removeModel ( const QString name) [virtual]

Remove a model and delete all data in it. Use with care.

Be aware that the Model instance will also be deleted.

Should be reimplemented if model() is reimplemented.

Parameters:
nameThe name of the requested Model.
Warning:
This is not the same as deleting the Model instance. It will also delete all the data on the harddisk.

Retrieve all models that have been loaded.

Returns:
A list of Model names.
bool Soprano::Server::ServerCore::start ( const QString socketPath = QString())

Start the core on a local socket. On Windows this is a named pipe and on Unix this this is a local domain socket.

Use Client::LocalSocketClient to connect.

Warning:
Via the local socket connection signals are not supported.
Returns:
true if the local socket could be successfully opened. false on error. See ErrorCache::lastError() for details.

Start the Server. Calling this method will make the Server listen on the specified port for incoming client connections.

Parameters:
portThe port to listen on for client connections.

Use Client::TcpClient to connect.

Warning:
Via the TCP connection signals are not supported. Thus, the models created by it will not emit signals such as Model::statementAdded. Also no permission handling or any kind of security is implemented at the moment. Thus, if a server is running and is listening on a port, it is open to connections from any client on any computer in the network.
Returns:
true if the server was successfully started, false otherwise.
Returns:
The port this server is listening on or 0 if listen has not been called successfully.
Since:
2.1

Register the ServerCore as a DBus object. The process needs to be registered as a DBus service before (QDBusConnection::registerService()).

Parameters:
objectPathThe DBus object path to register the server as. If empty the default path will be used (/org/soprano/Server).

Use Client::DBusClient to connect.

In case Soprano is compiled without D-Bus support this method does nothing.

D-Bus clients will be served in a separate thread.

virtual Model* Soprano::Server::ServerCore::createModel ( const QList< BackendSetting > &  settings) [protected, virtual]

Create a new Model. The default implementation uses the configured Backend with the configured settings to create a new Model. This method can be reimplemented to create specialized Model, for example in combination with some FilterModel.

Parameters:
settingsThe settings to use (a reimplementation may choose to ignore the settings.)
Returns:
A newly create Model.

Member Data Documentation

The default Soprano server port: 5000

Definition at line 85 of file servercore.h.


The documentation for this class was generated from the following file: