CommonIntentsFacade.java

package com.googlecode.android_scripting.facade;

import java.io.File;

import org.json.JSONException;
import org.json.JSONObject;

import android.app.SearchManager;
import android.content.Intent;
import android.net.Uri;
import android.provider.Contacts.People;

import com.googlecode.android_scripting.jsonrpc.RpcReceiver;
import com.googlecode.android_scripting.rpc.Rpc;
import com.googlecode.android_scripting.rpc.RpcOptional;
import com.googlecode.android_scripting.rpc.RpcParameter;

/**
 * A selection of commonly used intents. <br>
 * <br>
 * These can be used to trigger some common tasks.
 * 
 */
@SuppressWarnings("deprecation")
public class CommonIntentsFacade extends RpcReceiver {

	private final AndroidFacade mAndroidFacade;

	public CommonIntentsFacade(FacadeManager manager) {
		super(manager);
		mAndroidFacade = manager.getReceiver(AndroidFacade.class);
	}

	@Override
	public void shutdown() {
	}

	@Rpc(description = "Display content to be picked by URI (e.g. contacts)", returns = "A map of result values.")
	public Intent pick(@RpcParameter(name = "uri") String uri)
			throws JSONException {
		return mAndroidFacade.startActivityForResult(Intent.ACTION_PICK, uri,
				null, null, null, null);
	}

	@Rpc(description = "Starts the barcode scanner.", returns = "A Map representation of the result Intent.")
	public Intent scanBarcode() throws JSONException {
		return mAndroidFacade.startActivityForResult(
				"com.google.zxing.client.android.SCAN", null, null, null, null,
				null);
	}

	private void view(Uri uri, String type) {
		Intent intent = new Intent(Intent.ACTION_VIEW);
		intent.setDataAndType(uri, type);
		mAndroidFacade.startActivity(intent);
	}

	@Rpc(description = "Start activity with view action by URI (i.e. browser, contacts, etc.).")
	public void view(
			@RpcParameter(name = "uri") String uri,
			@RpcParameter(name = "type", description = "MIME type/subtype of the URI") @RpcOptional String type,
			@RpcParameter(name = "extras", description = "a Map of extras to add to the Intent") @RpcOptional JSONObject extras)
			throws Exception {
		mAndroidFacade.startActivity(Intent.ACTION_VIEW, uri, type, extras,
				true, null, null);
	}

	@Rpc(description = "Opens a map search for query (e.g. pizza, 123 My Street).")
	public void viewMap(
			@RpcParameter(name = "query, e.g. pizza, 123 My Street") String query)
			throws Exception {
		view("geo:0,0?q=" + query, null, null);
	}

	@Rpc(description = "Opens the list of contacts.")
	public void viewContacts() throws JSONException {
		view(People.CONTENT_URI, null);
	}

	@Rpc(description = "Opens the browser to display a local HTML file.")
	public void viewHtml(
			@RpcParameter(name = "path", description = "the path to the HTML file") String path)
			throws JSONException {
		File file = new File(path);
		view(Uri.fromFile(file), "text/html");
	}

	@Rpc(description = "Starts a search for the given query.")
	public void search(@RpcParameter(name = "query") String query) {
		Intent intent = new Intent(Intent.ACTION_SEARCH);
		intent.putExtra(SearchManager.QUERY, query);
		mAndroidFacade.startActivity(intent);
	}
}