include/afb/afb-event-x2-itf.h

   1 /*
   2  * Copyright (C) 2016, 2017, 2018 "IoT.bzh"
   3  * Author: José Bollo <jose.bollo@iot.bzh>
   4  *
   5  * Licensed under the Apache License, Version 2.0 (the "License");
   6  * you may not use this file except in compliance with the License.
   7  * You may obtain a copy of the License at
   8  *
   9  *   http://www.apache.org/licenses/LICENSE-2.0
  10  *
  11  * Unless required by applicable law or agreed to in writing, software
  12  * distributed under the License is distributed on an "AS IS" BASIS,
  13  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14  * See the License for the specific language governing permissions and
  15  * limitations under the License.
  16  */
  17
  18 #pragma once
  19
  20 struct afb_event_x2;
  21 struct afb_event_x2_itf;
  22
  23 /**
  24  * Interface for handling event_x2.
  25  *
  26  * It records the functions to be called for the event_x2.
  27  *
  28  * Don't use this structure directly.
  29  */
  30 struct afb_event_x2_itf
  31 {
  32         /* CAUTION: respect the order, add at the end */
  33
  34         /** broadcast the event */
  35         int (*broadcast)(struct afb_event_x2 *event, struct json_object *obj);
  36
  37         /** push the event to its subscribers */
  38         int (*push)(struct afb_event_x2 *event, struct json_object *obj);
  39
  40         /** unreference the event */
  41         void (*unref)(struct afb_event_x2 *event); /* aka drop */
  42
  43         /** get the event name */
  44         const char *(*name)(struct afb_event_x2 *event);
  45
  46         /** rereference the event */
  47         struct afb_event_x2 *(*addref)(struct afb_event_x2 *event);
  48 };
  49
  50 /**
  51  * Describes the event_x2
  52  */
  53 struct afb_event_x2
  54 {
  55         const struct afb_event_x2_itf *itf;     /**< the interface functions to use */
  56 };
  57