resource/include/CAManager.h

   1 /* ****************************************************************
   2  *
   3  * Copyright 2016 Samsung Electronics All Rights Reserved.
   4  *
   5  *
   6  *
   7  * Licensed under the Apache License, Version 2.0 (the "License");
   8  * you may not use this file except in compliance with the License.
   9  * You may obtain a copy of the License at
  10  *
  11  *      http://www.apache.org/licenses/LICENSE-2.0
  12  *
  13  * Unless required by applicable law or agreed to in writing, software
  14  * distributed under the License is distributed on an "AS IS" BASIS,
  15  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  16  * See the License for the specific language governing permissions and
  17  * limitations under the License.
  18  *
  19  ******************************************************************/
  20
  21 #ifndef CA_MANAGER_H_
  22 #define CA_MANAGER_H_
  23
  24 #include <OCApi.h>
  25
  26 namespace OC
  27 {
  28     /**
  29     * This namespace contains the main entrance/functionality to monitoring network changes.
  30     * It may be used with OC::CAManager::functionName. To set a custom callback function,
  31     * the implementer must make a call to CAManager::setNetworkMonitorHandler.
  32     */
  33     namespace CAManager
  34     {
  35         // typedef to get adapter status changes from CA.
  36         typedef std::function<void(OCTransportAdapter,
  37                                    const std::string&, bool)> ConnectionChangedCallback;
  38
  39         // typedef to get connection status changes from CA.
  40         typedef std::function<void(OCTransportAdapter, bool)> AdapterChangedCallback;
  41
  42         /**
  43         * Set network monitoring handler.
  44         * @param adapterHandler adapter state change handler to handle changes for
  45         *                       any transport types.
  46         * @param connectionHandler connection state change handler to handle changes for
  47         *                          connection with remote devices.
  48         * @return Returns ::OC_STACK_OK if success.
  49         */
  50         OCStackResult setNetworkMonitorHandler(AdapterChangedCallback adapterHandler,
  51                                                ConnectionChangedCallback connectionHandler);
  52     }
  53 }
  54
  55 #endif // CA_MANAGER_H_
  56
  57
  58