xref: /aosp_15_r20/external/ot-br-posix/src/rest/rest_web_server.hpp (revision 4a64e381480ef79f0532b2421e44e6ee336b8e0d)
1*4a64e381SAndroid Build Coastguard Worker /*
2*4a64e381SAndroid Build Coastguard Worker  *  Copyright (c) 2020, The OpenThread Authors.
3*4a64e381SAndroid Build Coastguard Worker  *  All rights reserved.
4*4a64e381SAndroid Build Coastguard Worker  *
5*4a64e381SAndroid Build Coastguard Worker  *  Redistribution and use in source and binary forms, with or without
6*4a64e381SAndroid Build Coastguard Worker  *  modification, are permitted provided that the following conditions are met:
7*4a64e381SAndroid Build Coastguard Worker  *  1. Redistributions of source code must retain the above copyright
8*4a64e381SAndroid Build Coastguard Worker  *     notice, this list of conditions and the following disclaimer.
9*4a64e381SAndroid Build Coastguard Worker  *  2. Redistributions in binary form must reproduce the above copyright
10*4a64e381SAndroid Build Coastguard Worker  *     notice, this list of conditions and the following disclaimer in the
11*4a64e381SAndroid Build Coastguard Worker  *     documentation and/or other materials provided with the distribution.
12*4a64e381SAndroid Build Coastguard Worker  *  3. Neither the name of the copyright holder nor the
13*4a64e381SAndroid Build Coastguard Worker  *     names of its contributors may be used to endorse or promote products
14*4a64e381SAndroid Build Coastguard Worker  *     derived from this software without specific prior written permission.
15*4a64e381SAndroid Build Coastguard Worker  *
16*4a64e381SAndroid Build Coastguard Worker  *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
17*4a64e381SAndroid Build Coastguard Worker  *  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18*4a64e381SAndroid Build Coastguard Worker  *  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19*4a64e381SAndroid Build Coastguard Worker  *  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
20*4a64e381SAndroid Build Coastguard Worker  *  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
21*4a64e381SAndroid Build Coastguard Worker  *  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
22*4a64e381SAndroid Build Coastguard Worker  *  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
23*4a64e381SAndroid Build Coastguard Worker  *  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
24*4a64e381SAndroid Build Coastguard Worker  *  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
25*4a64e381SAndroid Build Coastguard Worker  *  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
26*4a64e381SAndroid Build Coastguard Worker  *  POSSIBILITY OF SUCH DAMAGE.
27*4a64e381SAndroid Build Coastguard Worker  */
28*4a64e381SAndroid Build Coastguard Worker 
29*4a64e381SAndroid Build Coastguard Worker /**
30*4a64e381SAndroid Build Coastguard Worker  * @file
31*4a64e381SAndroid Build Coastguard Worker  *   This file includes definitions for RESTful HTTP server.
32*4a64e381SAndroid Build Coastguard Worker  */
33*4a64e381SAndroid Build Coastguard Worker 
34*4a64e381SAndroid Build Coastguard Worker #ifndef OTBR_REST_REST_WEB_SERVER_HPP_
35*4a64e381SAndroid Build Coastguard Worker #define OTBR_REST_REST_WEB_SERVER_HPP_
36*4a64e381SAndroid Build Coastguard Worker 
37*4a64e381SAndroid Build Coastguard Worker #include "openthread-br/config.h"
38*4a64e381SAndroid Build Coastguard Worker 
39*4a64e381SAndroid Build Coastguard Worker #include <netinet/in.h>
40*4a64e381SAndroid Build Coastguard Worker #include <netinet/ip.h>
41*4a64e381SAndroid Build Coastguard Worker #include <sys/socket.h>
42*4a64e381SAndroid Build Coastguard Worker 
43*4a64e381SAndroid Build Coastguard Worker #include "common/mainloop.hpp"
44*4a64e381SAndroid Build Coastguard Worker #include "rest/connection.hpp"
45*4a64e381SAndroid Build Coastguard Worker 
46*4a64e381SAndroid Build Coastguard Worker using otbr::Ncp::RcpHost;
47*4a64e381SAndroid Build Coastguard Worker using std::chrono::steady_clock;
48*4a64e381SAndroid Build Coastguard Worker 
49*4a64e381SAndroid Build Coastguard Worker namespace otbr {
50*4a64e381SAndroid Build Coastguard Worker namespace rest {
51*4a64e381SAndroid Build Coastguard Worker 
52*4a64e381SAndroid Build Coastguard Worker /**
53*4a64e381SAndroid Build Coastguard Worker  * This class implements a REST server.
54*4a64e381SAndroid Build Coastguard Worker  */
55*4a64e381SAndroid Build Coastguard Worker class RestWebServer : public MainloopProcessor
56*4a64e381SAndroid Build Coastguard Worker {
57*4a64e381SAndroid Build Coastguard Worker public:
58*4a64e381SAndroid Build Coastguard Worker     /**
59*4a64e381SAndroid Build Coastguard Worker      * The constructor to initialize a REST server.
60*4a64e381SAndroid Build Coastguard Worker      *
61*4a64e381SAndroid Build Coastguard Worker      * @param[in] aHost  A reference to the Thread controller.
62*4a64e381SAndroid Build Coastguard Worker      */
63*4a64e381SAndroid Build Coastguard Worker     RestWebServer(RcpHost &aHost, const std::string &aRestListenAddress, int aRestListenPort);
64*4a64e381SAndroid Build Coastguard Worker 
65*4a64e381SAndroid Build Coastguard Worker     /**
66*4a64e381SAndroid Build Coastguard Worker      * The destructor destroys the server instance.
67*4a64e381SAndroid Build Coastguard Worker      */
68*4a64e381SAndroid Build Coastguard Worker     ~RestWebServer(void) override;
69*4a64e381SAndroid Build Coastguard Worker 
70*4a64e381SAndroid Build Coastguard Worker     /**
71*4a64e381SAndroid Build Coastguard Worker      * This method initializes the REST server.
72*4a64e381SAndroid Build Coastguard Worker      */
73*4a64e381SAndroid Build Coastguard Worker     void Init(void);
74*4a64e381SAndroid Build Coastguard Worker 
75*4a64e381SAndroid Build Coastguard Worker     void Update(MainloopContext &aMainloop) override;
76*4a64e381SAndroid Build Coastguard Worker     void Process(const MainloopContext &aMainloop) override;
77*4a64e381SAndroid Build Coastguard Worker 
78*4a64e381SAndroid Build Coastguard Worker private:
79*4a64e381SAndroid Build Coastguard Worker     void      UpdateConnections(const fd_set &aReadFdSet);
80*4a64e381SAndroid Build Coastguard Worker     void      CreateNewConnection(int32_t &aFd);
81*4a64e381SAndroid Build Coastguard Worker     otbrError Accept(int32_t aListenFd);
82*4a64e381SAndroid Build Coastguard Worker     bool      ParseListenAddress(const std::string listenAddress, struct in6_addr *sin6_addr);
83*4a64e381SAndroid Build Coastguard Worker     void      InitializeListenFd(void);
84*4a64e381SAndroid Build Coastguard Worker     bool      SetFdNonblocking(int32_t fd);
85*4a64e381SAndroid Build Coastguard Worker 
86*4a64e381SAndroid Build Coastguard Worker     // Resource handler
87*4a64e381SAndroid Build Coastguard Worker     Resource mResource;
88*4a64e381SAndroid Build Coastguard Worker     // Struct for server configuration
89*4a64e381SAndroid Build Coastguard Worker     sockaddr_in6 mAddress;
90*4a64e381SAndroid Build Coastguard Worker     // File descriptor for listening
91*4a64e381SAndroid Build Coastguard Worker     int32_t mListenFd;
92*4a64e381SAndroid Build Coastguard Worker     // Connection List
93*4a64e381SAndroid Build Coastguard Worker     std::unordered_map<int32_t, std::unique_ptr<Connection>> mConnectionSet;
94*4a64e381SAndroid Build Coastguard Worker };
95*4a64e381SAndroid Build Coastguard Worker 
96*4a64e381SAndroid Build Coastguard Worker } // namespace rest
97*4a64e381SAndroid Build Coastguard Worker } // namespace otbr
98*4a64e381SAndroid Build Coastguard Worker 
99*4a64e381SAndroid Build Coastguard Worker #endif // OTBR_REST_REST_WEB_SERVER_HPP_
100