1 // Copyright (c) 2012 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 CHROME_BROWSER_SESSIONS_SESSION_RESTORE_H_ 6 #define CHROME_BROWSER_SESSIONS_SESSION_RESTORE_H_ 7 8 #include <vector> 9 10 #include "base/basictypes.h" 11 #include "chrome/browser/history/history_service.h" 12 #include "chrome/browser/sessions/session_types.h" 13 #include "chrome/browser/ui/host_desktop.h" 14 #include "ui/base/window_open_disposition.h" 15 16 class Browser; 17 class Profile; 18 19 namespace content { 20 class WebContents; 21 } 22 23 // SessionRestore handles restoring either the last or saved session. Session 24 // restore come in two variants, asynchronous or synchronous. The synchronous 25 // variety is meant for startup and blocks until restore is complete. 26 class SessionRestore { 27 public: 28 enum Behavior { 29 // Indicates the active tab of the supplied browser should be closed. 30 CLOBBER_CURRENT_TAB = 1 << 0, 31 32 // Indicates that if there is a problem restoring the last session then a 33 // new tabbed browser should be created. 34 ALWAYS_CREATE_TABBED_BROWSER = 1 << 1, 35 36 // Restore blocks until complete. This is intended for use during startup 37 // when we want to block until restore is complete. 38 SYNCHRONOUS = 1 << 2, 39 }; 40 41 // Restores the last session. |behavior| is a bitmask of Behaviors, see it 42 // for details. If |browser| is non-null the tabs for the first window are 43 // added to it. Returns the last active browser. 44 // Every additional browser created will be created on the desktop specified 45 // by |host_desktop_type|, if |browser| is non-null it should have the same 46 // desktop type. 47 // 48 // If |urls_to_open| is non-empty, a tab is added for each of the URLs. 49 static Browser* RestoreSession(Profile* profile, 50 Browser* browser, 51 chrome::HostDesktopType host_desktop_type, 52 uint32 behavior, 53 const std::vector<GURL>& urls_to_open); 54 55 // Restores the last session when the last session crashed. It's a wrapper 56 // of function RestoreSession. 57 static void RestoreSessionAfterCrash(Browser* browser); 58 59 // Specifically used in the restoration of a foreign session. This function 60 // restores the given session windows to multiple browsers all of which 61 // will be created on the desktop specified by |host_desktop_type|. Returns 62 // the created Browsers. 63 static std::vector<Browser*> RestoreForeignSessionWindows( 64 Profile* profile, 65 chrome::HostDesktopType host_desktop_type, 66 std::vector<const SessionWindow*>::const_iterator begin, 67 std::vector<const SessionWindow*>::const_iterator end); 68 69 // Specifically used in the restoration of a foreign session. This method 70 // restores the given session tab to the browser of |source_web_contents| if 71 // the disposition is not NEW_WINDOW. Returns the WebContents corresponding 72 // to the restored tab. If |disposition| is CURRENT_TAB, |source_web_contents| 73 // may be destroyed. 74 static content::WebContents* RestoreForeignSessionTab( 75 content::WebContents* source_web_contents, 76 const SessionTab& tab, 77 WindowOpenDisposition disposition); 78 79 // Returns true if we're in the process of restoring |profile|. 80 static bool IsRestoring(const Profile* profile); 81 82 // Returns true if synchronously restoring a session. 83 static bool IsRestoringSynchronously(); 84 85 // The max number of non-selected tabs SessionRestore loads when restoring 86 // a session. A value of 0 indicates all tabs are loaded at once. 87 static size_t num_tabs_to_load_; 88 89 private: 90 SessionRestore(); 91 92 DISALLOW_COPY_AND_ASSIGN(SessionRestore); 93 }; 94 95 #endif // CHROME_BROWSER_SESSIONS_SESSION_RESTORE_H_ 96