/* * Copyright (C) 2006 The Android Open Source Project * Copyright (c) 2010, The Linux Foundation. All rights reserved. * * 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.content.ContentResolver; import android.content.ContentValues; import android.content.Context; import android.content.Intent; import android.database.Cursor; import android.database.DatabaseUtils; import android.net.Uri; import android.os.AsyncTask; import android.util.Log; import android.webkit.WebIconDatabase; import java.util.Date; public class Browser { private static final String LOGTAG = "browser"; 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. *
* 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. *
* The value is a unique identification string that will be used to * indentify 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). *
*/
public static final String EXTRA_HEADERS = "com.android.browser.headers";
/* if you change column order you must also change indices
below */
public static final String[] HISTORY_PROJECTION = new String[] {
BookmarkColumns._ID, BookmarkColumns.URL, BookmarkColumns.VISITS,
BookmarkColumns.DATE, BookmarkColumns.BOOKMARK, BookmarkColumns.TITLE,
BookmarkColumns.FAVICON, BookmarkColumns.THUMBNAIL,
BookmarkColumns.TOUCH_ICON, BookmarkColumns.USER_ENTERED };
/* these indices dependent on HISTORY_PROJECTION */
public static final int HISTORY_PROJECTION_ID_INDEX = 0;
public static final int HISTORY_PROJECTION_URL_INDEX = 1;
public static final int HISTORY_PROJECTION_VISITS_INDEX = 2;
public static final int HISTORY_PROJECTION_DATE_INDEX = 3;
public static final int HISTORY_PROJECTION_BOOKMARK_INDEX = 4;
public static final int HISTORY_PROJECTION_TITLE_INDEX = 5;
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;
/* columns needed to determine whether to truncate history */
public static final String[] TRUNCATE_HISTORY_PROJECTION = new String[] {
BookmarkColumns._ID, BookmarkColumns.DATE, };
public static final int TRUNCATE_HISTORY_PROJECTION_ID_INDEX = 0;
/* truncate this many history items at a time */
public static final int TRUNCATE_N_OLDEST = 5;
public static final Uri SEARCHES_URI =
Uri.parse("content://browser/searches");
/* if you change column order you must also change indices
below */
public static final String[] SEARCHES_PROJECTION = new String[] {
SearchColumns._ID, SearchColumns.SEARCH, SearchColumns.DATE };
/* these indices dependent on SEARCHES_PROJECTION */
public static final int SEARCHES_PROJECTION_SEARCH_INDEX = 1;
public static final int SEARCHES_PROJECTION_DATE_INDEX = 2;
private static final String SEARCHES_WHERE_CLAUSE = "search = ?";
/* 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 the AddBookmark activity to save a bookmark. Launch with
* and/or url, which can be edited by the user before saving.
* @param c Context used to launch the AddBookmark activity.
* @param title Title for the bookmark. Can be null or empty string.
* @param url Url for the bookmark. Can be null or empty string.
*/
public static final void saveBookmark(Context c,
String title,
String url) {
Intent i = new Intent(Intent.ACTION_INSERT, Browser.BOOKMARKS_URI);
i.putExtra("title", title);
i.putExtra("url", url);
c.startActivity(i);
}
/**
* 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";
public static final void sendString(Context c, String s) {
sendString(c, s, c.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
*/
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 {
c.startActivity(Intent.createChooser(send, chooserDialogTitle));
} catch(android.content.ActivityNotFoundException ex) {
// if no app handles it, do nothing
}
}
/**
* Return a cursor pointing to a list of all the bookmarks.
* Requires {@link android.Manifest.permission#READ_HISTORY_BOOKMARKS}
* @param cr The ContentResolver used to access the database.
*/
public static final Cursor getAllBookmarks(ContentResolver cr) throws
IllegalStateException {
return cr.query(BOOKMARKS_URI,
new String[] { BookmarkColumns.URL },
"bookmark = 1", null, null);
}
/**
* Return a cursor pointing to a list of all visited site urls.
* Requires {@link android.Manifest.permission#READ_HISTORY_BOOKMARKS}
* @param cr The ContentResolver used to access the database.
*/
public static final Cursor getAllVisitedUrls(ContentResolver cr) throws
IllegalStateException {
return cr.query(BOOKMARKS_URI,
new String[] { BookmarkColumns.URL }, null, null, null);
}
private static final void addOrUrlEquals(StringBuilder sb) {
sb.append(" OR " + BookmarkColumns.URL + " = ");
}
/**
* Return a Cursor with all history/bookmarks that are similar to url,
* where similar means 'http(s)://' and 'www.' are optional, but the rest
* of the url is the same.
* @param cr The ContentResolver used to access the database.
* @param url The url to compare to.
* @hide
*/
public static final Cursor getVisitedLike(ContentResolver cr, String url) {
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(BookmarkColumns.URL + " = ");
DatabaseUtils.appendEscapedSQLString(whereClause,
"https://" + compareString);
addOrUrlEquals(whereClause);
DatabaseUtils.appendEscapedSQLString(whereClause,
"https://www." + compareString);
} else {
whereClause = new StringBuilder(BookmarkColumns.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(BOOKMARKS_URI, HISTORY_PROJECTION,
whereClause.toString(), null, null);
}
/**
* Update the visited history to acknowledge that a site has been
* visited.
* Requires {@link android.Manifest.permission#READ_HISTORY_BOOKMARKS}
* Requires {@link android.Manifest.permission#WRITE_HISTORY_BOOKMARKS}
* @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.
*/
public static final void updateVisitedHistory(ContentResolver cr,
String url, boolean real) {
long now = new Date().getTime();
Cursor c = null;
try {
c = getVisitedLike(cr, url);
/* We should only get one answer that is exactly the same. */
if (c.moveToFirst()) {
ContentValues map = new ContentValues();
if (real) {
map.put(BookmarkColumns.VISITS, c
.getInt(HISTORY_PROJECTION_VISITS_INDEX) + 1);
} else {
map.put(BookmarkColumns.USER_ENTERED, 1);
}
map.put(BookmarkColumns.DATE, now);
String[] projection = new String[]
{ Integer.valueOf(c.getInt(0)).toString() };
cr.update(BOOKMARKS_URI, map, "_id = ?", projection);
} else {
truncateHistory(cr);
ContentValues map = new ContentValues();
int visits;
int user_entered;
if (real) {
visits = 1;
user_entered = 0;
} else {
visits = 0;
user_entered = 1;
}
map.put(BookmarkColumns.URL, url);
map.put(BookmarkColumns.VISITS, visits);
map.put(BookmarkColumns.DATE, now);
map.put(BookmarkColumns.BOOKMARK, 0);
map.put(BookmarkColumns.TITLE, url);
map.put(BookmarkColumns.CREATED, 0);
map.put(BookmarkColumns.USER_ENTERED, user_entered);
cr.insert(BOOKMARKS_URI, map);
}
} catch (IllegalStateException e) {
Log.e(LOGTAG, "updateVisitedHistory", e);
} finally {
if (c != null) c.close();
}
}
/**
* Returns all the URLs in the history.
* Requires {@link android.Manifest.permission#READ_HISTORY_BOOKMARKS}
* @param cr The ContentResolver used to access the database.
* @hide pending API council approval
*/
public static final String[] getVisitedHistory(ContentResolver cr) {
Cursor c = null;
String[] str = null;
try {
String[] projection = new String[] {
"url"
};
c = cr.query(BOOKMARKS_URI, projection, "visits > 0", null,
null);
str = new String[c.getCount()];
int i = 0;
while (c.moveToNext()) {
str[i] = c.getString(0);
i++;
}
} catch (IllegalStateException e) {
Log.e(LOGTAG, "getVisitedHistory", e);
str = new String[0];
} finally {
if (c != null) c.close();
}
return str;
}
/**
* Returns top num of visited URLs in the history.
* Requires {@link android.Manifest.permission#READ_HISTORY_BOOKMARKS}
* @param cr The ContentResolver used to access the database.
* @hide pending API council approval
*/
public static final String[] getVisitedHistoryByOrder(ContentResolver cr, String order, int num) {
Cursor c = null;
try {
String[] projection = new String[] {
"url"
};
c = cr.query(BOOKMARKS_URI, projection, "visits > 0", null,
order);
int count = (c.getCount() > num)? num:c.getCount();
String[] str = new String[count];
int i = 0;
while ((i