SimpleM2MResource.h

// ----------------------------------------------------------------------------
// Copyright 2016-2017 ARM Ltd.
//
// SPDX-License-Identifier: Apache-2.0
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
// ----------------------------------------------------------------------------

#ifndef SIMPLE_M2M_RESOURCE_H
#define SIMPLE_M2M_RESOURCE_H

#include "mbed-cloud-client/MbedCloudClient.h"

// As this whole class is build by using C++'s standard template library (STL),
// we have it behind a flag. The cost of STL is 15KB of flash, depending on compiler,
// so on resource constrained devices it is essential to be able to remove any reference to it.
#if MBED_CLOUD_CLIENT_STL_API

#include <string>

class SimpleM2MResourceBase {

protected:

    // Prevents the use of default constructor.
    SimpleM2MResourceBase();

    // Prevents the use of assignment operator.
    SimpleM2MResourceBase& operator=( const SimpleM2MResourceBase& /*other*/ );

    // Prevents the use of copy constructor
    SimpleM2MResourceBase( const M2MBase& /*other*/ );

    SimpleM2MResourceBase(MbedCloudClient* client, string route);

    virtual ~SimpleM2MResourceBase();


public:

    bool define_resource_internal(string v,
                                  M2MBase::Operation opr,
                                  bool observable);

    string get() const;

    bool set(string v);

    bool set(const int& v);

    bool set_post_function(void(*fn)(void*));

    bool set_post_function(execute_callback fn);

    M2MResource* get_resource();

    virtual void update(){}

private:

    vector<string> parse_route(const char* route);

private:
    MbedCloudClient*                    _client;   // Not owned
    string                              _route;
};

class SimpleM2MResourceString : public SimpleM2MResourceBase
{
public:

    SimpleM2MResourceString(MbedCloudClient* client,
                   const char* route,
                   string v,
                   M2MBase::Operation opr = M2MBase::GET_PUT_ALLOWED,
                   bool observable = true,
                   FP1<void, string> on_update = NULL) m2m_deprecated;

    SimpleM2MResourceString(MbedCloudClient* client,
                   const char* route,
                   string v,
                   M2MBase::Operation opr,
                   bool observable,
                   void(*on_update)(string)) m2m_deprecated;


    virtual ~SimpleM2MResourceString();

    string operator=(const string& new_value);

    operator string() const;

    virtual void update();

private:
    FP1<void, string>                   _on_update;
};

class SimpleM2MResourceInt : public SimpleM2MResourceBase
{
public:

    SimpleM2MResourceInt(MbedCloudClient* client,
                const char* route,
                int v,
                M2MBase::Operation opr = M2MBase::GET_PUT_ALLOWED,
                bool observable = true,
                FP1<void, int> on_update = NULL) m2m_deprecated;

    SimpleM2MResourceInt(MbedCloudClient* client,
                const char* route,
                int v,
                M2MBase::Operation opr,
                bool observable,
                void(*on_update)(int)) m2m_deprecated;

    virtual ~SimpleM2MResourceInt();

    int operator=(int new_value);

    operator int() const;

    virtual void update();

private:
    FP1<void, int>                  _on_update;
};

#endif

#endif // SIMPLE_M2M_RESOURCE_H