/* * Copyright (C) 2007 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package com.android.browser; import com.android.browser.IntentHandler.UrlData; import android.os.Bundle; import android.util.Log; import android.webkit.WebBackForwardList; import android.webkit.WebView; import java.io.File; import java.util.ArrayList; import java.util.HashMap; import java.util.List; import java.util.Vector; class TabControl { // Log Tag private static final String LOGTAG = "TabControl"; // Maximum number of tabs. private int mMaxTabs; // Private array of WebViews that are used as tabs. private ArrayList mTabs; // Queue of most recently viewed tabs. private ArrayList mTabQueue; // Current position in mTabs. private int mCurrentTab = -1; // the main browser controller private final Controller mController; private final File mThumbnailDir; /** * Construct a new TabControl object */ TabControl(Controller controller) { mController = controller; mThumbnailDir = mController.getActivity() .getDir("thumbnails", 0); mMaxTabs = mController.getMaxTabs(); mTabs = new ArrayList(mMaxTabs); mTabQueue = new ArrayList(mMaxTabs); } File getThumbnailDir() { return mThumbnailDir; } /** * Return the current tab's main WebView. This will always return the main * WebView for a given tab and not a subwindow. * @return The current tab's WebView. */ WebView getCurrentWebView() { Tab t = getTab(mCurrentTab); if (t == null) { return null; } return t.getWebView(); } /** * Return the current tab's top-level WebView. This can return a subwindow * if one exists. * @return The top-level WebView of the current tab. */ WebView getCurrentTopWebView() { Tab t = getTab(mCurrentTab); if (t == null) { return null; } return t.getTopWindow(); } /** * Return the current tab's subwindow if it exists. * @return The subwindow of the current tab or null if it doesn't exist. */ WebView getCurrentSubWindow() { Tab t = getTab(mCurrentTab); if (t == null) { return null; } return t.getSubWebView(); } /** * return the list of tabs */ List getTabs() { return mTabs; } /** * Return the tab at the specified index. * @return The Tab for the specified index or null if the tab does not * exist. */ Tab getTab(int index) { if (index >= 0 && index < mTabs.size()) { return mTabs.get(index); } return null; } /** * Return the current tab. * @return The current tab. */ Tab getCurrentTab() { return getTab(mCurrentTab); } /** * Return the current tab index. * @return The current tab index */ int getCurrentIndex() { return mCurrentTab; } /** * Given a Tab, find it's index * @param Tab to find * @return index of Tab or -1 if not found */ int getTabIndex(Tab tab) { if (tab == null) { return -1; } return mTabs.indexOf(tab); } boolean canCreateNewTab() { return mMaxTabs != mTabs.size(); } /** * Returns true if there are any incognito tabs open. * @return True when any incognito tabs are open, false otherwise. */ boolean hasAnyOpenIncognitoTabs() { for (Tab tab : mTabs) { if (tab.getWebView() != null && tab.getWebView().isPrivateBrowsingEnabled()) { return true; } } return false; } /** * Create a new tab. * @return The newly createTab or null if we have reached the maximum * number of open tabs. */ Tab createNewTab(boolean closeOnExit, String appId, String url, boolean privateBrowsing) { int size = mTabs.size(); // Return false if we have maxed out on tabs if (mMaxTabs == size) { return null; } final WebView w = createNewWebView(privateBrowsing); // Create a new tab and add it to the tab list Tab t = new Tab(mController, w, closeOnExit, appId, url); mTabs.add(t); // Initially put the tab in the background. t.putInBackground(); return t; } /** * Create a new tab with default values for closeOnExit(false), * appId(null), url(null), and privateBrowsing(false). */ Tab createNewTab() { return createNewTab(false, null, null, false); } /** * Remove the parent child relationships from all tabs. */ void removeParentChildRelationShips() { for (Tab tab : mTabs) { tab.removeFromTree(); } } /** * Remove the tab from the list. If the tab is the current tab shown, the * last created tab will be shown. * @param t The tab to be removed. */ boolean removeTab(Tab t) { if (t == null) { return false; } // Grab the current tab before modifying the list. Tab current = getCurrentTab(); // Remove t from our list of tabs. mTabs.remove(t); // Put the tab in the background only if it is the current one. if (current == t) { t.putInBackground(); mCurrentTab = -1; } else { // If a tab that is earlier in the list gets removed, the current // index no longer points to the correct tab. mCurrentTab = getTabIndex(current); } // destroy the tab t.destroy(); // clear it's references to parent and children t.removeFromTree(); // The tab indices have shifted, update all the saved state so we point // to the correct index. for (Tab tab : mTabs) { Vector children = tab.getChildTabs(); if (children != null) { for (Tab child : children) { child.setParentTab(tab); } } } // Remove it from the queue of viewed tabs. mTabQueue.remove(t); return true; } /** * Destroy all the tabs and subwindows */ void destroy() { for (Tab t : mTabs) { t.destroy(); } mTabs.clear(); mTabQueue.clear(); } /** * Returns the number of tabs created. * @return The number of tabs created. */ int getTabCount() { return mTabs.size(); } /** * Save the state of all the Tabs. * @param outState The Bundle to save the state to. */ void saveState(Bundle outState) { final int numTabs = getTabCount(); outState.putInt(Tab.NUMTABS, numTabs); final int index = getCurrentIndex(); outState.putInt(Tab.CURRTAB, (index >= 0 && index < numTabs) ? index : 0); for (int i = 0; i < numTabs; i++) { final Tab t = getTab(i); if (t.saveState()) { outState.putBundle(Tab.WEBVIEW + i, t.getSavedState()); } } } /** * Check if the state can be restored. If the state can be restored, the * current tab index is returned. This can be passed to restoreState below * in order to restore the correct tab. Otherwise, -1 is returned and the * state cannot be restored. */ int canRestoreState(Bundle inState, boolean restoreIncognitoTabs) { final int numTabs = (inState == null) ? - 1 : inState.getInt(Tab.NUMTABS, -1); if (numTabs == -1) { return -1; } final int oldCurrentTab = inState.getInt(Tab.CURRTAB, -1); // Determine whether the saved current tab can be restored, and if not, // which tab will take its place. int currentTab = -1; if (restoreIncognitoTabs || !inState.getBundle(Tab.WEBVIEW + oldCurrentTab) .getBoolean(Tab.INCOGNITO)) { currentTab = oldCurrentTab; } else { for (int i = 0; i < numTabs; i++) { if (!inState.getBundle(Tab.WEBVIEW + i) .getBoolean(Tab.INCOGNITO)) { currentTab = i; break; } } } return currentTab; } /** * Restore the state of all the tabs. * @param currentTab The tab index to restore. * @param inState The saved state of all the tabs. * @param restoreIncognitoTabs Restoring private browsing tabs * @param restoreAll All webviews get restored, not just the current tab * (this does not override handling of incognito tabs) * @return True if there were previous tabs that were restored. False if * there was no saved state or restoring the state failed. */ void restoreState(Bundle inState, int currentTab, boolean restoreIncognitoTabs, boolean restoreAll) { if (currentTab == -1) { return; } // If currentTab is valid, numTabs must be present. final int numTabs = inState.getInt(Tab.NUMTABS, -1); // Map saved tab indices to new indices, in case any incognito tabs // need to not be restored. HashMap originalTabIndices = new HashMap(); originalTabIndices.put(-1, -1); for (int i = 0; i < numTabs; i++) { Bundle state = inState.getBundle(Tab.WEBVIEW + i); if (!restoreIncognitoTabs && state != null && state.getBoolean(Tab.INCOGNITO)) { originalTabIndices.put(i, -1); } else if (i == currentTab || restoreAll) { Tab t = createNewTab(); // Me must set the current tab before restoring the state // so that all the client classes are set. if (i == currentTab) { setCurrentTab(t); } if (!t.restoreState(state)) { Log.w(LOGTAG, "Fail in restoreState, load home page."); t.getWebView().loadUrl(BrowserSettings.getInstance() .getHomePage()); } originalTabIndices.put(i, getTabCount() - 1); } else { // Create a new tab and don't restore the state yet, add it // to the tab list Tab t = new Tab(mController, null, false, null, null); if (state != null) { t.setSavedState(state); // Need to maintain the app id and original url so we // can possibly reuse this tab. t.setAppId(state.getString(Tab.APPID)); } mTabs.add(t); // added the tab to the front as they are not current mTabQueue.add(0, t); originalTabIndices.put(i, getTabCount() - 1); } } // Rebuild the tree of tabs. Do this after all tabs have been // created/restored so that the parent tab exists. for (int i = 0; i < numTabs; i++) { final Bundle b = inState.getBundle(Tab.WEBVIEW + i); final Tab t = getTab(i); if (b != null && t != null) { final Integer parentIndex = originalTabIndices.get(b.getInt(Tab.PARENTTAB, -1)); if (parentIndex != -1) { final Tab parent = getTab(parentIndex); if (parent != null) { parent.addChildTab(t); } } } } } /** * Free the memory in this order, 1) free the background tabs; 2) free the * WebView cache; */ void freeMemory() { if (getTabCount() == 0) return; // free the least frequently used background tabs Vector tabs = getHalfLeastUsedTabs(getCurrentTab()); if (tabs.size() > 0) { Log.w(LOGTAG, "Free " + tabs.size() + " tabs in the browser"); for (Tab t : tabs) { // store the WebView's state. t.saveState(); // destroy the tab t.destroy(); } return; } // free the WebView's unused memory (this includes the cache) Log.w(LOGTAG, "Free WebView's unused memory and cache"); WebView view = getCurrentWebView(); if (view != null) { view.freeMemory(); } } private Vector getHalfLeastUsedTabs(Tab current) { Vector tabsToGo = new Vector(); // Don't do anything if we only have 1 tab or if the current tab is // null. if (getTabCount() == 1 || current == null) { return tabsToGo; } if (mTabQueue.size() == 0) { return tabsToGo; } // Rip through the queue starting at the beginning and tear down half of // available tabs which are not the current tab or the parent of the // current tab. int openTabCount = 0; for (Tab t : mTabQueue) { if (t != null && t.getWebView() != null) { openTabCount++; if (t != current && t != current.getParentTab()) { tabsToGo.add(t); } } } openTabCount /= 2; if (tabsToGo.size() > openTabCount) { tabsToGo.setSize(openTabCount); } return tabsToGo; } /** * Show the tab that contains the given WebView. * @param view The WebView used to find the tab. */ Tab getTabFromView(WebView view) { final int size = getTabCount(); for (int i = 0; i < size; i++) { final Tab t = getTab(i); if (t.getSubWebView() == view || t.getWebView() == view) { return t; } } return null; } /** * Return the tab with the matching application id. * @param id The application identifier. */ Tab getTabFromId(String id) { if (id == null) { return null; } final int size = getTabCount(); for (int i = 0; i < size; i++) { final Tab t = getTab(i); if (id.equals(t.getAppId())) { return t; } } return null; } /** * Stop loading in all opened WebView including subWindows. */ void stopAllLoading() { final int size = getTabCount(); for (int i = 0; i < size; i++) { final Tab t = getTab(i); final WebView webview = t.getWebView(); if (webview != null) { webview.stopLoading(); } final WebView subview = t.getSubWebView(); if (subview != null) { webview.stopLoading(); } } } // This method checks if a non-app tab (one created within the browser) // matches the given url. private boolean tabMatchesUrl(Tab t, String url) { if (t.getAppId() != null) { return false; } WebView webview = t.getWebView(); if (webview == null) { return false; } else if (url.equals(webview.getUrl()) || url.equals(webview.getOriginalUrl())) { return true; } return false; } /** * Return the tab that has no app id associated with it and the url of the * tab matches the given url. * @param url The url to search for. */ Tab findUnusedTabWithUrl(String url) { if (url == null) { return null; } // Check the current tab first. Tab t = getCurrentTab(); if (t != null && tabMatchesUrl(t, url)) { return t; } // Now check all the rest. final int size = getTabCount(); for (int i = 0; i < size; i++) { t = getTab(i); if (tabMatchesUrl(t, url)) { return t; } } return null; } /** * Recreate the main WebView of the given tab. */ void recreateWebView(Tab t) { final WebView w = t.getWebView(); if (w != null) { t.destroy(); } // Create a new WebView. If this tab is the current tab, we need to put // back all the clients so force it to be the current tab. t.setWebView(createNewWebView()); if (getCurrentTab() == t) { setCurrentTab(t, true); } // Clear the saved state and picker data t.setSavedState(null); } /** * Creates a new WebView and registers it with the global settings. */ private WebView createNewWebView() { return createNewWebView(false); } /** * Creates a new WebView and registers it with the global settings. * @param privateBrowsing When true, enables private browsing in the new * WebView. */ private WebView createNewWebView(boolean privateBrowsing) { return mController.getWebViewFactory().createWebView(privateBrowsing); } /** * Put the current tab in the background and set newTab as the current tab. * @param newTab The new tab. If newTab is null, the current tab is not * set. */ boolean setCurrentTab(Tab newTab) { return setCurrentTab(newTab, false); } /** * If force is true, this method skips the check for newTab == current. */ private boolean setCurrentTab(Tab newTab, boolean force) { Tab current = getTab(mCurrentTab); if (current == newTab && !force) { return true; } if (current != null) { current.putInBackground(); mCurrentTab = -1; } if (newTab == null) { return false; } // Move the newTab to the end of the queue int index = mTabQueue.indexOf(newTab); if (index != -1) { mTabQueue.remove(index); } mTabQueue.add(newTab); // Display the new current tab mCurrentTab = mTabs.indexOf(newTab); WebView mainView = newTab.getWebView(); boolean needRestore = (mainView == null); if (needRestore) { // Same work as in createNewTab() except don't do new Tab() mainView = createNewWebView(); newTab.setWebView(mainView); } newTab.putInForeground(); if (needRestore) { // Have to finish setCurrentTab work before calling restoreState if (!newTab.restoreState(newTab.getSavedState())) { mainView.loadUrl(BrowserSettings.getInstance().getHomePage()); } } return true; } }