Reference:Android.content.ComponentName
From Triled Wiki
android.content
public final class android.content.ComponentName
| java.lang.Object | ||
| android.content.ComponentName | Parcelable | |
Identifier for a specific application component (Activity, Service, IntentReceiver, or ContentProvider ) that is available. Two pieces of information, encapsulated here, are required to identify a component: the package (a String) it exists in, and the class (a String) name inside of that package.
[edit] Summary
[edit] Constants
| Value | ||||
|---|---|---|---|---|
| Creator | CREATOR |
[edit] Public Constructors
| ComponentName (String pkg, String cls) | |||||
| Create a new component identifier. | |||||
| ComponentName (Context pkg, String cls) | |||||
| Create a new component identifier from a Context and class name. | |||||
| )">ComponentName (Context pkg, Class cls) | |||||
| Create a new component identifier from a Context and Class object. | |||||
| ComponentName (Parcel in) | |||||
| Instantiate a new ComponentName from the data in a Parcel that was previously written with writeToParcel(Parcel). | |||||
[edit] Public Methods
| boolean | equals (Object obj) | ||||
| Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison. | |||||
| String | flattenToString () | ||||
| Return a String that unambiguously describes both the package and class names contained in the ComponentName. | |||||
| String | getClassName () | ||||
| Return the class name of this component. | |||||
| String | getPackageName () | ||||
| Return the package name of this component. | |||||
| int | hashCode () | ||||
| Answers an integer hash code for the receiver. | |||||
| static | ComponentName | readFromParcel (Parcel in) | |||
| Read a ComponentName from a Parcel that was previously written with writeToParcel(ComponentName, Parcel), returning either a null or new object as appropriate. | |||||
| String | toShortString () | ||||
| Return string representation of this class without the class's name as a prefix. | |||||
| String | toString () | ||||
| Answers a string containing a concise, human-readable description of the receiver. | |||||
| static | ComponentName | unflattenFromString (String str) | |||
| Recover a ComponentName from a String that was previously created with flattenToString(). | |||||
| void | writeToParcel (Parcel out) | ||||
| static | void | writeToParcel (ComponentName c, Parcel out) | |||
| Write a ComponentName to a Parcel, handling null pointers. | |||||
[edit] Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait[edit] Methods inherited from interface android.os.Parcelable
[edit] Details
[edit] Constants
[edit] public static final Creator CREATOR
[edit] Public Constructors
[edit] public ComponentName(String pkg, String cls)
Create a new component identifier.
Parameters
| pkg | The name of the package that the component exists in. Can not be null. |
|---|---|
| cls | The name of the class inside of pkg that implements the component. Can not be null. |
[edit] public ComponentName(Context pkg, String cls)
Create a new component identifier from a Context and class name.
Parameters
| pkg | A Context for the package implementing the component, from which the actual package name will be retrieved. |
|---|---|
| cls | The name of the class inside of pkg that implements the component. |
[edit] public ComponentName(Context pkg, Class cls)
Create a new component identifier from a Context and Class object.
Parameters
| pkg | A Context for the package implementing the component, from which the actual package name will be retrieved. |
|---|---|
| cls | The Class object of the desired component, from which the actual class name will be retrieved. |
[edit] public ComponentName(Parcel in)
Instantiate a new ComponentName from the data in a Parcel that was previously written with writeToParcel(Parcel). Note that you must not use this with data written by writeToParcel(ComponentName, Parcel) since it is not possible to handle a null ComponentObject here.
Parameters
| in | The Parcel containing the previously written ComponentName, positioned at the location in the buffer where it was written. |
|---|
[edit] Public Methods
[edit] public boolean equals(Object obj)
Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison. The implementation in Object answers true only if the argument is the exact same object as the receiver (==).
Parameters
| obj | Object the object to compare with this object. |
|---|
[edit] public String flattenToString()
Return a String that unambiguously describes both the package and class names contained in the ComponentName. You can later recover the ComponentName from this string through unflattenFromString(String).
Returns
- Returns a new String holding the package and class names. This is represented as the package name, concatenated with a '/' and then the class name.
See Also
[edit] public String getClassName()
Return the class name of this component.
[edit] public String getPackageName()
Return the package name of this component.
[edit] public int hashCode()
Answers an integer hash code for the receiver. Any two objects which answer true when passed to .equals must answer the same value for this method.
[edit] public static ComponentName readFromParcel(Parcel in)
Read a ComponentName from a Parcel that was previously written with writeToParcel(ComponentName, Parcel), returning either a null or new object as appropriate.
Parameters
| in | The Parcel from which to read the ComponentName |
|---|
Returns
- Returns a new ComponentName matching the previously written object, or null if a null had been written.
See Also
[edit] public String toShortString()
Return string representation of this class without the class's name as a prefix.
[edit] public String toString()
Answers a string containing a concise, human-readable description of the receiver.
[edit] public static ComponentName unflattenFromString(String str)
Recover a ComponentName from a String that was previously created with flattenToString(). It splits the string at the first '/', taking the part before as the package name and the part after as the class name. As a special convenience (to use, for example, when parsing component names on the command line), if the '/' is immediately followed by a '.' then the final class name will be the concatenation of the package name with the string following the '/'. Thus "com.foo/.Blah" becomes package="com.foo" class="com.foo.Blah".
Parameters
| str | The String that was returned by flattenToString(). |
|---|
Returns
- Returns a new ComponentName containing the package and class names that were encoded in str
See Also
[edit] public void writeToParcel(Parcel out)
[edit] public static void writeToParcel(ComponentName c, Parcel out)
Write a ComponentName to a Parcel, handling null pointers. Must be read with readFromParcel(Parcel).
Parameters
| c | The ComponentName to be written. |
|---|---|
| out | The Parcel in which the ComponentName will be placed. |
See Also
[edit] References
- Original documentation page for Android SDK build m5-rc15e - 14 apr 2008 17:27
