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 virtual void DisableContentSecurityPolicy() = 0; 82 virtual void OverrideContentSecurityPolicyObjectSrc( 83 const std::string& data) = 0; 84 virtual void OverrideContentSecurityPolicyFrameSrc( 85 const std::string& data) = 0; 86 virtual void DisableDenyXFrameOptions() = 0; 87 }; 88 89 } // namespace content 90 91 #endif // CONTENT_PUBLIC_BROWSER_WEB_UI_DATA_SOURCE_H_ 92
