components/autofill/core/browser/autofill_driver.h

   1 // Copyright 2013 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef COMPONENTS_AUTOFILL_CORE_BROWSER_AUTOFILL_DRIVER_H_
   6 #define COMPONENTS_AUTOFILL_CORE_BROWSER_AUTOFILL_DRIVER_H_
   7
   8 #include <vector>
   9
  10 #include "components/autofill/core/common/form_data.h"
  11
  12 namespace base {
  13 class SequencedWorkerPool;
  14 }
  15
  16 namespace net {
  17 class URLRequestContextGetter;
  18 }
  19
  20 namespace autofill {
  21
  22 class FormStructure;
  23
  24 // Interface that allows Autofill core code to interact with its driver (i.e.,
  25 // obtain information from it and give information to it). A concrete
  26 // implementation must be provided by the driver.
  27 class AutofillDriver {
  28  public:
  29    // The possible actions that the renderer can take on receiving form data.
  30   enum RendererFormDataAction {
  31     // The renderer should fill the form data.
  32     FORM_DATA_ACTION_FILL,
  33     // The renderer should preview the form data.
  34     FORM_DATA_ACTION_PREVIEW
  35   };
  36
  37   virtual ~AutofillDriver() {}
  38
  39   // Returns whether the user is currently operating in an off-the-record
  40   // (i.e., incognito) context.
  41   virtual bool IsOffTheRecord() const = 0;
  42
  43   // Returns the URL request context information associated with this driver.
  44   virtual net::URLRequestContextGetter* GetURLRequestContext() = 0;
  45
  46   // Returns the SequencedWorkerPool on which core Autofill code should run
  47   // tasks that may block. This pool must live at least as long as the driver.
  48   virtual base::SequencedWorkerPool* GetBlockingPool() = 0;
  49
  50   // Returns true iff the renderer is available for communication.
  51   virtual bool RendererIsAvailable() = 0;
  52
  53   // Forwards |data| to the renderer. |query_id| is the id of the renderer's
  54   // original request for the data. |action| is the action the renderer should
  55   // perform with the |data|. This method is a no-op if the renderer is not
  56   // currently available.
  57   virtual void SendFormDataToRenderer(int query_id,
  58                                       RendererFormDataAction action,
  59                                       const FormData& data) = 0;
  60
  61   // Pass the form structures to the password manager to choose correct username
  62   // and to the password generation manager to detect account creation forms.
  63   virtual void PropagateAutofillPredictions(
  64       const std::vector<autofill::FormStructure*>& forms) = 0;
  65
  66   // Sends the field type predictions specified in |forms| to the renderer. This
  67   // method is a no-op if the renderer is not available or the appropriate
  68   // command-line flag is not set.
  69   virtual void SendAutofillTypePredictionsToRenderer(
  70       const std::vector<FormStructure*>& forms) = 0;
  71
  72   // Tells the renderer to accept data list suggestions for |value|.
  73   virtual void RendererShouldAcceptDataListSuggestion(
  74       const base::string16& value) = 0;
  75
  76   // Tells the renderer to clear the currently filled Autofill results.
  77   virtual void RendererShouldClearFilledForm() = 0;
  78
  79   // Tells the renderer to clear the currently previewed Autofill results.
  80   virtual void RendererShouldClearPreviewedForm() = 0;
  81
  82   // Tells the renderer to set the node text.
  83   virtual void RendererShouldFillFieldWithValue(
  84       const base::string16& value) = 0;
  85
  86   // Tells the renderer to preview the node with suggested text.
  87   virtual void RendererShouldPreviewFieldWithValue(
  88       const base::string16& value) = 0;
  89
  90   // Informs the renderer that the popup has been hidden.
  91   virtual void PopupHidden() = 0;
  92 };
  93
  94 }  // namespace autofill
  95
  96 #endif  // COMPONENTS_AUTOFILL_CORE_BROWSER_AUTOFILL_DRIVER_H_