| /* |
| * Copyright (C) 2006 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 android.provider; |
| |
| import android.compat.annotation.UnsupportedAppUsage; |
| import android.content.ContentResolver; |
| import android.content.Context; |
| import android.content.Intent; |
| import android.database.Cursor; |
| import android.database.DatabaseUtils; |
| import android.database.MatrixCursor; |
| import android.graphics.BitmapFactory; |
| import android.net.Uri; |
| import android.provider.BrowserContract.Bookmarks; |
| import android.provider.BrowserContract.Combined; |
| import android.provider.BrowserContract.History; |
| import android.webkit.WebIconDatabase; |
| |
| public class Browser { |
| private static final String LOGTAG = "browser"; |
| |
| /** |
| * A table containing both bookmarks and history items. The columns of the table are defined in |
| * {@link BookmarkColumns}. |
| * @removed |
| */ |
| public static final Uri BOOKMARKS_URI = Uri.parse("content://browser/bookmarks"); |
| |
| /** |
| * The name of extra data when starting Browser with ACTION_VIEW or |
| * ACTION_SEARCH intent. |
| * <p> |
| * The value should be an integer between 0 and 1000. If not set or set to |
| * 0, the Browser will use default. If set to 100, the Browser will start |
| * with 100%. |
| */ |
| public static final String INITIAL_ZOOM_LEVEL = "browser.initialZoomLevel"; |
| |
| /** |
| * The name of the extra data when starting the Browser from another |
| * application. |
| * <p> |
| * The value is a unique identification string that will be used to |
| * identify the calling application. The Browser will attempt to reuse the |
| * same window each time the application launches the Browser with the same |
| * identifier. |
| */ |
| public static final String EXTRA_APPLICATION_ID = "com.android.browser.application_id"; |
| |
| /** |
| * The name of the extra data in the VIEW intent. The data are key/value |
| * pairs in the format of Bundle. They will be sent in the HTTP request |
| * headers for the provided url. The keys can't be the standard HTTP headers |
| * as they are set by the WebView. The url's schema must be http(s). |
| * <p> |
| */ |
| public static final String EXTRA_HEADERS = "com.android.browser.headers"; |
| |
| /** @removed if you change column order you must also change indices below */ |
| public static final String[] HISTORY_PROJECTION = new String[] { |
| BookmarkColumns._ID, // 0 |
| BookmarkColumns.URL, // 1 |
| BookmarkColumns.VISITS, // 2 |
| BookmarkColumns.DATE, // 3 |
| BookmarkColumns.BOOKMARK, // 4 |
| BookmarkColumns.TITLE, // 5 |
| BookmarkColumns.FAVICON, // 6 |
| BookmarkColumns.THUMBNAIL, // 7 |
| BookmarkColumns.TOUCH_ICON, // 8 |
| BookmarkColumns.USER_ENTERED, // 9 |
| }; |
| |
| /** @removed these indices dependent on HISTORY_PROJECTION */ |
| public static final int HISTORY_PROJECTION_ID_INDEX = 0; |
| |
| /** @removed */ |
| public static final int HISTORY_PROJECTION_URL_INDEX = 1; |
| |
| /** @removed */ |
| public static final int HISTORY_PROJECTION_VISITS_INDEX = 2; |
| |
| /** @removed */ |
| public static final int HISTORY_PROJECTION_DATE_INDEX = 3; |
| |
| /** @removed */ |
| public static final int HISTORY_PROJECTION_BOOKMARK_INDEX = 4; |
| |
| /** @removed */ |
| public static final int HISTORY_PROJECTION_TITLE_INDEX = 5; |
| |
| /** @removed */ |
| public static final int HISTORY_PROJECTION_FAVICON_INDEX = 6; |
| /** |
| * @hide |
| */ |
| public static final int HISTORY_PROJECTION_THUMBNAIL_INDEX = 7; |
| /** |
| * @hide |
| */ |
| public static final int HISTORY_PROJECTION_TOUCH_ICON_INDEX = 8; |
| |
| /** @removed columns needed to determine whether to truncate history @removed */ |
| public static final String[] TRUNCATE_HISTORY_PROJECTION = new String[] { |
| BookmarkColumns._ID, |
| BookmarkColumns.DATE, |
| }; |
| |
| /** @removed */ |
| public static final int TRUNCATE_HISTORY_PROJECTION_ID_INDEX = 0; |
| |
| /** @removed truncate this many history items at a time */ |
| public static final int TRUNCATE_N_OLDEST = 5; |
| |
| /** |
| * A table containing a log of browser searches. The columns of the table are defined in |
| * {@link SearchColumns}. |
| * @removed |
| */ |
| public static final Uri SEARCHES_URI = Uri.parse("content://browser/searches"); |
| |
| /** |
| * A projection of {@link #SEARCHES_URI} that contains {@link SearchColumns#_ID}, |
| * {@link SearchColumns#SEARCH}, and {@link SearchColumns#DATE}. |
| * @removed |
| */ |
| public static final String[] SEARCHES_PROJECTION = new String[] { |
| // if you change column order you must also change indices below |
| SearchColumns._ID, // 0 |
| SearchColumns.SEARCH, // 1 |
| SearchColumns.DATE, // 2 |
| }; |
| |
| /** @removed these indices dependent on SEARCHES_PROJECTION */ |
| public static final int SEARCHES_PROJECTION_SEARCH_INDEX = 1; |
| /** @removed */ |
| public static final int SEARCHES_PROJECTION_DATE_INDEX = 2; |
| |
| /* Set a cap on the count of history items in the history/bookmark |
| table, to prevent db and layout operations from dragging to a |
| crawl. Revisit this cap when/if db/layout performance |
| improvements are made. Note: this does not affect bookmark |
| entries -- if the user wants more bookmarks than the cap, they |
| get them. */ |
| private static final int MAX_HISTORY_COUNT = 250; |
| |
| /** |
| * Open an activity to save a bookmark. Launch with a title |
| * and/or a url, both of which can be edited by the user before saving. |
| * |
| * @param c Context used to launch the activity to add a bookmark. |
| * @param title Title for the bookmark. Can be null or empty string. |
| * @param url Url for the bookmark. Can be null or empty string. |
| * @removed |
| */ |
| public static final void saveBookmark(Context c, |
| String title, |
| String url) { |
| } |
| |
| /** |
| * Boolean extra passed along with an Intent to a browser, specifying that |
| * a new tab be created. Overrides EXTRA_APPLICATION_ID; if both are set, |
| * a new tab will be used, rather than using the same one. |
| */ |
| public static final String EXTRA_CREATE_NEW_TAB = "create_new_tab"; |
| |
| /** |
| * Stores a Bitmap extra in an {@link Intent} representing the screenshot of |
| * a page to share. When receiving an {@link Intent#ACTION_SEND} from the |
| * Browser, use this to access the screenshot. |
| * @hide |
| */ |
| public final static String EXTRA_SHARE_SCREENSHOT = "share_screenshot"; |
| |
| /** |
| * Stores a Bitmap extra in an {@link Intent} representing the favicon of a |
| * page to share. When receiving an {@link Intent#ACTION_SEND} from the |
| * Browser, use this to access the favicon. |
| * @hide |
| */ |
| public final static String EXTRA_SHARE_FAVICON = "share_favicon"; |
| |
| /** |
| * Sends the given string using an Intent with {@link Intent#ACTION_SEND} and a mime type |
| * of text/plain. The string is put into {@link Intent#EXTRA_TEXT}. |
| * |
| * @param context the context used to start the activity |
| * @param string the string to send |
| */ |
| public static final void sendString(Context context, String string) { |
| sendString(context, string, context.getString(com.android.internal.R.string.sendText)); |
| } |
| |
| /** |
| * Find an application to handle the given string and, if found, invoke |
| * it with the given string as a parameter. |
| * @param c Context used to launch the new activity. |
| * @param stringToSend The string to be handled. |
| * @param chooserDialogTitle The title of the dialog that allows the user |
| * to select between multiple applications that are all capable of handling |
| * the string. |
| * @hide pending API council approval |
| */ |
| @UnsupportedAppUsage |
| public static final void sendString(Context c, |
| String stringToSend, |
| String chooserDialogTitle) { |
| Intent send = new Intent(Intent.ACTION_SEND); |
| send.setType("text/plain"); |
| send.putExtra(Intent.EXTRA_TEXT, stringToSend); |
| |
| try { |
| Intent i = Intent.createChooser(send, chooserDialogTitle); |
| // In case this is called from outside an Activity |
| i.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK); |
| c.startActivity(i); |
| } catch(android.content.ActivityNotFoundException ex) { |
| // if no app handles it, do nothing |
| } |
| } |
| |
| /** |
| * Return a cursor pointing to a list of all the bookmarks. The cursor will have a single |
| * column, {@link BookmarkColumns#URL}. |
| * |
| * @param cr The ContentResolver used to access the database. |
| * @removed |
| */ |
| public static final Cursor getAllBookmarks(ContentResolver cr) throws |
| IllegalStateException { |
| android.util.SeempLog.record(32); |
| return new MatrixCursor(new String[]{Bookmarks.URL}, 0); |
| } |
| |
| /** |
| * Return a cursor pointing to a list of all visited site urls. The cursor will |
| * have a single column, {@link BookmarkColumns#URL}. |
| * |
| * @param cr The ContentResolver used to access the database. |
| * @removed |
| */ |
| public static final Cursor getAllVisitedUrls(ContentResolver cr) throws |
| IllegalStateException { |
| android.util.SeempLog.record(33); |
| return new MatrixCursor(new String[]{Combined.URL}, 0); |
| } |
| |
| private static final void addOrUrlEquals(StringBuilder sb) { |
| sb.append(" OR " + BookmarkColumns.URL + " = "); |
| } |
| |
| private static final Cursor getVisitedLike(ContentResolver cr, String url) { |
| android.util.SeempLog.record(34); |
| boolean secure = false; |
| String compareString = url; |
| if (compareString.startsWith("http://")) { |
| compareString = compareString.substring(7); |
| } else if (compareString.startsWith("https://")) { |
| compareString = compareString.substring(8); |
| secure = true; |
| } |
| if (compareString.startsWith("www.")) { |
| compareString = compareString.substring(4); |
| } |
| StringBuilder whereClause = null; |
| if (secure) { |
| whereClause = new StringBuilder(Bookmarks.URL + " = "); |
| DatabaseUtils.appendEscapedSQLString(whereClause, |
| "https://" + compareString); |
| addOrUrlEquals(whereClause); |
| DatabaseUtils.appendEscapedSQLString(whereClause, |
| "https://www." + compareString); |
| } else { |
| whereClause = new StringBuilder(Bookmarks.URL + " = "); |
| DatabaseUtils.appendEscapedSQLString(whereClause, |
| compareString); |
| addOrUrlEquals(whereClause); |
| String wwwString = "www." + compareString; |
| DatabaseUtils.appendEscapedSQLString(whereClause, |
| wwwString); |
| addOrUrlEquals(whereClause); |
| DatabaseUtils.appendEscapedSQLString(whereClause, |
| "http://" + compareString); |
| addOrUrlEquals(whereClause); |
| DatabaseUtils.appendEscapedSQLString(whereClause, |
| "http://" + wwwString); |
| } |
| return cr.query(History.CONTENT_URI, new String[] { History._ID, History.VISITS }, |
| whereClause.toString(), null, null); |
| } |
| |
| /** |
| * Update the visited history to acknowledge that a site has been |
| * visited. |
| * |
| * @param cr The ContentResolver used to access the database. |
| * @param url The site being visited. |
| * @param real If true, this is an actual visit, and should add to the |
| * number of visits. If false, the user entered it manually. |
| * @removed |
| */ |
| public static final void updateVisitedHistory(ContentResolver cr, |
| String url, boolean real) { |
| } |
| |
| /** |
| * Returns all the URLs in the history. |
| * |
| * @param cr The ContentResolver used to access the database. |
| * @hide pending API council approval |
| */ |
| @Deprecated |
| @UnsupportedAppUsage |
| public static final String[] getVisitedHistory(ContentResolver cr) { |
| android.util.SeempLog.record(35); |
| return new String[0]; |
| } |
| |
| /** |
| * If there are more than MAX_HISTORY_COUNT non-bookmark history |
| * items in the bookmark/history table, delete TRUNCATE_N_OLDEST |
| * of them. This is used to keep our history table to a |
| * reasonable size. Note: it does not prune bookmarks. If the |
| * user wants 1000 bookmarks, the user gets 1000 bookmarks. |
| * |
| * @param cr The ContentResolver used to access the database. |
| * @removed |
| */ |
| public static final void truncateHistory(ContentResolver cr) { |
| } |
| |
| /** |
| * Returns whether there is any history to clear. |
| * |
| * @param cr The ContentResolver used to access the database. |
| * @return boolean True if the history can be cleared. |
| * @removed |
| */ |
| public static final boolean canClearHistory(ContentResolver cr) { |
| return false; |
| } |
| |
| /** |
| * Delete all entries from the bookmarks/history table which are |
| * not bookmarks. Also set all visited bookmarks to unvisited. |
| * |
| * @param cr The ContentResolver used to access the database. |
| * @removed |
| */ |
| public static final void clearHistory(ContentResolver cr) { |
| android.util.SeempLog.record(37); |
| |
| } |
| |
| /** |
| * Delete all history items from begin to end. |
| * |
| * @param cr The ContentResolver used to access the database. |
| * @param begin First date to remove. If -1, all dates before end. |
| * Inclusive. |
| * @param end Last date to remove. If -1, all dates after begin. |
| * Non-inclusive. |
| * @removed |
| */ |
| public static final void deleteHistoryTimeFrame(ContentResolver cr, |
| long begin, long end) { |
| } |
| |
| /** |
| * Remove a specific url from the history database. |
| * |
| * @param cr The ContentResolver used to access the database. |
| * @param url url to remove. |
| * @removed |
| */ |
| public static final void deleteFromHistory(ContentResolver cr, |
| String url) { |
| } |
| |
| /** |
| * Add a search string to the searches database. |
| * |
| * @param cr The ContentResolver used to access the database. |
| * @param search The string to add to the searches database. |
| * @removed |
| */ |
| public static final void addSearchUrl(ContentResolver cr, String search) { |
| } |
| |
| /** |
| * Remove all searches from the search database. |
| * |
| * @param cr The ContentResolver used to access the database. |
| * @removed |
| */ |
| public static final void clearSearches(ContentResolver cr) { |
| } |
| |
| /** |
| * Request all icons from the database. This call must either be called |
| * in the main thread or have had Looper.prepare() invoked in the calling |
| * thread. |
| * |
| * @param cr The ContentResolver used to access the database. |
| * @param where Clause to be used to limit the query from the database. |
| * Must be an allowable string to be passed into a database query. |
| * @param listener IconListener that gets the icons once they are |
| * retrieved. |
| * @removed |
| */ |
| public static final void requestAllIcons(ContentResolver cr, String where, |
| WebIconDatabase.IconListener listener) { |
| android.util.SeempLog.record(36); |
| // Do nothing: this is no longer used. |
| } |
| |
| /** |
| * Column definitions for the mixed bookmark and history items available |
| * at {@link #BOOKMARKS_URI}. |
| * @removed |
| */ |
| public static class BookmarkColumns implements BaseColumns { |
| /** |
| * The URL of the bookmark or history item. |
| * <p>Type: TEXT (URL)</p> |
| */ |
| public static final String URL = "url"; |
| |
| /** |
| * The number of time the item has been visited. |
| * <p>Type: NUMBER</p> |
| */ |
| public static final String VISITS = "visits"; |
| |
| /** |
| * The date the item was last visited, in milliseconds since the epoch. |
| * <p>Type: NUMBER (date in milliseconds since January 1, 1970)</p> |
| */ |
| public static final String DATE = "date"; |
| |
| /** |
| * Flag indicating that an item is a bookmark. A value of 1 indicates a bookmark, a value |
| * of 0 indicates a history item. |
| * <p>Type: INTEGER (boolean)</p> |
| */ |
| public static final String BOOKMARK = "bookmark"; |
| |
| /** |
| * The user visible title of the bookmark or history item. |
| * <p>Type: TEXT</p> |
| */ |
| public static final String TITLE = "title"; |
| |
| /** |
| * The date the item created, in milliseconds since the epoch. |
| * <p>Type: NUMBER (date in milliseconds since January 1, 1970)</p> |
| */ |
| public static final String CREATED = "created"; |
| |
| /** |
| * The favicon of the bookmark. Must decode via {@link BitmapFactory#decodeByteArray}. |
| * <p>Type: BLOB (image)</p> |
| */ |
| public static final String FAVICON = "favicon"; |
| |
| /** |
| * @hide |
| */ |
| public static final String THUMBNAIL = "thumbnail"; |
| |
| /** |
| * @hide |
| */ |
| public static final String TOUCH_ICON = "touch_icon"; |
| |
| /** |
| * @hide |
| */ |
| public static final String USER_ENTERED = "user_entered"; |
| } |
| |
| /** |
| * Column definitions for the search history table, available at {@link #SEARCHES_URI}. |
| * @removed |
| */ |
| public static class SearchColumns implements BaseColumns { |
| /** |
| * @deprecated Not used. |
| */ |
| @Deprecated |
| public static final String URL = "url"; |
| |
| /** |
| * The user entered search term. |
| */ |
| public static final String SEARCH = "search"; |
| |
| /** |
| * The date the search was performed, in milliseconds since the epoch. |
| * <p>Type: NUMBER (date in milliseconds since January 1, 1970)</p> |
| */ |
| public static final String DATE = "date"; |
| } |
| } |