content: /*
   * 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.annotation.UnsupportedAppUsage;
  import android.content.ContentResolver;
  import android.content.ContentUris;
  import android.content.ContentValues;
  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.provider.BrowserContract.Searches;
  import android.util.Log;
  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 {
          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 {
          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) {
          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) {
          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) {
  
      }
  
      /**
       * 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) {
          // 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";
      }
  }
  