/* * 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.content; import android.net.Uri; import android.os.Bundle; import android.os.Parcel; import android.os.Parcelable; import java.io.IOException; import java.io.PrintWriter; import java.io.Serializable; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; import java.net.URISyntaxException; import java.util.ArrayList; import java.util.HashSet; import java.util.List; import java.util.Locale; import java.util.Objects; import java.util.Set; /** * An intent is an abstract description of an operation to be performed. It can * be used with {@link Context#startActivity(Intent) startActivity} to launch an * {@link android.app.Activity}, * {@link android.content.Context#sendBroadcast(Intent) broadcastIntent} to send * it to any interested {@link BroadcastReceiver BroadcastReceiver} components, * and {@link android.content.Context#startService} or * {@link android.content.Context#bindService} to communicate with a background * {@link android.app.Service}. * *

* An Intent provides a facility for performing late runtime binding between the * code in different applications. Its most significant use is in the launching * of activities, where it can be thought of as the glue between activities. It * is basically a passive data structure holding an abstract description of an * action to be performed. *

* *
*

Developer Guides

*

* For information about how to create and resolve intents, read the * Intents and * Intent Filters developer guide. *

*
* * *

Intent Structure

*

* The primary pieces of information in an intent are: *

* * * * *

* Some examples of action/data pairs are: *

* * * *

* In addition to these primary attributes, there are a number of secondary * attributes that you can also include with an intent: *

* * * *

* Here are some examples of other operations you can specify as intents using * these additional parameters: *

* * * *

* There are a variety of standard Intent action and category constants defined * in the Intent class, but applications can also define their own. These * strings use Java-style scoping, to ensure they are unique -- for example, the * standard {@link #ACTION_VIEW} is called "android.intent.action.VIEW". *

* *

* Put together, the set of actions, data types, categories, and extra data * defines a language for the system allowing for the expression of phrases such * as "call john smith's cell". As applications are added to the system, they * can extend this language by adding new actions, types, and categories, or * they can modify the behavior of existing phrases by supplying their own * activities that handle them. *

* * *

Intent Resolution

* *

* There are two primary forms of intents you will use. * *

* *

* When using implicit intents, given such an arbitrary intent we need to know * what to do with it. This is handled by the process of Intent * resolution, which maps an Intent to an {@link android.app.Activity}, * {@link BroadcastReceiver}, or {@link android.app.Service} (or sometimes two * or more activities/receivers) that can handle it. *

* *

* The intent resolution mechanism basically revolves around matching an Intent * against all of the <intent-filter> descriptions in the installed * application packages. (Plus, in the case of broadcasts, any * {@link BroadcastReceiver} objects explicitly registered with * {@link Context#registerReceiver}.) More details on this can be found in the * documentation on the {@link IntentFilter} class. *

* *

* There are three pieces of information in the Intent that are used for * resolution: the action, type, and category. Using this information, a query * is done on the {@link PackageManager} for a component that can handle the * intent. The appropriate component is determined based on the intent * information supplied in the AndroidManifest.xml file as follows: *

* * * *

* For example, consider the Note Pad sample application that allows a user to * browse through a list of notes data and view details about individual items. * Text in italics indicates places where you would replace a name with one * specific to your own package. *

* * 
 *  <manifest xmlns:android="http://schemas.android.com/apk/res/android"
 *       package="com.android.notepad">
 *     <application android:icon="@drawable/app_notes"
 *             android:label="@string/app_name">
 *
 *         <provider class=".NotePadProvider"
 *                 android:authorities="com.google.provider.NotePad" />
 *
 *         <activity class=".NotesList" android:label="@string/title_notes_list">
 *             <intent-filter>
 *                 <action android:name="android.intent.action.MAIN" />
 *                 <category android:name="android.intent.category.LAUNCHER" />
 *             </intent-filter>
 *             <intent-filter>
 *                 <action android:name="android.intent.action.VIEW" />
 *                 <action android:name="android.intent.action.EDIT" />
 *                 <action android:name="android.intent.action.PICK" />
 *                 <category android:name="android.intent.category.DEFAULT" />
 *                 <data android:mimeType="vnd.android.cursor.dir/vnd.google.note" />
 *             </intent-filter>
 *             <intent-filter>
 *                 <action android:name="android.intent.action.GET_CONTENT" />
 *                 <category android:name="android.intent.category.DEFAULT" />
 *                 <data android:mimeType="vnd.android.cursor.item/vnd.google.note" />
 *             </intent-filter>
 *         </activity>
 *
 *         <activity class=".NoteEditor" android:label="@string/title_note">
 *             <intent-filter android:label="@string/resolve_edit">
 *                 <action android:name="android.intent.action.VIEW" />
 *                 <action android:name="android.intent.action.EDIT" />
 *                 <category android:name="android.intent.category.DEFAULT" />
 *                 <data android:mimeType="vnd.android.cursor.item/vnd.google.note" />
 *             </intent-filter>
 *
 *             <intent-filter>
 *                 <action android:name="android.intent.action.INSERT" />
 *                 <category android:name="android.intent.category.DEFAULT" />
 *                 <data android:mimeType="vnd.android.cursor.dir/vnd.google.note" />
 *             </intent-filter>
 *
 *         </activity>
 *
 *         <activity class=".TitleEditor" android:label="@string/title_edit_title"
 *                 android:theme="@android:style/Theme.Dialog">
 *             <intent-filter android:label="@string/resolve_title">
 *                 <action android:name="com.android.notepad.action.EDIT_TITLE" />
 *                 <category android:name="android.intent.category.DEFAULT" />
 *                 <category android:name="android.intent.category.ALTERNATIVE" />
 *                 <category android:name="android.intent.category.SELECTED_ALTERNATIVE" />
 *                 <data android:mimeType="vnd.android.cursor.item/vnd.google.note" />
 *             </intent-filter>
 *         </activity>
 *
 *     </application>
 * </manifest>
 *
* *

* The first activity, com.android.notepad.NotesList, serves as our * main entry into the app. It can do three things as described by its three * intent templates: *

    *
  1. * * 
     * <intent-filter>
 *     <action android:name="{@link #ACTION_MAIN android.intent.action.MAIN}" />
 *     <category android:name="{@link #CATEGORY_LAUNCHER android.intent.category.LAUNCHER}" />
 * </intent-filter>
 *
    *

    * This provides a top-level entry into the NotePad application: the standard * MAIN action is a main entry point (not requiring any other information in the * Intent), and the LAUNCHER category says that this entry point should be * listed in the application launcher. *

    *
  2. * * 
     * <intent-filter>
 *     <action android:name="{@link #ACTION_VIEW android.intent.action.VIEW}" />
 *     <action android:name="{@link #ACTION_EDIT android.intent.action.EDIT}" />
 *     <action android:name="{@link #ACTION_PICK android.intent.action.PICK}" />
 *     <category android:name="{@link #CATEGORY_DEFAULT android.intent.category.DEFAULT}" />
 *     <data android:mimeType="vnd.android.cursor.dir/vnd.google.note" />
 * </intent-filter>
 *
    *

    * This declares the things that the activity can do on a directory of notes. * The type being supported is given with the <type> tag, where * vnd.android.cursor.dir/vnd.google.note is a URI from which a * Cursor of zero or more items (vnd.android.cursor.dir) can be * retrieved which holds our note pad data (vnd.google.note). The * activity allows the user to view or edit the directory of data (via the VIEW * and EDIT actions), or to pick a particular note and return it to the caller * (via the PICK action). Note also the DEFAULT category supplied here: this is * required for the {@link Context#startActivity Context.startActivity} * method to resolve your activity when its component name is not explicitly * specified. *

    *
  3. * * 
     * <intent-filter>
 *     <action android:name="{@link #ACTION_GET_CONTENT android.intent.action.GET_CONTENT}" />
 *     <category android:name="{@link #CATEGORY_DEFAULT android.intent.category.DEFAULT}" />
 *     <data android:mimeType="vnd.android.cursor.item/vnd.google.note" />
 * </intent-filter>
 *
    *

    * This filter describes the ability to return to the caller a note selected by * the user without needing to know where it came from. The data type * vnd.android.cursor.item/vnd.google.note is a URI from which a * Cursor of exactly one (vnd.android.cursor.item) item can be * retrieved which contains our note pad data (vnd.google.note). * The GET_CONTENT action is similar to the PICK action, where the activity will * return to its caller a piece of data selected by the user. Here, however, the * caller specifies the type of data they desire instead of the type of data the * user will be picking from. *

    *
* *

* Given these capabilities, the following intents will resolve to the NotesList * activity: *

* * * *

* The second activity, com.android.notepad.NoteEditor, shows the * user a single note entry and allows them to edit it. It can do two things as * described by its two intent templates: *

    *
  1. * * 
     * <intent-filter android:label="@string/resolve_edit">
 *     <action android:name="{@link #ACTION_VIEW android.intent.action.VIEW}" />
 *     <action android:name="{@link #ACTION_EDIT android.intent.action.EDIT}" />
 *     <category android:name="{@link #CATEGORY_DEFAULT android.intent.category.DEFAULT}" />
 *     <data android:mimeType="vnd.android.cursor.item/vnd.google.note" />
 * </intent-filter>
 *
    *

    * The first, primary, purpose of this activity is to let the user interact with * a single note, as decribed by the MIME type * vnd.android.cursor.item/vnd.google.note. The activity can either * VIEW a note or allow the user to EDIT it. Again we support the DEFAULT * category to allow the activity to be launched without explicitly specifying * its component. *

    *
  2. * * 
     * <intent-filter>
 *     <action android:name="{@link #ACTION_INSERT android.intent.action.INSERT}" />
 *     <category android:name="{@link #CATEGORY_DEFAULT android.intent.category.DEFAULT}" />
 *     <data android:mimeType="vnd.android.cursor.dir/vnd.google.note" />
 * </intent-filter>
 *
    *

    * The secondary use of this activity is to insert a new note entry into an * existing directory of notes. This is used when the user creates a new note: * the INSERT action is executed on the directory of notes, causing this * activity to run and have the user create the new note data which it then adds * to the content provider. *

    *
* *

* Given these capabilities, the following intents will resolve to the * NoteEditor activity: *

* * * *

* The last activity, com.android.notepad.TitleEditor, allows the * user to edit the title of a note. This could be implemented as a class that * the application directly invokes (by explicitly setting its component in the * Intent), but here we show a way you can publish alternative operations on * existing data: *

* * 
 * <intent-filter android:label="@string/resolve_title">
 *     <action android:name="com.android.notepad.action.EDIT_TITLE" />
 *     <category android:name="{@link #CATEGORY_DEFAULT android.intent.category.DEFAULT}" />
 *     <category android:name="{@link #CATEGORY_ALTERNATIVE android.intent.category.ALTERNATIVE}" />
 *     <category android:name="{@link #CATEGORY_SELECTED_ALTERNATIVE android.intent.category.SELECTED_ALTERNATIVE}" />
 *     <data android:mimeType="vnd.android.cursor.item/vnd.google.note" />
 * </intent-filter>
 *
* *

* In the single intent template here, we have created our own private action * called com.android.notepad.action.EDIT_TITLE which means to edit * the title of a note. It must be invoked on a specific note (data type * vnd.android.cursor.item/vnd.google.note) like the previous view * and edit actions, but here displays and edits the title contained in the note * data. * *

* In addition to supporting the default category as usual, our title editor * also supports two other standard categories: ALTERNATIVE and * SELECTED_ALTERNATIVE. Implementing these categories allows others to find the * special action it provides without directly knowing about it, through the * {@link android.content.pm.PackageManager#queryIntentActivityOptions} method, * or more often to build dynamic menu items with * {@link android.view.Menu#addIntentOptions}. Note that in the intent template * here was also supply an explicit name for the template (via * android:label="@string/resolve_title") to better control what * the user sees when presented with this activity as an alternative action to * the data they are viewing. * *

* Given these capabilities, the following intent will resolve to the * TitleEditor activity: *

* * * *

Standard Activity Actions

* *

* These are the current standard actions that Intent defines for launching * activities (usually through {@link Context#startActivity}. The most * important, and by far most frequently used, are {@link #ACTION_MAIN} and * {@link #ACTION_EDIT}. * *

* *

Standard Broadcast Actions

* *

* These are the current standard actions that Intent defines for receiving * broadcasts (usually through {@link Context#registerReceiver} or a * <receiver> tag in a manifest). * *

* *

Standard Categories

* *

* These are the current standard categories that can be used to further clarify * an Intent via {@link #addCategory}. * *

* *

Standard Extra Data

* *

* These are the current standard fields that can be used as extra data via * {@link #putExtra}. * *

* *

Flags

* *

* These are the possible flags that can be used in the Intent via * {@link #setFlags} and {@link #addFlags}. See {@link #setFlags} for a list of * all possible flags. */ public class Intent implements Parcelable, Cloneable { /** * Create an empty intent. */ public Intent() { } /** * Copy constructor. */ public Intent(Intent o) { } /** * Create an intent with a given action. All other fields (data, type, class) * are null. Note that the action must be in a namespace because * Intents are used globally in the system -- for example the system VIEW action * is android.intent.action.VIEW; an application's custom action would be * something like com.google.app.myapp.CUSTOM_ACTION. * * @param action The Intent action, such as ACTION_VIEW. */ public Intent(String action) { } /** * Create an intent with a given action and for a given data url. Note that the * action must be in a namespace because Intents are used globally in * the system -- for example the system VIEW action is * android.intent.action.VIEW; an application's custom action would be something * like com.google.app.myapp.CUSTOM_ACTION. * *

* Note: scheme and host name matching in the Android framework is * case-sensitive, unlike the formal RFC. As a result, you should always ensure * that you write your Uri with these elements using lower case letters, and * normalize any Uris you receive from outside of Android to ensure the scheme * and host is lower case. *

* * @param action The Intent action, such as ACTION_VIEW. * @param uri The Intent data URI. */ public Intent(String action, Uri uri) { } /** * Create an intent for a specific component. All other fields (action, data, * type, class) are null, though they can be modified later with explicit calls. * This provides a convenient way to create an intent that is intended to * execute a hard-coded class name, rather than relying on the system to find an * appropriate class for you; see {@link #setComponent} for more information on * the repercussions of this. * * @param packageContext A Context of the application package implementing this * class. * @param cls The component class that is to be used for the intent. * * @see #setClass * @see #setComponent * @see #Intent(String, android.net.Uri , Context, Class) */ public Intent(Context packageContext, Class cls) { } /** * Create an intent for a specific component with a specified action and data. * This is equivalent to using {@link #Intent(String, android.net.Uri)} to * construct the Intent and then calling {@link #setClass} to set its class. * *

* Note: scheme and host name matching in the Android framework is * case-sensitive, unlike the formal RFC. As a result, you should always ensure * that you write your Uri with these elements using lower case letters, and * normalize any Uris you receive from outside of Android to ensure the scheme * and host is lower case. *

* * @param action The Intent action, such as ACTION_VIEW. * @param uri The Intent data URI. * @param packageContext A Context of the application package implementing this * class. * @param cls The component class that is to be used for the intent. * * @see #Intent(String, android.net.Uri) * @see #Intent(Context, Class) * @see #setClass * @see #setComponent */ public Intent(String action, Uri uri, Context packageContext, Class cls) { } /** * Call {@link #parseUri} with 0 flags. * * @deprecated Use {@link #parseUri} instead. */ @Deprecated public static Intent getIntent(String uri) { return null; } /** * Create an intent from a URI. This URI may encode the action, category, and * other intent fields, if it was returned by {@link #toUri}. If the Intent was * not generate by toUri(), its data will be the entire URI and its action will * be ACTION_VIEW. * *

* The URI given here must not be relative -- that is, it must include the * scheme and full path. * * @param uri The URI to turn into an Intent. * @param flags Additional processing flags. * * @return Intent The newly created Intent object. * * @throws URISyntaxException Throws URISyntaxError if the basic URI syntax it * bad (as parsed by the Uri class) or the Intent * data within the URI is invalid. * * @see #toUri */ public static Intent parseUri(String uri, int flags) { return null; } /** * Retrieve the general action to be performed, such as {@link #ACTION_VIEW}. * The action describes the general way the rest of the information in the * intent should be interpreted -- most importantly, what to do with the data * returned by {@link #getData}. * * @return The action of this intent or null if none is specified. * * @see #setAction */ public String getAction() { return null; } /** * Retrieve data this intent is operating on. This URI specifies the name of the * data; often it uses the content: scheme, specifying data in a content * provider. Other schemes may be handled by specific activities, such as http: * by the web browser. * * @return The URI of the data this intent is targeting or null. * * @see #getScheme * @see #setData */ public Uri getData() { return null; } /** * The same as {@link #getData()}, but returns the URI as an encoded String. */ public String getDataString() { return null; } /** * Return the scheme portion of the intent's data. If the data is null or does * not include a scheme, null is returned. Otherwise, the scheme prefix without * the final ':' is returned, i.e. "http". * *

* This is the same as calling getData().getScheme() (and checking for null * data). * * @return The scheme of this intent. * * @see #getData */ public String getScheme() { return null; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * * @return the value of an item previously added with putExtra(), or null if * none was found. * * @deprecated * @hide */ @Deprecated public Object getExtra(String name) { return null; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * @param defaultValue the value to be returned if no value of the desired type * is stored with the given name. * * @return the value of an item previously added with putExtra(), or the default * value if none was found. * * @see #putExtra(String, boolean) */ public boolean getBooleanExtra(String name, boolean defaultValue) { return false; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * @param defaultValue the value to be returned if no value of the desired type * is stored with the given name. * * @return the value of an item previously added with putExtra(), or the default * value if none was found. * * @see #putExtra(String, byte) */ public byte getByteExtra(String name, byte defaultValue) { return -1; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * @param defaultValue the value to be returned if no value of the desired type * is stored with the given name. * * @return the value of an item previously added with putExtra(), or the default * value if none was found. * * @see #putExtra(String, short) */ public short getShortExtra(String name, short defaultValue) { return -1; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * @param defaultValue the value to be returned if no value of the desired type * is stored with the given name. * * @return the value of an item previously added with putExtra(), or the default * value if none was found. * * @see #putExtra(String, char) */ public char getCharExtra(String name, char defaultValue) { return 'a'; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * @param defaultValue the value to be returned if no value of the desired type * is stored with the given name. * * @return the value of an item previously added with putExtra(), or the default * value if none was found. * * @see #putExtra(String, int) */ public int getIntExtra(String name, int defaultValue) { return -1; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * @param defaultValue the value to be returned if no value of the desired type * is stored with the given name. * * @return the value of an item previously added with putExtra(), or the default * value if none was found. * * @see #putExtra(String, long) */ public long getLongExtra(String name, long defaultValue) { return -1; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * @param defaultValue the value to be returned if no value of the desired type * is stored with the given name. * * @return the value of an item previously added with putExtra(), or the default * value if no such item is present * * @see #putExtra(String, float) */ public float getFloatExtra(String name, float defaultValue) { return -1; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * @param defaultValue the value to be returned if no value of the desired type * is stored with the given name. * * @return the value of an item previously added with putExtra(), or the default * value if none was found. * * @see #putExtra(String, double) */ public double getDoubleExtra(String name, double defaultValue) { return -1; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * * @return the value of an item previously added with putExtra(), or null if no * String value was found. * * @see #putExtra(String, String) */ public String getStringExtra(String name) { return null; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * * @return the value of an item previously added with putExtra(), or null if no * CharSequence value was found. * * @see #putExtra(String, CharSequence) */ public CharSequence getCharSequenceExtra(String name) { return null; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * * @return the value of an item previously added with putExtra(), or null if no * Parcelable value was found. * * @see #putExtra(String, Parcelable) */ public T getParcelableExtra(String name) { return null; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * * @return the value of an item previously added with putExtra(), or null if no * Parcelable[] value was found. * * @see #putExtra(String, Parcelable[]) */ public Parcelable[] getParcelableArrayExtra(String name) { return null; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * * @return the value of an item previously added with * putParcelableArrayListExtra(), or null if no ArrayList * value was found. * * @see #putParcelableArrayListExtra(String, ArrayList) */ public ArrayList getParcelableArrayListExtra(String name) { return null; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * * @return the value of an item previously added with putExtra(), or null if no * Serializable value was found. * * @see #putExtra(String, Serializable) */ public Serializable getSerializableExtra(String name) { return null; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * * @return the value of an item previously added with * putIntegerArrayListExtra(), or null if no ArrayList value * was found. * * @see #putIntegerArrayListExtra(String, ArrayList) */ public ArrayList getIntegerArrayListExtra(String name) { return null; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * * @return the value of an item previously added with putStringArrayListExtra(), * or null if no ArrayList value was found. * * @see #putStringArrayListExtra(String, ArrayList) */ public ArrayList getStringArrayListExtra(String name) { return null; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * * @return the value of an item previously added with * putCharSequenceArrayListExtra, or null if no ArrayList * value was found. * * @see #putCharSequenceArrayListExtra(String, ArrayList) */ public ArrayList getCharSequenceArrayListExtra(String name) { return null; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * * @return the value of an item previously added with putExtra(), or null if no * boolean array value was found. * * @see #putExtra(String, boolean[]) */ public boolean[] getBooleanArrayExtra(String name) { return null; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * * @return the value of an item previously added with putExtra(), or null if no * byte array value was found. * * @see #putExtra(String, byte[]) */ public byte[] getByteArrayExtra(String name) { return null; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * * @return the value of an item previously added with putExtra(), or null if no * short array value was found. * * @see #putExtra(String, short[]) */ public short[] getShortArrayExtra(String name) { return null; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * * @return the value of an item previously added with putExtra(), or null if no * char array value was found. * * @see #putExtra(String, char[]) */ public char[] getCharArrayExtra(String name) { return null; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * * @return the value of an item previously added with putExtra(), or null if no * int array value was found. * * @see #putExtra(String, int[]) */ public int[] getIntArrayExtra(String name) { return null; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * * @return the value of an item previously added with putExtra(), or null if no * long array value was found. * * @see #putExtra(String, long[]) */ public long[] getLongArrayExtra(String name) { return null; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * * @return the value of an item previously added with putExtra(), or null if no * float array value was found. * * @see #putExtra(String, float[]) */ public float[] getFloatArrayExtra(String name) { return null; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * * @return the value of an item previously added with putExtra(), or null if no * double array value was found. * * @see #putExtra(String, double[]) */ public double[] getDoubleArrayExtra(String name) { return null; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * * @return the value of an item previously added with putExtra(), or null if no * String array value was found. * * @see #putExtra(String, String[]) */ public String[] getStringArrayExtra(String name) { return null; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * * @return the value of an item previously added with putExtra(), or null if no * CharSequence array value was found. * * @see #putExtra(String, CharSequence[]) */ public CharSequence[] getCharSequenceArrayExtra(String name) { return null; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * * @return the value of an item previously added with putExtra(), or null if no * Bundle value was found. * * @see #putExtra(String, Bundle) */ public Bundle getBundleExtra(String name) { return null; } /** * Retrieve extended data from the intent. * * @param name The name of the desired item. * @param defaultValue The default value to return in case no item is associated * with the key 'name' * * @return the value of an item previously added with putExtra(), or * defaultValue if none was found. * * @see #putExtra * * @deprecated * @hide */ @Deprecated public Object getExtra(String name, Object defaultValue) { return null; } /** * Retrieves a map of extended data from the intent. * * @return the map of all extras previously added with putExtra(), or null if * none have been added. */ public Bundle getExtras() { return null; } /** * Filter extras to only basic types. * * @hide */ public void removeUnsafeExtras() { } /** * Set the general action to be performed. * * @param action An action name, such as ACTION_VIEW. Application-specific * actions should be prefixed with the vendor's package name. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #getAction */ public Intent setAction(String action) { return null; } /** * Set the data this intent is operating on. This method automatically clears * any type that was previously set by {@link #setType} or * {@link #setTypeAndNormalize}. * *

* Note: scheme matching in the Android framework is case-sensitive, unlike * the formal RFC. As a result, you should always write your Uri with a lower * case scheme, or use {@link Uri#normalizeScheme} or * {@link #setDataAndNormalize} to ensure that the scheme is converted to lower * case. * * @param data The Uri of the data this intent is now targeting. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #getData * @see #setDataAndNormalize * @see android.net.Uri#normalizeScheme() */ public Intent setData(Uri data) { return null; } /** * Add extended data to the intent. The name must include a package prefix, for * example the app com.android.contacts would use names like * "com.android.contacts.ShowAll". * * @param name The name of the extra data, with package prefix. * @param value The boolean data value. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #putExtras * @see #removeExtra * @see #getBooleanExtra(String, boolean) */ public Intent putExtra(String name, boolean value) { return null; } /** * Add extended data to the intent. The name must include a package prefix, for * example the app com.android.contacts would use names like * "com.android.contacts.ShowAll". * * @param name The name of the extra data, with package prefix. * @param value The byte data value. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #putExtras * @see #removeExtra * @see #getByteExtra(String, byte) */ public Intent putExtra(String name, byte value) { return null; } /** * Add extended data to the intent. The name must include a package prefix, for * example the app com.android.contacts would use names like * "com.android.contacts.ShowAll". * * @param name The name of the extra data, with package prefix. * @param value The char data value. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #putExtras * @see #removeExtra * @see #getCharExtra(String, char) */ public Intent putExtra(String name, char value) { return null; } /** * Add extended data to the intent. The name must include a package prefix, for * example the app com.android.contacts would use names like * "com.android.contacts.ShowAll". * * @param name The name of the extra data, with package prefix. * @param value The short data value. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #putExtras * @see #removeExtra * @see #getShortExtra(String, short) */ public Intent putExtra(String name, short value) { return null; } /** * Add extended data to the intent. The name must include a package prefix, for * example the app com.android.contacts would use names like * "com.android.contacts.ShowAll". * * @param name The name of the extra data, with package prefix. * @param value The integer data value. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #putExtras * @see #removeExtra * @see #getIntExtra(String, int) */ public Intent putExtra(String name, int value) { return null; } /** * Add extended data to the intent. The name must include a package prefix, for * example the app com.android.contacts would use names like * "com.android.contacts.ShowAll". * * @param name The name of the extra data, with package prefix. * @param value The long data value. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #putExtras * @see #removeExtra * @see #getLongExtra(String, long) */ public Intent putExtra(String name, long value) { return null; } /** * Add extended data to the intent. The name must include a package prefix, for * example the app com.android.contacts would use names like * "com.android.contacts.ShowAll". * * @param name The name of the extra data, with package prefix. * @param value The float data value. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #putExtras * @see #removeExtra * @see #getFloatExtra(String, float) */ public Intent putExtra(String name, float value) { return null; } /** * Add extended data to the intent. The name must include a package prefix, for * example the app com.android.contacts would use names like * "com.android.contacts.ShowAll". * * @param name The name of the extra data, with package prefix. * @param value The double data value. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #putExtras * @see #removeExtra * @see #getDoubleExtra(String, double) */ public Intent putExtra(String name, double value) { return null; } /** * Add extended data to the intent. The name must include a package prefix, for * example the app com.android.contacts would use names like * "com.android.contacts.ShowAll". * * @param name The name of the extra data, with package prefix. * @param value The String data value. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #putExtras * @see #removeExtra * @see #getStringExtra(String) */ public Intent putExtra(String name, String value) { return null; } /** * Add extended data to the intent. The name must include a package prefix, for * example the app com.android.contacts would use names like * "com.android.contacts.ShowAll". * * @param name The name of the extra data, with package prefix. * @param value The CharSequence data value. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #putExtras * @see #removeExtra * @see #getCharSequenceExtra(String) */ public Intent putExtra(String name, CharSequence value) { return null; } /** * Add extended data to the intent. The name must include a package prefix, for * example the app com.android.contacts would use names like * "com.android.contacts.ShowAll". * * @param name The name of the extra data, with package prefix. * @param value The Parcelable data value. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #putExtras * @see #removeExtra * @see #getParcelableExtra(String) */ public Intent putExtra(String name, Parcelable value) { return null; } /** * Add extended data to the intent. The name must include a package prefix, for * example the app com.android.contacts would use names like * "com.android.contacts.ShowAll". * * @param name The name of the extra data, with package prefix. * @param value The Parcelable[] data value. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #putExtras * @see #removeExtra * @see #getParcelableArrayExtra(String) */ public Intent putExtra(String name, Parcelable[] value) { return null; } /** * Add extended data to the intent. The name must include a package prefix, for * example the app com.android.contacts would use names like * "com.android.contacts.ShowAll". * * @param name The name of the extra data, with package prefix. * @param value The ArrayList data value. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #putExtras * @see #removeExtra * @see #getParcelableArrayListExtra(String) */ public Intent putParcelableArrayListExtra(String name, ArrayList value) { return null; } /** * Add extended data to the intent. The name must include a package prefix, for * example the app com.android.contacts would use names like * "com.android.contacts.ShowAll". * * @param name The name of the extra data, with package prefix. * @param value The ArrayList data value. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #putExtras * @see #removeExtra * @see #getIntegerArrayListExtra(String) */ public Intent putIntegerArrayListExtra(String name, ArrayList value) { return null; } /** * Add extended data to the intent. The name must include a package prefix, for * example the app com.android.contacts would use names like * "com.android.contacts.ShowAll". * * @param name The name of the extra data, with package prefix. * @param value The ArrayList data value. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #putExtras * @see #removeExtra * @see #getStringArrayListExtra(String) */ public Intent putStringArrayListExtra(String name, ArrayList value) { return null; } /** * Add extended data to the intent. The name must include a package prefix, for * example the app com.android.contacts would use names like * "com.android.contacts.ShowAll". * * @param name The name of the extra data, with package prefix. * @param value The ArrayList data value. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #putExtras * @see #removeExtra * @see #getCharSequenceArrayListExtra(String) */ public Intent putCharSequenceArrayListExtra(String name, ArrayList value) { return null; } /** * Add extended data to the intent. The name must include a package prefix, for * example the app com.android.contacts would use names like * "com.android.contacts.ShowAll". * * @param name The name of the extra data, with package prefix. * @param value The Serializable data value. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #putExtras * @see #removeExtra * @see #getSerializableExtra(String) */ public Intent putExtra(String name, Serializable value) { return null; } /** * Add extended data to the intent. The name must include a package prefix, for * example the app com.android.contacts would use names like * "com.android.contacts.ShowAll". * * @param name The name of the extra data, with package prefix. * @param value The boolean array data value. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #putExtras * @see #removeExtra * @see #getBooleanArrayExtra(String) */ public Intent putExtra(String name, boolean[] value) { return null; } /** * Add extended data to the intent. The name must include a package prefix, for * example the app com.android.contacts would use names like * "com.android.contacts.ShowAll". * * @param name The name of the extra data, with package prefix. * @param value The byte array data value. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #putExtras * @see #removeExtra * @see #getByteArrayExtra(String) */ public Intent putExtra(String name, byte[] value) { return null; } /** * Add extended data to the intent. The name must include a package prefix, for * example the app com.android.contacts would use names like * "com.android.contacts.ShowAll". * * @param name The name of the extra data, with package prefix. * @param value The short array data value. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #putExtras * @see #removeExtra * @see #getShortArrayExtra(String) */ public Intent putExtra(String name, short[] value) { return null; } /** * Add extended data to the intent. The name must include a package prefix, for * example the app com.android.contacts would use names like * "com.android.contacts.ShowAll". * * @param name The name of the extra data, with package prefix. * @param value The char array data value. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #putExtras * @see #removeExtra * @see #getCharArrayExtra(String) */ public Intent putExtra(String name, char[] value) { return null; } /** * Add extended data to the intent. The name must include a package prefix, for * example the app com.android.contacts would use names like * "com.android.contacts.ShowAll". * * @param name The name of the extra data, with package prefix. * @param value The int array data value. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #putExtras * @see #removeExtra * @see #getIntArrayExtra(String) */ public Intent putExtra(String name, int[] value) { return null; } /** * Add extended data to the intent. The name must include a package prefix, for * example the app com.android.contacts would use names like * "com.android.contacts.ShowAll". * * @param name The name of the extra data, with package prefix. * @param value The byte array data value. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #putExtras * @see #removeExtra * @see #getLongArrayExtra(String) */ public Intent putExtra(String name, long[] value) { return null; } /** * Add extended data to the intent. The name must include a package prefix, for * example the app com.android.contacts would use names like * "com.android.contacts.ShowAll". * * @param name The name of the extra data, with package prefix. * @param value The float array data value. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #putExtras * @see #removeExtra * @see #getFloatArrayExtra(String) */ public Intent putExtra(String name, float[] value) { return null; } /** * Add extended data to the intent. The name must include a package prefix, for * example the app com.android.contacts would use names like * "com.android.contacts.ShowAll". * * @param name The name of the extra data, with package prefix. * @param value The double array data value. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #putExtras * @see #removeExtra * @see #getDoubleArrayExtra(String) */ public Intent putExtra(String name, double[] value) { return null; } /** * Add extended data to the intent. The name must include a package prefix, for * example the app com.android.contacts would use names like * "com.android.contacts.ShowAll". * * @param name The name of the extra data, with package prefix. * @param value The String array data value. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #putExtras * @see #removeExtra * @see #getStringArrayExtra(String) */ public Intent putExtra(String name, String[] value) { return null; } /** * Add extended data to the intent. The name must include a package prefix, for * example the app com.android.contacts would use names like * "com.android.contacts.ShowAll". * * @param name The name of the extra data, with package prefix. * @param value The CharSequence array data value. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #putExtras * @see #removeExtra * @see #getCharSequenceArrayExtra(String) */ public Intent putExtra(String name, CharSequence[] value) { return null; } /** * Add extended data to the intent. The name must include a package prefix, for * example the app com.android.contacts would use names like * "com.android.contacts.ShowAll". * * @param name The name of the extra data, with package prefix. * @param value The Bundle data value. * * @return Returns the same Intent object, for chaining multiple calls into a * single statement. * * @see #putExtras * @see #removeExtra * @see #getBundleExtra(String) */ public Intent putExtra(String name, Bundle value) { return null; } /** * Copy all extras in 'src' in to this intent. * * @param src Contains the extras to copy. * * @see #putExtra */ public Intent putExtras(Intent src) { return null; } /** * Add a set of extended data to the intent. The keys must include a package * prefix, for example the app com.android.contacts would use names like * "com.android.contacts.ShowAll". * * @param extras The Bundle of extras to add to this intent. * * @see #putExtra * @see #removeExtra */ public Intent putExtras(Bundle extras) { return null; } /** * Completely replace the extras in the Intent with the extras in the given * Intent. * * @param src The exact extras contained in this Intent are copied into the * target intent, replacing any that were previously there. */ public Intent replaceExtras(Intent src) { return null; } /** * Completely replace the extras in the Intent with the given Bundle of extras. * * @param extras The new set of extras in the Intent, or null to erase all * extras. */ public Intent replaceExtras(Bundle extras) { return null; } /** * Remove extended data from the intent. * * @see #putExtra */ public void removeExtra(String name) { } public void writeToParcel(Parcel out, int flags) { } public void readFromParcel(Parcel in) { } /** * Retrieve the application package name this Intent is limited to. When * resolving an Intent, if non-null this limits the resolution to only * components in the given application package. * * @return The name of the application package for the Intent. * * @see #resolveActivity * @see #setPackage */ public String getPackage() { return null; } /** * (Usually optional) Set an explicit application package name that limits * the components this Intent will resolve to. If left to the default * value of null, all components in all applications will considered. * If non-null, the Intent can only match the components in the given * application package. * * @param packageName The name of the application package to handle the * intent, or null to allow any application package. * * @return Returns the same Intent object, for chaining multiple calls * into a single statement. * * @see #getPackage * @see #resolveActivity */ public Intent setPackage(String packageName) { return null; } /** * Convenience for calling {@link #setComponent} with an * explicit class name. * * @param packageContext A Context of the application package implementing * this class. * @param className The name of a class inside of the application package * that will be used as the component for this Intent. * * @return Returns the same Intent object, for chaining multiple calls * into a single statement. * * @see #setComponent * @see #setClass */ public Intent setClassName(Context packageContext, String className) { return null; } /** * Convenience for calling {@link #setComponent} with an * explicit application package name and class name. * * @param packageName The name of the package implementing the desired * component. * @param className The name of a class inside of the application package * that will be used as the component for this Intent. * * @return Returns the same Intent object, for chaining multiple calls * into a single statement. * * @see #setComponent * @see #setClass */ public Intent setClassName(String packageName, String className) { return null; } }