src/content/public/browser/web_ui_data_source.h

   1 // Copyright (c) 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 CONTENT_PUBLIC_BROWSER_WEB_UI_DATA_SOURCE_H_
   6 #define CONTENT_PUBLIC_BROWSER_WEB_UI_DATA_SOURCE_H_
   7
   8 #include "base/callback.h"
   9 #include "base/strings/string16.h"
  10 #include "content/common/content_export.h"
  11
  12 namespace base {
  13 class DictionaryValue;
  14 class RefCountedMemory;
  15 }
  16
  17 namespace content {
  18 class BrowserContext;
  19
  20 // A data source that can help with implementing the common operations needed by
  21 // WebUI pages.
  22 class WebUIDataSource {
  23  public:
  24   virtual ~WebUIDataSource() {}
  25
  26   CONTENT_EXPORT static WebUIDataSource* Create(const std::string& source_name);
  27
  28   // Adds a WebUI data source to |browser_context|.
  29   CONTENT_EXPORT static void Add(BrowserContext* browser_context,
  30                                  WebUIDataSource* source);
  31
  32   // Adds a string keyed to its name to our dictionary.
  33   virtual void AddString(const std::string& name, const string16& value) = 0;
  34
  35   // Adds a string keyed to its name to our dictionary.
  36   virtual void AddString(const std::string& name, const std::string& value) = 0;
  37
  38   // Adds a localized string with resource |ids| keyed to its name to our
  39   // dictionary.
  40   virtual void AddLocalizedString(const std::string& name, int ids) = 0;
  41
  42   // Add strings from |localized_strings| to our dictionary.
  43   virtual void AddLocalizedStrings(
  44       const base::DictionaryValue& localized_strings) = 0;
  45
  46   // Adds a boolean keyed to its name to our dictionary.
  47   virtual void AddBoolean(const std::string& name, bool value) = 0;
  48
  49   // Sets the path which will return the JSON strings.
  50   virtual void SetJsonPath(const std::string& path) = 0;
  51
  52   // Sets the data source to use a slightly different format for json data. Some
  53   // day this should become the default.
  54   virtual void SetUseJsonJSFormatV2() = 0;
  55
  56   // Adds a mapping between a path name and a resource to return.
  57   virtual void AddResourcePath(const std::string &path, int resource_id) = 0;
  58
  59   // Sets the resource to returned when no other paths match.
  60   virtual void SetDefaultResource(int resource_id) = 0;
  61
  62   // Used as a parameter to GotDataCallback. The caller has to run this callback
  63   // with the result for the path that they filtered, passing ownership of the
  64   // memory.
  65   typedef base::Callback<void(base::RefCountedMemory*)> GotDataCallback;
  66
  67   // Used by SetRequestFilter. The string parameter is the path of the request.
  68   // If the callee doesn't want to handle the data, false is returned. Otherwise
  69   // true is returned and the GotDataCallback parameter is called either then or
  70   // asynchronously with the response.
  71   typedef base::Callback<bool(const std::string&, const GotDataCallback&)>
  72       HandleRequestCallback;
  73
  74   // Allows a caller to add a filter for URL requests.
  75   virtual void SetRequestFilter(const HandleRequestCallback& callback) = 0;
  76
  77   // The following map to methods on URLDataSource. See the documentation there.
  78   // NOTE: it's not acceptable to call DisableContentSecurityPolicy for new
  79   // pages, see URLDataSource::ShouldAddContentSecurityPolicy and talk to
  80   // tsepez.
  81
  82   // Currently only used by embedders for WebUIs with multiple instances.
  83   virtual void DisableReplaceExistingSource() = 0;
  84   virtual void DisableContentSecurityPolicy() = 0;
  85   virtual void OverrideContentSecurityPolicyObjectSrc(
  86       const std::string& data) = 0;
  87   virtual void OverrideContentSecurityPolicyFrameSrc(
  88       const std::string& data) = 0;
  89   virtual void DisableDenyXFrameOptions() = 0;
  90 };
  91
  92 }  // namespace content
  93
  94 #endif  // CONTENT_PUBLIC_BROWSER_WEB_UI_DATA_SOURCE_H_