#include <vpClient.h>

Inheritance diagram for vpClient:

Public Member Functions
	vpClient ()

virtual	~vpClient ()

bool	connectToHostname (const std::string &hostname, const int &port_serv)

bool	connectToIP (const std::string &ip, const int &port_serv)

void	deconnect (const int &index=0)

unsigned int	getNumberOfAttempts ()

unsigned int	getNumberOfServers ()

virtual 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 ()

virtual void	print (const char *id="")

template<typename T >
int	receive (T *object, const int &sizeOfObject=sizeof(T))

template<typename T >
int	receiveFrom (T *object, const int &receptorEmitting, const int &sizeOfObject=sizeof(T))

std::vector< int >	receiveRequest ()

std::vector< int >	receiveRequestFrom (const int &receptorEmitting)

int	receiveRequestOnce ()

int	receiveRequestOnceFrom (const int &receptorEmitting)

std::vector< int >	receiveAndDecodeRequest ()

std::vector< int >	receiveAndDecodeRequestFrom (const int &receptorEmitting)

int	receiveAndDecodeRequestOnce ()

int	receiveAndDecodeRequestOnceFrom (const int &receptorEmitting)

void	removeDecodingRequest (const char *)

template<typename T >
int	send (T *object, const int &sizeOfObject=sizeof(T))

template<typename T >
int	sendTo (T *object, const int &dest, const int &sizeOfObject=sizeof(T))

int	sendRequest (vpRequest &req)

int	sendRequestTo (vpRequest &req, const int &dest)

int	sendAndEncodeRequest (vpRequest &req)

int	sendAndEncodeRequestTo (vpRequest &req, const 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

Detailed Description

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:

#include <visp/vpClient.h>
#include <iostream>
int main(int argc, char **argv)
{
  std::string servername = "localhost";
  unsigned int port = 35000;
  vpClient client;
  client.connectToHostname(servername, port);
  //client.connectToIP("127.0.0.1",port);
  int val = 0;
  while(1)
  {
    if(client.send(&val) != sizeof(int)) //Sending the new value to the first client
      std::cout << "Error while sending" << std::endl;
    else
      std::cout << "Sending : " << val << std::endl;
    
    if(client.receive(&val) != sizeof(int)) //Receiving a value from the first client
        std::cout << "Error while receiving" << std::endl;
    else
      std::cout << "Received : " << val << std::endl;
  }
  
  return 0;
}

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.

#include <visp/vpClient.h>
#include <visp/vpV4l2Grabber.h>
#include <visp/vpImage.h>
#include <visp/vpDisplayX.h>
#include <visp/vpDisplayGDI.h>
#include <iostream>
#include "vpRequestImage.h" //See vpRequest class documentation
int main(int argc, char **argv)
{
#if defined(VISP_HAVE_V4L2)
#if defined(VISP_HAVE_X11) || defined(VISP_HAVE_GDI)
  
  std::string servername = "localhost";
  unsigned int port = 35000;
  
  vpImage<unsigned char> I; // Create a gray level image container
  
  // Create a grabber based on v4l2 third party lib (for usb cameras under Linux)
  vpV4l2Grabber g;
  g.setScale(1);
  g.setInput(0);
  g.open(I);
  // Create an image viewer
#ifdef UNIX
  vpDisplayX d(I, -1, -1, "Camera frame");
#else //Win32
  vpDisplayGDI d(I, -1, -1, "Camera frame");
#endif
  vpClient client;
  client.connectToHostname(servername, port);
  //client.connectToIP("127.0.0.1",port);
  vpRequestImage reqImage(&I);
  while(1)
  {
    double t = vpTime::measureTimeMs();
    // Acquire a new image
    g.acquire(I);
    
    vpDisplay::display(I);
    vpDisplay::flush(I);
    
    client.sendAndEncodeRequest(reqImage);
    // A click in the viewer to exit
    if ( vpDisplay::getClick(I, false) )
      break;
  }
  return 0;
#endif
#endif
}

See also: vpClient; vpRequest; vpNetwork

Examples:: testClient.cpp.

Definition at line 165 of file vpClient.h.

Constructor & Destructor Documentation

vpClient::vpClient ( )

Definition at line 45 of file vpClient.cpp.

vpClient::~vpClient ( )

virtual

Disconnect the client from all the servers, and close the sockets.

Definition at line 51 of file vpClient.cpp.

References stop().

Member Function Documentation

void vpNetwork::addDecodingRequest ( vpRequest * req )

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.

Warning: vpRequest is a virtual pure class. It has to be implemented according to the way how you want to decode the message received.

See also: vpNetwork::removeDecodingRequest()

Parameters

req	: Request to add.

Definition at line 84 of file vpNetwork.cpp.

References vpRequest::getId(), and vpNetwork::request_list.

bool vpClient::connectToHostname	(	const std::string &	hostname,
		const int &	port_serv
	)

Connect to the server represented by the given hostname, and at a given port.

See also: vpClient::connectToIP();

Parameters

hostname	: Hostname of the server.
port_serv	: Port used for the connection.

Returns: True if the connection has been etablished, false otherwise.

Examples:: testClient.cpp.

Definition at line 66 of file vpClient.cpp.

References vpNetwork::vpReceptor::receptorAddress, vpNetwork::vpReceptor::receptorIP, vpNetwork::vpReceptor::socketFileDescriptorReceptor, and vpERROR_TRACE.

bool vpClient::connectToIP	(	const std::string &	ip,
		const int &	port_serv
	)

Connect to the server represented by the given ip, and at a given port.

See also: vpClient::connectToHostname()

Parameters

ip	: IP of the server.
port_serv	: Port used for the connection.

Returns: True if the connection has been etablished, false otherwise.

Definition at line 111 of file vpClient.cpp.

References vpNetwork::vpReceptor::receptorAddress, vpNetwork::vpReceptor::socketFileDescriptorReceptor, and vpERROR_TRACE.

void vpClient::deconnect ( const int & index = 0 )

Deconnect from the server at a specific index.

Parameters

index : Index of the server.

Definition at line 136 of file vpClient.cpp.

References vpNetwork::receptor_list.

unsigned int vpNetwork::getMaxSizeReceivedMessage ( )

inlineinherited

Get the maximum size that the emitter can receive (in request mode).

See also: vpNetwork::setMaxSizeReceivedMessage()

Returns: Acutal max size value.

Definition at line 168 of file vpNetwork.h.

unsigned int vpClient::getNumberOfAttempts ( )

inline

Get the actual number of attempts to connect to the server.

See also: vpClient::setNumberOfAttempts()

Returns: Actual number of attempts.

Definition at line 195 of file vpClient.h.

unsigned int vpClient::getNumberOfServers ( )

inline

Get the number of server that the client is connected on.

Returns: Number of servers.

Definition at line 202 of file vpClient.h.

int vpNetwork::getReceptorIndex ( const char * name )

inherited

Get the receptor index from its name. The name can be either the IP, or its name on the network.

Parameters

name	: Name of the receptor.

Returns: Index of the receptor.

Definition at line 139 of file vpNetwork.cpp.

References vpNetwork::receptor_list, and vpERROR_TRACE.

std::string vpNetwork::getRequestIdFromIndex ( const int & ind )

inlineinherited

Get the Id of the request at the index ind.

Parameters

ind	: Index of the request.

Returns: Id of the request.

Definition at line 155 of file vpNetwork.h.

void vpNetwork::print ( const char * id = "" )

virtualinherited

Print the receptors.

Parameters

id	: Message to display before the receptor's index.

Definition at line 124 of file vpNetwork.cpp.

References vpNetwork::receptor_list.

Referenced by print(), and vpServer::print().

void vpClient::print ( )

virtual

Print the servers.

Definition at line 168 of file vpClient.cpp.

References vpNetwork::print().

template<typename T >

int vpNetwork::receive	(	T *	object,
		const int &	sizeOfObject = `sizeof(T)`
	)

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.

Warning: Using this function means that you know what kind of object you are suppose to receive, and when you are suppose to receive. If the emitter has several receptors. It might be a problem, and in that case you better use the "request" option.

See also: vpNetwork::receiveRequest(); vpNetwork::receiveRequestOnce(); vpNetwork::receiveAndDecodeRequest(); vpNetwork::receiveAndDecodeRequestOnce()

Parameters

object	: Received object.
sizeOfObject	: Size of the received object.

Returns: the number of bytes received, or -1 if an error occured.

Examples:: testClient.cpp, and testServer.cpp.

Definition at line 261 of file vpNetwork.h.

References vpNetwork::tv, vpNetwork::tv_sec, vpNetwork::tv_usec, vpERROR_TRACE, and vpTRACE.

std::vector< int > vpNetwork::receiveAndDecodeRequest ( )

inherited

Receives and decode requests untils there is requests to receive.

Warning: Requests will be received but not decoded.

See also: vpNetwork::receive(); vpNetwork::receiveRequestFrom(); vpNetwork::receiveRequestOnce(); vpNetwork::receiveRequestOnceFrom(); vpNetwork::receiveAndDecodeRequest(); vpNetwork::receiveAndDecodeRequestFrom(); vpNetwork::receiveAndDecodeRequestOnce(); vpNetwork::receiveAndDecodeRequestOnceFrom()

Definition at line 371 of file vpNetwork.cpp.

References vpNetwork::receiveRequest(), and vpNetwork::request_list.

std::vector< int > vpNetwork::receiveAndDecodeRequestFrom ( const int & receptorEmitting )

inherited

Receives and decode requests, from a specific emitter, untils there is request to receive.

Warning: Requests will be received but not decoded.

See also: vpNetwork::receive(); vpNetwork::receiveRequest(); vpNetwork::receiveRequestOnce(); vpNetwork::receiveRequestOnceFrom(); vpNetwork::receiveAndDecodeRequest(); vpNetwork::receiveAndDecodeRequestFrom(); vpNetwork::receiveAndDecodeRequestOnce(); vpNetwork::receiveAndDecodeRequestOnceFrom()

Parameters

receptorEmitting : Index of the receptor emitting the message

Definition at line 397 of file vpNetwork.cpp.

References vpNetwork::receiveRequestFrom(), and vpNetwork::request_list.

int vpNetwork::receiveAndDecodeRequestOnce ( )

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.

Warning: Requests will be received but not decoded.

See also: vpNetwork::receive(); vpNetwork::receiveRequestFrom(); vpNetwork::receiveRequest(); vpNetwork::receiveRequestOnceFrom(); vpNetwork::receiveAndDecodeRequest(); vpNetwork::receiveAndDecodeRequestFrom(); vpNetwork::receiveAndDecodeRequestOnce(); vpNetwork::receiveAndDecodeRequestOnceFrom()

Returns: The number of bytes received, -1 if an error occured.

Definition at line 426 of file vpNetwork.cpp.

References vpNetwork::receiveRequestOnce(), and vpNetwork::request_list.

int vpNetwork::receiveAndDecodeRequestOnceFrom ( const int & receptorEmitting )

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.

Warning: Requests will be received but not decoded.

See also: vpNetwork::receive(); vpNetwork::receiveRequestFrom(); vpNetwork::receiveRequest(); vpNetwork::receiveRequestOnce(); vpNetwork::receiveAndDecodeRequest(); vpNetwork::receiveAndDecodeRequestFrom(); vpNetwork::receiveAndDecodeRequestOnce(); vpNetwork::receiveAndDecodeRequestOnceFrom()

Parameters

receptorEmitting : Index of the receptor emitting the message.

Returns: The number of bytes received, -1 if an error occured.

Definition at line 456 of file vpNetwork.cpp.

References vpNetwork::receiveRequestOnceFrom(), and vpNetwork::request_list.

template<typename T >

int vpNetwork::receiveFrom	(	T *	object,
		const int &	receptorEmitting,
		const int &	sizeOfObject = `sizeof(T)`
	)

inherited

Receives a object from a receptor, by specifying its size or not. Note that a received message can correspond to a deconnection signal.

Warning: Using this function means that you know what kind of object you are suppose to receive, and when you are suppose to receive. If the emitter has several receptors. It might be a problem, and in that case you better use the "request" mode.

See also: vpNetwork::getReceptorIndex(); vpNetwork::receiveRequestFrom(); vpNetwork::receiveRequestOnceFrom(); vpNetwork::receiveAndDecodeRequestFrom(); vpNetwork::receiveAndDecodeRequestOnceFrom()

Parameters

object	: Received object.
receptorEmitting	: Index of the receptor emitting the message.
sizeOfObject	: Size of the received object.

Returns: the number of bytes received, or -1 if an error occured.

Definition at line 337 of file vpNetwork.h.

References vpNetwork::tv, vpNetwork::tv_sec, vpNetwork::tv_usec, vpERROR_TRACE, and vpTRACE.

std::vector< int > vpNetwork::receiveRequest ( )

inherited

Receive requests untils there is requests to receive.

Warning: Requests will be received but not decoded.

See also: vpNetwork::receive(); vpNetwork::receiveRequestFrom(); vpNetwork::receiveRequestOnce(); vpNetwork::receiveRequestOnceFrom(); vpNetwork::receiveAndDecodeRequest(); vpNetwork::receiveAndDecodeRequestFrom(); vpNetwork::receiveAndDecodeRequestOnce(); vpNetwork::receiveAndDecodeRequestOnceFrom()

Definition at line 279 of file vpNetwork.cpp.

Referenced by vpNetwork::receiveAndDecodeRequest().

std::vector< int > vpNetwork::receiveRequestFrom ( const int & receptorEmitting )

inherited

Receives requests, from a specific emitter, untils there is request to receive.

Warning: Requests will be received but not decoded.

See also: vpNetwork::receive(); vpNetwork::receiveRequest(); vpNetwork::receiveRequestOnce(); vpNetwork::receiveRequestOnceFrom(); vpNetwork::receiveAndDecodeRequest(); vpNetwork::receiveAndDecodeRequestFrom(); vpNetwork::receiveAndDecodeRequestOnce(); vpNetwork::receiveAndDecodeRequestOnceFrom()

Parameters

receptorEmitting : Index of the receptor emitting the message

Definition at line 301 of file vpNetwork.cpp.

Referenced by vpNetwork::receiveAndDecodeRequestFrom().

int vpNetwork::receiveRequestOnce ( )

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.

Warning: Requests will be received but not decoded.

See also: vpNetwork::receive(); vpNetwork::receiveRequestFrom(); vpNetwork::receiveRequest(); vpNetwork::receiveRequestOnceFrom(); vpNetwork::receiveAndDecodeRequest(); vpNetwork::receiveAndDecodeRequestFrom(); vpNetwork::receiveAndDecodeRequestOnce(); vpNetwork::receiveAndDecodeRequestOnceFrom()

Returns: The number of bytes received, -1 if an error occured.

Definition at line 325 of file vpNetwork.cpp.

Referenced by vpNetwork::receiveAndDecodeRequestOnce().

int vpNetwork::receiveRequestOnceFrom ( const int & receptorEmitting )

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.

Warning: Requests will be received but not decoded.

See also: vpNetwork::receive(); vpNetwork::receiveRequestFrom(); vpNetwork::receiveRequest(); vpNetwork::receiveRequestOnce(); vpNetwork::receiveAndDecodeRequest(); vpNetwork::receiveAndDecodeRequestFrom(); vpNetwork::receiveAndDecodeRequestOnce(); vpNetwork::receiveAndDecodeRequestOnceFrom()

Parameters

receptorEmitting : Index of the receptor emitting the message.

Returns: The number of bytes received, -1 if an error occured.

Definition at line 351 of file vpNetwork.cpp.

Referenced by vpNetwork::receiveAndDecodeRequestOnceFrom().

void vpNetwork::removeDecodingRequest ( const char * id )

inherited

Delete a decoding request from the emitter.

See also: vpNetwork::addDecodingRequest()

Parameters

id	: Id of the request to delete.

Definition at line 107 of file vpNetwork.cpp.

References vpNetwork::request_list.

template<typename T >

int vpNetwork::send	(	T *	object,
		const int &	sizeOfObject = `sizeof(T)`
	)

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.

Warning: Using this function means that, in the other side of the network, it knows what kind of object it is suppose to receive, and when it is suppose to receive. If the emitter has several receptors. It might be a problem, and in that case you better use the "request" option.

See also: vpNetwork::sendTo(); vpNetwork::sendRequest(); vpNetwork::sendRequestTo(); vpNetwork::sendAndEncodeRequest(); vpNetwork::sendAndEncodeRequestTo()

Parameters

object	: Received object.
sizeOfObject	: Size of the object

Returns: The number of bytes sent, or -1 if an error happened.

Examples:: testClient.cpp, and testServer.cpp.

Definition at line 403 of file vpNetwork.h.

References vpTRACE.

int vpNetwork::sendAndEncodeRequest ( vpRequest & req )

inherited

Send and encode a request to the first receptor in the list.

See also: vpNetwork::sendRequestTo(); vpNetwork::sendAndEncodeRequest(); vpNetwork::sendAndEncodeRequestTo(); vpNetwork::send(); vpNetwork::sendTo()

Parameters

req	: Request to send.

Returns: The number of bytes that have been sent, -1 if an error occured.

Definition at line 239 of file vpNetwork.cpp.

References vpRequest::encode(), and vpNetwork::sendRequest().

int vpNetwork::sendAndEncodeRequestTo	(	vpRequest &	req,
		const int &	dest
	)

inherited

Send and encode a request to a specific receptor.

See also: vpNetwork::sendRequest(); vpNetwork::sendAndEncodeRequest(); vpNetwork::sendAndEncodeRequestTo(); vpNetwork::send(); vpNetwork::sendTo()

Parameters

req	: Request to send.
dest	: Index of the receptor receiving the request.

Returns: The number of bytes that have been sent, -1 if an error occured.

Definition at line 259 of file vpNetwork.cpp.

References vpRequest::encode(), and vpNetwork::sendRequestTo().

int vpNetwork::sendRequest ( vpRequest & req )

inherited

Send a request to the first receptor in the list.

See also: vpNetwork::sendRequestTo(); vpNetwork::sendAndEncodeRequest(); vpNetwork::sendAndEncodeRequestTo(); vpNetwork::send(); vpNetwork::sendTo()

Parameters

req	: Request to send.

Returns: The number of bytes that have been sent, -1 if an error occured.

Definition at line 175 of file vpNetwork.cpp.

References vpNetwork::sendRequestTo().

Referenced by vpNetwork::sendAndEncodeRequest().

int vpNetwork::sendRequestTo	(	vpRequest &	req,
		const int &	dest
	)

inherited

Send a request to a specific receptor.

See also: vpNetwork::sendRequest(); vpNetwork::sendAndEncodeRequest(); vpNetwork::sendAndEncodeRequestTo(); vpNetwork::send(); vpNetwork::sendTo()

Parameters

req	: Request to send.
dest	: Index of the receptor receiving the request.

Returns: The number of bytes that have been sent, -1 if an error occured.

Definition at line 194 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().

template<typename T >

int vpNetwork::sendTo	(	T *	object,
		const int &	dest,
		const int &	sizeOfObject = `sizeof(T)`
	)

inherited

Send an object. The size has to be specified.

Warning: Using this function means that, in the other side of the network, it knows what kind of object it is suppose to receive, and when it is suppose to receive. If the emitter has several receptors. It might be a problem, and in that case you better use the "request" option.