mirror of https://github.com/nymea/nymea.git
127 lines
4.7 KiB
C++
127 lines
4.7 KiB
C++
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
|
|
*
|
|
* Copyright 2013 - 2020, nymea GmbH
|
|
* Contact: contact@nymea.io
|
|
*
|
|
* This file is part of nymea.
|
|
* This project including source code and documentation is protected by
|
|
* copyright law, and remains the property of nymea GmbH. All rights, including
|
|
* reproduction, publication, editing and translation, are reserved. The use of
|
|
* this project is subject to the terms of a license agreement to be concluded
|
|
* with nymea GmbH in accordance with the terms of use of nymea GmbH, available
|
|
* under https://nymea.io/license
|
|
*
|
|
* GNU General Public License Usage
|
|
* Alternatively, this project may be redistributed and/or modified under the
|
|
* terms of the GNU General Public License as published by the Free Software
|
|
* Foundation, GNU version 3. This project 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 General
|
|
* Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License along with
|
|
* this project. If not, see <https://www.gnu.org/licenses/>.
|
|
*
|
|
* For any further details and any questions please contact us under
|
|
* contact@nymea.io or see our FAQ/Licensing Information on
|
|
* https://nymea.io/license/faq
|
|
*
|
|
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
|
|
|
|
/*!
|
|
\class nymeaserver::TransportInterface
|
|
\brief This class provides an interface for the JSON servers.
|
|
|
|
\ingroup server
|
|
\inmodule core
|
|
|
|
\sa WebSocketServer, TcpServer
|
|
*/
|
|
|
|
/*! \fn void nymeaserver::TransportInterface::clientConnected(const QUuid &clientId);
|
|
This signal is emitted when a new client with the given \a clientId has been connected.
|
|
|
|
\sa WebSocketServer, TcpServer
|
|
*/
|
|
|
|
/*! \fn void nymeaserver::TransportInterface::clientDisconnected(const QUuid &clientId);
|
|
This signal is emitted when a new client with the given \a clientId has been disconnected.
|
|
|
|
\sa WebSocketServer, TcpServer
|
|
*/
|
|
|
|
/*! \fn bool nymeaserver::TransportInterface::startServer();
|
|
Pure virtual public slot for starting the corresponding \l{TransportInterface}. Returns true
|
|
if started successfully.
|
|
|
|
\sa WebSocketServer::startServer(), TcpServer::startServer()
|
|
*/
|
|
|
|
/*! \fn bool nymeaserver::TransportInterface::stopServer();
|
|
Pure virtual public slot for stopping the corresponding \l{TransportInterface}. Returns true
|
|
if stopped successfully.
|
|
|
|
\sa WebSocketServer::stopServer(), TcpServer::stopServer()
|
|
*/
|
|
|
|
/*! \fn void nymeaserver::TransportInterface::sendData(const QUuid &clientId, const QByteArray &data);
|
|
Pure virtual method for sending \a data to the client with the id \a clientId over the corresponding \l{TransportInterface}.
|
|
*/
|
|
|
|
/*! \fn void nymeaserver::TransportInterface::sendData(const QList<QUuid> &clients, const QByteArray &data);
|
|
Pure virtual method for sending \a data to \a clients over the corresponding \l{TransportInterface}.
|
|
*/
|
|
|
|
/*! \fn void nymeaserver::TransportInterface::terminateClientConnection(const QUuid &clientId);
|
|
Pure virtual method for terminating \a clients connection. The JSON RPC server might call this when a
|
|
client violates the protocol. Transports should close the connection to the client.
|
|
IMPORTANT: Any pending outgoing buffers should be sent before termination. This is important for clients
|
|
to receive error messages when the server terminates the connection because of and error. I.e. do not
|
|
abort the connection but close it after flushing outgoing buffers.
|
|
*/
|
|
|
|
/*! \fn void nymeaserver::TransportInterface::dataAvailable(const QUuid &clientId, const QByteArray &data);
|
|
This signal is emitted when valid \a data from the client with the given \a clientId are available.
|
|
|
|
\sa WebSocketServer, TcpServer, BluetoothServer
|
|
*/
|
|
|
|
#include "transportinterface.h"
|
|
#include "loggingcategories.h"
|
|
|
|
#include <QJsonDocument>
|
|
|
|
namespace nymeaserver {
|
|
|
|
/*! Constructs a \l{TransportInterface} with the given \a config and \a parent. */
|
|
TransportInterface::TransportInterface(const ServerConfiguration &config, QObject *parent) :
|
|
QObject(parent),
|
|
m_config(config)
|
|
{
|
|
}
|
|
|
|
/*! Set the ServerConfiguration of this TransportInterface to the given \a config. */
|
|
void TransportInterface::setConfiguration(const ServerConfiguration &config)
|
|
{
|
|
m_config = config;
|
|
}
|
|
|
|
/*! Returns the \{ServerConfiguration}. */
|
|
ServerConfiguration TransportInterface::configuration() const
|
|
{
|
|
return m_config;
|
|
}
|
|
|
|
/*! Set the name of this TransportInterface to the given \a serverName. */
|
|
void TransportInterface::setServerName(const QString &serverName)
|
|
{
|
|
m_serverName = serverName;
|
|
}
|
|
|
|
/*! Virtual destructor for \l{TransportInterface}. */
|
|
TransportInterface::~TransportInterface()
|
|
{
|
|
}
|
|
|
|
}
|