Class Overview
Identifier for a specific application component (Activity ,Service ,BroadcastReceiver ,
orContentProvider ) 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.
Summary
[Expand]
Inherited Methods
|
From class
java.lang.Object
Object |
clone()
Creates and returns a copy of this Object .
|
boolean |
equals(Object
o)
Compares this instance with the specified object and indicates if they are equal.
|
void |
finalize()
Invoked when the garbage collector has detected that this instance is no longer reachable.
|
final
Class<?> |
getClass()
Returns the unique instance of Class that represents this object's class.
|
int |
hashCode()
Returns an integer hash code for this object.
|
final void |
notify()
Causes a thread which is waiting on this object's monitor (by means of calling one of thewait() methods) to be woken up.
|
final void |
notifyAll()
Causes all threads which are waiting on this object's monitor (by means of calling one of thewait() methods) to be woken up.
|
String |
toString()
Returns a string containing a concise, human-readable description of this object.
|
final void |
wait()
Causes the calling thread to wait until another thread calls thenotify() ornotifyAll() method of this object.
|
final void |
wait(long millis, int nanos)
Causes the calling thread to wait until another thread calls thenotify() ornotifyAll() method of this object or until the specified timeout expires.
|
final void |
wait(long millis)
Causes the calling thread to wait until another thread calls thenotify() ornotifyAll() method of this object or until the specified timeout expires.
|
|
From interface
android.os.Parcelable
abstract int |
describeContents()
Describe the kinds of special objects contained in this Parcelable's marshalled representation.
|
abstract void |
writeToParcel(Parcel
dest, int flags)
Flatten this object in to a Parcel.
|
|
From interface
java.lang.Comparable
abstract int |
compareTo(T another)
Compares this object to the specified object to determine their relative order.
|
|
Fields
Public Constructors
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. |
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. |
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. |
public ComponentName(Parcel in)
Parameters
in |
The Parcel containing the previously written ComponentName, positioned at the location in the buffer where it was written. |
Public Methods
Creates and returns a copy of this Object . The default implementation returns a so-called "shallow" copy: It creates a new instance of the same class and then copies the field values (including object references) from this instance to the new
instance. A "deep" copy, in contrast, would also recursively clone nested objects. A subclass that needs to implement this kind of cloning should callsuper.clone() to create the new instance and then create deep copies of the nested, mutable objects.
public int describeContents()
Describe the kinds of special objects contained in this Parcelable's marshalled representation.
Returns
- a bitmask indicating the set of special object types marshalled by the Parcelable.
public boolean equals(Object obj)
Compares this instance with the specified object and indicates if they are equal. In order to be equal,o must represent the same object as this instance using a class-specific comparison. The general contract is that this comparison should be
reflexive, symmetric, and transitive. Also, no object reference other than null is equal to null.
The default implementation returns true only if this == o . SeeWriting a correctequals method if you intend implementing your
ownequals method.
The general contract for the equals and hashCode() methods is that ifequals returnstrue for any two objects, thenhashCode()
must return the same value for these objects. This means that subclasses ofObject usually override either both methods or neither of them.
Parameters
obj |
the object to compare this instance with. |
Returns
true if the specified object is equal to this Object ;false otherwise.
public
String flattenToShortString
()
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.
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 throughunflattenFromString(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.
public
String getClassName ()
Return the class name of this component.
public
String getPackageName
()
Return the package name of this component.
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.
public int hashCode()
Returns an integer hash code for this object. By contract, any two objects for whichequals(Object) returnstrue must return the same
hash code value. This means that subclasses ofObject usually override both methods or neither method.
Note that hash values must not change over time unless information used in equals comparisons also changes.
See
Writing a correct hashCode method if you intend implementing your ownhashCode method.
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.
public
String toShortString
()
Return string representation of this class without the class's name as a prefix.
public
String toString ()
Returns a string containing a concise, human-readable description of this object. Subclasses are encouraged to override this method and provide an implementation that takes into account the object's type and data. The default implementation is equivalent
to the following expression:
getClass().getName() + '@' + Integer.toHexString(hashCode())
See
Writing a useful toString method if you intend implementing your owntoString method.
Returns
- a printable representation of this object.
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 instr
public void writeToParcel(Parcel out, int flags)
Flatten this object in to a Parcel.
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_WRITE_RETURN_VALUE . |
public static void writeToParcel(ComponentName c,Parcel
out)
Parameters
c |
The ComponentName to be written. |
out |
The Parcel in which the ComponentName will be placed. |
|