1

#ifndef NETWORK_ENDPOINT_HH

     2

#define NETWORK_ENDPOINT_HH

     3

     8

 */

    12

    13

#include <string>

    14

    15

// assume...

    16

#if INET6_ADDRSTRLEN < INET_ADDRSTRLEN

    17

    #error INET6_ADDRSTRLEN is smaller than INET_ADDRSTRLEN

    18

#endif

    19

    20

/**

    22

 */

    23

const socklen_t NETWORK_ADDRESS_LENGTH = INET6_ADDRSTRLEN;

    24

    25

/**

    34

 */ 

    35

class NetworkEndpoint {

    36

    protected:

    37

        /**

    38

         * Our human-readable hostname

    39

         */

    40

        std::string hostname;

    41

    42

        /**

    43

         * Our human-readable service

    44

         */

    45

        std::string service;

    46

    47

    public:

    48

        /**

    49

         * Construct an empty NetworkEndpoint

    50

         */

    51

        NetworkEndpoint (void);

    52

    53

        /**

    54

         * Construct a NetworkEndpoint with a NULL hostname, and a specific service

    55

         */

    56

        explicit NetworkEndpoint (std::string service);

    57

    58

        /**

    59

         * Construct a NetworkEndpoint on a specific hostname and service

    60

         */

    61

        NetworkEndpoint (std::string hostname, std::string service);

    62

    63

        /*

    64

         * We can use the default copy-constructor and assignment operator

    65

         */

    66

    67

    public:    

    68

        /**

    69

         * Get a addrinfo* for this address using the given family/type/protocol/flags.

    70

         *

    71

         * Remember to free the returned pointer using freeaddrinfo() after use.

    72

         *

    73

         * @param family the socket family for hints.ai_family

    74

         * @param socktype the socket type for hints.ai_socktype

    75

         * @param protoocl the socket protocol for hints.ai_protocol

    76

         * @param flags the flags for hints.ai_flags

    77

         * @return linked list of addrinfo's

    78

         * @throw NetworkAddressError if resolving this address fails

    79

         */

    80

        virtual addrinfo* get_addrinfo (int family, int socktype, int protocol = 0, int flags = 0) const;

    81

    82

        /**

    83

         * Free an addrinfo returned by get_addrinfo

    84

         */

    85

        virtual void free_addrinfo (addrinfo *info) const;

    86

    87

        /**

    88

         * Get the human-readable hostname

    89

         */

    90

        virtual std::string get_hostname (void) const { return hostname; }

    91

    92

        /**

    93

         * Get the human-readable service name

    94

         */

    95

        virtual std::string get_service (void) const { return service; }

    96

};

    97

    98

/**

    99

 * Formatted as  [<addr>:<port>]

   100

 */

   101

std::ostream& operator<< (std::ostream &s, const NetworkEndpoint &addr);

   102

   103

/**

   105

 */

   106

class NetworkAddressError : public Error {

   107

    protected:

   108

        static std::string build_str (const NetworkEndpoint &addr, const char *op, const char *msg);

   109

   110

    public:

   111

        NetworkAddressError (const NetworkEndpoint &addr, const char *op, const char *msg);

   112

};

   113

   114

#endif /* NETWORK_ADDRESS_HH */