Reference:Android.content.ComponentName

From Triled Wiki

Jump to: navigation, search


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.

Contents

[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

writeToParcel

[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

Personal tools