summaryrefslogtreecommitdiffstats
path: root/net/base/host_resolver_proc.h
diff options
context:
space:
mode:
Diffstat (limited to 'net/base/host_resolver_proc.h')
-rw-r--r--net/base/host_resolver_proc.h69
1 files changed, 69 insertions, 0 deletions
diff --git a/net/base/host_resolver_proc.h b/net/base/host_resolver_proc.h
new file mode 100644
index 0000000..2690987
--- /dev/null
+++ b/net/base/host_resolver_proc.h
@@ -0,0 +1,69 @@
+// Copyright (c) 2009 The Chromium 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 NET_BASE_HOST_RESOLVER_PROC_H_
+#define NET_BASE_HOST_RESOLVER_PROC_H_
+
+#include <string>
+
+#include "base/ref_counted.h"
+
+namespace net {
+
+class AddressList;
+
+// Interface for a getaddrinfo()-like procedure. This is used by unit-tests
+// to control the underlying resolutions in HostResolverImpl. HostResolverProcs
+// can be chained together; they fallback to the next procedure in the chain
+// by calling ResolveUsingPrevious().
+//
+// Note that implementations of HostResolverProc *MUST BE THREADSAFE*, since
+// the HostResolver implementation using them can be multi-threaded.
+class HostResolverProc : public base::RefCountedThreadSafe<HostResolverProc> {
+ public:
+ explicit HostResolverProc(HostResolverProc* previous);
+ virtual ~HostResolverProc() {}
+
+ // Resolves |host| to an address list. If successful returns OK and fills
+ // |addrlist| with a list of socket addresses. Otherwise returns a
+ // network error code.
+ virtual int Resolve(const std::string& host, AddressList* addrlist) = 0;
+
+ protected:
+ // Asks the fallback procedure (if set) to do the resolve.
+ int ResolveUsingPrevious(const std::string& host, AddressList* addrlist);
+
+ private:
+ friend class HostResolverImpl;
+ friend class MockHostResolver;
+ friend class ScopedDefaultHostResolverProc;
+
+ // Sets the previous procedure in the chain.
+ void set_previous_proc(HostResolverProc* proc) {
+ previous_proc_ = proc;
+ }
+
+ // Sets the default host resolver procedure that is used by HostResolverImpl.
+ // This can be used through ScopedDefaultHostResolverProc to set a catch-all
+ // DNS block in unit-tests (individual tests should use MockHostResolver to
+ // prevent hitting the network).
+ static HostResolverProc* SetDefault(HostResolverProc* proc);
+ static HostResolverProc* GetDefault();
+
+ private:
+ scoped_refptr<HostResolverProc> previous_proc_;
+ static HostResolverProc* default_proc_;
+
+ DISALLOW_COPY_AND_ASSIGN(HostResolverProc);
+};
+
+// Resolves |host| to an address list, using the system's default host resolver.
+// (i.e. this calls out to getaddrinfo()). If successful returns OK and fills
+// |addrlist| with a list of socket addresses. Otherwise returns a
+// network error code.
+int SystemHostResolverProc(const std::string& host, AddressList* addrlist);
+
+} // namespace net
+
+#endif // NET_BASE_HOST_RESOLVER_PROC_H_