m2mendpoint.h

Go to the documentation of this file.

/*
 * Copyright (c) 2015 ARM Limited. All rights reserved.
 * 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 M2M_ENDPOINT_H
#define M2M_ENDPOINT_H

#include "mbed-client/m2mvector.h"
#include "mbed-client/m2mbase.h"
#include "mbed-client/m2mobject.h"
#include "mbed-client/m2mstring.h"

#ifdef MBED_CLOUD_CLIENT_EDGE_EXTENSION

//FORWARD DECLARATION
typedef Vector<M2MObject *> M2MObjectList;


class M2MEndpoint : public M2MBase
{

friend class M2MInterfaceFactory;
friend class M2MNsdlInterface;
friend class TestFactory;
friend class Test_M2MObject;

protected :

    M2MEndpoint(const String &object_name,
              char *path);

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

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

    // Prevents the use of copy constructor.
    M2MEndpoint( const M2MEndpoint& /*other*/ );

    /*
     * \brief Data has been changed and it needs to be updated to Device Management.
     */
    virtual void set_changed();

    /*
     * \brief You can clear the flag the when the data has been updated into Device Management.
     */
    void clear_changed();

    /*
     * \brief Returns current changed status.
     */
    bool get_changed() const;


public:

    virtual ~M2MEndpoint();

    M2MObject* create_object(const String &name);

    bool remove_object(const String &name);

    M2MObject* object(const String &name) const;

    const M2MObjectList& objects() const;

    uint16_t object_count() const;

    virtual M2MObservationHandler* observation_handler() const;

    virtual void set_observation_handler(M2MObservationHandler *handler);

    virtual void add_observation_level(M2MBase::Observation observation_level);

    virtual void remove_observation_level(M2MBase::Observation observation_level);

    virtual sn_coap_hdr_s* handle_get_request(nsdl_s *nsdl,
                                              sn_coap_hdr_s *received_coap_header,
                                              M2MObservationHandler *observation_handler = NULL);

    virtual sn_coap_hdr_s* handle_put_request(nsdl_s *nsdl,
                                              sn_coap_hdr_s *received_coap_header,
                                              M2MObservationHandler *observation_handler,
                                              bool &execute_value_updated);

    virtual sn_coap_hdr_s* handle_post_request(nsdl_s *nsdl,
                                               sn_coap_hdr_s *received_coap_header,
                                               M2MObservationHandler *observation_handler,
                                               bool &execute_value_updated,
                                               sn_nsdl_addr_s *address = NULL);

    void set_context(void *ctx);

    void* get_context() const;

    virtual void set_deleted();

    virtual bool is_deleted();

  private:

    M2MObjectList     _object_list; // owned
    M2MObservationHandler    *_observation_handler; // Not owned
    void             *_ctx; // user defined context
    bool             _changed; // True if modifications have been done to this endpoint since last registration update.
                               // False otherwise.
    bool             _deleted; // True if this M2MEndpoint is deleted, false otherwise.

friend class Test_M2MEndpoint;
friend class Test_M2MInterfaceImpl;
friend class Test_M2MNsdlInterface;
friend class Test_M2MTLVSerializer;
friend class Test_M2MTLVDeserializer;
friend class Test_M2MDevice;
friend class Test_M2MFirmware;
friend class Test_M2MBase;
friend class Test_M2MResource;
friend class Test_M2MSecurity;
friend class Test_M2MServer;
friend class Test_M2MResourceInstance;
};

#endif // MBED_CLOUD_CLIENT_EDGE_EXTENSION

#endif // M2M_ENDPOINT_H