232 lines
5.4 KiB
C++
232 lines
5.4 KiB
C++
/*
|
|
* This file is part of the Owl Positioning System (OwlPS).
|
|
* OwlPS is a project of the University of Franche-Comté
|
|
* (Université de Franche-Comté), France.
|
|
*/
|
|
|
|
|
|
#ifndef _OWLPS_POSITIONING_REQUEST_HH_
|
|
#define _OWLPS_POSITIONING_REQUEST_HH_
|
|
|
|
class Mobile ;
|
|
|
|
#include "measurement.hh"
|
|
#include "timestamp.hh"
|
|
|
|
#include <owlps.h>
|
|
|
|
#include <ctime>
|
|
#include <vector>
|
|
#include <boost/tr1/unordered_map.hpp>
|
|
#include <ostream>
|
|
|
|
/// Represents a request sent by a Mobile
|
|
class Request
|
|
{
|
|
protected:
|
|
/// Type of the request
|
|
uint_fast8_t type ;
|
|
/// Number of packets sent by the mobile for this request
|
|
uint_fast16_t nb_packets ;
|
|
/// The mobile that sent the request
|
|
Mobile *mobile ;
|
|
/// Local date of the request on the mobile
|
|
Timestamp time_sent ;
|
|
/// List of Measurement of the request
|
|
/** Note that this is not a pointer list, values are actually stored.
|
|
The \em string parameter is the MAC address of the receiver AP. */
|
|
std::tr1::unordered_map<std::string, Measurement> measurements ;
|
|
/// \brief Real coordinates of the request (normally unavailable for a
|
|
/// standard positioning request)
|
|
Point3D *real_position ;
|
|
|
|
/** @name Write accessors */
|
|
//@{
|
|
void clear_real_position(void) ;
|
|
//@}
|
|
|
|
public:
|
|
Request(const Mobile *_mobile = NULL,
|
|
const Timestamp &_time_sent = Timestamp(),
|
|
const std::tr1::unordered_map<std::string, Measurement>
|
|
&_measurements =
|
|
std::tr1::unordered_map<std::string, Measurement>()):
|
|
type(OWL_REQUEST_UNDEFINED), nb_packets(1),
|
|
mobile(const_cast<Mobile*>(_mobile)), time_sent(_time_sent),
|
|
measurements(_measurements), real_position(NULL) {}
|
|
|
|
Request(const std::tr1::unordered_map<std::string, Measurement>
|
|
&_measurements):
|
|
type(OWL_REQUEST_UNDEFINED), nb_packets(1),
|
|
mobile(NULL), measurements(_measurements), real_position(NULL) {}
|
|
|
|
Request(const Timestamp &_time_sent,
|
|
const std::tr1::unordered_map<std::string, Measurement>
|
|
&_measurements =
|
|
std::tr1::unordered_map<std::string, Measurement>()):
|
|
type(OWL_REQUEST_UNDEFINED), nb_packets(1),
|
|
mobile(NULL), time_sent(_time_sent),
|
|
measurements(_measurements), real_position(NULL) {}
|
|
|
|
Request(const Request &source):
|
|
type(source.type), nb_packets(1),
|
|
mobile(source.mobile), time_sent(source.time_sent),
|
|
measurements(source.measurements), real_position(NULL) {}
|
|
|
|
virtual ~Request(void) ;
|
|
|
|
/** @name Read accessors */
|
|
//@{
|
|
uint_fast8_t get_type(void) const ;
|
|
uint_fast16_t get_nb_packets(void) const ;
|
|
Mobile* get_mobile(void) const ;
|
|
const Timestamp& get_time_sent(void) const ;
|
|
/// Returns all the measurements
|
|
const std::tr1::unordered_map<std::string, Measurement>&
|
|
get_measurements(void) const ;
|
|
/// Returns the measurement made by the AP \em mac_receiver, if any
|
|
const Measurement*
|
|
get_measurement(const std::string &mac_receiver) const ;
|
|
const Point3D* get_real_position(void) const ;
|
|
//@}
|
|
|
|
/** @name Write accessors */
|
|
//@{
|
|
void set_type(const uint_fast8_t _type) ;
|
|
void set_nb_packets(const uint_fast16_t _nb_packets) ;
|
|
void set_mobile(const Mobile *_mobile) ;
|
|
void set_time_sent(const Timestamp &_time_sent) ;
|
|
void set_measurements(const std::tr1::unordered_map
|
|
<std::string, Measurement> &_measurements) ;
|
|
void set_real_position(const Point3D &_real_position) ;
|
|
/// Reinitialises all attributes
|
|
void clear(void) ;
|
|
//@}
|
|
|
|
/** @name Operations */
|
|
//@{
|
|
/// Computes the distance between two Request
|
|
float ss_square_distance(const Request &source) const ;
|
|
//@}
|
|
|
|
/** @name Operators */
|
|
//@{
|
|
Request& operator=(const Request &source) ;
|
|
bool operator==(const Request &comp) const ;
|
|
bool operator!=(const Request &comp) const ;
|
|
operator bool(void) const ;
|
|
//@}
|
|
|
|
/// Displays a Request
|
|
friend std::ostream& operator<<(std::ostream &os, const Request &r) ;
|
|
|
|
/// Hashes a Request
|
|
friend std::size_t hash_value(const Request &source) ;
|
|
} ;
|
|
|
|
|
|
|
|
/* *** Read accessors *** */
|
|
|
|
|
|
|
|
inline uint_fast8_t Request::get_type() const
|
|
{
|
|
return type ;
|
|
}
|
|
|
|
|
|
inline uint_fast16_t Request::get_nb_packets() const
|
|
{
|
|
return nb_packets ;
|
|
}
|
|
|
|
|
|
inline Mobile* Request::get_mobile() const
|
|
{
|
|
return mobile ;
|
|
}
|
|
|
|
|
|
inline const Timestamp& Request::get_time_sent() const
|
|
{
|
|
return time_sent ;
|
|
}
|
|
|
|
|
|
inline const std::tr1::unordered_map<std::string, Measurement>&
|
|
Request::get_measurements(void) const
|
|
{
|
|
return measurements ;
|
|
}
|
|
|
|
|
|
inline const Point3D* Request::get_real_position(void) const
|
|
{
|
|
return real_position ;
|
|
}
|
|
|
|
|
|
|
|
/* *** Write accessors *** */
|
|
|
|
|
|
inline void Request::set_type(const uint_fast8_t _type)
|
|
{
|
|
type = _type ;
|
|
}
|
|
|
|
|
|
inline void Request::set_nb_packets(const uint_fast16_t _nb_packets)
|
|
{
|
|
nb_packets = _nb_packets ;
|
|
}
|
|
|
|
|
|
inline void Request::set_mobile(const Mobile *_mobile)
|
|
{
|
|
mobile = const_cast<Mobile*>(_mobile) ;
|
|
}
|
|
|
|
|
|
inline void Request::set_time_sent(const Timestamp &_time_sent)
|
|
{
|
|
time_sent = _time_sent ;
|
|
}
|
|
|
|
|
|
inline void Request::
|
|
set_measurements(const std::tr1::unordered_map<std::string, Measurement>
|
|
&_measurements)
|
|
{
|
|
measurements = _measurements ;
|
|
}
|
|
|
|
|
|
|
|
/* *** Operators *** */
|
|
|
|
|
|
inline bool Request::operator!=(const Request &comp) const
|
|
{
|
|
return !(*this == comp) ;
|
|
}
|
|
|
|
|
|
/**
|
|
* @return \em false if the Request is empty.
|
|
* @return \em true if at least one attribute (other than #type and
|
|
* #nb_packets) is initialised.
|
|
*/
|
|
inline Request::operator bool() const
|
|
{
|
|
return
|
|
mobile != NULL ||
|
|
time_sent ||
|
|
measurements.size() > 0 ;
|
|
}
|
|
|
|
|
|
|
|
#endif // _OWLPS_POSITIONING_REQUEST_HH_
|