Build 1.0_r1(from source)

android.content
Class ComponentName

java.lang.Object
  extended by android.content.ComponentName
All Implemented Interfaces:
Parcelable

public final class ComponentName
extends Object
implements Parcelable

Identifier for a specific application component (Activity, Service, BroadcastReceiver, 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.


Nested Class Summary
 
Nested classes/interfaces inherited from interface android.os.Parcelable
Parcelable.Creator<T>
 
Field Summary
static Parcelable.Creator<ComponentName> CREATOR
           
 
Fields inherited from interface android.os.Parcelable
CONTENTS_FILE_DESCRIPTOR, PARCELABLE_WRITE_RETURN_VALUE
 
Constructor Summary
ComponentName(Context pkg, Class<?> cls)
          Create a new component identifier from a Context and Class object.
ComponentName(Context pkg, String cls)
          Create a new component identifier from a Context and class name.
ComponentName(Parcel in)
          Instantiate a new ComponentName from the data in a Parcel that was previously written with writeToParcel(Parcel, int).
ComponentName(String pkg, String cls)
          Create a new component identifier.
 
Method Summary
 int describeContents()
          Describe the kinds of special objects contained in this Parcelable's marshalled representation.
 boolean equals(Object obj)
          Compares the argument to the receiver, and returns true if they represent the same object using a class specific comparison.
 String flattenToShortString()
          The samee as flattenToString(), but abbreviates the class name if it is a suffix of the package.
 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.
 String getShortClassName()
          Return the class name, either fully qualified or in a shortened form (with a leading '.') if it is a suffix of the package.
 int hashCode()
          Returns 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()
          Returns 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().
static void writeToParcel(ComponentName c, Parcel out)
          Write a ComponentName to a Parcel, handling null pointers.
 void writeToParcel(Parcel out, int flags)
          Flatten this object in to a Parcel.
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Field Detail

CREATOR

public static final Parcelable.Creator<ComponentName> CREATOR
Constructor Detail

ComponentName

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.

ComponentName

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.

ComponentName

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.

ComponentName

public ComponentName(Parcel in)
Instantiate a new ComponentName from the data in a Parcel that was previously written with writeToParcel(Parcel, int). 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.
Method Detail

getPackageName

public String getPackageName()
Return the package name of this component.


getClassName

public String getClassName()
Return the class name of this component.


getShortClassName

public String getShortClassName()
Return the class name, either fully qualified or in a shortened form (with a leading '.') if it is a suffix of the package.


flattenToString

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:
unflattenFromString(String)

flattenToShortString

public String flattenToShortString()
The samee as flattenToString(), but abbreviates the class name if it is a suffix of the package. The result can still be used with 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:
unflattenFromString(String)

unflattenFromString

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:
flattenToString()

toShortString

public String toShortString()
Return string representation of this class without the class's name as a prefix.


toString

public String toString()
Description copied from class: Object
Returns a string containing a concise, human-readable description of the receiver.

Overrides:
toString in class Object
Returns:
String a printable representation for the receiver.

equals

public boolean equals(Object obj)
Description copied from class: Object
Compares the argument to the receiver, and returns true if they represent the same object using a class specific comparison. The implementation in Object returns true only if the argument is the exact same object as the receiver (==).

Overrides:
equals in class Object
Parameters:
obj - Object the object to compare with this object.
Returns:
boolean true if the object is the same as this object false if it is different from this object.
See Also:
Object.hashCode()

hashCode

public int hashCode()
Description copied from class: Object
Returns 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.

Overrides:
hashCode in class Object
Returns:
int the receiver's hash.
See Also:
Object.equals(java.lang.Object)

describeContents

public int describeContents()
Description copied from interface: Parcelable
Describe the kinds of special objects contained in this Parcelable's marshalled representation.

Specified by:
describeContents in interface Parcelable
Returns:
a bitmask indicating the set of special object types marshalled by the Parcelable.

writeToParcel

public void writeToParcel(Parcel out,
                          int flags)
Description copied from interface: Parcelable
Flatten this object in to a Parcel.

Specified by:
writeToParcel in interface Parcelable
Parameters:
out - The Parcel in which the object should be written.
flags - Additional flags about how the object should be written. May be 0 or Parcelable.PARCELABLE_WRITE_RETURN_VALUE.

writeToParcel

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:
readFromParcel(Parcel)

readFromParcel

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:
writeToParcel(ComponentName, Parcel)

Build 1.0_r1(from source)

Please submit a feedback, bug or feature