summaryrefslogtreecommitdiff
path: root/src/components/transport_manager/include/transport_manager/websocket_server/websocket_server_transport_adapter.h
blob: ce2844fa45f8ff7b0ea9964c7b3dd795c5ee48ce (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
/*
 * \file websocket_transport_adapter.h
 * \brief WebSocketTransportAdapter class header file.
 *
 * Copyright (c) 2020, Ford Motor Company
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 *
 * Redistributions of source code must retain the above copyright notice, this
 * list of conditions and the following disclaimer.
 *
 * Redistributions in binary form must reproduce the above copyright notice,
 * this list of conditions and the following
 * disclaimer in the documentation and/or other materials provided with the
 * distribution.
 *
 * Neither the name of the Ford Motor Company nor the names of its contributors
 * may be used to endorse or promote products derived from this software
 * without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 */

#ifndef SRC_COMPONENTS_TRANSPORT_MANAGER_INCLUDE_TRANSPORT_MANAGER_WEBSOCKET_SERVER_WEBSOCKET_SERVER_TRANSPORT_ADAPTER_H_
#define SRC_COMPONENTS_TRANSPORT_MANAGER_INCLUDE_TRANSPORT_MANAGER_WEBSOCKET_SERVER_WEBSOCKET_SERVER_TRANSPORT_ADAPTER_H_

#include <string>
#include "transport_manager/transport_adapter/transport_adapter_impl.h"

namespace transport_manager {
namespace transport_adapter {

/**
 * @brief Transport adapter that uses WebSocket transport.
 */
class WebSocketServerTransportAdapter : public TransportAdapterImpl {
 public:
  /**
   * @brief Constructor.
   */
  WebSocketServerTransportAdapter(resumption::LastState& last_state,
                                  const TransportManagerSettings& settings);

  /**
   * @brief Destructor.
   */
  virtual ~WebSocketServerTransportAdapter();

  /**
   * @brief Websocket server transport adapter
   * specific Init() method
   * @note Perform additional actions required by WS transport adapter
   * then calls basic class Init()
   */
  TransportAdapter::Error Init() OVERRIDE;

  /**
   * @brief Adds webengine device to internal storage
   * of related WebSocket transport adapter
   * @param device webengine device to add
   * @note webengine device storage required
   * to be used in Low Voltage conditions
   */
  DeviceSptr AddDevice(DeviceSptr device) OVERRIDE;

  /**
   * @brief Notification that transport's configuration is updated
   *
   * @param new_config The new configuration of the transport
   */
  void TransportConfigUpdated(const TransportConfig& new_config) OVERRIDE;

  /**
   * @brief Returns the transport's configuration information
   */
  virtual TransportConfig GetTransportConfiguration() const OVERRIDE;

  /**
   * @brief Store adapter state in last state
   */
  void Store() const OVERRIDE;

  /**
   * @brief Restore adapter state from last state
   * @return True on success false otherwise
   */
  bool Restore() OVERRIDE;

  std::string GetStoredDeviceID(const std::string& device_name) const OVERRIDE;

 protected:
  /**
   * @brief Return type of device.
   *
   * @return String with device type.
   */
  DeviceType GetDeviceType() const OVERRIDE;

 private:
  /**
   * @brief Keeps transport specific configuration
   *
   * TCP transport uses following information:
   * - "enabled": whether the transport is currently enabled or not. Value can
   *              be "true" or "false".
   * - "tcp_ip_address": string representation of IP address (either IPv4 or
   *                     IPv6)
   * - "tcp_port": string representation of TCP port number (e.g. "12345")
   */
  TransportConfig transport_config_;
  DeviceSptr webengine_device_;
};

}  // namespace transport_adapter
}  // namespace transport_manager

#endif  // SRC_COMPONENTS_TRANSPORT_MANAGER_INCLUDE_TRANSPORT_MANAGER_WEBSOCKET_SERVER_WEBSOCKET_SERVER_TRANSPORT_ADAPTER_H_