public class Browser extends Object
Modifier and Type | Class and Description |
---|---|
static class |
Browser.BookmarkColumns
Column definitions for the mixed bookmark and history items available
at
BOOKMARKS_URI . |
static class |
Browser.SearchColumns
Column definitions for the search history table, available at
SEARCHES_URI . |
Modifier and Type | Field and Description |
---|---|
static Uri |
BOOKMARKS_URI
A table containing both bookmarks and history items.
|
static String |
EXTRA_APPLICATION_ID
The name of the extra data when starting the Browser from another
application.
|
static String |
EXTRA_CREATE_NEW_TAB
Boolean extra passed along with an Intent to a browser, specifying that
a new tab be created.
|
static String |
EXTRA_HEADERS
The name of the extra data in the VIEW intent.
|
static String |
EXTRA_SHARE_FAVICON
Stores a Bitmap extra in an
Intent representing the favicon of a
page to share. |
static String |
EXTRA_SHARE_SCREENSHOT
Stores a Bitmap extra in an
Intent representing the screenshot of
a page to share. |
static String[] |
HISTORY_PROJECTION |
static int |
HISTORY_PROJECTION_BOOKMARK_INDEX |
static int |
HISTORY_PROJECTION_DATE_INDEX |
static int |
HISTORY_PROJECTION_FAVICON_INDEX |
static int |
HISTORY_PROJECTION_ID_INDEX |
static int |
HISTORY_PROJECTION_THUMBNAIL_INDEX |
static int |
HISTORY_PROJECTION_TITLE_INDEX |
static int |
HISTORY_PROJECTION_TOUCH_ICON_INDEX |
static int |
HISTORY_PROJECTION_URL_INDEX |
static int |
HISTORY_PROJECTION_VISITS_INDEX |
static String |
INITIAL_ZOOM_LEVEL
The name of extra data when starting Browser with ACTION_VIEW or
ACTION_SEARCH intent.
|
static String[] |
SEARCHES_PROJECTION
A projection of
SEARCHES_URI that contains BaseColumns._ID ,
Browser.SearchColumns.SEARCH , and Browser.SearchColumns.DATE . |
static int |
SEARCHES_PROJECTION_DATE_INDEX |
static int |
SEARCHES_PROJECTION_SEARCH_INDEX |
static Uri |
SEARCHES_URI
A table containing a log of browser searches.
|
static String[] |
TRUNCATE_HISTORY_PROJECTION |
static int |
TRUNCATE_HISTORY_PROJECTION_ID_INDEX |
static int |
TRUNCATE_N_OLDEST |
Constructor and Description |
---|
Browser() |
Modifier and Type | Method and Description |
---|---|
static void |
addSearchUrl(ContentResolver cr,
String search)
Add a search string to the searches database.
|
static boolean |
canClearHistory(ContentResolver cr)
Returns whether there is any history to clear.
|
static void |
clearHistory(ContentResolver cr)
Delete all entries from the bookmarks/history table which are
not bookmarks.
|
static void |
clearSearches(ContentResolver cr)
Remove all searches from the search database.
|
static void |
deleteFromHistory(ContentResolver cr,
String url)
Remove a specific url from the history database.
|
static void |
deleteHistoryTimeFrame(ContentResolver cr,
long begin,
long end)
Delete all history items from begin to end.
|
static Cursor |
getAllBookmarks(ContentResolver cr)
Return a cursor pointing to a list of all the bookmarks.
|
static Cursor |
getAllVisitedUrls(ContentResolver cr)
Return a cursor pointing to a list of all visited site urls.
|
static String[] |
getVisitedHistory(ContentResolver cr)
Returns all the URLs in the history.
|
static void |
requestAllIcons(ContentResolver cr,
String where,
WebIconDatabase.IconListener listener)
Request all icons from the database.
|
static void |
saveBookmark(Context c,
String title,
String url)
Open an activity to save a bookmark.
|
static void |
sendString(Context context,
String string)
Sends the given string using an Intent with
Intent.ACTION_SEND and a mime type
of text/plain. |
static void |
sendString(Context c,
String stringToSend,
String chooserDialogTitle)
Find an application to handle the given string and, if found, invoke
it with the given string as a parameter.
|
static void |
truncateHistory(ContentResolver cr)
If there are more than MAX_HISTORY_COUNT non-bookmark history
items in the bookmark/history table, delete TRUNCATE_N_OLDEST
of them.
|
static void |
updateVisitedHistory(ContentResolver cr,
String url,
boolean real)
Update the visited history to acknowledge that a site has been
visited.
|
public static final Uri BOOKMARKS_URI
Browser.BookmarkColumns
. Reading this table requires the
android.Manifest.permission#READ_HISTORY_BOOKMARKS
permission and writing to it
requires the android.Manifest.permission#WRITE_HISTORY_BOOKMARKS
permission.public static final String INITIAL_ZOOM_LEVEL
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 EXTRA_APPLICATION_ID
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_HEADERS
public static final String[] HISTORY_PROJECTION
public static final int HISTORY_PROJECTION_ID_INDEX
public static final int HISTORY_PROJECTION_URL_INDEX
public static final int HISTORY_PROJECTION_VISITS_INDEX
public static final int HISTORY_PROJECTION_DATE_INDEX
public static final int HISTORY_PROJECTION_BOOKMARK_INDEX
public static final int HISTORY_PROJECTION_TITLE_INDEX
public static final int HISTORY_PROJECTION_FAVICON_INDEX
public static final int HISTORY_PROJECTION_THUMBNAIL_INDEX
public static final int HISTORY_PROJECTION_TOUCH_ICON_INDEX
public static final String[] TRUNCATE_HISTORY_PROJECTION
public static final int TRUNCATE_HISTORY_PROJECTION_ID_INDEX
public static final int TRUNCATE_N_OLDEST
public static final Uri SEARCHES_URI
Browser.SearchColumns
. Reading this table requires the
android.Manifest.permission#READ_HISTORY_BOOKMARKS
permission and writing to it
requires the android.Manifest.permission#WRITE_HISTORY_BOOKMARKS
permission.public static final String[] SEARCHES_PROJECTION
SEARCHES_URI
that contains BaseColumns._ID
,
Browser.SearchColumns.SEARCH
, and Browser.SearchColumns.DATE
.public static final int SEARCHES_PROJECTION_SEARCH_INDEX
public static final int SEARCHES_PROJECTION_DATE_INDEX
public static final String EXTRA_CREATE_NEW_TAB
public static final String EXTRA_SHARE_SCREENSHOT
Intent
representing the screenshot of
a page to share. When receiving an Intent.ACTION_SEND
from the
Browser, use this to access the screenshot.public static final String EXTRA_SHARE_FAVICON
Intent
representing the favicon of a
page to share. When receiving an Intent.ACTION_SEND
from the
Browser, use this to access the favicon.public static final void saveBookmark(Context c, String title, String url)
c
- Context used to launch the activity to add a bookmark.title
- Title for the bookmark. Can be null or empty string.url
- Url for the bookmark. Can be null or empty string.public static final void sendString(Context context, String string)
Intent.ACTION_SEND
and a mime type
of text/plain. The string is put into Intent.EXTRA_TEXT
.context
- the context used to start the activitystring
- the string to sendpublic static final void sendString(Context c, String stringToSend, String chooserDialogTitle)
c
- Context used to launch the new activity.stringToSend
- The string to be handled.chooserDialogTitle
- The title of the dialog that allows the user
to select between multiple applications that are all capable of handling
the string.public static final Cursor getAllBookmarks(ContentResolver cr) throws IllegalStateException
Browser.BookmarkColumns.URL
.
Requires android.Manifest.permission#READ_HISTORY_BOOKMARKS
cr
- The ContentResolver used to access the database.IllegalStateException
public static final Cursor getAllVisitedUrls(ContentResolver cr) throws IllegalStateException
Browser.BookmarkColumns.URL
.
Requires android.Manifest.permission#READ_HISTORY_BOOKMARKS
cr
- The ContentResolver used to access the database.IllegalStateException
public static final void updateVisitedHistory(ContentResolver cr, String url, boolean real)
android.Manifest.permission#READ_HISTORY_BOOKMARKS
Requires android.Manifest.permission#WRITE_HISTORY_BOOKMARKS
cr
- The ContentResolver used to access the database.url
- The site being visited.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 String[] getVisitedHistory(ContentResolver cr)
android.Manifest.permission#READ_HISTORY_BOOKMARKS
cr
- The ContentResolver used to access the database.public static final void truncateHistory(ContentResolver cr)
android.Manifest.permission#READ_HISTORY_BOOKMARKS
Requires android.Manifest.permission#WRITE_HISTORY_BOOKMARKS
cr
- The ContentResolver used to access the database.public static final boolean canClearHistory(ContentResolver cr)
android.Manifest.permission#READ_HISTORY_BOOKMARKS
cr
- The ContentResolver used to access the database.public static final void clearHistory(ContentResolver cr)
android.Manifest.permission#WRITE_HISTORY_BOOKMARKS
cr
- The ContentResolver used to access the database.public static final void deleteHistoryTimeFrame(ContentResolver cr, long begin, long end)
android.Manifest.permission#WRITE_HISTORY_BOOKMARKS
cr
- The ContentResolver used to access the database.begin
- First date to remove. If -1, all dates before end.
Inclusive.end
- Last date to remove. If -1, all dates after begin.
Non-inclusive.public static final void deleteFromHistory(ContentResolver cr, String url)
android.Manifest.permission#WRITE_HISTORY_BOOKMARKS
cr
- The ContentResolver used to access the database.url
- url to remove.public static final void addSearchUrl(ContentResolver cr, String search)
android.Manifest.permission#READ_HISTORY_BOOKMARKS
Requires android.Manifest.permission#WRITE_HISTORY_BOOKMARKS
cr
- The ContentResolver used to access the database.search
- The string to add to the searches database.public static final void clearSearches(ContentResolver cr)
android.Manifest.permission#WRITE_HISTORY_BOOKMARKS
cr
- The ContentResolver used to access the database.public static final void requestAllIcons(ContentResolver cr, String where, WebIconDatabase.IconListener listener)
android.Manifest.permission#READ_HISTORY_BOOKMARKS
cr
- The ContentResolver used to access the database.where
- Clause to be used to limit the query from the database.
Must be an allowable string to be passed into a database query.listener
- IconListener that gets the icons once they are
retrieved.