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 | // Copyright (C) 2011-2024 Internet Systems Consortium, Inc. ("ISC")
//
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at http://mozilla.org/MPL/2.0/.
#ifndef TCP_ENDPOINT_H
#define TCP_ENDPOINT_H 1
#ifndef BOOST_ASIO_HPP
#error "asio.hpp must be included before including this, see asiolink.h as to why"
#endif
#include <asiolink/io_endpoint.h>
namespace isc {
namespace asiolink {
/// \brief The \c TCPEndpoint class is a concrete derived class of
/// \c IOEndpoint that represents an endpoint of a TCP packet.
///
/// Other notes about \c TCPEndpoint applies to this class, too.
class TCPEndpoint : public IOEndpoint {
public:
///
/// \name Constructors and Destructor.
///
//@{
/// \brief Default Constructor
///
/// Creates an internal endpoint. This is expected to be set by some
/// external call.
TCPEndpoint() :
asio_endpoint_placeholder_(new boost::asio::ip::tcp::endpoint()),
asio_endpoint_(*asio_endpoint_placeholder_)
{}
/// \brief Constructor from a pair of address and port.
///
/// \param address The IP address of the endpoint.
/// \param port The TCP port number of the endpoint.
TCPEndpoint(const IOAddress& address, const unsigned short port) :
asio_endpoint_placeholder_(
new boost::asio::ip::tcp::endpoint(boost::asio::ip::address::from_string(address.toText()),
port)),
asio_endpoint_(*asio_endpoint_placeholder_)
{}
/// \brief Constructor from an ASIO TCP endpoint.
///
/// This constructor is designed to be an efficient wrapper for the
/// corresponding ASIO class, \c tcp::endpoint.
///
/// \param asio_endpoint The ASIO representation of the TCP endpoint.
TCPEndpoint(boost::asio::ip::tcp::endpoint& asio_endpoint) :<--- Class 'TCPEndpoint' has a constructor with 1 argument that is not explicit. [+]Class 'TCPEndpoint' has a constructor with 1 argument that is not explicit. Such, so called "Converting constructors", should in general be explicit for type safety reasons as that prevents unintended implicit conversions.
asio_endpoint_placeholder_(NULL), asio_endpoint_(asio_endpoint)
{}
/// \brief Constructor from an ASIO TCP endpoint.
///
/// This constructor is designed to be an efficient wrapper for the
/// corresponding ASIO class, \c tcp::endpoint.
///
/// \param asio_endpoint The ASIO representation of the TCP endpoint.
TCPEndpoint(const boost::asio::ip::tcp::endpoint& asio_endpoint) :<--- Class 'TCPEndpoint' has a constructor with 1 argument that is not explicit. [+]Class 'TCPEndpoint' has a constructor with 1 argument that is not explicit. Such, so called "Converting constructors", should in general be explicit for type safety reasons as that prevents unintended implicit conversions.
asio_endpoint_placeholder_(new boost::asio::ip::tcp::endpoint(asio_endpoint)),
asio_endpoint_(*asio_endpoint_placeholder_)
{}
/// \brief The destructor.
virtual ~TCPEndpoint() { delete asio_endpoint_placeholder_; }<--- Destructor in derived class
//@}
virtual IOAddress getAddress() const {<--- Function in derived class
return (asio_endpoint_.address());
}
virtual const struct sockaddr& getSockAddr() const {<--- Function in derived class
return (*asio_endpoint_.data());
}
virtual uint16_t getPort() const {<--- Function in derived class
return (asio_endpoint_.port());
}
virtual short getProtocol() const {<--- Function in derived class
return (asio_endpoint_.protocol().protocol());
}
virtual short getFamily() const {<--- Function in derived class
return (asio_endpoint_.protocol().family());
}
// This is not part of the exposed IOEndpoint API but allows
// direct access to the ASIO implementation of the endpoint
inline const boost::asio::ip::tcp::endpoint& getASIOEndpoint() const {
return (asio_endpoint_);
}
inline boost::asio::ip::tcp::endpoint& getASIOEndpoint() {
return (asio_endpoint_);
}
private:
boost::asio::ip::tcp::endpoint* asio_endpoint_placeholder_;
boost::asio::ip::tcp::endpoint& asio_endpoint_;
};
} // namespace asiolink
} // namespace isc
#endif // TCP_ENDPOINT_H
|