Add ChromeExtensionFunctionDetails

chrome/browser/extensions/chrome_extension_function.h

 // Copyright 2013 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 CHROME_BROWSER_EXTENSIONS_CHROME_EXTENSION_FUNCTION_H_
 #define CHROME_BROWSER_EXTENSIONS_CHROME_EXTENSION_FUNCTION_H_
 
 #include "extensions/browser/extension_function.h"
 
 class Browser;
 class Profile;
 
 namespace content {
 class WebContents;
 }
 
 namespace extensions {
 class WindowController;
 }
 
 // A chrome specific analog to AsyncExtensionFunction. This has access to a
 // chrome Profile.
+//
+// DEPRECATED: Please consider inherting UIThreadExtensionFunction directly.
+// Then if you need access to Chrome details, you can construct a
+// ChromeExtensionFunctionDetails object within your function implementation.
 class ChromeUIThreadExtensionFunction : public UIThreadExtensionFunction {
  public:
   ChromeUIThreadExtensionFunction();
 
   Profile* GetProfile() const;
 
   // Returns true if this function (and the profile and extension that it was
   // invoked from) can operate on the window wrapped by |window_controller|.
   bool CanOperateOnWindow(const extensions::WindowController* window_controller)
       const;
@@ skipping 24 matching lines @@
   // Gets the "current" web contents if any. If there is no associated web
   // contents then defaults to the foremost one.
   virtual content::WebContents* GetAssociatedWebContents() OVERRIDE;
 
  protected:
   virtual ~ChromeUIThreadExtensionFunction();
 };
 
 // A chrome specific analog to AsyncExtensionFunction. This has access to a
 // chrome Profile.
+//
+// DEPRECATED: Please consider inherting UIThreadExtensionFunction or
+// AsyncExtensionFunction directly. Then if you need access to Chrome details,
+// you can construct a ChromeExtensionFunctionDetails object within your
+// function implementation.
 class ChromeAsyncExtensionFunction : public ChromeUIThreadExtensionFunction {
  public:
   ChromeAsyncExtensionFunction();
 
  protected:
   virtual ~ChromeAsyncExtensionFunction();
 
   // Deprecated, see AsyncExtensionFunction::RunAsync.
   virtual bool RunAsync() = 0;
 
   // ValidationFailure override to match RunAsync().
   static bool ValidationFailure(ChromeAsyncExtensionFunction* function);
 
  private:
   virtual ResponseAction Run() OVERRIDE;
 };
 
 // A chrome specific analog to SyncExtensionFunction. This has access to a
 // chrome Profile.
+//
+// DEPRECATED: Please consider inherting UIThreadExtensionFunction or
+// SyncExtensionFunction directly. Then if you need access to Chrome details,
+// you can construct a ChromeExtensionFunctionDetails object within your
+// function implementation.
 class ChromeSyncExtensionFunction : public ChromeUIThreadExtensionFunction {
  public:
   ChromeSyncExtensionFunction();
 
  protected:
   virtual ~ChromeSyncExtensionFunction();
 
   // Deprecated, see SyncExtensionFunction::RunSync.
   virtual bool RunSync() = 0;
 
   // ValidationFailure override to match RunSync().
   static bool ValidationFailure(ChromeSyncExtensionFunction* function);
 
  private:
   virtual ResponseAction Run() OVERRIDE;
 };
 
 #endif  // CHROME_BROWSER_EXTENSIONS_CHROME_EXTENSION_FUNCTION_H_