trident/rpc_endpoint.h at master · anqin/trident · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
// Copyright (c) 2014 The Trident Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef _TRIDENT_RPC_ENDPOINT_H_
#define _TRIDENT_RPC_ENDPOINT_H_

#include <trident/common_internal.h>

namespace trident {

// RpcEndpoint is a tuple <host:port>.
typedef boost::asio::ip::tcp::endpoint RpcEndpoint;

std::string RpcEndpointToString(const RpcEndpoint& endpoint);

// Get host of RpcEndpoint.
std::string HostOfRpcEndpoint(const RpcEndpoint& endpoint);

// Get port of RpcEndpoint.
uint32 PortOfRpcEndpoint(const RpcEndpoint& endpoint);

// DNS resolve server address to RpcEndpoint, only choose the first one.
// @param io_service is the io service used for resolving.
// @param host can be an ip or host name, eg. "127.0.0.1" or "".
// @param svc can be a port or service name, eg. "21" or "ftp".
// @param endpoints is out param, stores resolved RpcEndpoint if succeed,
// but may be empty.
// @return true if resolve succeed.
// @return false if resolve failed.
bool ResolveAddress(IOService& io_service,
        const std::string& host, const std::string& svc,
        RpcEndpoint* endpoint);

// DNS resolve server address to RpcEndpoint, only choose the first one.
// @param io_service is the io service used for resolving.
// @param server address should be in format of "host:port".
// @param endpoint is out param, stores resolved RpcEndpoint if succeed.
// @return true if resolve succeed.
// @return false if resolve failed or not address found.
bool ResolveAddress(IOService& io_service,
        const std::string& address,
        RpcEndpoint* endpoint);

} // namespace trident

#endif // _TRIDENT_RPC_ENDPOINT_H_