15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Copyright (c) 2012 The Chromium Authors. All rights reserved. 25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Use of this source code is governed by a BSD-style license that can be 35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// found in the LICENSE file. 45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifndef NET_PROXY_DHCP_SCRIPT_FETCHER_FACTORY_H_ 65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define NET_PROXY_DHCP_SCRIPT_FETCHER_FACTORY_H_ 75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/basictypes.h" 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/memory/singleton.h" 105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "net/base/completion_callback.h" 115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "net/base/net_export.h" 125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace net { 145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class DhcpProxyScriptFetcher; 165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class URLRequestContext; 175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Factory object for creating the appropriate concrete base class of 195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// DhcpProxyScriptFetcher for your operating system and settings. 205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// 215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// You might think we could just implement a DHCP client at the protocol 225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// level and have cross-platform support for retrieving PAC configuration 235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// from DHCP, but unfortunately the DHCP protocol assumes there is a single 245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// client per machine (specifically per network interface card), and there 255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// is an implicit state machine between the client and server, so adding a 265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// second client to the machine would not be advisable (see e.g. some 275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// discussion of what can happen at this URL: 285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// http://www.net.princeton.edu/multi-dhcp-one-interface-handling.html). 295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// 305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Therefore, we have platform-specific implementations, and so we use 315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// this factory to select the right one. 325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class NET_EXPORT DhcpProxyScriptFetcherFactory { 335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public: 345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Creates a new factory object with default settings. 355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DhcpProxyScriptFetcherFactory(); 365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Ownership is transferred to the caller. url_request_context must be valid 385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // and its lifetime must exceed that of the returned DhcpProxyScriptFetcher. 395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Note that while a request is in progress, the fetcher may be holding a 415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // reference to |url_request_context|. Be careful not to create cycles 425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // between the fetcher and the context; you can break such cycles by calling 435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Cancel(). 445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DhcpProxyScriptFetcher* Create(URLRequestContext* url_request_context); 455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Attempts to enable/disable the DHCP WPAD feature. Does nothing 475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // if |IsSupported()| returns false. 485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The default is |enabled() == true|. 505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void set_enabled(bool enabled); 515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Returns true if the DHCP WPAD feature is enabled. Always returns 535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // false if |IsSupported()| is false. 545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool enabled() const; 555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Returns true if the DHCP WPAD feature is supported on the current 575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // operating system. 585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static bool IsSupported(); 595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) private: 615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool feature_enabled_; 625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DISALLOW_COPY_AND_ASSIGN(DhcpProxyScriptFetcherFactory); 645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} // namespace net 675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif // NET_PROXY_DHCP_SCRIPT_FETCHER_FACTORY_H_ 69