Adjust URLFetcher::Create API so that object is returned as scoped_ptr.

net/url_request/url_fetcher.h

 // Copyright (c) 2012 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_URL_REQUEST_URL_FETCHER_H_
 #define NET_URL_REQUEST_URL_FETCHER_H_
 
 #include <string>
 #include <vector>
 
@@ skipping 19 matching lines @@
 class HttpRequestHeaders;
 class HttpResponseHeaders;
 class URLFetcherDelegate;
 class URLFetcherResponseWriter;
 class URLRequestContextGetter;
 class URLRequestStatus;
 typedef std::vector<std::string> ResponseCookies;
 
 // To use this class, create an instance with the desired URL and a pointer to
 // the object to be notified when the URL has been loaded:
-//   scoped_ptr<URLFetcher> fetcher(URLFetcher::Create("http://www.google.com",
+//   scoped_ptr<URLFetcher> fetcher =
+//   URLFetcher::Create("http://www.google.com",
 //                                                     URLFetcher::GET,
-//                                                     this));
+//                                                     this);
 //
 // You must also set a request context getter:
 //
 //   fetcher->SetRequestContext(&my_request_context_getter);
 //
 // Then, optionally set properties on this object, like the request context or
 // extra headers:
 //   fetcher->set_extra_request_headers("X-Foo: bar");
 //
 // Finally, start the request:
@@ skipping 42 matching lines @@
   // Used by SetUploadStreamFactory. The callback should assign a fresh upload
   // data stream every time it's called.
   typedef base::Callback<scoped_ptr<UploadDataStream>()>
       CreateUploadStreamCallback;
 
   virtual ~URLFetcher();
 
   // |url| is the URL to send the request to.
   // |request_type| is the type of request to make.
   // |d| the object that will receive the callback on fetch completion.
-  // Caller is responsible for destroying the returned URLFetcher.
-  static URLFetcher* Create(const GURL& url,
-                            URLFetcher::RequestType request_type,
-                            URLFetcherDelegate* d);
+  static scoped_ptr<URLFetcher> Create(const GURL& url,
+                                       URLFetcher::RequestType request_type,
+                                       URLFetcherDelegate* d);
 
   // Like above, but if there's a URLFetcherFactory registered with the
   // implementation it will be used. |id| may be used during testing to identify
   // who is creating the URLFetcher.
-  // Caller is responsible for destroying the returned URLFetcher.
-  static URLFetcher* Create(int id,
-                            const GURL& url,
-                            URLFetcher::RequestType request_type,
-                            URLFetcherDelegate* d);
+  static scoped_ptr<URLFetcher> Create(int id,
+                                       const GURL& url,
+                                       URLFetcher::RequestType request_type,
+                                       URLFetcherDelegate* d);
 
   // Cancels all existing URLFetchers.  Will notify the URLFetcherDelegates.
   // Note that any new URLFetchers created while this is running will not be
   // cancelled.  Typically, one would call this in the CleanUp() method of an IO
   // thread, so that no new URLRequests would be able to start on the IO thread
   // anyway.  This doesn't prevent new URLFetchers from trying to post to the IO
   // thread though, even though the task won't ever run.
   static void CancelAll();
 
   // Normally, URLFetcher will abort loads that request SSL client certificate
@@ skipping 188 matching lines @@
   // be removed once the URLFetcher is destroyed.  User should not take
   // ownership more than once, or call this method after taking ownership.
   virtual bool GetResponseAsFilePath(
       bool take_ownership,
       base::FilePath* out_response_path) const = 0;
 };
 
 }  // namespace net
 
 #endif  // NET_URL_REQUEST_URL_FETCHER_H_