mirror of https://github.com/nymea/nymea.git
113 lines
3.9 KiB
C++
113 lines
3.9 KiB
C++
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
|
|
* *
|
|
* Copyright (C) 2015 Simon Stürz <simon.stuerz@guh.io> *
|
|
* Copyright (C) 2014 Michael Zanetti <michael_zanetti@gmx.net> *
|
|
* *
|
|
* This file is part of nymea. *
|
|
* *
|
|
* 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 *
|
|
* <http://www.gnu.org/licenses/>. *
|
|
* *
|
|
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
|
|
|
|
/*!
|
|
\class Action
|
|
\brief Holds information required to execute an action described by a \l{ActionType}.
|
|
|
|
\ingroup nymea-types
|
|
\inmodule libnymea
|
|
|
|
It is bound to a \l{Device} and an \l{ActionType} and holds the parameters
|
|
for the execution of the action.
|
|
|
|
The params must match the template as described in \l{ActionType}.
|
|
|
|
\sa Device, ActionType
|
|
*/
|
|
|
|
#include "action.h"
|
|
|
|
/*! Construct an Action with the given \a deviceId and \a actionTypeId. */
|
|
Action::Action(const ActionTypeId &actionTypeId, const DeviceId &deviceId) :
|
|
m_id(ActionId::createActionId()),
|
|
m_actionTypeId(actionTypeId),
|
|
m_deviceId(deviceId)
|
|
{
|
|
}
|
|
|
|
/*! Construct a copy of an \a other Action. */
|
|
Action::Action(const Action &other):
|
|
m_id(other.id()),
|
|
m_actionTypeId(other.actionTypeId()),
|
|
m_deviceId(other.deviceId()),
|
|
m_params(other.params())
|
|
{
|
|
}
|
|
|
|
/*! Returns the actionId for this Action. */
|
|
ActionId Action::id() const
|
|
{
|
|
return m_id;
|
|
}
|
|
|
|
/*! An Action is valid if actionTypeId and deviceId are valid uuids. Returns true if valid, false if not. */
|
|
bool Action::isValid() const
|
|
{
|
|
return !m_actionTypeId.isNull() && !m_deviceId.isNull();
|
|
}
|
|
|
|
/*! Returns the actionTypeId for this Action.*/
|
|
ActionTypeId Action::actionTypeId() const
|
|
{
|
|
return m_actionTypeId;
|
|
}
|
|
|
|
/*! Returns the deviceId this Action is associated with. */
|
|
DeviceId Action::deviceId() const
|
|
{
|
|
return m_deviceId;
|
|
}
|
|
|
|
/*! Returns the parameters for this Action. */
|
|
ParamList Action::params() const
|
|
{
|
|
return m_params;
|
|
}
|
|
|
|
/*! Set the parameters for this Action. \a params must match the template in the \l{ActionType}
|
|
* referred by \l{Action::actionTypeId()}. */
|
|
void Action::setParams(const ParamList ¶ms)
|
|
{
|
|
m_params = params;
|
|
}
|
|
|
|
/*! Returns the parameter of this Action with a cetrain \a paramTypeId. */
|
|
Param Action::param(const ParamTypeId ¶mTypeId) const
|
|
{
|
|
foreach (const Param ¶m, m_params) {
|
|
if (param.paramTypeId() == paramTypeId) {
|
|
return param;
|
|
}
|
|
}
|
|
return Param(ParamTypeId(), QString());
|
|
}
|
|
|
|
/*! Copy the data to an \l{Action} from an \a other action. */
|
|
void Action::operator =(const Action &other)
|
|
{
|
|
m_id = other.id();
|
|
m_actionTypeId = other.actionTypeId();
|
|
m_params = other.params();
|
|
}
|