blob: caed739190880f7d1859ede398758a4c3b0bb9c4 [file] [log] [blame]
[email protected]87ab41e72012-01-04 18:45:111// Copyright (c) 2012 The Chromium Authors. All rights reserved.
[email protected]73852b8f2010-05-14 00:38:122// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
4
5#include "chrome/browser/printing/print_dialog_cloud.h"
6#include "chrome/browser/printing/print_dialog_cloud_internal.h"
7
[email protected]73852b8f2010-05-14 00:38:128#include "base/base64.h"
[email protected]ba4fc242011-10-04 18:56:569#include "base/bind.h"
10#include "base/bind_helpers.h"
[email protected]65c9d89a2011-04-13 21:02:3911#include "base/command_line.h"
[email protected]73852b8f2010-05-14 00:38:1212#include "base/file_util.h"
13#include "base/json/json_reader.h"
[email protected]3853a4c2013-02-11 17:15:5714#include "base/prefs/pref_service.h"
[email protected]4b8852a2011-06-10 17:24:4615#include "base/utf_string_conversions.h"
[email protected]73852b8f2010-05-14 00:38:1216#include "base/values.h"
[email protected]70019152012-12-19 11:44:1917#include "chrome/browser/devtools/devtools_window.h"
[email protected]2e6389f2012-05-18 19:41:2518#include "chrome/browser/lifetime/application_lifetime.h"
[email protected]c753f142013-02-10 13:14:0419#include "chrome/browser/prefs/pref_registry_syncable.h"
[email protected]2283eead2010-09-29 23:17:3020#include "chrome/browser/printing/cloud_print/cloud_print_url.h"
[email protected]8ecad5e2010-12-02 21:18:3321#include "chrome/browser/profiles/profile.h"
[email protected]e39027a2011-01-24 21:41:5422#include "chrome/browser/profiles/profile_manager.h"
[email protected]508326df2012-05-23 16:01:1923#include "chrome/browser/ui/browser_dialogs.h"
[email protected]65c9d89a2011-04-13 21:02:3924#include "chrome/common/chrome_switches.h"
[email protected]ea161da2010-11-02 21:57:3525#include "chrome/common/pref_names.h"
[email protected]1375e3ab2011-03-24 17:07:2226#include "chrome/common/print_messages.h"
[email protected]73852b8f2010-05-14 00:38:1227#include "chrome/common/url_constants.h"
[email protected]c38831a12011-10-28 12:44:4928#include "content/public/browser/browser_thread.h"
[email protected]cdcb1dee2012-01-04 00:46:2029#include "content/public/browser/navigation_controller.h"
[email protected]022af742011-12-28 18:37:2530#include "content/public/browser/navigation_entry.h"
[email protected]6c2381d2011-10-19 02:52:5331#include "content/public/browser/notification_registrar.h"
32#include "content/public/browser/notification_source.h"
[email protected]0d6e9bd2011-10-18 04:29:1633#include "content/public/browser/notification_types.h"
[email protected]9c1662b2012-03-06 15:44:3334#include "content/public/browser/render_view_host.h"
[email protected]0ec4898e2011-12-30 21:09:2435#include "content/public/browser/web_contents.h"
[email protected]8643e6d2012-01-18 20:26:1036#include "content/public/browser/web_contents_view.h"
[email protected]01ec4ec2012-01-18 04:13:4737#include "content/public/browser/web_ui.h"
[email protected]fca6b9b2012-05-22 17:11:0538#include "grit/generated_resources.h"
[email protected]c051a1b2011-01-21 23:30:1739#include "ui/base/l10n/l10n_util.h"
[email protected]fca6b9b2012-05-22 17:11:0540#include "webkit/glue/webpreferences.h"
[email protected]520c2022012-03-15 00:13:1541
[email protected]88bfd25b2012-06-22 06:28:3342#if defined(USE_AURA)
43#include "ui/aura/root_window.h"
44#include "ui/aura/window.h"
45#endif
46
[email protected]520c2022012-03-15 00:13:1547#if defined(OS_WIN)
48#include "ui/base/win/foreground_helper.h"
49#endif
50
[email protected]73852b8f2010-05-14 00:38:1251// This module implements the UI support in Chrome for cloud printing.
52// This means hosting a dialog containing HTML/JavaScript and using
53// the published cloud print user interface integration APIs to get
54// page setup settings from the dialog contents and provide the
[email protected]a984bdf2011-03-15 20:17:1655// generated print data to the dialog contents for uploading to the
[email protected]73852b8f2010-05-14 00:38:1256// cloud print service.
57
58// Currently, the flow between these classes is as follows:
59
[email protected]a984bdf2011-03-15 20:17:1660// PrintDialogCloud::CreatePrintDialogForFile is called from
[email protected]73852b8f2010-05-14 00:38:1261// resource_message_filter_gtk.cc once the renderer has informed the
[email protected]a984bdf2011-03-15 20:17:1662// renderer host that print data generation into the renderer host provided
[email protected]032682b2011-01-12 22:05:0263// temp file has been completed. That call is on the FILE thread.
[email protected]73852b8f2010-05-14 00:38:1264// That, in turn, hops over to the UI thread to create an instance of
65// PrintDialogCloud.
66
67// The constructor for PrintDialogCloud creates a
[email protected]5835871a2012-04-25 21:56:5568// CloudPrintWebDialogDelegate and asks the current active browser to
[email protected]73852b8f2010-05-14 00:38:1269// show an HTML dialog using that class as the delegate. That class
[email protected]89f550b2011-06-08 18:34:0370// hands in the kChromeUICloudPrintResourcesURL as the URL to visit. That is
[email protected]80a8fad2011-01-29 04:02:3871// recognized by the GetWebUIFactoryFunction as a signal to create an
[email protected]02b5ccc2012-04-30 23:58:3172// ExternalWebDialogUI.
[email protected]73852b8f2010-05-14 00:38:1273
[email protected]5835871a2012-04-25 21:56:5574// CloudPrintWebDialogDelegate also temporarily owns a
[email protected]73852b8f2010-05-14 00:38:1275// CloudPrintFlowHandler, a class which is responsible for the actual
[email protected]a984bdf2011-03-15 20:17:1676// interactions with the dialog contents, including handing in the
[email protected]73852b8f2010-05-14 00:38:1277// print data and getting any page setup parameters that the dialog
78// contents provides. As part of bringing up the dialog,
[email protected]02b5ccc2012-04-30 23:58:3179// WebDialogUI::RenderViewCreated is called (an override of
[email protected]c39f9bf2011-02-12 00:43:5580// WebUI::RenderViewCreated). That routine, in turn, calls the
[email protected]36e12172011-02-08 23:46:0281// delegate's GetWebUIMessageHandlers routine, at which point the
[email protected]73852b8f2010-05-14 00:38:1282// ownership of the CloudPrintFlowHandler is handed over. A pointer
83// to the flow handler is kept to facilitate communication back and
84// forth between the two classes.
85
[email protected]c39f9bf2011-02-12 00:43:5586// The WebUI continues dialog bring-up, calling
[email protected]73852b8f2010-05-14 00:38:1287// CloudPrintFlowHandler::RegisterMessages. This is where the
88// additional object model capabilities are registered for the dialog
89// contents to use. It is also at this time that capabilities for the
90// dialog contents are adjusted to allow the dialog contents to close
91// the window. In addition, the pending URL is redirected to the
92// actual cloud print service URL. The flow controller also registers
93// for notification of when the dialog contents finish loading, which
[email protected]a984bdf2011-03-15 20:17:1694// is currently used to send the data to the dialog contents.
[email protected]73852b8f2010-05-14 00:38:1295
[email protected]a984bdf2011-03-15 20:17:1696// In order to send the data to the dialog contents, the flow
[email protected]73852b8f2010-05-14 00:38:1297// handler uses a CloudPrintDataSender. It creates one, letting it
[email protected]a984bdf2011-03-15 20:17:1698// know the name of the temporary file containing the data, and
[email protected]73852b8f2010-05-14 00:38:1299// posts the task of reading the file
100// (CloudPrintDataSender::ReadPrintDataFile) to the file thread. That
101// routine reads in the file, and then hops over to the IO thread to
102// send that data to the dialog contents.
103
104// When the dialog contents are finished (by either being cancelled or
105// hitting the print button), the delegate is notified, and responds
106// that the dialog should be closed, at which point things are torn
107// down and released.
108
[email protected]631bb742011-11-02 11:29:39109using content::BrowserThread;
[email protected]c5eed492012-01-04 17:07:50110using content::NavigationController;
[email protected]10f417c52011-12-28 21:04:23111using content::NavigationEntry;
[email protected]eaabba22012-03-07 15:02:11112using content::RenderViewHost;
[email protected]a81343d232011-12-27 07:39:20113using content::WebContents;
[email protected]26e2632a2011-12-31 04:02:55114using content::WebUIMessageHandler;
[email protected]20c07f8e2012-05-31 08:43:14115using ui::WebDialogDelegate;
[email protected]631bb742011-11-02 11:29:39116
[email protected]681958c2013-02-21 13:48:14117const int kDefaultWidth = 912;
118const int kDefaultHeight = 633;
119
[email protected]73852b8f2010-05-14 00:38:12120namespace internal_cloud_print_helpers {
121
[email protected]73852b8f2010-05-14 00:38:12122// From the JSON parsed value, get the entries for the page setup
123// parameters.
124bool GetPageSetupParameters(const std::string& json,
[email protected]1375e3ab2011-03-24 17:07:22125 PrintMsg_Print_Params& parameters) {
[email protected]cd5785752012-04-11 00:15:41126 scoped_ptr<Value> parsed_value(base::JSONReader::Read(json));
[email protected]73852b8f2010-05-14 00:38:12127 DLOG_IF(ERROR, (!parsed_value.get() ||
128 !parsed_value->IsType(Value::TYPE_DICTIONARY)))
129 << "PageSetup call didn't have expected contents";
130 if (!parsed_value.get() || !parsed_value->IsType(Value::TYPE_DICTIONARY))
131 return false;
132
133 bool result = true;
134 DictionaryValue* params = static_cast<DictionaryValue*>(parsed_value.get());
[email protected]05c7da62011-05-05 17:23:56135 result &= params->GetDouble("dpi", &parameters.dpi);
136 result &= params->GetDouble("min_shrink", &parameters.min_shrink);
137 result &= params->GetDouble("max_shrink", &parameters.max_shrink);
[email protected]a65175d2010-08-17 04:00:57138 result &= params->GetBoolean("selection_only", &parameters.selection_only);
[email protected]73852b8f2010-05-14 00:38:12139 return result;
140}
141
[email protected]e8368e92011-08-20 04:05:56142string16 GetSwitchValueString16(const CommandLine& command_line,
143 const char* switchName) {
144#ifdef OS_WIN
145 CommandLine::StringType native_switch_val;
146 native_switch_val = command_line.GetSwitchValueNative(switchName);
147 return string16(native_switch_val);
148#elif defined(OS_POSIX)
149 // POSIX Command line string types are different.
150 CommandLine::StringType native_switch_val;
151 native_switch_val = command_line.GetSwitchValueASCII(switchName);
152 // Convert the ASCII string to UTF16 to prepare to pass.
153 return string16(ASCIIToUTF16(native_switch_val));
154#endif
155}
156
[email protected]73852b8f2010-05-14 00:38:12157void CloudPrintDataSenderHelper::CallJavascriptFunction(
158 const std::wstring& function_name) {
[email protected]47e870b2013-02-24 21:14:53159 web_ui_->CallJavascriptFunction(WideToASCII(function_name));
[email protected]73852b8f2010-05-14 00:38:12160}
161
162void CloudPrintDataSenderHelper::CallJavascriptFunction(
163 const std::wstring& function_name, const Value& arg) {
[email protected]47e870b2013-02-24 21:14:53164 web_ui_->CallJavascriptFunction(WideToASCII(function_name), arg);
[email protected]73852b8f2010-05-14 00:38:12165}
166
167void CloudPrintDataSenderHelper::CallJavascriptFunction(
168 const std::wstring& function_name, const Value& arg1, const Value& arg2) {
[email protected]47e870b2013-02-24 21:14:53169 web_ui_->CallJavascriptFunction(WideToASCII(function_name), arg1, arg2);
[email protected]73852b8f2010-05-14 00:38:12170}
171
[email protected]e8368e92011-08-20 04:05:56172void CloudPrintDataSenderHelper::CallJavascriptFunction(
173 const std::wstring& function_name,
174 const Value& arg1,
175 const Value& arg2,
176 const Value& arg3) {
[email protected]46adf7ff2011-12-30 00:53:09177 web_ui_->CallJavascriptFunction(
[email protected]47e870b2013-02-24 21:14:53178 WideToASCII(function_name), arg1, arg2, arg3);
[email protected]e8368e92011-08-20 04:05:56179}
180
[email protected]73852b8f2010-05-14 00:38:12181// Clears out the pointer we're using to communicate. Either routine is
182// potentially expensive enough that stopping whatever is in progress
183// is worth it.
184void CloudPrintDataSender::CancelPrintDataFile() {
[email protected]20305ec2011-01-21 04:55:52185 base::AutoLock lock(lock_);
[email protected]73852b8f2010-05-14 00:38:12186 // We don't own helper, it was passed in to us, so no need to
187 // delete, just let it go.
188 helper_ = NULL;
189}
190
[email protected]38e08982010-10-22 17:28:43191CloudPrintDataSender::CloudPrintDataSender(CloudPrintDataSenderHelper* helper,
[email protected]a984bdf2011-03-15 20:17:16192 const string16& print_job_title,
[email protected]e8368e92011-08-20 04:05:56193 const string16& print_ticket,
[email protected]a9723e12013-03-05 04:02:45194 const std::string& file_type,
195 const base::RefCountedMemory* data)
[email protected]38e08982010-10-22 17:28:43196 : helper_(helper),
[email protected]a984bdf2011-03-15 20:17:16197 print_job_title_(print_job_title),
[email protected]e8368e92011-08-20 04:05:56198 print_ticket_(print_ticket),
[email protected]a9723e12013-03-05 04:02:45199 file_type_(file_type),
200 data_(data) {
[email protected]38e08982010-10-22 17:28:43201}
202
203CloudPrintDataSender::~CloudPrintDataSender() {}
204
[email protected]73852b8f2010-05-14 00:38:12205// We have the data in hand that needs to be pushed into the dialog
206// contents; do so from the IO thread.
207
208// TODO(scottbyer): If the print data ends up being larger than the
209// upload limit (currently 10MB), what we need to do is upload that
210// large data to google docs and set the URL in the printing
211// JavaScript to that location, and make sure it gets deleted when not
212// needed. - 4/1/2010
[email protected]a9723e12013-03-05 04:02:45213void CloudPrintDataSender::SendPrintData() {
[email protected]ba4f1132010-10-09 02:02:35214 DCHECK(BrowserThread::CurrentlyOn(BrowserThread::IO));
[email protected]a9723e12013-03-05 04:02:45215 if (!data_ || !data_->size())
216 return;
217
218 std::string base64_data;
219 base::Base64Encode(
220 base::StringPiece(reinterpret_cast<const char*>(data_->front()),
221 data_->size()),
222 &base64_data);
223 data_ = NULL;
224 std::string header("data:");
225 header.append(file_type_);
226 header.append(";base64,");
227 base64_data.insert(0, header);
228
[email protected]20305ec2011-01-21 04:55:52229 base::AutoLock lock(lock_);
[email protected]a9723e12013-03-05 04:02:45230 if (helper_) {
[email protected]9848c7e2010-06-03 16:06:56231 StringValue title(print_job_title_);
[email protected]e8368e92011-08-20 04:05:56232 StringValue ticket(print_ticket_);
233 // TODO(abodenha): Change Javascript call to pass in print ticket
234 // after server side support is added. Add test for it.
[email protected]73852b8f2010-05-14 00:38:12235
236 // Send the print data to the dialog contents. The JavaScript
237 // function is a preliminary API for prototyping purposes and is
238 // subject to change.
239 const_cast<CloudPrintDataSenderHelper*>(helper_)->CallJavascriptFunction(
[email protected]a9723e12013-03-05 04:02:45240 L"printApp._printDataUrl", StringValue(base64_data), title);
[email protected]73852b8f2010-05-14 00:38:12241 }
242}
243
244
[email protected]a9723e12013-03-05 04:02:45245CloudPrintFlowHandler::CloudPrintFlowHandler(const base::RefCountedMemory* data,
[email protected]a984bdf2011-03-15 20:17:16246 const string16& print_job_title,
[email protected]e8368e92011-08-20 04:05:56247 const string16& print_ticket,
[email protected]4cd49022012-01-19 20:37:37248 const std::string& file_type,
249 bool close_after_signin,
250 const base::Closure& callback)
[email protected]c7bf7452011-09-12 21:31:50251 : dialog_delegate_(NULL),
[email protected]a9723e12013-03-05 04:02:45252 data_(data),
[email protected]a984bdf2011-03-15 20:17:16253 print_job_title_(print_job_title),
[email protected]e8368e92011-08-20 04:05:56254 print_ticket_(print_ticket),
[email protected]4cd49022012-01-19 20:37:37255 file_type_(file_type),
256 close_after_signin_(close_after_signin),
257 callback_(callback) {
[email protected]38e08982010-10-22 17:28:43258}
259
260CloudPrintFlowHandler::~CloudPrintFlowHandler() {
261 // This will also cancel any task in flight.
262 CancelAnyRunningTask();
263}
264
265
[email protected]73852b8f2010-05-14 00:38:12266void CloudPrintFlowHandler::SetDialogDelegate(
[email protected]5835871a2012-04-25 21:56:55267 CloudPrintWebDialogDelegate* delegate) {
[email protected]7b748982011-02-14 19:28:23268 // Even if setting a new WebUI, it means any previous task needs
[email protected]a2c92a1c2012-04-03 12:32:14269 // to be canceled, its now invalid.
[email protected]ba4f1132010-10-09 02:02:35270 DCHECK(BrowserThread::CurrentlyOn(BrowserThread::UI));
[email protected]73852b8f2010-05-14 00:38:12271 CancelAnyRunningTask();
272 dialog_delegate_ = delegate;
273}
274
275// Cancels any print data sender we have in flight and removes our
276// reference to it, so when the task that is calling it finishes and
[email protected]a2c92a1c2012-04-03 12:32:14277// removes its reference, it goes away.
[email protected]73852b8f2010-05-14 00:38:12278void CloudPrintFlowHandler::CancelAnyRunningTask() {
[email protected]ba4f1132010-10-09 02:02:35279 DCHECK(BrowserThread::CurrentlyOn(BrowserThread::UI));
[email protected]73852b8f2010-05-14 00:38:12280 if (print_data_sender_.get()) {
281 print_data_sender_->CancelPrintDataFile();
282 print_data_sender_ = NULL;
283 }
284}
285
[email protected]73852b8f2010-05-14 00:38:12286void CloudPrintFlowHandler::RegisterMessages() {
[email protected]73852b8f2010-05-14 00:38:12287 // TODO(scottbyer) - This is where we will register messages for the
288 // UI JS to use. Needed: Call to update page setup parameters.
[email protected]46adf7ff2011-12-30 00:53:09289 web_ui()->RegisterMessageCallback("ShowDebugger",
[email protected]ba4fc242011-10-04 18:56:56290 base::Bind(&CloudPrintFlowHandler::HandleShowDebugger,
291 base::Unretained(this)));
[email protected]46adf7ff2011-12-30 00:53:09292 web_ui()->RegisterMessageCallback("SendPrintData",
[email protected]ba4fc242011-10-04 18:56:56293 base::Bind(&CloudPrintFlowHandler::HandleSendPrintData,
294 base::Unretained(this)));
[email protected]46adf7ff2011-12-30 00:53:09295 web_ui()->RegisterMessageCallback("SetPageParameters",
[email protected]ba4fc242011-10-04 18:56:56296 base::Bind(&CloudPrintFlowHandler::HandleSetPageParameters,
297 base::Unretained(this)));
[email protected]73852b8f2010-05-14 00:38:12298
[email protected]0eb25c42011-08-11 14:50:14299 // Register for appropriate notifications, and re-direct the URL
300 // to the real server URL, now that we've gotten an HTML dialog
301 // going.
[email protected]c5eed492012-01-04 17:07:50302 NavigationController* controller =
[email protected]01ec4ec2012-01-18 04:13:47303 &web_ui()->GetWebContents()->GetController();
[email protected]10f417c52011-12-28 21:04:23304 NavigationEntry* pending_entry = controller->GetPendingEntry();
[email protected]0eb25c42011-08-11 14:50:14305 if (pending_entry) {
[email protected]46adf7ff2011-12-30 00:53:09306 Profile* profile = Profile::FromWebUI(web_ui());
[email protected]4cd49022012-01-19 20:37:37307 if (close_after_signin_) {
308 pending_entry->SetURL(
309 CloudPrintURL(profile).GetCloudPrintSigninURL());
310 } else {
311 pending_entry->SetURL(
312 CloudPrintURL(profile).GetCloudPrintServiceDialogURL());
313 }
[email protected]73852b8f2010-05-14 00:38:12314 }
[email protected]0eb25c42011-08-11 14:50:14315 registrar_.Add(this, content::NOTIFICATION_LOAD_STOP,
[email protected]c5eed492012-01-04 17:07:50316 content::Source<NavigationController>(controller));
[email protected]57c8cf22013-03-02 16:50:00317 registrar_.Add(this, content::NOTIFICATION_NAV_ENTRY_COMMITTED,
318 content::Source<NavigationController>(controller));
[email protected]73852b8f2010-05-14 00:38:12319}
320
[email protected]6c2381d2011-10-19 02:52:53321void CloudPrintFlowHandler::Observe(
322 int type,
323 const content::NotificationSource& source,
324 const content::NotificationDetails& details) {
[email protected]57c8cf22013-03-02 16:50:00325 switch (type) {
326 case content::NOTIFICATION_NAV_ENTRY_COMMITTED: {
327 NavigationEntry* entry =
328 web_ui()->GetWebContents()->GetController().GetActiveEntry();
329 if (entry)
330 NavigationToURLDidCloseDialog(entry->GetURL());
331 break;
[email protected]20c52d22011-06-20 22:42:42332 }
[email protected]57c8cf22013-03-02 16:50:00333 case content::NOTIFICATION_LOAD_STOP: {
334 // Take the opportunity to set some (minimal) additional
335 // script permissions required for the web UI.
336 GURL url = web_ui()->GetWebContents()->GetURL();
337 GURL dialog_url = CloudPrintURL(
338 Profile::FromWebUI(web_ui())).GetCloudPrintServiceDialogURL();
339 if (url.host() == dialog_url.host() &&
340 url.path() == dialog_url.path() &&
341 url.scheme() == dialog_url.scheme()) {
342 RenderViewHost* rvh = web_ui()->GetWebContents()->GetRenderViewHost();
343 if (rvh) {
344 webkit_glue::WebPreferences webkit_prefs =
345 rvh->GetWebkitPreferences();
346 webkit_prefs.allow_scripts_to_close_windows = true;
347 rvh->UpdateWebkitPreferences(webkit_prefs);
348 } else {
349 NOTREACHED();
350 }
351 }
[email protected]20c52d22011-06-20 22:42:42352
[email protected]57c8cf22013-03-02 16:50:00353 // Choose one or the other. If you need to debug, bring up the
354 // debugger. You can then use the various chrome.send()
355 // registrations above to kick of the various function calls,
356 // including chrome.send("SendPrintData") in the javaScript
357 // console and watch things happen with:
358 // HandleShowDebugger(NULL);
359 HandleSendPrintData(NULL);
360 break;
361 }
[email protected]73852b8f2010-05-14 00:38:12362 }
363}
364
[email protected]88942a22010-08-19 20:34:43365void CloudPrintFlowHandler::HandleShowDebugger(const ListValue* args) {
[email protected]73852b8f2010-05-14 00:38:12366 ShowDebugger();
367}
368
369void CloudPrintFlowHandler::ShowDebugger() {
[email protected]46adf7ff2011-12-30 00:53:09370 if (web_ui()) {
[email protected]01ec4ec2012-01-18 04:13:47371 RenderViewHost* rvh = web_ui()->GetWebContents()->GetRenderViewHost();
[email protected]73852b8f2010-05-14 00:38:12372 if (rvh)
[email protected]aebdd072011-07-07 12:36:59373 DevToolsWindow::OpenDevToolsWindow(rvh);
[email protected]73852b8f2010-05-14 00:38:12374 }
375}
376
377scoped_refptr<CloudPrintDataSender>
378CloudPrintFlowHandler::CreateCloudPrintDataSender() {
[email protected]46adf7ff2011-12-30 00:53:09379 DCHECK(web_ui());
380 print_data_helper_.reset(new CloudPrintDataSenderHelper(web_ui()));
[email protected]a9723e12013-03-05 04:02:45381 scoped_refptr<CloudPrintDataSender> sender(
382 new CloudPrintDataSender(print_data_helper_.get(), print_job_title_,
383 print_ticket_, file_type_, data_));
384 data_ = NULL;
385 return sender;
[email protected]73852b8f2010-05-14 00:38:12386}
387
[email protected]88942a22010-08-19 20:34:43388void CloudPrintFlowHandler::HandleSendPrintData(const ListValue* args) {
[email protected]ba4f1132010-10-09 02:02:35389 DCHECK(BrowserThread::CurrentlyOn(BrowserThread::UI));
[email protected]73852b8f2010-05-14 00:38:12390 // This will cancel any ReadPrintDataFile() or SendPrintDataFile()
391 // requests in flight (this is anticipation of when setting page
392 // setup parameters becomes asynchronous and may be set while some
393 // data is in flight). Then we can clear out the print data.
394 CancelAnyRunningTask();
[email protected]46adf7ff2011-12-30 00:53:09395 if (web_ui()) {
[email protected]73852b8f2010-05-14 00:38:12396 print_data_sender_ = CreateCloudPrintDataSender();
[email protected]3e2dd4fa2011-11-10 06:06:40397 BrowserThread::PostTask(
[email protected]a9723e12013-03-05 04:02:45398 BrowserThread::IO, FROM_HERE,
399 base::Bind(&CloudPrintDataSender::SendPrintData, print_data_sender_));
[email protected]73852b8f2010-05-14 00:38:12400 }
401}
402
[email protected]88942a22010-08-19 20:34:43403void CloudPrintFlowHandler::HandleSetPageParameters(const ListValue* args) {
[email protected]036056a32011-03-03 21:05:01404 std::string json;
[email protected]e675f7b2011-06-22 17:32:12405 bool ret = args->GetString(0, &json);
406 if (!ret || json.empty()) {
[email protected]036056a32011-03-03 21:05:01407 NOTREACHED() << "Empty json string";
[email protected]73852b8f2010-05-14 00:38:12408 return;
[email protected]036056a32011-03-03 21:05:01409 }
[email protected]73852b8f2010-05-14 00:38:12410
411 // These are backstop default values - 72 dpi to match the screen,
412 // 8.5x11 inch paper with margins subtracted (1/4 inch top, left,
413 // right and 0.56 bottom), and the min page shrink and max page
414 // shrink values appear all over the place with no explanation.
415
416 // TODO(scottbyer): Get a Linux/ChromeOS edge for PrintSettings
417 // working so that we can get the default values from there. Fix up
418 // PrintWebViewHelper to do the same.
419 const int kDPI = 72;
420 const int kWidth = static_cast<int>((8.5-0.25-0.25)*kDPI);
421 const int kHeight = static_cast<int>((11-0.25-0.56)*kDPI);
422 const double kMinPageShrink = 1.25;
423 const double kMaxPageShrink = 2.0;
424
[email protected]1375e3ab2011-03-24 17:07:22425 PrintMsg_Print_Params default_settings;
[email protected]10980442011-12-04 22:33:05426 default_settings.content_size = gfx::Size(kWidth, kHeight);
[email protected]732b8132012-01-10 23:17:32427 default_settings.printable_area = gfx::Rect(0, 0, kWidth, kHeight);
[email protected]73852b8f2010-05-14 00:38:12428 default_settings.dpi = kDPI;
429 default_settings.min_shrink = kMinPageShrink;
430 default_settings.max_shrink = kMaxPageShrink;
431 default_settings.desired_dpi = kDPI;
432 default_settings.document_cookie = 0;
433 default_settings.selection_only = false;
[email protected]718af822011-08-12 22:11:33434 default_settings.preview_request_id = 0;
435 default_settings.is_first_request = true;
[email protected]732b8132012-01-10 23:17:32436 default_settings.print_to_pdf = false;
[email protected]73852b8f2010-05-14 00:38:12437
438 if (!GetPageSetupParameters(json, default_settings)) {
439 NOTREACHED();
440 return;
441 }
442
443 // TODO(scottbyer) - Here is where we would kick the originating
444 // renderer thread with these new parameters in order to get it to
[email protected]a984bdf2011-03-15 20:17:16445 // re-generate the PDF data and hand it back to us. window.print() is
[email protected]73852b8f2010-05-14 00:38:12446 // currently synchronous, so there's a lot of work to do to get to
447 // that point.
448}
449
[email protected]ea161da2010-11-02 21:57:35450void CloudPrintFlowHandler::StoreDialogClientSize() const {
[email protected]01ec4ec2012-01-18 04:13:47451 if (web_ui() && web_ui()->GetWebContents() &&
452 web_ui()->GetWebContents()->GetView()) {
453 gfx::Size size = web_ui()->GetWebContents()->GetView()->GetContainerSize();
[email protected]46adf7ff2011-12-30 00:53:09454 Profile* profile = Profile::FromWebUI(web_ui());
[email protected]0eb25c42011-08-11 14:50:14455 profile->GetPrefs()->SetInteger(prefs::kCloudPrintDialogWidth,
456 size.width());
457 profile->GetPrefs()->SetInteger(prefs::kCloudPrintDialogHeight,
458 size.height());
[email protected]ea161da2010-11-02 21:57:35459 }
460}
461
[email protected]a911c4e2012-10-12 00:37:57462bool CloudPrintFlowHandler::NavigationToURLDidCloseDialog(const GURL& url) {
463 if (close_after_signin_) {
464 GURL dialog_url = CloudPrintURL(
465 Profile::FromWebUI(web_ui())).GetCloudPrintServiceURL();
466
467 if (url.host() == dialog_url.host() &&
[email protected]22f450492013-02-20 22:02:51468 StartsWithASCII(url.path(), dialog_url.path(), false) &&
[email protected]a911c4e2012-10-12 00:37:57469 url.scheme() == dialog_url.scheme()) {
470 StoreDialogClientSize();
471 web_ui()->GetWebContents()->GetRenderViewHost()->ClosePage();
472 callback_.Run();
473 return true;
474 }
475 }
476 return false;
477}
478
[email protected]5835871a2012-04-25 21:56:55479CloudPrintWebDialogDelegate::CloudPrintWebDialogDelegate(
[email protected]b5b79d72012-05-24 19:42:28480 content::BrowserContext* browser_context,
481 gfx::NativeWindow modal_parent,
[email protected]a9723e12013-03-05 04:02:45482 const base::RefCountedMemory* data,
[email protected]9848c7e2010-06-03 16:06:56483 const std::string& json_arguments,
[email protected]e39027a2011-01-24 21:41:54484 const string16& print_job_title,
[email protected]e8368e92011-08-20 04:05:56485 const string16& print_ticket,
[email protected]a984bdf2011-03-15 20:17:16486 const std::string& file_type,
[email protected]4cd49022012-01-19 20:37:37487 bool close_after_signin,
488 const base::Closure& callback)
[email protected]a9723e12013-03-05 04:02:45489 : flow_handler_(
490 new CloudPrintFlowHandler(data, print_job_title, print_ticket,
491 file_type, close_after_signin, callback)),
[email protected]b5b79d72012-05-24 19:42:28492 modal_parent_(modal_parent),
[email protected]6ddda232011-04-22 15:41:47493 owns_flow_handler_(true),
[email protected]b5b79d72012-05-24 19:42:28494 keep_alive_when_non_modal_(true) {
495 Init(browser_context, json_arguments);
[email protected]73852b8f2010-05-14 00:38:12496}
497
[email protected]05acb55472011-02-03 00:11:07498// For unit testing.
[email protected]5835871a2012-04-25 21:56:55499CloudPrintWebDialogDelegate::CloudPrintWebDialogDelegate(
[email protected]73852b8f2010-05-14 00:38:12500 CloudPrintFlowHandler* flow_handler,
[email protected]a9723e12013-03-05 04:02:45501 const std::string& json_arguments)
502 : flow_handler_(flow_handler),
[email protected]b5b79d72012-05-24 19:42:28503 modal_parent_(NULL),
504 owns_flow_handler_(true),
505 keep_alive_when_non_modal_(false) {
506 Init(NULL, json_arguments);
[email protected]73852b8f2010-05-14 00:38:12507}
508
[email protected]b5b79d72012-05-24 19:42:28509// Returns the persisted width/height for the print dialog.
510void GetDialogWidthAndHeightFromPrefs(content::BrowserContext* browser_context,
511 int* width,
512 int* height) {
[email protected]b5b79d72012-05-24 19:42:28513 if (!browser_context) {
514 *width = kDefaultWidth;
515 *height = kDefaultHeight;
516 return;
517 }
518
[email protected]c753f142013-02-10 13:14:04519 PrefService* prefs = Profile::FromBrowserContext(browser_context)->GetPrefs();
[email protected]c753f142013-02-10 13:14:04520 *width = prefs->GetInteger(prefs::kCloudPrintDialogWidth);
521 *height = prefs->GetInteger(prefs::kCloudPrintDialogHeight);
[email protected]b5b79d72012-05-24 19:42:28522}
523
524void CloudPrintWebDialogDelegate::Init(content::BrowserContext* browser_context,
[email protected]5835871a2012-04-25 21:56:55525 const std::string& json_arguments) {
[email protected]73852b8f2010-05-14 00:38:12526 // This information is needed to show the dialog HTML content.
[email protected]ba4f1132010-10-09 02:02:35527 DCHECK(BrowserThread::CurrentlyOn(BrowserThread::UI));
[email protected]b5b79d72012-05-24 19:42:28528
[email protected]89f550b2011-06-08 18:34:03529 params_.url = GURL(chrome::kChromeUICloudPrintResourcesURL);
[email protected]b5b79d72012-05-24 19:42:28530 GetDialogWidthAndHeightFromPrefs(browser_context,
531 &params_.width,
532 &params_.height);
[email protected]73852b8f2010-05-14 00:38:12533 params_.json_input = json_arguments;
534
535 flow_handler_->SetDialogDelegate(this);
[email protected]e39027a2011-01-24 21:41:54536 // If we're not modal we can show the dialog with no browser.
537 // We need this to keep Chrome alive while our dialog is up.
[email protected]b5b79d72012-05-24 19:42:28538 if (!modal_parent_ && keep_alive_when_non_modal_)
[email protected]313fce12013-01-30 17:09:04539 chrome::StartKeepAlive();
[email protected]73852b8f2010-05-14 00:38:12540}
541
[email protected]5835871a2012-04-25 21:56:55542CloudPrintWebDialogDelegate::~CloudPrintWebDialogDelegate() {
[email protected]73852b8f2010-05-14 00:38:12543 // If the flow_handler_ is about to outlive us because we don't own
[email protected]a2c92a1c2012-04-03 12:32:14544 // it anymore, we need to have it remove its reference to us.
[email protected]ba4f1132010-10-09 02:02:35545 DCHECK(BrowserThread::CurrentlyOn(BrowserThread::UI));
[email protected]73852b8f2010-05-14 00:38:12546 flow_handler_->SetDialogDelegate(NULL);
547 if (owns_flow_handler_) {
548 delete flow_handler_;
549 }
550}
551
[email protected]5835871a2012-04-25 21:56:55552ui::ModalType CloudPrintWebDialogDelegate::GetDialogModalType() const {
[email protected]b5b79d72012-05-24 19:42:28553 return modal_parent_ ? ui::MODAL_TYPE_WINDOW : ui::MODAL_TYPE_NONE;
[email protected]73852b8f2010-05-14 00:38:12554}
555
[email protected]5835871a2012-04-25 21:56:55556string16 CloudPrintWebDialogDelegate::GetDialogTitle() const {
[email protected]bdae5c12011-08-05 21:49:06557 return string16();
[email protected]73852b8f2010-05-14 00:38:12558}
559
[email protected]5835871a2012-04-25 21:56:55560GURL CloudPrintWebDialogDelegate::GetDialogContentURL() const {
[email protected]73852b8f2010-05-14 00:38:12561 return params_.url;
562}
563
[email protected]5835871a2012-04-25 21:56:55564void CloudPrintWebDialogDelegate::GetWebUIMessageHandlers(
[email protected]36e12172011-02-08 23:46:02565 std::vector<WebUIMessageHandler*>* handlers) const {
[email protected]73852b8f2010-05-14 00:38:12566 handlers->push_back(flow_handler_);
567 // We don't own flow_handler_ anymore, but it sticks around until at
568 // least right after OnDialogClosed() is called (and this object is
569 // destroyed).
570 owns_flow_handler_ = false;
571}
572
[email protected]5835871a2012-04-25 21:56:55573void CloudPrintWebDialogDelegate::GetDialogSize(gfx::Size* size) const {
[email protected]73852b8f2010-05-14 00:38:12574 size->set_width(params_.width);
575 size->set_height(params_.height);
576}
577
[email protected]5835871a2012-04-25 21:56:55578std::string CloudPrintWebDialogDelegate::GetDialogArgs() const {
[email protected]73852b8f2010-05-14 00:38:12579 return params_.json_input;
580}
581
[email protected]5835871a2012-04-25 21:56:55582void CloudPrintWebDialogDelegate::OnDialogClosed(
[email protected]73852b8f2010-05-14 00:38:12583 const std::string& json_retval) {
[email protected]ea161da2010-11-02 21:57:35584 // Get the final dialog size and store it.
585 flow_handler_->StoreDialogClientSize();
[email protected]6ddda232011-04-22 15:41:47586
[email protected]e39027a2011-01-24 21:41:54587 // If we're modal we can show the dialog with no browser.
588 // End the keep-alive so that Chrome can exit.
[email protected]b5b79d72012-05-24 19:42:28589 if (!modal_parent_ && keep_alive_when_non_modal_)
[email protected]313fce12013-01-30 17:09:04590 chrome::EndKeepAlive();
[email protected]73852b8f2010-05-14 00:38:12591 delete this;
592}
593
[email protected]5835871a2012-04-25 21:56:55594void CloudPrintWebDialogDelegate::OnCloseContents(WebContents* source,
595 bool* out_close_dialog) {
[email protected]18137e02010-05-25 21:10:35596 if (out_close_dialog)
597 *out_close_dialog = true;
598}
599
[email protected]5835871a2012-04-25 21:56:55600bool CloudPrintWebDialogDelegate::ShouldShowDialogTitle() const {
[email protected]ea161da2010-11-02 21:57:35601 return false;
602}
603
[email protected]5835871a2012-04-25 21:56:55604bool CloudPrintWebDialogDelegate::HandleContextMenu(
[email protected]35be7ec2012-02-12 20:42:51605 const content::ContextMenuParams& params) {
[email protected]34478212011-04-19 01:35:46606 return true;
607}
608
[email protected]a911c4e2012-10-12 00:37:57609bool CloudPrintWebDialogDelegate::HandleOpenURLFromTab(
610 content::WebContents* source,
611 const content::OpenURLParams& params,
612 content::WebContents** out_new_contents) {
613 return flow_handler_->NavigationToURLDidCloseDialog(params.url);
614}
615
[email protected]6085c70d2011-03-22 22:51:07616// Called from the UI thread, starts up the dialog.
[email protected]b5b79d72012-05-24 19:42:28617void CreateDialogImpl(content::BrowserContext* browser_context,
618 gfx::NativeWindow modal_parent,
[email protected]a9723e12013-03-05 04:02:45619 const base::RefCountedMemory* data,
[email protected]6085c70d2011-03-22 22:51:07620 const string16& print_job_title,
[email protected]e8368e92011-08-20 04:05:56621 const string16& print_ticket,
[email protected]6085c70d2011-03-22 22:51:07622 const std::string& file_type,
[email protected]4cd49022012-01-19 20:37:37623 bool close_after_signin,
624 const base::Closure& callback) {
[email protected]ba4f1132010-10-09 02:02:35625 DCHECK(BrowserThread::CurrentlyOn(BrowserThread::UI));
[email protected]5835871a2012-04-25 21:56:55626 WebDialogDelegate* dialog_delegate =
627 new internal_cloud_print_helpers::CloudPrintWebDialogDelegate(
[email protected]a9723e12013-03-05 04:02:45628 browser_context, modal_parent, data, std::string(), print_job_title,
629 print_ticket, file_type, close_after_signin, callback);
[email protected]88bfd25b2012-06-22 06:28:33630#if defined(OS_WIN)
631 gfx::NativeWindow window =
632#endif
[email protected]87586fb72012-07-02 13:15:02633 chrome::ShowWebDialog(modal_parent,
634 Profile::FromBrowserContext(browser_context),
635 dialog_delegate);
[email protected]88bfd25b2012-06-22 06:28:33636#if defined(OS_WIN)
[email protected]a9723e12013-03-05 04:02:45637 if (window) {
[email protected]88bfd25b2012-06-22 06:28:33638 HWND dialog_handle;
639#if defined(USE_AURA)
640 dialog_handle = window->GetRootWindow()->GetAcceleratedWidget();
641#else
642 dialog_handle = window;
643#endif
644 if (::GetForegroundWindow() != dialog_handle) {
645 ui::ForegroundHelper::SetForeground(dialog_handle);
646 }
647 }
648#endif
[email protected]73852b8f2010-05-14 00:38:12649}
[email protected]6085c70d2011-03-22 22:51:07650
[email protected]b5b79d72012-05-24 19:42:28651void CreateDialogSigninImpl(content::BrowserContext* browser_context,
652 gfx::NativeWindow modal_parent,
653 const base::Closure& callback) {
[email protected]a9723e12013-03-05 04:02:45654 CreateDialogImpl(browser_context, modal_parent, NULL, string16(),
655 string16(), std::string(), true, callback);
[email protected]4cd49022012-01-19 20:37:37656}
657
[email protected]a9723e12013-03-05 04:02:45658void CreateDialogForFileImpl(content::BrowserContext* browser_context,
659 gfx::NativeWindow modal_parent,
660 const base::FilePath& path_to_file,
661 const string16& print_job_title,
662 const string16& print_ticket,
663 const std::string& file_type,
664 bool delete_on_close) {
665 DCHECK(BrowserThread::CurrentlyOn(BrowserThread::FILE));
666 scoped_refptr<base::RefCountedMemory> data;
667 int64 file_size = 0;
668 if (file_util::GetFileSize(path_to_file, &file_size) && file_size != 0) {
669 std::string file_data;
670 if (file_size < kuint32max) {
671 file_data.reserve(static_cast<unsigned int>(file_size));
672 } else {
673 DLOG(WARNING) << " print data file too large to reserve space";
674 }
675 if (file_util::ReadFileToString(path_to_file, &file_data)) {
676 data = base::RefCountedString::TakeString(&file_data);
677 }
678 }
679 // Proceed even for empty data to simplify testing.
680 BrowserThread::PostTask(
681 BrowserThread::UI, FROM_HERE,
682 base::Bind(&print_dialog_cloud::CreatePrintDialogForBytes,
683 browser_context, modal_parent, data, print_job_title,
684 print_ticket, file_type));
685 if (delete_on_close)
686 file_util::Delete(path_to_file, false);
[email protected]6ddda232011-04-22 15:41:47687}
688
[email protected]6085c70d2011-03-22 22:51:07689} // namespace internal_cloud_print_helpers
690
691namespace print_dialog_cloud {
692
[email protected]681958c2013-02-21 13:48:14693void RegisterUserPrefs(PrefRegistrySyncable* registry) {
694 registry->RegisterIntegerPref(
695 prefs::kCloudPrintDialogWidth,
696 kDefaultWidth,
697 PrefRegistrySyncable::UNSYNCABLE_PREF);
698 registry->RegisterIntegerPref(
699 prefs::kCloudPrintDialogHeight,
700 kDefaultHeight,
701 PrefRegistrySyncable::UNSYNCABLE_PREF);
702}
703
[email protected]6085c70d2011-03-22 22:51:07704// Called on the FILE or UI thread. This is the main entry point into creating
705// the dialog.
706
[email protected]b5b79d72012-05-24 19:42:28707void CreatePrintDialogForFile(content::BrowserContext* browser_context,
708 gfx::NativeWindow modal_parent,
[email protected]650b2d52013-02-10 03:41:45709 const base::FilePath& path_to_file,
[email protected]6085c70d2011-03-22 22:51:07710 const string16& print_job_title,
[email protected]e8368e92011-08-20 04:05:56711 const string16& print_ticket,
[email protected]6085c70d2011-03-22 22:51:07712 const std::string& file_type,
[email protected]d955fc92011-09-19 20:49:03713 bool delete_on_close) {
[email protected]6085c70d2011-03-22 22:51:07714 DCHECK(BrowserThread::CurrentlyOn(BrowserThread::FILE) ||
715 BrowserThread::CurrentlyOn(BrowserThread::UI));
[email protected]6085c70d2011-03-22 22:51:07716 BrowserThread::PostTask(
[email protected]a9723e12013-03-05 04:02:45717 BrowserThread::FILE, FROM_HERE,
718 base::Bind(&internal_cloud_print_helpers::CreateDialogForFileImpl,
[email protected]b5b79d72012-05-24 19:42:28719 browser_context, modal_parent, path_to_file, print_job_title,
720 print_ticket, file_type, delete_on_close));
[email protected]d955fc92011-09-19 20:49:03721}
722
[email protected]b5b79d72012-05-24 19:42:28723void CreateCloudPrintSigninDialog(content::BrowserContext* browser_context,
724 gfx::NativeWindow modal_parent,
725 const base::Closure& callback) {
[email protected]4cd49022012-01-19 20:37:37726 DCHECK(BrowserThread::CurrentlyOn(BrowserThread::UI));
727
728 BrowserThread::PostTask(
729 BrowserThread::UI, FROM_HERE,
730 base::Bind(&internal_cloud_print_helpers::CreateDialogSigninImpl,
[email protected]a9723e12013-03-05 04:02:45731 browser_context, modal_parent, callback));
[email protected]4cd49022012-01-19 20:37:37732}
733
[email protected]b5b79d72012-05-24 19:42:28734void CreatePrintDialogForBytes(content::BrowserContext* browser_context,
735 gfx::NativeWindow modal_parent,
[email protected]a9723e12013-03-05 04:02:45736 const base::RefCountedMemory* data,
[email protected]d955fc92011-09-19 20:49:03737 const string16& print_job_title,
738 const string16& print_ticket,
[email protected]b5b79d72012-05-24 19:42:28739 const std::string& file_type) {
[email protected]a9723e12013-03-05 04:02:45740 internal_cloud_print_helpers::CreateDialogImpl(browser_context, modal_parent,
741 data, print_job_title,
742 print_ticket, file_type, false,
743 base::Closure());
[email protected]6085c70d2011-03-22 22:51:07744}
745
[email protected]65c9d89a2011-04-13 21:02:39746bool CreatePrintDialogFromCommandLine(const CommandLine& command_line) {
[email protected]87ab41e72012-01-04 18:45:11747 DCHECK(command_line.HasSwitch(switches::kCloudPrintFile));
[email protected]65c9d89a2011-04-13 21:02:39748 if (!command_line.GetSwitchValuePath(switches::kCloudPrintFile).empty()) {
[email protected]650b2d52013-02-10 03:41:45749 base::FilePath cloud_print_file;
[email protected]65c9d89a2011-04-13 21:02:39750 cloud_print_file =
751 command_line.GetSwitchValuePath(switches::kCloudPrintFile);
752 if (!cloud_print_file.empty()) {
753 string16 print_job_title;
[email protected]e8368e92011-08-20 04:05:56754 string16 print_job_print_ticket;
[email protected]65c9d89a2011-04-13 21:02:39755 if (command_line.HasSwitch(switches::kCloudPrintJobTitle)) {
[email protected]e8368e92011-08-20 04:05:56756 print_job_title =
757 internal_cloud_print_helpers::GetSwitchValueString16(
758 command_line, switches::kCloudPrintJobTitle);
759 }
760 if (command_line.HasSwitch(switches::kCloudPrintPrintTicket)) {
761 print_job_print_ticket =
762 internal_cloud_print_helpers::GetSwitchValueString16(
763 command_line, switches::kCloudPrintPrintTicket);
[email protected]65c9d89a2011-04-13 21:02:39764 }
765 std::string file_type = "application/pdf";
766 if (command_line.HasSwitch(switches::kCloudPrintFileType)) {
767 file_type = command_line.GetSwitchValueASCII(
768 switches::kCloudPrintFileType);
769 }
[email protected]e8368e92011-08-20 04:05:56770
[email protected]d955fc92011-09-19 20:49:03771 bool delete_on_close = CommandLine::ForCurrentProcess()->HasSwitch(
772 switches::kCloudPrintDeleteFile);
773
[email protected]b5b79d72012-05-24 19:42:28774 print_dialog_cloud::CreatePrintDialogForFile(
775 ProfileManager::GetDefaultProfile(),
776 NULL,
777 cloud_print_file,
778 print_job_title,
779 print_job_print_ticket,
780 file_type,
781 delete_on_close);
[email protected]65c9d89a2011-04-13 21:02:39782 return true;
783 }
784 }
785 return false;
786}
787
[email protected]6085c70d2011-03-22 22:51:07788} // end namespace