Intent Filter

IntentFilter
public class IntentFilter

extends Object implements Parcelable
java.lang.Object
↳ android.content.IntentFilter
Structured description of Intent values to be matched. An IntentFilter can match against

actions, categories, and data (either via its type, scheme, and/or path) in an Intent. It
also includes a "priority" value which is used to order multiple matching filters.
IntentFilter objects are often created in XML as part of a

package's AndroidManifest.xml file, using intent-filter tags.
There are three Intent characteristics you can filter on: the action, data, and categories.
For each of these characteristics you can provide multiple possible matching values
(via addAction(String),addDataType(String), addDataScheme(String), addData
SchemeSpecificPart(String, int),addDataAuthority(String,
String), addDataPath(String, int), and addCategory(String), respectively). For
actions, the field will not be tested if no values have been given (treating it as a
wildcard); if no data characteristics are specified, however, then the filter will only match
intents that contain no data.
The data characteristic is itself divided into three attributes: type, scheme, authority, and
path. Any that are specified must match the contents of the Intent. If you specify a
scheme but no type, only Intent that does not have a type (such as mailto:) will match; a
content: URI will never match because they always have a MIME type that is supplied
by their content provider. Specifying a type with no scheme has somewhat special
meaning: it will match either an Intent with no URI field, or an Intent with a content: or
file: URI. If you specify neither, then only an Intent with no data or type will match. To
specify an authority, you must also specify one or more schemes that it is associated
with. To specify a path, you also must specify both one or more authorities and one or
more schemes it is associated with.
Developer Guides
For information about how to create and resolve intents, read the Intents and Intent Filters developer
guide.
Filter Rules
A match is based on the following rules. Note that for an IntentFilter to match an Intent,
three conditions must hold: the action and category must match, and the data (both
the data type and data scheme+authority+path if specified) must match
(see match(ContentResolver, Intent, boolean, String) for more details on how
the data fields match).
Action matches if any of the given values match the Intent action; if the filter specifies
no actions, then it will only match Intents that do not contain an action.
Data Type matches if any of the given values match the Intent type. The Intent type is
determined by calling resolveType(ContentResolver). A wildcard can be used for
the MIME sub-type, in both the Intent and IntentFilter, so that the type "audio/*" will
match "audio/mpeg", "audio/aiff", "audio/*", etc. Note that MIME type matching here
is case sensitive, unlike formal RFC MIME types! You should thus always use lower
case letters for your MIME types.
Data Scheme matches if any of the given values match the Intent data's scheme. The
Intent scheme is determined by calling getData() and getScheme() on that URI. Note
that scheme matching here is case sensitive, unlike formal RFC schemes! You should
thus always use lower case letters for your schemes.
Data Scheme Specific Part matches if any of the given values match the Intent's data
scheme specific part andone of the data schemes in the filter has matched the
Intent, or no scheme specific parts were supplied in the filter. The Intent scheme
specific part is determined by calling getData() and getSchemeSpecificPart() on
that URI. Note that scheme specific part matching is case sensitive.
Data Authority matches if any of the given values match the Intent's data
authority and one of the data schemes in the filter has matched the Intent, or no
authories were supplied in the filter. The Intent authority is determined by
calling getData() and getAuthority() on that URI. Note that authority matching here
is case sensitive, unlike formal RFC host names! You should thus always use lower
case letters for your authority.
Data Path matches if any of the given values match the Intent's data path and both a
scheme and authority in the filter has matched against the Intent, or no paths were
supplied in the filter. The Intent authority is determined by
calling getData() and getPath() on that URI.
Categories match if all of the categories in the Intent match categories given in the
filter. Extra categories in the filter that are not in the Intent will not cause the match to
fail. Note that unlike the action, an IntentFilter with no categories will only match an
Intent that does not have any categories.
Summary
Nested classes
class IntentFilter.AuthorityEntry
This is an entry for a single authority in the Iterator returned by authoritiesIterator().
class IntentFilter.MalformedMimeTypeException
This exception is thrown when a given MIME type does not have a valid syntax.
Constants
int MATCH_ADJUSTMENT_MASK
The part of a match constant that applies a quality adjustment to the basic category of match.
int MATCH_ADJUSTMENT_NORMAL
Quality adjustment applied to the category of match that signifies the default, base value; higher numbers
quality while lower numbers reduce it.
int MATCH_CATEGORY_EMPTY
The filter matched an intent that had no data specified.
int MATCH_CATEGORY_HOST
The filter matched an intent with the same data URI scheme and authority host.
int MATCH_CATEGORY_MASK
The part of a match constant that describes the category of match that occurred.
int MATCH_CATEGORY_PATH
The filter matched an intent with the same data URI scheme, authority, and path.
int MATCH_CATEGORY_PORT
The filter matched an intent with the same data URI scheme and authority host and port.
int MATCH_CATEGORY_SCHEME
The filter matched an intent with the same data URI scheme.
int MATCH_CATEGORY_SCHEME_SPECIFIC_PART
The filter matched an intent with the same data URI scheme and scheme specific part.
int MATCH_CATEGORY_TYPE
The filter matched an intent with the same data MIME type.
int NO_MATCH_ACTION
The filter didn't match due to different actions.
int NO_MATCH_CATEGORY
The filter didn't match because it required one or more categories that were not in the Intent.
int NO_MATCH_DATA
The filter didn't match due to different data URIs.
int NO_MATCH_TYPE
The filter didn't match due to different MIME types.
int SYSTEM_HIGH_PRIORITY
The filter setPriority(int) value at which system high-priority receivers are placed; that is, receivers
execute before application code.
int SYSTEM_LOW_PRIORITY
The filter setPriority(int) value at which system low-priority receivers are placed; that is, receivers th
execute after application code.
Inherited constants
From interface android.os.Parcelable
Fields
public static CREATOR

finalCreator<IntentFilter>
Public constructors
IntentFilter()
New empty IntentFilter.
IntentFilter(String action)
New IntentFilter that matches a single action

with no data.
IntentFilter(String action, String
dataType)
New IntentFilter that matches a single action

and data type.
IntentFilter(IntentFilter o)
New IntentFilter containing a copy of an existing

filter.
Public methods
final Iterator<String> actionsIterator()
Return an iterator over the filter's actions.
final void addAction(String action)
Add a new Intent action to match against.
final void addCategory(String category)
Add a new Intent category to match against.
final void addDataAuthority(String host, String port)
Add a new Intent data authority to match against.
final void addDataPath(String path, int type)
Add a new Intent data path to match against.
final void addDataScheme(String scheme)
Add a new Intent data scheme to match against.

final void addDataSchemeSpecificPart(String ssp, int type)
Add a new Intent data "scheme specific part" to match against.
final void addDataType(String type)
Add a new Intent data type to match against.
finalIterator<IntentFilter.Authorit authoritiesIterator()
yEntry>
Return an iterator over the filter's data authorities.
final Iterator<String> categoriesIterator()
Return an iterator over the filter's categories.
final int countActions()
Return the number of actions in the filter.
final int countCategories()
Return the number of categories in the filter.
final int countDataAuthorities()
Return the number of data authorities in the filter.
final int countDataPaths()
Return the number of data paths in the filter.
final int countDataSchemeSpecificParts()
Return the number of data scheme specific parts in the filter.
final int countDataSchemes()
Return the number of data schemes in the filter.
final int countDataTypes()
Return the number of data types in the filter.
static IntentFilter create(String action, String dataType)
Create a new IntentFilter instance with a specified action and MI

where you know the MIME type is correctly formatted.
final int describeContents()
Describe the kinds of special objects contained in this Parcelable

marshaled representation.
void dump(Printer du, String prefix)
final String getAction(int index)
Return an action in the filter.
final String getCategory(int index)
Return a category in the filter.
final IntentFilter.AuthorityEntry getDataAuthority(int index)
Return a data authority in the filter.
final PatternMatcher getDataPath(int index)
Return a data path in the filter.
final String getDataScheme(int index)
Return a data scheme in the filter.
final PatternMatcher getDataSchemeSpecificPart(int index)
Return a data scheme specific part in the filter.
final String getDataType(int index)
Return a data type in the filter.
final int getPriority()
Return the priority of this filter.
final boolean hasAction(String action)
Is the given action included in the filter? Note that if the filter doe
include any actions, false will always be returned.
final boolean hasCategory(String category)
Is the given category included in the filter?
final boolean hasDataAuthority(Uri data)
Is the given data authority included in the filter? Note that if the fi
not include any authorities, false will always be returned.
final boolean hasDataPath(String data)
Is the given data path included in the filter? Note that if the filter d
include any paths, false will always be returned.
final boolean hasDataScheme(String scheme)
Is the given data scheme included in the filter? Note that if the fil
include any scheme, false will always be returned.
final boolean hasDataSchemeSpecificPart(String data)
Is the given data scheme specific part included in the filter? Note
filter does not include any scheme specific parts, false will alway
returned.
final boolean hasDataType(String type)
Is the given data type included in the filter? Note that if the filter d
include any type, false will always be returned.
final int match(String action, String type, String scheme,

a,Set<String> categories, String logTag)
Test whether this filter matches the given intent data.
final int match(ContentResolver resolver, Intent intent, b

resolve,String logTag)
Test whether this filter matches the given intent.
final boolean matchAction(String action)
Match this filter against an Intent's action.
final String matchCategories(Set<String> categories)

Match this filter against an Intent's categories.
final int matchData(String type, String scheme, Uri data)
Match this filter against an Intent's data (type, scheme and path)
final int matchDataAuthority(Uri data)
Match this intent filter against the given Intent data.
finalIterator<PatternMatcher> pathsIterator()
Return an iterator over the filter's data paths.
void readFromXml(XmlPullParser parser)
finalIterator<PatternMatcher> schemeSpecificPartsIterator()
Return an iterator over the filter's data scheme specific parts.
final Iterator<String> schemesIterator()
Return an iterator over the filter's data schemes.
final void setPriority(int priority)
Modify priority of this filter.
final Iterator<String> typesIterator()
Return an iterator over the filter's data types.
final void writeToParcel(Parcel dest, int flags)
Flatten this object in to a Parcel.
void writeToXml(XmlSerializer serializer)
Write the contents of the IntentFilter as an XML stream.
Inherited methods
From class java.lang.Object
From interface android.os.Parcelable
Constants
MATCH_ADJUSTMENT_MASK
added in API level 1
int MATCH_ADJUSTMENT_MASK
The part of a match constant that applies a quality adjustment to the basic category of
match. The value MATCH_ADJUSTMENT_NORMAL is no adjustment; higher numbers than
that improve the quality, while lower numbers reduce it.
Constant Value: 65535 (0x0000ffff)
MATCH_ADJUSTMENT_NORMAL
int MATCH_ADJUSTMENT_NORMAL
Quality adjustment applied to the category of match that signifies the default, base
value; higher numbers improve the quality while lower numbers reduce it.
Constant Value: 32768 (0x00008000)
MATCH_CATEGORY_EMPTY
int MATCH_CATEGORY_EMPTY
The filter matched an intent that had no data specified.
Constant Value: 1048576 (0x00100000)

MATCH_CATEGORY_HOST
int MATCH_CATEGORY_HOST
The filter matched an intent with the same data URI scheme and authority host.
Constant Value: 3145728 (0x00300000)
MATCH_CATEGORY_MASK
int MATCH_CATEGORY_MASK
The part of a match constant that describes the category of match that occurred. May
be
either MATCH_CATEGORY_EMPTY, MATCH_CATEGORY_SCHEME, MATCH_CATEGORY_SCHEME_
SPECIFIC_PART,MATCH_CATEGORY_HOST, MATCH_CATEGORY_PORT, MATCH_CATEGORY_PA
TH, or MATCH_CATEGORY_TYPE. Higher values indicate a better match.
Constant Value: 268369920 (0x0fff0000)
MATCH_CATEGORY_PATH
int MATCH_CATEGORY_PATH
The filter matched an intent with the same data URI scheme, authority, and path.
Constant Value: 5242880 (0x00500000)
MATCH_CATEGORY_PORT
int MATCH_CATEGORY_PORT
The filter matched an intent with the same data URI scheme and authority host and
port.
Constant Value: 4194304 (0x00400000)
MATCH_CATEGORY_SCHEME
int MATCH_CATEGORY_SCHEME
The filter matched an intent with the same data URI scheme.
Constant Value: 2097152 (0x00200000)
MATCH_CATEGORY_SCHEME_SPECIFIC_PART
int MATCH_CATEGORY_SCHEME_SPECIFIC_PART
The filter matched an intent with the same data URI scheme and scheme specific part.
Constant Value: 5767168 (0x00580000)
MATCH_CATEGORY_TYPE
int MATCH_CATEGORY_TYPE
The filter matched an intent with the same data MIME type.
Constant Value: 6291456 (0x00600000)
NO_MATCH_ACTION
int NO_MATCH_ACTION
The filter didn't match due to different actions.
Constant Value: -3 (0xfffffffd)
NO_MATCH_CATEGORY
int NO_MATCH_CATEGORY
The filter didn't match because it required one or more categories that were not in the
Intent.
Constant Value: -4 (0xfffffffc)
NO_MATCH_DATA
int NO_MATCH_DATA
The filter didn't match due to different data URIs.
Constant Value: -2 (0xfffffffe)
NO_MATCH_TYPE
int NO_MATCH_TYPE
The filter didn't match due to different MIME types.
Constant Value: -1 (0xffffffff)

SYSTEM_HIGH_PRIORITY
int SYSTEM_HIGH_PRIORITY
The filter setPriority(int) value at which system high-priority receivers are placed;

that is, receivers that should execute before application code. Applications should never
use filters with this or higher priorities.
See also:
 setPriority(int)
Constant Value: 1000 (0x000003e8)
SYSTEM_LOW_PRIORITY
int SYSTEM_LOW_PRIORITY
The filter setPriority(int) value at which system low-priority receivers are placed;

that is, receivers that should execute after application code. Applications should never
use filters with this or lower priorities.
See also:
Constant Value: -1000 (0xfffffc18)
Fields
CREATOR
Creator<IntentFilter> CREATOR
Public constructors
IntentFilter
IntentFilter ()
New empty IntentFilter.
IntentFilter
IntentFilter (String action)
New IntentFilter that matches a single action with no data. If no data characteristics are
subsequently specified, then the filter will only match intents that contain no data.
Parameters
action String: The action to match, such as Intent.ACTION_MAIN.
IntentFilter
IntentFilter (String action,
String dataType)
New IntentFilter that matches a single action and data type.

Note: MIME type matching in the Android framework is case-sensitive, unlike formal
RFC MIME types. As a result, you should always write your MIME types with lower
case letters, and any MIME types you receive from outside of Android should be
converted to lower case before supplying them here.
Throws IntentFilter.MalformedMimeTypeException if the given MIME type is not

syntactically correct.
Parameters
action String: The action to match, such as Intent.ACTION_VIEW
dataType String: The type to match, such as "vnd.android.cursor.dir
Throws
IntentFilter.MalformedMimeTypeException
IntentFilter
IntentFilter (IntentFilter o)
New IntentFilter containing a copy of an existing filter.
Parameters
o IntentFilter: The original filter to copy.
Public methods
actionsIterator
Iterator<String> actionsIterator ()
Return an iterator over the filter's actions. If there are no actions, returns null.
Returns
Iterator<String>
addAction
void addAction (String action)
Add a new Intent action to match against. If any actions are included in the filter, then
an Intent's action must be one of those values for it to match. If no actions are included,
the Intent action is ignored.
Parameters
action String: Name of the action to match, such as Intent.ACTION_VIEW.
addCategory
void addCategory (String category)
Add a new Intent category to match against. The semantics of categories is the
opposite of actions -- an Intent includes the categories that it requires, all of which must
be included in the filter in order to match. In other words, adding a category to the filter
has no impact on matching unless that category is specified in the intent.
Parameters
category String: Name of category to match, such as Intent.CATEGORY_EMBED.

addDataAuthority
void addDataAuthority (String host,
String port)
Add a new Intent data authority to match against. The filter must include one or more
schemes (via addDataScheme(String)) for the authority to be considered. If any
authorities are included in the filter, then an Intent's data must match one of them. If no
authorities are included, then only the scheme must match.
Note: host name in the Android framework is case-sensitive, unlike formal RFC host
names. As a result, you should always write your host names with lower case letters,
and any host names you receive from outside of Android should be converted to lower
case before supplying them here.
Parameters
hos String: The host part of the authority to match. May start with a single '*' to wildcard the front of the host n
t
por String: Optional port part of the authority to match. If null, any port is allowed.
t
See also:
 matchData(String, String, Uri)

 addDataScheme(String)
addDataPath
void addDataPath (String path,
int type)
Add a new Intent data path to match against. The filter must include one or more
schemes (via addDataScheme(String)) and one or more authorities
(via addDataAuthority(String, String)) for the path to be considered. If any paths
are included in the filter, then an Intent's data must match one of them. If no paths are
included, then only the scheme/authority must match.
The path given here can either be a literal that must directly match or match against a
prefix, or it can be a simple globbing pattern. If the latter, you can use '*' anywhere in
the pattern to match zero or more instances of the previous character, '.' as a wildcard
to match any character, and '\' to escape the next character.
Parameters
pat String: Either a raw string that must exactly match the file path, or a simple pattern, depending on type.
h
typ int: Determines how path will be compared to determine a match: either PATTERN_LITERAL, PATTERN_P

e or PATTERN_SIMPLE_GLOB.
See also:

 addDataAuthority(String, String)
addDataScheme
void addDataScheme (String scheme)
Add a new Intent data scheme to match against. If any schemes are included in the
filter, then an Intent's data must be either one of these schemes or a matching data
type. If no schemes are included, then an Intent will match only if it includes no data.
Note: scheme matching in the Android framework is case-sensitive, unlike formal RFC
schemes. As a result, you should always write your schemes with lower case letters,
and any schemes you receive from outside of Android should be converted to lower
case before supplying them here.
Parameters
scheme String: Name of the scheme to match, such as "http".

See also:
addDataSchemeSpecificPart
void addDataSchemeSpecificPart (String ssp,
int type)
Add a new Intent data "scheme specific part" to match against. The filter must include
one or more schemes (via addDataScheme(String)) for the scheme specific part to be
considered. If any scheme specific parts are included in the filter, then an Intent's data
must match one of them. If no scheme specific parts are included, then only the scheme
must match.
The "scheme specific part" that this matches against is the string returned
by Uri.getSchemeSpecificPart. For Uris that contain a path, this kind of matching is
not generally of interest, since addDataAuthority(String,
String) and addDataPath(String, int) can provide a better mechanism for
matching them. However, for Uris that do not contain a path, the authority and path are
empty, so this is the only way to match against the non-scheme part.
Parameters
ssp String: Either a raw string that must exactly match the scheme specific part path, or a simple pattern, dep
on type.
typ int: Determines how ssp will be compared to determine a match: either PATTERN_LITERAL, PATTERN_P

e or PATTERN_SIMPLE_GLOB.
See also:

addDataType
void addDataType (String type)
Add a new Intent data type to match against. If any types are included in the filter, then
an Intent's data must be either one of these types or a matching scheme. If no data
types are included, then an Intent will only match if it specifies no data.
Note: MIME type matching in the Android framework is case-sensitive, unlike formal
RFC MIME types. As a result, you should always write your MIME types with lower
case letters, and any MIME types you receive from outside of Android should be
converted to lower case before supplying them here.
Throws IntentFilter.MalformedMimeTypeException if the given MIME type is not

syntactically correct.
Parameters
type String: Name of the data type to match, such as

"vnd.android.cursor.dir/person".
Throws
IntentFilter.MalformedMimeTypeException
See also:
authoritiesIterator
Iterator<IntentFilter.AuthorityEntry> authoritiesIterator ()
Return an iterator over the filter's data authorities.
Returns
Iterator<IntentFilter.AuthorityEntry>
categoriesIterator
Iterator<String> categoriesIterator ()
Return an iterator over the filter's categories.
Returns
Iterator<String> Iterator if this filter has categories or null if none.
countActions
int countActions ()
Return the number of actions in the filter.
Returns
int
countCategories
int countCategories ()
Return the number of categories in the filter.
Returns
int
countDataAuthorities
int countDataAuthorities ()
Return the number of data authorities in the filter.
Returns
int
countDataPaths
int countDataPaths ()
Return the number of data paths in the filter.
Returns
int
countDataSchemeSpecificParts
int countDataSchemeSpecificParts ()
Return the number of data scheme specific parts in the filter.
Returns
int
countDataSchemes
int countDataSchemes ()
Return the number of data schemes in the filter.
Returns
int
countDataTypes
int countDataTypes ()
Return the number of data types in the filter.
Returns
int
create
IntentFilter create (String action,
String dataType)
Create a new IntentFilter instance with a specified action and MIME type, where you
know the MIME type is correctly formatted. This catches
the IntentFilter.MalformedMimeTypeException exception that the constructor can
call and turns it into a runtime exception.
Parameters
action String: The action to match, such as Intent.ACTION_VIEW.
dataType String: The type to match, such as "vnd.android.cursor.dir/person".
Returns
IntentFilter A new IntentFilter for the given action and type.
See also:
 IntentFilter(String, String)
describeContents
int describeContents ()
Describe the kinds of special objects contained in this Parcelable instance's marshaled
representation. For example, if the object will include a file descriptor in the output
of writeToParcel(Parcel, int), the return value of this method must include
the CONTENTS_FILE_DESCRIPTOR bit.
Returns
int a bitmask indicating the set of special object types marshaled by this Parcelable object instance.
dump
void dump (Printer du,
String prefix)
Parameters
du Printer
prefix String
getAction
String getAction (int index)
Return an action in the filter.
Parameters
index int
Returns
String
getCategory
String getCategory (int index)
Return a category in the filter.
Parameters
index int
Returns
String
getDataAuthority
IntentFilter.AuthorityEntry getDataAuthority (int index)
Return a data authority in the filter.
Parameters
index int
Returns
IntentFilter.AuthorityEntry
getDataPath
PatternMatcher getDataPath (int index)
Return a data path in the filter.
Parameters
index int
Returns
PatternMatcher
getDataScheme
String getDataScheme (int index)
Return a data scheme in the filter.
Parameters
index int
Returns
String
getDataSchemeSpecificPart
PatternMatcher getDataSchemeSpecificPart (int index)
Return a data scheme specific part in the filter.
Parameters
index int
Returns
PatternMatcher
getDataType
String getDataType (int index)

Return a data type in the filter.
Parameters
index int
Returns
String
getPriority
int getPriority ()
Return the priority of this filter.
Returns
int The priority of the filter.
See also:
hasAction
boolean hasAction (String action)
Is the given action included in the filter? Note that if the filter does not include any
actions, false will always be returned.
Parameters
action String: The action to look for.
Returns
boolean True if the action is explicitly mentioned in the filter.
hasCategory
boolean hasCategory (String category)
Is the given category included in the filter?
Parameters
category String: The category that the filter supports.
Returns
boolean True if the category is explicitly mentioned in the filter.
hasDataAuthority
boolean hasDataAuthority (Uri data)
Is the given data authority included in the filter? Note that if the filter does not include
any authorities, false will always be returned.
Parameters
data Uri: The data whose authority is being looked for.
Returns
boolean Returns true if the data string matches an authority listed in the filter.
hasDataPath
boolean hasDataPath (String data)
Is the given data path included in the filter? Note that if the filter does not include any
paths, false will always be returned.
Parameters
data String: The data path to look for. This is without the scheme prefix.
Returns
boolean True if the data string matches a path listed in the filter.
hasDataScheme
boolean hasDataScheme (String scheme)
Is the given data scheme included in the filter? Note that if the filter does not include any
scheme, false will always be returned.
Parameters
scheme String: The data scheme to look for.
Returns
boolean True if the scheme is explicitly mentioned in the filter.

hasDataSchemeSpecificPart
boolean hasDataSchemeSpecificPart (String data)
Is the given data scheme specific part included in the filter? Note that if the filter does
not include any scheme specific parts, false will always be returned.
Parameters
data String: The scheme specific part that is being looked for.
Returns
boolean Returns true if the data string matches a scheme specific part listed in the filter.
hasDataType
boolean hasDataType (String type)
Is the given data type included in the filter? Note that if the filter does not include any
type, false will always be returned.
Parameters
type String: The data type to look for.
Returns
boolean True if the type is explicitly mentioned in the filter.
match
int match (String action,
String type,
String scheme,
Uri data,
Set<String> categories,
String logTag)
Test whether this filter matches the given intent data. A match is only successful if the
actions and categories in the Intent match against the filter, as described
in IntentFilter; in that case, the match result returned will be as
per matchData(String, String, Uri).
Parameters
action String: The intent action to match against (Intent.getAction).
type String: The intent type to match against (Intent.resolveType()).
scheme String: The data scheme to match against (Intent.getScheme()).
data Uri: The data URI to match against (Intent.getData()).
categories Set: The categories to match against (Intent.getCategories()).
logTag String: Tag to use in debugging messages.
Returns
int Returns either a valid match constant (a combination

of MATCH_CATEGORY_MASK and MATCH_ADJUSTMENT_MASK), or one of the error codes NO_MATCH
the type didn't match, NO_MATCH_DATA if the scheme/path didn't match, NO_MATCH_ACTION if the
didn't match, or NO_MATCH_CATEGORY if one or more categories didn't match.
See also:

 getAction()
 resolveType(ContentResolver)
 getScheme()
 getData()
 getCategories()
match
int match (ContentResolver resolver,
Intent intent,
boolean resolve,
String logTag)
Test whether this filter matches the given intent.
Parameters
resolver ContentResolver
intent Intent: The Intent to compare against.
resolve boolean: If true, the intent's type will be resolved by calling Intent.resolveType(); otherwise a simple m
against Intent.type will be performed.
logTag String: Tag to use in debugging messages.
Returns
int Returns either a valid match constant (a combination

of MATCH_CATEGORY_MASK and MATCH_ADJUSTMENT_MASK), or one of the error codes NO_MATCH_T
type didn't match, NO_MATCH_DATA if the scheme/path didn't match, NO_MATCH_ACTION if the action
match, or NO_MATCH_CATEGORY if one or more categories didn't match.
See also:
 match(String, String, String, android.net.Uri, Set, String)

matchAction
boolean matchAction (String action)
Match this filter against an Intent's action. If the filter does not specify any actions, the
match will always fail.
Parameters
action String: The desired action to look for.
Returns
boolean True if the action is listed in the filter.
matchCategories
String matchCategories (Set<String> categories)
Match this filter against an Intent's categories. Each category in the Intent must be
specified by the filter; if any are not in the filter, the match fails.
Parameters
categories Set: The categories included in the intent, as returned by Intent.getCategories().
Returns
String If all categories match (success), null; else the name of the first category that didn't match.
matchData
int matchData (String type,
String scheme,
Uri data)
Match this filter against an Intent's data (type, scheme and path). If the filter does not
specify any types and does not specify any schemes/paths, the match will only succeed
if the intent does not also specify a type or data. If the filter does not specify any
schemes, it will implicitly match intents with no scheme, or the schemes "content:" or
"file:" (basically performing a MIME-type only match). If the filter does not specify any
MIME types, the Intent also must not specify a MIME type.
Be aware that to match against an authority, you must also specify a base scheme the
authority is in. To match against a data path, both a scheme and authority must be
specified. If the filter does not specify any types or schemes that it matches against, it is
considered to be empty (any authority or data path given is ignored, as if it were empty
as well).
Note: MIME type, Uri scheme, and host name matching in the Android framework is
case-sensitive, unlike the formal RFC definitions. As a result, you should always write
these elements with lower case letters, and normalize any MIME types or Uris you
receive from outside of Android to ensure these elements are lower case before
supplying them here.
Parameters
type String: The desired data type to look for, as returned by Intent.resolveType().
scheme String: The desired data scheme to look for, as returned by Intent.getScheme().
data Uri: The full data string to match against, as supplied in Intent.data.
Returns
int Returns either a valid match constant (a combination of MATCH_CATEGORY_MASK and MATCH_ADJUSTM

or one of the error codes NO_MATCH_TYPE if the type didn't match or NO_MATCH_DATA if the scheme/pa
match.
See also:
 match(ContentResolver, Intent, boolean, String)

matchDataAuthority
int matchDataAuthority (Uri data)
Match this intent filter against the given Intent data. This ignores the data scheme --
unlike matchData(String, String, Uri), the authority will match regardless of
whether there is a matching scheme.
Parameters
dat Uri: The data whose authority is being looked for.

a
Returns
int Returns either MATCH_CATEGORY_HOST, MATCH_CATEGORY_PORT, NO_MATCH_DATA.
pathsIterator
Iterator<PatternMatcher> pathsIterator ()
Return an iterator over the filter's data paths.
Returns
Iterator<PatternMatcher
>
readFromXml
void readFromXml (XmlPullParser parser)

Parameters
parser XmlPullParser
Throws
XmlPullParserException
IOException
schemeSpecificPartsIterator
Iterator<PatternMatcher> schemeSpecificPartsIterator ()
Return an iterator over the filter's data scheme specific parts.
Returns
Iterator<PatternMatcher
>
schemesIterator
Iterator<String> schemesIterator ()
Return an iterator over the filter's data schemes.
Returns
Iterator<String>
setPriority
void setPriority (int priority)
Modify priority of this filter. This only affects receiver filters. The priority of activity filters
are set in XML and cannot be changed programatically. The default priority is 0. Positive
values will be before the default, lower values will be after it. Applications should use a
value that is larger than SYSTEM_LOW_PRIORITY and smaller
than SYSTEM_HIGH_PRIORITY .
Parameters
priority int: The new priority value.
See also:
 getPriority()
 SYSTEM_LOW_PRIORITY
 SYSTEM_HIGH_PRIORITY
typesIterator
Iterator<String> typesIterator ()
Return an iterator over the filter's data types.
Returns
Iterator<String>
writeToParcel
void writeToParcel (Parcel dest,
int flags)
Flatten this object in to a Parcel.
Parameters
dest Parcel: The Parcel in which the object should be written.
flags int: Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_
writeToXml
void writeToXml (XmlSerializer serializer)
Write the contents of the IntentFilter as an XML stream.
Parameters
serializer XmlSerializer
Throws
IOException

Intent Filter

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Intent Filter

Uploaded by

Copyright:

Available Formats

IntentFilter

public class IntentFilter

Structured description of Intent values to be matched. An IntentFilter can match against

IntentFilter objects are often created in XML as part of a

This is an entry for a single authority in the Iterator returned by authoritiesIterator().

The filter matched an intent that had no data specified.

The filter didn't match due to different actions.

The filter didn't match due to different data URIs.

The filter didn't match due to different MIME types.

public static CREATOR

New empty IntentFilter.

New IntentFilter that matches a single action

New IntentFilter that matches a single action

New IntentFilter containing a copy of an existing

Return an iterator over the filter's actions.

final void addAction(String action)

Add a new Intent action to match against.

final void addCategory(String category)

Add a new Intent category to match against.

final void addDataAuthority(String host, String port)

Add a new Intent data authority to match against.

final void addDataPath(String path, int type)

Add a new Intent data path to match against.

final void addDataScheme(String scheme)

Add a new Intent data scheme to match against.

Add a new Intent data "scheme specific part" to match against.

final void addDataType(String type)

Add a new Intent data type to match against.

Return an iterator over the filter's categories.

final int countActions()

Return the number of actions in the filter.

final int countCategories()

Return the number of categories in the filter.

final int countDataAuthorities()

Return the number of data authorities in the filter.

final int countDataPaths()

Return the number of data paths in the filter.

final int countDataSchemeSpecificParts()

Return the number of data scheme specific parts in the filter.

final int countDataSchemes()

Return the number of data schemes in the filter.

final int countDataTypes()

Return the number of data types in the filter.

Create a new IntentFilter instance with a specified action and MI

final int describeContents()

Describe the kinds of special objects contained in this Parcelable

final String getAction(int index)

Return an action in the filter.

final String getCategory(int index)

Return a category in the filter.

final IntentFilter.AuthorityEntry getDataAuthority(int index)

Return a data authority in the filter.

final PatternMatcher getDataPath(int index)

Return a data path in the filter.

final String getDataScheme(int index)

Return a data scheme in the filter.

final PatternMatcher getDataSchemeSpecificPart(int index)

Return a data scheme specific part in the filter.

final String getDataType(int index)

Return a data type in the filter.

final int getPriority()

Return the priority of this filter.

final boolean hasAction(String action)