Visual Servoing Platform
version 3.5.0 under development (2022-02-15)
|
#include <visp3/core/vpClient.h>
Public Member Functions | |
vpClient () | |
virtual | ~vpClient () |
bool | connectToHostname (const std::string &hostname, const unsigned int &port_serv) |
bool | connectToIP (const std::string &ip, const unsigned int &port_serv) |
void | deconnect (const unsigned int &index=0) |
unsigned int | getNumberOfAttempts () |
unsigned int | getNumberOfServers () |
void | print () |
void | setNumberOfAttempts (const unsigned int &nb) |
void | stop () |
void | addDecodingRequest (vpRequest *) |
int | getReceptorIndex (const char *name) |
std::string | getRequestIdFromIndex (const int &ind) |
unsigned int | getMaxSizeReceivedMessage () |
void | print (const char *id="") |
template<typename T > | |
int | receive (T *object, const unsigned int &sizeOfObject=sizeof(T)) |
template<typename T > | |
int | receiveFrom (T *object, const unsigned int &receptorEmitting, const unsigned int &sizeOfObject=sizeof(T)) |
std::vector< int > | receiveRequest () |
std::vector< int > | receiveRequestFrom (const unsigned int &receptorEmitting) |
int | receiveRequestOnce () |
int | receiveRequestOnceFrom (const unsigned int &receptorEmitting) |
std::vector< int > | receiveAndDecodeRequest () |
std::vector< int > | receiveAndDecodeRequestFrom (const unsigned int &receptorEmitting) |
int | receiveAndDecodeRequestOnce () |
int | receiveAndDecodeRequestOnceFrom (const unsigned int &receptorEmitting) |
void | removeDecodingRequest (const char *) |
template<typename T > | |
int | send (T *object, const int unsigned &sizeOfObject=sizeof(T)) |
template<typename T > | |
int | send (T *object, const unsigned int &sizeOfObject) |
template<typename T > | |
int | sendTo (T *object, const unsigned int &dest, const unsigned int &sizeOfObject=sizeof(T)) |
int | sendRequest (vpRequest &req) |
int | sendRequestTo (vpRequest &req, const unsigned int &dest) |
int | sendAndEncodeRequest (vpRequest &req) |
int | sendAndEncodeRequestTo (vpRequest &req, const unsigned int &dest) |
void | setMaxSizeReceivedMessage (const unsigned int &s) |
void | setTimeoutSec (const long &sec) |
void | setTimeoutUSec (const long &usec) |
void | setVerbose (const bool &mode) |
Protected Attributes | |
vpEmitter | emitter |
std::vector< vpReceptor > | receptor_list |
fd_set | readFileDescriptor |
int | socketMax |
std::vector< vpRequest * > | request_list |
unsigned int | max_size_message |
std::string | separator |
std::string | beginning |
std::string | end |
std::string | param_sep |
std::string | currentMessageReceived |
struct timeval | tv |
long | tv_sec |
long | tv_usec |
bool | verboseMode |
This class represents a Transmission Control Protocol (TCP) client.
TCP provides reliable, ordered delivery of a stream of bytes from a program on one computer to another program on another computer.
Exemple of client's code, receiving and sending basic message It corresponds to the client used in the first exemple of vpServer class' documentation:
Exemple of client's code, sending a vpImage on request form. It correspond to the server used in the second exemple of vpServer class' documentation.
Definition at line 167 of file vpClient.h.
vpClient::vpClient | ( | ) |
Definition at line 44 of file vpClient.cpp.
|
virtual |
Disconnect the client from all the servers, and close the sockets.
Definition at line 49 of file vpClient.cpp.
References stop().
|
inherited |
Add a decoding request to the emitter. This request will be used to decode the received messages. Each request must have a different id.
req | : Request to add. |
Definition at line 83 of file vpNetwork.cpp.
References vpRequest::getId(), and vpNetwork::request_list.
bool vpClient::connectToHostname | ( | const std::string & | hostname, |
const unsigned int & | port_serv | ||
) |
Connect to the server represented by the given hostname, and at a given port.
hostname | : Hostname of the server. |
port_serv | : Port used for the connection. |
Definition at line 62 of file vpClient.cpp.
References vpERROR_TRACE.
bool vpClient::connectToIP | ( | const std::string & | ip, |
const unsigned int & | port_serv | ||
) |
Connect to the server represented by the given ip, and at a given port.
ip | : IP of the server. |
port_serv | : Port used for the connection. |
Definition at line 109 of file vpClient.cpp.
References vpERROR_TRACE.
void vpClient::deconnect | ( | const unsigned int & | index = 0 | ) |
Deconnect from the server at a specific index.
index | : Index of the server. |
Definition at line 137 of file vpClient.cpp.
References vpNetwork::receptor_list.
|
inlineinherited |
Get the maximum size that the emitter can receive (in request mode).
Definition at line 193 of file vpNetwork.h.
|
inline |
Get the actual number of attempts to connect to the server.
Definition at line 197 of file vpClient.h.
|
inline |
Get the number of server that the client is connected on.
Definition at line 204 of file vpClient.h.
References vpNetwork::print().
|
inherited |
Get the receptor index from its name. The name can be either the IP, or its name on the network.
name | : Name of the receptor. |
Definition at line 138 of file vpNetwork.cpp.
References vpNetwork::receptor_list, and vpERROR_TRACE.
|
inlineinherited |
Get the Id of the request at the index ind.
ind | : Index of the request. |
Definition at line 179 of file vpNetwork.h.
|
inherited |
Print the receptors.
id | : Message to display before the receptor's index. |
Definition at line 123 of file vpNetwork.cpp.
References vpNetwork::receptor_list.
Referenced by vpServer::getNumberOfClients(), getNumberOfServers(), print(), and vpServer::print().
void vpClient::print | ( | ) |
Print the servers.
Definition at line 168 of file vpClient.cpp.
References vpNetwork::print(), vpNetwork::receptor_list, vpERROR_TRACE, and vpTime::wait().
|
inherited |
Receives a object. The size of the received object is suppose to be the size of the type of the object. Note that a received message can correspond to a deconnection signal.
object | : Received object. |
sizeOfObject | : Size of the received object. |
Definition at line 283 of file vpNetwork.h.
References vpERROR_TRACE, and vpTRACE.
|
inherited |
Receives and decode requests untils there is requests to receive.
Definition at line 375 of file vpNetwork.cpp.
References vpNetwork::receiveRequest(), and vpNetwork::request_list.
|
inherited |
Receives and decode requests, from a specific emitter, untils there is request to receive.
receptorEmitting | : Index of the receptor emitting the message |
Definition at line 402 of file vpNetwork.cpp.
References vpNetwork::receiveRequestFrom(), and vpNetwork::request_list.
|
inherited |
Receives a message once (in the limit of the Maximum message size value). This message can represent an entire request or not. Several calls to this function might be necessary to get the entire request. If it represents an entire request, it decodes the request.
Definition at line 432 of file vpNetwork.cpp.
References vpNetwork::receiveRequestOnce(), and vpNetwork::request_list.
|
inherited |
Receives a message once (in the limit of the Maximum message size value), from a specific emitter. This message can represent an entire request or not. Several calls to this function might be necessary to get the entire request. If it represents an entire request, it decodes the request.
receptorEmitting | : Index of the receptor emitting the message. |
Definition at line 462 of file vpNetwork.cpp.
References vpNetwork::beginning, vpNetwork::currentMessageReceived, vpNetwork::end, vpNetwork::max_size_message, vpNetwork::param_sep, vpNetwork::readFileDescriptor, vpNetwork::receiveRequestOnceFrom(), vpNetwork::receptor_list, vpNetwork::request_list, vpNetwork::separator, vpNetwork::socketMax, vpNetwork::tv, vpNetwork::tv_sec, vpNetwork::tv_usec, vpNetwork::verboseMode, vpERROR_TRACE, and vpTRACE.
|
inherited |
Receives a object from a receptor, by specifying its size or not. Note that a received message can correspond to a deconnection signal.
object | : Received object. |
receptorEmitting | : Index of the receptor emitting the message. |
sizeOfObject | : Size of the received object. |
Definition at line 365 of file vpNetwork.h.
References vpERROR_TRACE, and vpTRACE.
|
inherited |
Receive requests untils there is requests to receive.
Definition at line 281 of file vpNetwork.cpp.
Referenced by vpNetwork::receiveAndDecodeRequest().
|
inherited |
Receives requests, from a specific emitter, untils there is request to receive.
receptorEmitting | : Index of the receptor emitting the message |
Definition at line 304 of file vpNetwork.cpp.
Referenced by vpNetwork::receiveAndDecodeRequestFrom().
|
inherited |
Receives a message once (in the limit of the Maximum message size value). This message can represent an entire request or not. Several calls to this function might be necessary to get the entire request.
Definition at line 328 of file vpNetwork.cpp.
Referenced by vpNetwork::receiveAndDecodeRequestOnce().
|
inherited |
Receives a message once (in the limit of the Maximum message size value), from a specific emitter. This message can represent an entire request or not. Several calls to this function might be necessary to get the entire request.
receptorEmitting | : Index of the receptor emitting the message. |
Definition at line 355 of file vpNetwork.cpp.
Referenced by vpNetwork::receiveAndDecodeRequestOnceFrom().
|
inherited |
Delete a decoding request from the emitter.
id | : Id of the request to delete. |
Definition at line 108 of file vpNetwork.cpp.
References vpNetwork::request_list.
|
inherited |
|
inherited |
Send an object. The size of the received object is suppose to be the size of its type. Note that sending object containing pointers, virtual methods, etc, won't probably work.
object | : Received object. |
sizeOfObject | : Size of the object |
Definition at line 437 of file vpNetwork.h.
References vpTRACE.
|
inherited |
Send and encode a request to the first receptor in the list.
req | : Request to send. |
Definition at line 241 of file vpNetwork.cpp.
References vpRequest::encode(), and vpNetwork::sendRequest().
|
inherited |
Send and encode a request to a specific receptor.
req | : Request to send. |
dest | : Index of the receptor receiving the request. |
Definition at line 261 of file vpNetwork.cpp.
References vpRequest::encode(), and vpNetwork::sendRequestTo().
|
inherited |
Send a request to the first receptor in the list.
req | : Request to send. |
Definition at line 173 of file vpNetwork.cpp.
References vpNetwork::sendRequestTo().
Referenced by vpNetwork::sendAndEncodeRequest().
|
inherited |
Send a request to a specific receptor.
req | : Request to send. |
dest | : Index of the receptor receiving the request. |
Definition at line 189 of file vpNetwork.cpp.
References vpNetwork::beginning, vpNetwork::end, vpRequest::getId(), vpNetwork::param_sep, vpNetwork::receptor_list, vpNetwork::separator, vpRequest::size(), vpNetwork::verboseMode, and vpTRACE.
Referenced by vpNetwork::sendAndEncodeRequestTo(), and vpNetwork::sendRequest().
|
inherited |
Send an object. The size has to be specified.
object | : Object to send. |
dest | : Index of the receptor that you are sending the object. |
sizeOfObject | : Size of the object. |
Definition at line 481 of file vpNetwork.h.
References vpTRACE.
|
inlineinherited |
Change the maximum size that the emitter can receive (in request mode).
s | : new maximum size value. |
Definition at line 229 of file vpNetwork.h.
|
inline |
Set the number of attempts to connect to the server.
nb | : Number of attempts. |
Definition at line 215 of file vpClient.h.
|
inlineinherited |
Change the time the emitter spend to check if he receives a message from a receptor. Initially this value is set to 10usec.
sec | : new value in second. |
Definition at line 239 of file vpNetwork.h.
|
inlineinherited |
Change the time the emitter spend to check if he receives a message from a receptor. Initially this value is set to 10usec.
usec | : new value in micro second. |
Definition at line 249 of file vpNetwork.h.
|
inlineinherited |
Set the verbose mode.
mode | : Change the verbose mode. True to turn on, False to turn off. |
Definition at line 256 of file vpNetwork.h.
void vpClient::stop | ( | ) |
Stops the server and close the sockets.
Definition at line 152 of file vpClient.cpp.
References vpNetwork::receptor_list.
Referenced by ~vpClient().
|
protectedinherited |
Definition at line 143 of file vpNetwork.h.
Referenced by vpNetwork::receiveAndDecodeRequestOnceFrom(), and vpNetwork::sendRequestTo().
|
protectedinherited |
Definition at line 147 of file vpNetwork.h.
Referenced by vpNetwork::receiveAndDecodeRequestOnceFrom().
|
protectedinherited |
Definition at line 129 of file vpNetwork.h.
Referenced by vpServer::checkForConnections(), vpServer::start(), vpServer::vpServer(), and vpServer::~vpServer().
|
protectedinherited |
Definition at line 144 of file vpNetwork.h.
Referenced by vpNetwork::receiveAndDecodeRequestOnceFrom(), and vpNetwork::sendRequestTo().
|
protectedinherited |
Definition at line 141 of file vpNetwork.h.
Referenced by vpNetwork::receiveAndDecodeRequestOnceFrom().
|
protectedinherited |
Definition at line 145 of file vpNetwork.h.
Referenced by vpNetwork::receiveAndDecodeRequestOnceFrom(), and vpNetwork::sendRequestTo().
|
protectedinherited |
Definition at line 131 of file vpNetwork.h.
Referenced by vpServer::checkForConnections(), and vpNetwork::receiveAndDecodeRequestOnceFrom().
|
protectedinherited |
Definition at line 130 of file vpNetwork.h.
Referenced by vpServer::checkForConnections(), deconnect(), vpNetwork::getReceptorIndex(), vpNetwork::print(), print(), vpNetwork::receiveAndDecodeRequestOnceFrom(), vpNetwork::sendRequestTo(), stop(), and vpServer::~vpServer().
|
protectedinherited |
|
protectedinherited |
Definition at line 142 of file vpNetwork.h.
Referenced by vpNetwork::receiveAndDecodeRequestOnceFrom(), and vpNetwork::sendRequestTo().
|
protectedinherited |
Definition at line 133 of file vpNetwork.h.
Referenced by vpServer::checkForConnections(), and vpNetwork::receiveAndDecodeRequestOnceFrom().
|
protectedinherited |
Definition at line 149 of file vpNetwork.h.
Referenced by vpServer::checkForConnections(), vpNetwork::receiveAndDecodeRequestOnceFrom(), and vpNetwork::vpNetwork().
|
protectedinherited |
Definition at line 150 of file vpNetwork.h.
Referenced by vpServer::checkForConnections(), vpNetwork::receiveAndDecodeRequestOnceFrom(), and vpNetwork::vpNetwork().
|
protectedinherited |
Definition at line 151 of file vpNetwork.h.
Referenced by vpServer::checkForConnections(), vpNetwork::receiveAndDecodeRequestOnceFrom(), and vpNetwork::vpNetwork().
|
protectedinherited |
Definition at line 153 of file vpNetwork.h.
Referenced by vpNetwork::receiveAndDecodeRequestOnceFrom(), and vpNetwork::sendRequestTo().