| Index: net/proxy/dhcp_proxy_script_fetcher.h
|
| ===================================================================
|
| --- net/proxy/dhcp_proxy_script_fetcher.h (revision 85647)
|
| +++ net/proxy/dhcp_proxy_script_fetcher.h (working copy)
|
| @@ -1,98 +0,0 @@
|
| -// Copyright (c) 2011 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_PROXY_DHCP_SCRIPT_FETCHER_H_
|
| -#define NET_PROXY_DHCP_SCRIPT_FETCHER_H_
|
| -#pragma once
|
| -
|
| -#include "base/basictypes.h"
|
| -#include "base/compiler_specific.h"
|
| -#include "base/string16.h"
|
| -#include "net/base/completion_callback.h"
|
| -#include "net/proxy/proxy_script_fetcher.h"
|
| -#include "net/url_request/url_request_context.h"
|
| -
|
| -namespace net {
|
| -
|
| -// Interface for classes that can fetch a proxy script as configured via DHCP.
|
| -//
|
| -// The Fetch method on this interface tries to retrieve the most appropriate
|
| -// PAC script configured via DHCP.
|
| -//
|
| -// Normally there are zero or one DHCP scripts configured, but in the
|
| -// presence of multiple adapters with DHCP enabled, the fetcher resolves
|
| -// which PAC script to use if one or more are available.
|
| -class DhcpProxyScriptFetcher {
|
| - public:
|
| - // Destruction should cancel any outstanding requests.
|
| - virtual ~DhcpProxyScriptFetcher();
|
| -
|
| - // Attempts to retrieve the most appropriate PAC script configured via DHCP,
|
| - // and invokes |callback| on completion.
|
| - //
|
| - // Returns OK on success, otherwise the error code. If the return code is
|
| - // ERR_IO_PENDING, then the request completes asynchronously, and |callback|
|
| - // will be invoked later with the final error code.
|
| - //
|
| - // After synchronous or asynchronous completion with a result code of OK,
|
| - // |*utf16_text| is filled with the response. On failure, the result text is
|
| - // an empty string, and the result code is a network error. Some special
|
| - // network errors that may occur are:
|
| - //
|
| - // ERR_PAC_NOT_IN_DHCP -- no script configured in DHCP.
|
| - //
|
| - // The following all indicate there was one or more script configured
|
| - // in DHCP but all failed to download, and the error for the most
|
| - // preferred adapter that had a script configured was what the error
|
| - // code says:
|
| - //
|
| - // ERR_TIMED_OUT -- fetch took too long to complete.
|
| - // ERR_FILE_TOO_BIG -- response body was too large.
|
| - // ERR_PAC_STATUS_NOT_OK -- script failed to download.
|
| - // ERR_NOT_IMPLEMENTED -- script required authentication.
|
| - //
|
| - // If the request is cancelled (either using the "Cancel()" method or by
|
| - // deleting |this|), then no callback is invoked.
|
| - //
|
| - // Only one fetch is allowed to be outstanding at a time.
|
| - virtual int Fetch(string16* utf16_text,
|
| - CompletionCallback* callback) = 0;
|
| -
|
| - // Aborts the in-progress fetch (if any).
|
| - virtual void Cancel() = 0;
|
| -
|
| - // After successful completion of |Fetch()|, this will return the URL
|
| - // retrieved from DHCP. It is reset if/when |Fetch()| is called again.
|
| - virtual const GURL& GetPacURL() const = 0;
|
| -
|
| - // Intended for unit tests only, so they can test that factories return
|
| - // the right types under given circumstances.
|
| - virtual std::string GetFetcherName() const;
|
| -
|
| - protected:
|
| - DhcpProxyScriptFetcher();
|
| -
|
| - private:
|
| - DISALLOW_COPY_AND_ASSIGN(DhcpProxyScriptFetcher);
|
| -};
|
| -
|
| -// A do-nothing retriever, always returns synchronously with
|
| -// ERR_NOT_IMPLEMENTED result and empty text.
|
| -class DoNothingDhcpProxyScriptFetcher : public DhcpProxyScriptFetcher {
|
| - public:
|
| - DoNothingDhcpProxyScriptFetcher();
|
| - virtual ~DoNothingDhcpProxyScriptFetcher();
|
| -
|
| - virtual int Fetch(string16* utf16_text,
|
| - CompletionCallback* callback) OVERRIDE;
|
| - virtual void Cancel() OVERRIDE;
|
| - virtual const GURL& GetPacURL() const OVERRIDE;
|
| - private:
|
| - GURL gurl_;
|
| - DISALLOW_COPY_AND_ASSIGN(DoNothingDhcpProxyScriptFetcher);
|
| -};
|
| -
|
| -} // namespace net
|
| -
|
| -#endif // NET_PROXY_DHCP_SCRIPT_FETCHER_H_
|
|
|