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
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
|
// Copyright 2013 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CHROME_BROWSER_LOCAL_DISCOVERY_SERVICE_DISCOVERY_CLIENT_H_
#define CHROME_BROWSER_LOCAL_DISCOVERY_SERVICE_DISCOVERY_CLIENT_H_
#include <memory>
#include <string>
#include <vector>
#include "base/functional/callback.h"
#include "base/time/time.h"
#include "net/base/address_family.h"
#include "net/base/host_port_pair.h"
#include "net/base/ip_address.h"
namespace local_discovery {
struct ServiceDescription {
public:
ServiceDescription();
ServiceDescription(const ServiceDescription& other);
~ServiceDescription();
// Convenience function to get useful parts of the service name. A service
// name follows the format <instance_name>.<service_type>.
std::string instance_name() const;
std::string service_type() const;
// The name of the service.
std::string service_name;
// The address (in host/port format) for the service (from SRV record).
net::HostPortPair address;
// The metadata (from TXT record) of the service.
std::vector<std::string> metadata;
// IP address of the service, if available from cache. May be empty.
net::IPAddress ip_address;
// Last time the service was seen.
base::Time last_seen;
};
// Lets users browse the network for services of interest or listen for changes
// in the services they are interested in. See
// |ServiceDiscoveryClient::CreateServiceWatcher|.
class ServiceWatcher {
public:
enum UpdateType {
UPDATE_ADDED,
UPDATE_CHANGED,
UPDATE_REMOVED,
UPDATE_INVALIDATED,
UPDATE_PERMISSION_REJECTED,
UPDATE_TYPE_LAST = UPDATE_PERMISSION_REJECTED
};
// Called when a service has been added or removed for a certain service name.
using UpdatedCallback =
base::RepeatingCallback<void(UpdateType, const std::string&)>;
// Listening will automatically stop when the destructor is called.
virtual ~ServiceWatcher() = default;
// Start the service type watcher.
virtual void Start() = 0;
// Probe for services of this type.
virtual void DiscoverNewServices() = 0;
virtual void SetActivelyRefreshServices(bool actively_refresh_services) = 0;
virtual std::string GetServiceType() const = 0;
};
// Represents a service on the network and allows users to access the service's
// address and metadata. See |ServiceDiscoveryClient::CreateServiceResolver|.
class ServiceResolver {
public:
enum RequestStatus {
STATUS_SUCCESS,
STATUS_REQUEST_TIMEOUT,
STATUS_KNOWN_NONEXISTENT,
REQUEST_STATUS_LAST = STATUS_KNOWN_NONEXISTENT
};
// A callback called once the service has been resolved.
typedef base::OnceCallback<void(RequestStatus, const ServiceDescription&)>
ResolveCompleteCallback;
// Listening will automatically stop when the destructor is called.
virtual ~ServiceResolver() = default;
// Start the service reader.
virtual void StartResolving() = 0;
virtual std::string GetName() const = 0;
};
class LocalDomainResolver {
public:
typedef base::OnceCallback<void(bool /*success*/,
const net::IPAddress& /*address_ipv4*/,
const net::IPAddress& /*address_ipv6*/)>
IPAddressCallback;
virtual ~LocalDomainResolver() = default;
virtual void Start() = 0;
};
class ServiceDiscoveryClient {
public:
virtual ~ServiceDiscoveryClient() = default;
// Create a service watcher object listening for DNS-SD service announcements
// on service type |service_type|.
virtual std::unique_ptr<ServiceWatcher> CreateServiceWatcher(
const std::string& service_type,
ServiceWatcher::UpdatedCallback callback) = 0;
// Create a service resolver object for getting detailed service information
// for the service called |service_name|.
virtual std::unique_ptr<ServiceResolver> CreateServiceResolver(
const std::string& service_name,
ServiceResolver::ResolveCompleteCallback callback) = 0;
// Create a resolver for local domain, both ipv4 or ipv6.
virtual std::unique_ptr<LocalDomainResolver> CreateLocalDomainResolver(
const std::string& domain,
net::AddressFamily address_family,
LocalDomainResolver::IPAddressCallback callback) = 0;
};
} // namespace local_discovery
#endif // CHROME_BROWSER_LOCAL_DISCOVERY_SERVICE_DISCOVERY_CLIENT_H_
|
