/* Copyright (C) 2010 The giomm Development Team
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library. If not, see .
*/
#include
#include
#include
#include
_DEFS(giomm,gio)
_PINCLUDE(glibmm/private/object_p.h)
namespace Gio
{
namespace DBus
{
_GMMPROC_EXTRA_NAMESPACE(DBus)
//TODO: Add example from the C API in class docs.
/** This is a helper for listening to and accepting D-Bus connections.
* Since Server derives from Initiable, its constructors can
* throw an exception if construction fails.
*
* This can be used to create a new D-Bus server, allowing two
* peers to use the D-Bus protocol for their own specialized communication.
* A server instance provided in this way will not perform message routing or
* implement the org.freedesktop.DBus interface.
*
* To just export an object on a well-known name on a message bus, such as the
* session or system bus, you should instead use Gio::DBus::own_name().
*
* @newin{2,28}
* @ingroup DBus
*/
class GIOMM_API Server : public Glib::Object, public Initable
{
_CLASS_GOBJECT(Server, GDBusServer, G_DBUS_SERVER, Glib::Object, GObject, , , GIOMM_API)
_IMPLEMENTS_INTERFACE(Initable)
public:
_WRAP_ENUM(Flags, GDBusServerFlags, gtype_func g_dbus_server_flags_get_type, decl_prefix GIOMM_API)
protected:
Server(const std::string& address,
const std::string& guid,
const Glib::RefPtr& observer,
const Glib::RefPtr& cancellable,
Flags flags);
Server(const std::string& address,
const std::string& guid,
const Glib::RefPtr& cancellable,
Flags flags);
Server(const std::string& address,
const std::string& guid,
const Glib::RefPtr& observer,
Flags flags);
Server(const std::string& address,
const std::string& guid,
Flags flags);
public:
_WRAP_METHOD_DOCS_ONLY(g_dbus_server_new_sync)
/// @throw Glib::Error.
static Glib::RefPtr create_sync(const std::string& address,
const std::string& guid,
const Glib::RefPtr& observer,
const Glib::RefPtr& cancellable,
Flags flags = Gio::DBus::Server::Flags::NONE);
_WRAP_METHOD_DOCS_ONLY(g_dbus_server_new_sync)
/// @throw Glib::Error.
static Glib::RefPtr create_sync(const std::string& address,
const std::string& guid,
const Glib::RefPtr& cancellable,
Flags flags = Gio::DBus::Server::Flags::NONE);
/// Non-cancellable version of create_sync().
static Glib::RefPtr create_sync(const std::string& address,
const std::string& guid,
const Glib::RefPtr& observer,
Flags flags = Gio::DBus::Server::Flags::NONE);
/// Non-cancellable version of create_sync().
static Glib::RefPtr create_sync(const std::string& address,
const std::string& guid,
Flags flags = Gio::DBus::Server::Flags::NONE);
_WRAP_METHOD(void start(), g_dbus_server_start)
_WRAP_METHOD(void stop(), g_dbus_server_stop)
_WRAP_METHOD(bool is_active() const, g_dbus_server_is_active)
_WRAP_METHOD(std::string get_guid() const, g_dbus_server_get_guid)
_WRAP_METHOD(Flags get_flags() const, g_dbus_server_get_flags)
_WRAP_METHOD(std::string get_client_address() const, g_dbus_server_get_client_address)
_WRAP_PROPERTY("active", bool)
_WRAP_PROPERTY("address", std::string)
_WRAP_PROPERTY("authentication-observer", Glib::RefPtr)
_WRAP_PROPERTY("client-address", std::string)
_WRAP_PROPERTY("flags", Flags)
_WRAP_PROPERTY("guid", std::string)
#m4 _CONVERSION(`GDBusConnection*', `const Glib::RefPtr&', `Glib::wrap($3, true)')
_WRAP_SIGNAL(bool new_connection(const Glib::RefPtr& connection), "new-connection", no_default_handler)
};
} //namespace DBus
} // namespace Gio