PluginCommandInterfaceDbus/include/DBusMessageHandler.h

   1 /**
   2  * Copyright (C) 2011, BMW AG
   3  *
   4  * GeniviAudioMananger DbusPlugin
   5  *
   6  * \file DBusMessageHandler
   7  *
   8  * \date 20-Oct-2011 3:42:04 PM
   9  * \author Christian Mueller (christian.ei.mueller@bmw.de)
  10  *
  11  * \section License
  12  * GNU Lesser General Public License, version 2.1, with special exception (GENIVI clause)
  13  * Copyright (C) 2011, BMW AG Christian Mueller  Christian.ei.mueller@bmw.de
  14  *
  15  * This program is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License, version 2.1, as published by the Free Software Foundation.
  16  * This program 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, version 2.1, for more details.
  17  * You should have received a copy of the GNU Lesser General Public License, version 2.1, along with this program; if not, see <http://www.gnu.org/licenses/lgpl-2.1.html>.
  18  * Note that the copyright holders assume that the GNU Lesser General Public License, version 2.1, may also be applicable to programs even in cases in which the program is not a library in the technical sense.
  19  * Linking AudioManager statically or dynamically with other modules is making a combined work based on AudioManager. You may license such other modules under the GNU Lesser General Public License, version 2.1. If you do not want to license your linked modules under the GNU Lesser General Public License, version 2.1, you may use the program under the following exception.
  20  * As a special exception, the copyright holders of AudioManager give you permission to combine AudioManager with software programs or libraries that are released under any license unless such a combination is not permitted by the license of such a software program or library. You may copy and distribute such a system following the terms of the GNU Lesser General Public License, version 2.1, including this special exception, for AudioManager and the licenses of the other code concerned.
  21  * Note that people who make modified versions of AudioManager are not obligated to grant this special exception for their modified versions; it is their choice whether to do so. The GNU Lesser General Public License, version 2.1, gives permission to release a modified version without this exception; this exception also makes it possible to release a modified version which carries forward this exception.
  22  *
  23  * THIS CODE HAS BEEN GENERATED BY ENTERPRISE ARCHITECT GENIVI MODEL. PLEASE CHANGE ONLY IN ENTERPRISE ARCHITECT AND GENERATE AGAIN
  24  */
  25
  26 #ifndef _DBUSMESSAGEHANDLER_H_
  27 #define _DBUSMESSAGEHANDLER_H_
  28
  29 #include <audiomanagertypes.h>
  30 #include <dbus/dbus.h>
  31 #include <vector>
  32 #include <sstream>
  33 #include <string>
  34 #include <list>
  35
  36 namespace am
  37 {
  38
  39 /**
  40  * handles DBus Messages, is used to extract & append parameters and send messages
  41  */
  42 class DBusMessageHandler
  43 {
  44 public:
  45     DBusMessageHandler();
  46     ~DBusMessageHandler();
  47
  48     /**
  49      * sets the DBus Connection
  50      * @param connection pointer to the DBus Connection
  51      */
  52     void setDBusConnection(DBusConnection*& connection);
  53
  54     /**
  55      * is called to initiate the receiving of a message
  56      * @param msg pointer to the message to be received
  57      */
  58     void initReceive(DBusMessage* msg);
  59
  60     /**
  61      *  is called to initiate the reply to a message
  62      * @param msg pointer to the message the reply is for
  63      */
  64     void initReply(DBusMessage* msg);
  65
  66     /**
  67      * inits a signal to be sent via dbus
  68      * parameters can be added before sending the signal
  69      * @param path the path
  70      * @param signalName the signal name
  71      */
  72     void initSignal(std::string path, std::string signalName);
  73
  74     /**
  75      * sends out the message
  76      */
  77     void sendMessage();
  78
  79     /**
  80      * the get functions return a value from the received dbus message
  81      * @return
  82      */
  83     dbus_uint16_t getUInt();
  84     dbus_int16_t getInt();
  85     dbus_bool_t getBool();
  86     char getByte();
  87     double getDouble();
  88     char* getString();
  89     void getProperty(dbus_int16_t& type, dbus_int16_t& value);
  90
  91     /**
  92      * the overloaded append function appends different datatypes to the dbusmessage
  93      */
  94     void append(dbus_int16_t toAppend);
  95     void append(dbus_uint16_t toAppend);
  96     void append(char toAppend);
  97     void append(bool toAppend);
  98     void append(double toAppend);
  99     void append(const am::am_SinkType_s& sinkType);
 100     void append(const am::am_SourceType_s& sourceType);
 101     void append(const am::am_MainSoundProperty_s mainSoundProperty);
 102     void append(const am::am_Availability_s & availability);
 103     void append(const am::am_SystemProperty_s & SystemProperty);
 104     void append(const std::vector<am::am_MainConnectionType_s>& listMainConnections);
 105     void append(const std::vector<am::am_SinkType_s>& listMainSinks);
 106     void append(const std::vector<am::am_SourceType_s>& listMainSources);
 107     void append(const std::vector<am::am_MainSoundProperty_s>& listMainSoundProperties);
 108     void append(const std::vector<am::am_SourceClass_s>& listSourceClasses);
 109     void append(const std::vector<am::am_SinkClass_s>& listSinkClasses);
 110     void append(const std::vector<am::am_SystemProperty_s>& listSystemProperties);
 111
 112 private:
 113
 114     DBusMessageIter mDBusMessageIter;
 115     DBusError mDBusError;
 116     dbus_uint32_t mSerial;
 117     std::string mErrorName;
 118     std::string mErrorMsg;
 119     DBusMessage* mDbusMessage;
 120     DBusMessage* mReveiveMessage;
 121     DBusConnection* mDBusConnection;
 122 };
 123
 124 }
 125
 126 #endif // _DBUSMESSAGEWRAPPER_H_