A Transport that communicates on a WebSocket connection.
More...
#include <websocket-transport.hpp>
A Transport that communicates on a WebSocket connection.
Definition at line 54 of file websocket-transport.hpp.
identifies an endpoint on the link
Definition at line 109 of file transport.hpp.
nfd::face::WebSocketTransport::WebSocketTransport |
( |
websocketpp::connection_hdl |
hdl, |
|
|
websocket::Server & |
server, |
|
|
time::milliseconds |
pingInterval |
|
) |
| |
void nfd::face::WebSocketTransport::beforeChangePersistency |
( |
ndn::nfd::FacePersistency |
newPersistency | ) |
|
|
finalprotectedvirtual |
invoked before persistency is changed
- Exceptions
-
std::invalid_argument | new persistency is not supported |
std::runtime_error | transition is disallowed |
Implements nfd::face::Transport.
Definition at line 80 of file websocket-transport.cpp.
void nfd::face::Transport::close |
( |
| ) |
|
|
inherited |
request the transport to be closed
This operation is effective only if transport is in UP or DOWN state, otherwise it has no effect. The transport changes state to CLOSING, and performs cleanup procedure. The state will be changed to CLOSED when cleanup is complete, which may happen synchronously or asynchronously.
Definition at line 86 of file transport.cpp.
void nfd::face::WebSocketTransport::doClose |
( |
| ) |
|
|
finalprotectedvirtual |
performs Transport specific operations to close the transport
This is invoked once by close()
after changing state to CLOSING. It will not be invoked by Transport class if the transport is already CLOSING or CLOSED.
When the cleanup procedure is complete, this method should change state to CLOSED. This transition can happen synchronously or asynchronously.
Implements nfd::face::Transport.
Definition at line 173 of file websocket-transport.cpp.
time::steady_clock::TimePoint nfd::face::Transport::getExpirationTime |
( |
| ) |
const |
|
inlineinherited |
- Returns
- expiration time of the transport
- Return values
-
time::steady_clock::TimePoint::max() | the transport has indefinite lifetime |
Definition at line 429 of file transport.hpp.
const Face * nfd::face::Transport::getFace |
( |
| ) |
const |
|
inlineinherited |
const LinkService * nfd::face::Transport::getLinkService |
( |
| ) |
const |
|
inlineinherited |
ndn::nfd::LinkType nfd::face::Transport::getLinkType |
( |
| ) |
const |
|
inlineinherited |
- Returns
- whether face is point-to-point or multi-access
Definition at line 398 of file transport.hpp.
FaceUri nfd::face::Transport::getLocalUri |
( |
| ) |
const |
|
inlineinherited |
- Returns
- a FaceUri representing local endpoint
Definition at line 356 of file transport.hpp.
ssize_t nfd::face::Transport::getMtu |
( |
| ) |
const |
|
inlineinherited |
- Returns
- maximum payload size
- Return values
-
MTU_UNLIMITED | transport has no limit on payload size |
This size is the maximum packet size that can be sent or received through this transport.
For a datagram-based transport, this is typically the Maximum Transmission Unit (MTU), after the overhead of headers introduced by the transport has been accounted for. For a stream-based transport, this is typically unlimited (MTU_UNLIMITED).
Definition at line 410 of file transport.hpp.
ndn::nfd::FacePersistency nfd::face::Transport::getPersistency |
( |
| ) |
const |
|
inlineinherited |
FaceUri nfd::face::Transport::getRemoteUri |
( |
| ) |
const |
|
inlineinherited |
- Returns
- a FaceUri representing remote endpoint
Definition at line 368 of file transport.hpp.
ndn::nfd::FaceScope nfd::face::Transport::getScope |
( |
| ) |
const |
|
inlineinherited |
- Returns
- whether face is local or non-local for scope control purpose
Definition at line 380 of file transport.hpp.
void nfd::face::WebSocketTransport::handlePong |
( |
| ) |
|
void nfd::face::WebSocketTransport::handlePongTimeout |
( |
| ) |
|
void nfd::face::Transport::receive |
( |
Packet && |
packet | ) |
|
|
protectedinherited |
receive a link-layer packet
- Warning
- undefined behavior if packet size exceeds MTU limit
Definition at line 119 of file transport.cpp.
void nfd::face::WebSocketTransport::receiveMessage |
( |
const std::string & |
msg | ) |
|
void nfd::face::Transport::send |
( |
Packet && |
packet | ) |
|
|
inherited |
send a link-layer packet
- Note
- This operation has no effect if
getState()
is neither UP nor DOWN
- Warning
- undefined behavior if packet size exceeds MTU limit
Definition at line 99 of file transport.cpp.
void nfd::face::Transport::setExpirationTime |
( |
const time::steady_clock::TimePoint & |
expirationTime | ) |
|
|
inlineprotectedinherited |
void nfd::face::Transport::setFaceAndLinkService |
( |
Face & |
face, |
|
|
LinkService & |
service |
|
) |
| |
|
inherited |
void nfd::face::Transport::setLinkType |
( |
ndn::nfd::LinkType |
linkType | ) |
|
|
inlineprotectedinherited |
void nfd::face::Transport::setLocalUri |
( |
const FaceUri & |
uri | ) |
|
|
inlineprotectedinherited |
void nfd::face::Transport::setMtu |
( |
ssize_t |
mtu | ) |
|
|
inlineprotectedinherited |
void nfd::face::Transport::setPersistency |
( |
ndn::nfd::FacePersistency |
persistency | ) |
|
|
inherited |
void nfd::face::Transport::setRemoteUri |
( |
const FaceUri & |
uri | ) |
|
|
inlineprotectedinherited |
void nfd::face::Transport::setScope |
( |
ndn::nfd::FaceScope |
scope | ) |
|
|
inlineprotectedinherited |
set transport state
Only the following transitions are valid: UP->DOWN, DOWN->UP, UP/DOWN->CLOSING/FAILED, CLOSING/FAILED->CLOSED
- Exceptions
-
std::runtime_error | transition is invalid. |
Definition at line 150 of file transport.cpp.
signals when transport state changes
Definition at line 254 of file transport.hpp.
total incoming bytes
This counter includes headers imposed by NFD (such as NDNLP), but excludes overhead of underlying protocol (such as IP header). For a datagram-based transport, an incoming packet that cannot be parsed as TLV would not be counted.
Definition at line 82 of file transport.hpp.
count of incoming packets
A 'packet' typically means a top-level TLV block. For a datagram-based transport, an incoming packet that cannot be parsed as TLV would not be counted.
Definition at line 66 of file transport.hpp.
total outgoing bytes
This counter includes headers imposed by NFD (such as NDNLP), but excludes overhead of underlying protocol (such as IP header). This counter is increased only if transport is UP.
Definition at line 90 of file transport.hpp.
count of outgoing packets
A 'packet' typically means a top-level TLV block. This counter is incremented only if transport is UP.
Definition at line 73 of file transport.hpp.