chrome/android/java/src/org/chromium/chrome/browser/search_engines/TemplateUrlService.java - chromium/src - Git at Google

 // Copyright 2013 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.

 package org.chromium.chrome.browser.search_engines;

 import android.support.annotation.IntDef;
 import android.text.TextUtils;

 import org.chromium.base.ObserverList;
 import org.chromium.base.ThreadUtils;
 import org.chromium.base.VisibleForTesting;
 import org.chromium.base.annotations.CalledByNative;

 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 import java.util.ArrayList;
 import java.util.List;
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;

 /**
  * Android wrapper of the TemplateUrlService which provides access from the Java
  * layer.
  *
  * Only usable from the UI thread as it's primary purpose is for supporting the Android
  * preferences UI.
  *
  * See components/search_engines/template_url_service.h for more details.
  */
 public class TemplateUrlService {

     /**
      * This listener will be notified when template url service is done loading.
      */
     public interface LoadListener {
         void onTemplateUrlServiceLoaded();
     }

     /**
      * Observer to be notified whenever the set of TemplateURLs are modified.
      */
     public interface TemplateUrlServiceObserver {
         /**
          * Notification that the template url model has changed in some way.
          */
         void onTemplateURLServiceChanged();
     }

     /**
      * Type for default search engine which is not prepopulated. This is needed because
      * if a custom search engine is set as default, it will be moved to the prepopulated list.
      */
     @IntDef({TYPE_DEFAULT, TYPE_PREPOPULATED, TYPE_RECENT})
     @Retention(RetentionPolicy.SOURCE)
     public @interface TemplateUrlType {}
     public static final int TYPE_DEFAULT = 0;
     public static final int TYPE_PREPOPULATED = 1;
     public static final int TYPE_RECENT = 2;

     /**
      * Represents search engine with its index.
      */
     public static class TemplateUrl {
         private final int mIndex;
         private final String mShortName;
         private final String mUrl;
         private final boolean mIsPrepopulated;
         private final String mKeyword;
         @TemplateUrlType private int mTemplateUrlType;

         @CalledByNative("TemplateUrl")
         public static TemplateUrl create(
                 int id, String shortName, String url, boolean isPrepopulated, String keyword) {
             return new TemplateUrl(id, shortName, url, isPrepopulated, keyword);
         }

         public TemplateUrl(
                 int index, String shortName, String url, boolean isPrepopulated, String keyword) {
             mIndex = index;
             mShortName = shortName;
             Pattern pattern = Pattern.compile("[^/]+.com");
             Matcher m = pattern.matcher(url);
             mUrl = m.find() ? m.group(0) : "";
             mIsPrepopulated = isPrepopulated;
             mKeyword = keyword;
         }

         public int getIndex() {
             return mIndex;
         }

         public String getShortName() {
             return mShortName;
         }

         public String getUrl() {
             return mUrl;
         }

         public boolean getIsPrepopulated() {
             return mIsPrepopulated;
         }

         public String getKeyword() {
             return mKeyword;
         }

         public void setType(@TemplateUrlType int templateUrlType) {
             mTemplateUrlType = templateUrlType;
         }

         @TemplateUrlType
         public int getType() {
             return mTemplateUrlType;
         }

         @Override
         public int hashCode() {
             final int prime = 31;
             int result = 1;
             result = prime * result + mIndex;
             result = prime * result + ((mShortName == null) ? 0 : mShortName.hashCode());
             return result;
         }

         @Override
         public boolean equals(Object other) {
             if (!(other instanceof TemplateUrl)) return false;
             TemplateUrl otherTemplateUrl = (TemplateUrl) other;
             return mIndex == otherTemplateUrl.mIndex
                     && TextUtils.equals(mShortName, otherTemplateUrl.mShortName);
         }
     }

     private static TemplateUrlService sService;

     public static TemplateUrlService getInstance() {
         ThreadUtils.assertOnUiThread();
         if (sService == null) {
             sService = new TemplateUrlService();
         }
         return sService;
     }

     private final long mNativeTemplateUrlServiceAndroid;
     private final ObserverList<LoadListener> mLoadListeners = new ObserverList<LoadListener>();
     private final ObserverList<TemplateUrlServiceObserver> mObservers =
             new ObserverList<TemplateUrlServiceObserver>();

     private TemplateUrlService() {
         // Note that this technically leaks the native object, however, TemlateUrlService
         // is a singleton that lives forever and there's no clean shutdown of Chrome on Android
         mNativeTemplateUrlServiceAndroid = nativeInit();
     }

     public boolean isLoaded() {
         ThreadUtils.assertOnUiThread();
         return nativeIsLoaded(mNativeTemplateUrlServiceAndroid);
     }

     public void load() {
         ThreadUtils.assertOnUiThread();
         nativeLoad(mNativeTemplateUrlServiceAndroid);
     }

     /**
      * Returns a list of the prepopulated search engines.
      *
      * Warning: TemplateUrl.getIndex() is *not* an index into this list, since this list contains
      * only prepopulated search engines. E.g. getLocalizedSearchEngines().get(0).getIndex() could
      * return 3.
      */
     public List<TemplateUrl> getSearchEngines() {
         ThreadUtils.assertOnUiThread();
         int defaultSearchEngineIndex = getDefaultSearchEngineIndex();
         int templateUrlCount = nativeGetTemplateUrlCount(mNativeTemplateUrlServiceAndroid);
         List<TemplateUrl> templateUrls = new ArrayList<TemplateUrl>(templateUrlCount);
         for (int i = 0; i < templateUrlCount; i++) {
             TemplateUrl templateUrl = nativeGetTemplateUrlAt(mNativeTemplateUrlServiceAndroid, i);
             if (templateUrl != null) {
                 setSearchEngineType(templateUrl, defaultSearchEngineIndex);
                 templateUrls.add(templateUrl);
             }
         }
         return templateUrls;
     }

     private void setSearchEngineType(TemplateUrl templateUrl, int defaultSearchEngineIndex) {
         if (templateUrl.getIsPrepopulated()) {
             templateUrl.setType(TYPE_PREPOPULATED);
         } else if (templateUrl.getIndex() == defaultSearchEngineIndex) {
             templateUrl.setType(TYPE_DEFAULT);
         } else {
             templateUrl.setType(TYPE_RECENT);
         }
     }

     /**
      * Called from native when template URL service is done loading.
      */
     @CalledByNative
     private void templateUrlServiceLoaded() {
         ThreadUtils.assertOnUiThread();
         for (LoadListener listener : mLoadListeners) {
             listener.onTemplateUrlServiceLoaded();
         }
     }

     @CalledByNative
     private void onTemplateURLServiceChanged() {
         for (TemplateUrlServiceObserver observer : mObservers) {
             observer.onTemplateURLServiceChanged();
         }
     }

     /**
      * @return The default search engine index (e.g., 0, 1, 2,...).
      */
     public int getDefaultSearchEngineIndex() {
         ThreadUtils.assertOnUiThread();
         return nativeGetDefaultSearchProviderIndex(mNativeTemplateUrlServiceAndroid);
     }

     /**
      * @return {@link TemplateUrlService.TemplateUrl} for the default search engine.
      */
     public TemplateUrl getDefaultSearchEngineTemplateUrl() {
         if (!isLoaded()) return null;

         int defaultSearchEngineIndex = getDefaultSearchEngineIndex();
         if (defaultSearchEngineIndex == -1) return null;

         assert defaultSearchEngineIndex >= 0;
         assert defaultSearchEngineIndex < nativeGetTemplateUrlCount(
                 mNativeTemplateUrlServiceAndroid);

         return nativeGetTemplateUrlAt(mNativeTemplateUrlServiceAndroid, defaultSearchEngineIndex);
     }

     public void setSearchEngine(String selectedKeyword) {
         ThreadUtils.assertOnUiThread();
         nativeSetUserSelectedDefaultSearchProvider(
                 mNativeTemplateUrlServiceAndroid, selectedKeyword);
     }

     public boolean isSearchProviderManaged() {
         return nativeIsSearchProviderManaged(mNativeTemplateUrlServiceAndroid);
     }

     /**
      * @return Whether or not the default search engine has search by image support.
      */
     public boolean isSearchByImageAvailable() {
         ThreadUtils.assertOnUiThread();
         return nativeIsSearchByImageAvailable(mNativeTemplateUrlServiceAndroid);
     }

     /**
      * @return Whether the default configured search engine is for a Google property.
      */
     public boolean isDefaultSearchEngineGoogle() {
         return nativeIsDefaultSearchEngineGoogle(mNativeTemplateUrlServiceAndroid);
     }

     /**
      * Registers a listener for the callback that indicates that the
      * TemplateURLService has loaded.
      */
     public void registerLoadListener(final LoadListener listener) {
         ThreadUtils.assertOnUiThread();
         boolean added = mLoadListeners.addObserver(listener);
         assert added;

         // If the load has already been completed, post a load complete to the observer.  Done
         // as an asynchronous call to keep the client code predictable in the loaded/unloaded state.
         if (isLoaded()) {
             ThreadUtils.postOnUiThread(new Runnable() {
                 @Override
                 public void run() {
                     if (!mLoadListeners.hasObserver(listener)) return;

                     listener.onTemplateUrlServiceLoaded();
                 }
             });
         }
     }

     /**
      * Unregisters a listener for the callback that indicates that the
      * TemplateURLService has loaded.
      */
     public void unregisterLoadListener(LoadListener listener) {
         ThreadUtils.assertOnUiThread();
         boolean removed = mLoadListeners.removeObserver(listener);
         assert removed;
     }

     /**
      * Adds an observer to be notified on changes to the template URLs.
      * @param observer The observer to be added.
      */
     public void addObserver(TemplateUrlServiceObserver observer) {
         mObservers.addObserver(observer);
     }

     /**
      * Removes an observer for changes to the template URLs.
      * @param observer The observer to be removed.
      */
     public void removeObserver(TemplateUrlServiceObserver observer) {
         mObservers.removeObserver(observer);
     }

     /**
      * Finds the default search engine for the default provider and returns the url query
      * {@link String} for {@code query}.
      * @param query The {@link String} that represents the text query the search url should
      *              represent.
      * @return      A {@link String} that contains the url of the default search engine with
      *              {@code query} inserted as the search parameter.
      */
     public String getUrlForSearchQuery(String query) {
         return nativeGetUrlForSearchQuery(mNativeTemplateUrlServiceAndroid, query);
     }

     /**
      * Finds the default search engine for the default provider and returns the url query
      * {@link String} for {@code query} with voice input source param set.
      * @param query The {@link String} that represents the text query the search url should
      *              represent.
      * @return      A {@link String} that contains the url of the default search engine with
      *              {@code query} inserted as the search parameter and voice input source param set.
      */
     public String getUrlForVoiceSearchQuery(String query) {
         return nativeGetUrlForVoiceSearchQuery(mNativeTemplateUrlServiceAndroid, query);
     }

     /**
      * Replaces the search terms from {@code query} in {@code url}.
      * @param query The {@link String} that represents the text query that should replace the
      *              existing query in {@code url}.
      * @param url   The {@link String} that contains the search url with another search query that
      *              will be replaced with {@code query}.
      * @return      A new version of {@code url} with the search term replaced with {@code query}.
      */
     public String replaceSearchTermsInUrl(String query, String url) {
         return nativeReplaceSearchTermsInUrl(mNativeTemplateUrlServiceAndroid, query, url);
     }

     /**
      * Finds the default search engine for the default provider and returns the url query
      * {@link String} for {@code query} with the contextual search version param set.
      * @param query The search term to use as the main query in the returned search url.
      * @param alternateTerm The alternate search term to use as an alternate suggestion.
      * @param shouldPrefetch Whether the returned url should include a prefetch parameter.
      * @param protocolVersion The version of the Contextual Search API protocol to use.
      * @return      A {@link String} that contains the url of the default search engine with
      *              {@code query} and {@code alternateTerm} inserted as parameters and contextual
      *              search and prefetch parameters conditionally set.
      */
     public String getUrlForContextualSearchQuery(
             String query, String alternateTerm, boolean shouldPrefetch, String protocolVersion) {
         return nativeGetUrlForContextualSearchQuery(mNativeTemplateUrlServiceAndroid, query,
                 alternateTerm, shouldPrefetch, protocolVersion);
     }

     /**
      * Finds the URL for the search engine at the given index.
      * @param index The templateUrl index to look up.
      * @return      A {@link String} that contains the url of the specified search engine.
      */
     public String getSearchEngineUrlFromTemplateUrl(String keyword) {
         return nativeGetSearchEngineUrlFromTemplateUrl(mNativeTemplateUrlServiceAndroid, keyword);
     }

     @VisibleForTesting
     public String addSearchEngineForTesting(String keyword, int ageInDays) {
         return nativeAddSearchEngineForTesting(
                 mNativeTemplateUrlServiceAndroid, keyword, ageInDays);
     }

     @VisibleForTesting
     public String updateLastVisitedForTesting(String keyword) {
         return nativeUpdateLastVisitedForTesting(mNativeTemplateUrlServiceAndroid, keyword);
     }

     private native long nativeInit();
     private native void nativeLoad(long nativeTemplateUrlServiceAndroid);
     private native boolean nativeIsLoaded(long nativeTemplateUrlServiceAndroid);
     private native int nativeGetTemplateUrlCount(long nativeTemplateUrlServiceAndroid);
     private native TemplateUrl nativeGetTemplateUrlAt(long nativeTemplateUrlServiceAndroid, int i);
     private native void nativeSetUserSelectedDefaultSearchProvider(
             long nativeTemplateUrlServiceAndroid, String selectedKeyword);
     private native int nativeGetDefaultSearchProviderIndex(long nativeTemplateUrlServiceAndroid);
     private native boolean nativeIsSearchProviderManaged(long nativeTemplateUrlServiceAndroid);
     private native boolean nativeIsSearchByImageAvailable(long nativeTemplateUrlServiceAndroid);
     private native boolean nativeIsDefaultSearchEngineGoogle(long nativeTemplateUrlServiceAndroid);
     private native String nativeGetUrlForSearchQuery(long nativeTemplateUrlServiceAndroid,
             String query);
     private native String nativeGetUrlForVoiceSearchQuery(long nativeTemplateUrlServiceAndroid,
             String query);
     private native String nativeReplaceSearchTermsInUrl(long nativeTemplateUrlServiceAndroid,
             String query, String currentUrl);
     private native String nativeGetUrlForContextualSearchQuery(long nativeTemplateUrlServiceAndroid,
             String query, String alternateTerm, boolean shouldPrefetch, String protocolVersion);
     private native String nativeGetSearchEngineUrlFromTemplateUrl(
             long nativeTemplateUrlServiceAndroid, String keyword);
     private native String nativeAddSearchEngineForTesting(
             long nativeTemplateUrlServiceAndroid, String keyword, int offset);
     private native String nativeUpdateLastVisitedForTesting(
             long nativeTemplateUrlServiceAndroid, String keyword);
 }
	// Copyright 2013 The Chromium Authors. All rights reserved.
	// Use of this source code is governed by a BSD-style license that can be
	// found in the LICENSE file.

	package org.chromium.chrome.browser.search_engines;

	import android.support.annotation.IntDef;
	import android.text.TextUtils;

	import org.chromium.base.ObserverList;
	import org.chromium.base.ThreadUtils;
	import org.chromium.base.VisibleForTesting;
	import org.chromium.base.annotations.CalledByNative;

	import java.lang.annotation.Retention;
	import java.lang.annotation.RetentionPolicy;
	import java.util.ArrayList;
	import java.util.List;
	import java.util.regex.Matcher;
	import java.util.regex.Pattern;

	/**
	* Android wrapper of the TemplateUrlService which provides access from the Java
	* layer.
	*
	* Only usable from the UI thread as it's primary purpose is for supporting the Android
	* preferences UI.
	*
	* See components/search_engines/template_url_service.h for more details.
	*/
	public class TemplateUrlService {

	/**
	* This listener will be notified when template url service is done loading.
	*/
	public interface LoadListener {
	void onTemplateUrlServiceLoaded();
	}

	/**
	* Observer to be notified whenever the set of TemplateURLs are modified.
	*/
	public interface TemplateUrlServiceObserver {
	/**
	* Notification that the template url model has changed in some way.
	*/
	void onTemplateURLServiceChanged();
	}

	/**
	* Type for default search engine which is not prepopulated. This is needed because
	* if a custom search engine is set as default, it will be moved to the prepopulated list.
	*/
	@IntDef({TYPE_DEFAULT, TYPE_PREPOPULATED, TYPE_RECENT})
	@Retention(RetentionPolicy.SOURCE)
	public @interface TemplateUrlType {}
	public static final int TYPE_DEFAULT = 0;
	public static final int TYPE_PREPOPULATED = 1;
	public static final int TYPE_RECENT = 2;

	/**
	* Represents search engine with its index.
	*/
	public static class TemplateUrl {
	private final int mIndex;
	private final String mShortName;
	private final String mUrl;
	private final boolean mIsPrepopulated;
	private final String mKeyword;
	@TemplateUrlType private int mTemplateUrlType;

	@CalledByNative("TemplateUrl")
	public static TemplateUrl create(
	int id, String shortName, String url, boolean isPrepopulated, String keyword) {
	return new TemplateUrl(id, shortName, url, isPrepopulated, keyword);
	}

	public TemplateUrl(
	int index, String shortName, String url, boolean isPrepopulated, String keyword) {
	mIndex = index;
	mShortName = shortName;
	Pattern pattern = Pattern.compile("[^/]+.com");
	Matcher m = pattern.matcher(url);
	mUrl = m.find() ? m.group(0) : "";
	mIsPrepopulated = isPrepopulated;
	mKeyword = keyword;
	}

	public int getIndex() {
	return mIndex;
	}

	public String getShortName() {
	return mShortName;
	}

	public String getUrl() {
	return mUrl;
	}

	public boolean getIsPrepopulated() {
	return mIsPrepopulated;
	}

	public String getKeyword() {
	return mKeyword;
	}

	public void setType(@TemplateUrlType int templateUrlType) {
	mTemplateUrlType = templateUrlType;
	}

	@TemplateUrlType
	public int getType() {
	return mTemplateUrlType;
	}

	@Override
	public int hashCode() {
	final int prime = 31;
	int result = 1;
	result = prime * result + mIndex;
	result = prime * result + ((mShortName == null) ? 0 : mShortName.hashCode());
	return result;
	}

	@Override
	public boolean equals(Object other) {
	if (!(other instanceof TemplateUrl)) return false;
	TemplateUrl otherTemplateUrl = (TemplateUrl) other;
	return mIndex == otherTemplateUrl.mIndex
	&& TextUtils.equals(mShortName, otherTemplateUrl.mShortName);
	}
	}

	private static TemplateUrlService sService;

	public static TemplateUrlService getInstance() {
	ThreadUtils.assertOnUiThread();
	if (sService == null) {
	sService = new TemplateUrlService();
	}
	return sService;
	}

	private final long mNativeTemplateUrlServiceAndroid;
	private final ObserverList<LoadListener> mLoadListeners = new ObserverList<LoadListener>();
	private final ObserverList<TemplateUrlServiceObserver> mObservers =
	new ObserverList<TemplateUrlServiceObserver>();

	private TemplateUrlService() {
	// Note that this technically leaks the native object, however, TemlateUrlService
	// is a singleton that lives forever and there's no clean shutdown of Chrome on Android
	mNativeTemplateUrlServiceAndroid = nativeInit();
	}

	public boolean isLoaded() {
	ThreadUtils.assertOnUiThread();
	return nativeIsLoaded(mNativeTemplateUrlServiceAndroid);
	}

	public void load() {
	ThreadUtils.assertOnUiThread();
	nativeLoad(mNativeTemplateUrlServiceAndroid);
	}

	/**
	* Returns a list of the prepopulated search engines.
	*
	* Warning: TemplateUrl.getIndex() is not an index into this list, since this list contains
	* only prepopulated search engines. E.g. getLocalizedSearchEngines().get(0).getIndex() could
	* return 3.
	*/
	public List<TemplateUrl> getSearchEngines() {
	ThreadUtils.assertOnUiThread();
	int defaultSearchEngineIndex = getDefaultSearchEngineIndex();
	int templateUrlCount = nativeGetTemplateUrlCount(mNativeTemplateUrlServiceAndroid);
	List<TemplateUrl> templateUrls = new ArrayList<TemplateUrl>(templateUrlCount);
	for (int i = 0; i < templateUrlCount; i++) {
	TemplateUrl templateUrl = nativeGetTemplateUrlAt(mNativeTemplateUrlServiceAndroid, i);
	if (templateUrl != null) {
	setSearchEngineType(templateUrl, defaultSearchEngineIndex);
	templateUrls.add(templateUrl);
	}
	}
	return templateUrls;
	}

	private void setSearchEngineType(TemplateUrl templateUrl, int defaultSearchEngineIndex) {
	if (templateUrl.getIsPrepopulated()) {
	templateUrl.setType(TYPE_PREPOPULATED);
	} else if (templateUrl.getIndex() == defaultSearchEngineIndex) {
	templateUrl.setType(TYPE_DEFAULT);
	} else {
	templateUrl.setType(TYPE_RECENT);
	}
	}

	/**
	* Called from native when template URL service is done loading.
	*/
	@CalledByNative
	private void templateUrlServiceLoaded() {
	ThreadUtils.assertOnUiThread();
	for (LoadListener listener : mLoadListeners) {
	listener.onTemplateUrlServiceLoaded();
	}
	}

	@CalledByNative
	private void onTemplateURLServiceChanged() {
	for (TemplateUrlServiceObserver observer : mObservers) {
	observer.onTemplateURLServiceChanged();
	}
	}

	/**
	* @return The default search engine index (e.g., 0, 1, 2,...).
	*/
	public int getDefaultSearchEngineIndex() {
	ThreadUtils.assertOnUiThread();
	return nativeGetDefaultSearchProviderIndex(mNativeTemplateUrlServiceAndroid);
	}

	/**
	* @return {@link TemplateUrlService.TemplateUrl} for the default search engine.
	*/
	public TemplateUrl getDefaultSearchEngineTemplateUrl() {
	if (!isLoaded()) return null;

	int defaultSearchEngineIndex = getDefaultSearchEngineIndex();
	if (defaultSearchEngineIndex == -1) return null;

	assert defaultSearchEngineIndex >= 0;
	assert defaultSearchEngineIndex < nativeGetTemplateUrlCount(
	mNativeTemplateUrlServiceAndroid);

	return nativeGetTemplateUrlAt(mNativeTemplateUrlServiceAndroid, defaultSearchEngineIndex);
	}

	public void setSearchEngine(String selectedKeyword) {
	ThreadUtils.assertOnUiThread();
	nativeSetUserSelectedDefaultSearchProvider(
	mNativeTemplateUrlServiceAndroid, selectedKeyword);
	}

	public boolean isSearchProviderManaged() {
	return nativeIsSearchProviderManaged(mNativeTemplateUrlServiceAndroid);
	}

	/**
	* @return Whether or not the default search engine has search by image support.
	*/
	public boolean isSearchByImageAvailable() {
	ThreadUtils.assertOnUiThread();
	return nativeIsSearchByImageAvailable(mNativeTemplateUrlServiceAndroid);
	}

	/**
	* @return Whether the default configured search engine is for a Google property.
	*/
	public boolean isDefaultSearchEngineGoogle() {
	return nativeIsDefaultSearchEngineGoogle(mNativeTemplateUrlServiceAndroid);
	}

	/**
	* Registers a listener for the callback that indicates that the
	* TemplateURLService has loaded.
	*/
	public void registerLoadListener(final LoadListener listener) {
	ThreadUtils.assertOnUiThread();
	boolean added = mLoadListeners.addObserver(listener);
	assert added;

	// If the load has already been completed, post a load complete to the observer. Done
	// as an asynchronous call to keep the client code predictable in the loaded/unloaded state.
	if (isLoaded()) {
	ThreadUtils.postOnUiThread(new Runnable() {
	@Override
	public void run() {
	if (!mLoadListeners.hasObserver(listener)) return;

	listener.onTemplateUrlServiceLoaded();
	}
	});
	}
	}

	/**
	* Unregisters a listener for the callback that indicates that the
	* TemplateURLService has loaded.
	*/
	public void unregisterLoadListener(LoadListener listener) {
	ThreadUtils.assertOnUiThread();
	boolean removed = mLoadListeners.removeObserver(listener);
	assert removed;
	}

	/**
	* Adds an observer to be notified on changes to the template URLs.
	* @param observer The observer to be added.
	*/
	public void addObserver(TemplateUrlServiceObserver observer) {
	mObservers.addObserver(observer);
	}

	/**
	* Removes an observer for changes to the template URLs.
	* @param observer The observer to be removed.
	*/
	public void removeObserver(TemplateUrlServiceObserver observer) {
	mObservers.removeObserver(observer);
	}

	/**
	* Finds the default search engine for the default provider and returns the url query
	* {@link String} for {@code query}.
	* @param query The {@link String} that represents the text query the search url should
	* represent.
	* @return A {@link String} that contains the url of the default search engine with
	* {@code query} inserted as the search parameter.
	*/
	public String getUrlForSearchQuery(String query) {
	return nativeGetUrlForSearchQuery(mNativeTemplateUrlServiceAndroid, query);
	}

	/**
	* Finds the default search engine for the default provider and returns the url query
	* {@link String} for {@code query} with voice input source param set.
	* @param query The {@link String} that represents the text query the search url should
	* represent.
	* @return A {@link String} that contains the url of the default search engine with
	* {@code query} inserted as the search parameter and voice input source param set.
	*/
	public String getUrlForVoiceSearchQuery(String query) {
	return nativeGetUrlForVoiceSearchQuery(mNativeTemplateUrlServiceAndroid, query);
	}

	/**
	* Replaces the search terms from {@code query} in {@code url}.
	* @param query The {@link String} that represents the text query that should replace the
	* existing query in {@code url}.
	* @param url The {@link String} that contains the search url with another search query that
	* will be replaced with {@code query}.
	* @return A new version of {@code url} with the search term replaced with {@code query}.
	*/
	public String replaceSearchTermsInUrl(String query, String url) {
	return nativeReplaceSearchTermsInUrl(mNativeTemplateUrlServiceAndroid, query, url);
	}

	/**
	* Finds the default search engine for the default provider and returns the url query
	* {@link String} for {@code query} with the contextual search version param set.
	* @param query The search term to use as the main query in the returned search url.
	* @param alternateTerm The alternate search term to use as an alternate suggestion.
	* @param shouldPrefetch Whether the returned url should include a prefetch parameter.
	* @param protocolVersion The version of the Contextual Search API protocol to use.
	* @return A {@link String} that contains the url of the default search engine with
	* {@code query} and {@code alternateTerm} inserted as parameters and contextual
	* search and prefetch parameters conditionally set.
	*/
	public String getUrlForContextualSearchQuery(
	String query, String alternateTerm, boolean shouldPrefetch, String protocolVersion) {
	return nativeGetUrlForContextualSearchQuery(mNativeTemplateUrlServiceAndroid, query,
	alternateTerm, shouldPrefetch, protocolVersion);
	}

	/**
	* Finds the URL for the search engine at the given index.
	* @param index The templateUrl index to look up.
	* @return A {@link String} that contains the url of the specified search engine.
	*/
	public String getSearchEngineUrlFromTemplateUrl(String keyword) {
	return nativeGetSearchEngineUrlFromTemplateUrl(mNativeTemplateUrlServiceAndroid, keyword);
	}

	@VisibleForTesting
	public String addSearchEngineForTesting(String keyword, int ageInDays) {
	return nativeAddSearchEngineForTesting(
	mNativeTemplateUrlServiceAndroid, keyword, ageInDays);
	}

	@VisibleForTesting
	public String updateLastVisitedForTesting(String keyword) {
	return nativeUpdateLastVisitedForTesting(mNativeTemplateUrlServiceAndroid, keyword);
	}

	private native long nativeInit();
	private native void nativeLoad(long nativeTemplateUrlServiceAndroid);
	private native boolean nativeIsLoaded(long nativeTemplateUrlServiceAndroid);
	private native int nativeGetTemplateUrlCount(long nativeTemplateUrlServiceAndroid);
	private native TemplateUrl nativeGetTemplateUrlAt(long nativeTemplateUrlServiceAndroid, int i);
	private native void nativeSetUserSelectedDefaultSearchProvider(
	long nativeTemplateUrlServiceAndroid, String selectedKeyword);
	private native int nativeGetDefaultSearchProviderIndex(long nativeTemplateUrlServiceAndroid);
	private native boolean nativeIsSearchProviderManaged(long nativeTemplateUrlServiceAndroid);
	private native boolean nativeIsSearchByImageAvailable(long nativeTemplateUrlServiceAndroid);
	private native boolean nativeIsDefaultSearchEngineGoogle(long nativeTemplateUrlServiceAndroid);
	private native String nativeGetUrlForSearchQuery(long nativeTemplateUrlServiceAndroid,
	String query);
	private native String nativeGetUrlForVoiceSearchQuery(long nativeTemplateUrlServiceAndroid,
	String query);
	private native String nativeReplaceSearchTermsInUrl(long nativeTemplateUrlServiceAndroid,
	String query, String currentUrl);
	private native String nativeGetUrlForContextualSearchQuery(long nativeTemplateUrlServiceAndroid,
	String query, String alternateTerm, boolean shouldPrefetch, String protocolVersion);
	private native String nativeGetSearchEngineUrlFromTemplateUrl(
	long nativeTemplateUrlServiceAndroid, String keyword);
	private native String nativeAddSearchEngineForTesting(
	long nativeTemplateUrlServiceAndroid, String keyword, int offset);
	private native String nativeUpdateLastVisitedForTesting(
	long nativeTemplateUrlServiceAndroid, String keyword);
	}