java.lang.Object | |
↳ | android.content.ComponentName |
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.
[Expand]
Inherited Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From interface
android.os.Parcelable
|
Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
CREATOR |
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Create a new component identifier.
| |||||||||||
Create a new component identifier from a Context and class name.
| |||||||||||
Create a new component identifier from a Context and Class object.
| |||||||||||
Instantiate a new ComponentName from the data in a Parcel that was
previously written with
writeToParcel(Parcel, int) . |
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Creates and returns a copy of this
Object . | |||||||||||
Describe the kinds of special objects contained in this Parcelable's
marshalled representation.
| |||||||||||
Compares this instance with the specified object and indicates if they
are equal.
| |||||||||||
The same as
flattenToString() , but abbreviates the class
name if it is a suffix of the package. | |||||||||||
Return a String that unambiguously describes both the package and
class names contained in the ComponentName.
| |||||||||||
Return the class name of this component.
| |||||||||||
Return the package name of this component.
| |||||||||||
Return the class name, either fully qualified or in a shortened form
(with a leading '.') if it is a suffix of the package.
| |||||||||||
Returns an integer hash code for this object.
| |||||||||||
Read a ComponentName from a Parcel that was previously written
with
writeToParcel(ComponentName, Parcel) , returning either
a null or new object as appropriate. | |||||||||||
Return string representation of this class without the class's name
as a prefix.
| |||||||||||
Returns a string containing a concise, human-readable description of this
object.
| |||||||||||
Recover a ComponentName from a String that was previously created with
flattenToString() . | |||||||||||
Flatten this object in to a Parcel.
| |||||||||||
Write a ComponentName to a Parcel, handling null pointers.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
| |||||||||||
From interface
android.os.Parcelable
| |||||||||||
From interface
java.lang.Comparable
|
Create a new component identifier.
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. |
Create a new component identifier from a Context and class name.
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. |
Create a new component identifier from a Context and Class object.
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. |
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.
in | The Parcel containing the previously written ComponentName, positioned at the location in the buffer where it was written. |
---|
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 call super.clone()
to create the new instance and then create deep copies of the nested,
mutable objects.
Describe the kinds of special objects contained in this Parcelable's marshalled representation.
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
. See Writing a correct
equals
method
if you intend implementing your own equals
method.
The general contract for the equals
and hashCode()
methods is that if equals
returns true
for
any two objects, then hashCode()
must return the same value for
these objects. This means that subclasses of Object
usually
override either both methods or neither of them.
obj | the object to compare this instance with. |
---|
true
if the specified object is equal to this Object
; false
otherwise.The same as flattenToString()
, but abbreviates the class
name if it is a suffix of the package. The result can still be used
with unflattenFromString(String)
.
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)
.
Return the class name, either fully qualified or in a shortened form (with a leading '.') if it is a suffix of the package.
Returns an integer hash code for this object. By contract, any two
objects for which equals(Object)
returns true
must return
the same hash code value. This means that subclasses of Object
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 own hashCode
method.
Read a ComponentName from a Parcel that was previously written
with writeToParcel(ComponentName, Parcel)
, returning either
a null or new object as appropriate.
in | The Parcel from which to read the ComponentName |
---|
Return string representation of this class without the class's name as a prefix.
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 own toString
method.
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".
str | The String that was returned by flattenToString(). |
---|
Flatten this object in to a Parcel.
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 .
|
Write a ComponentName to a Parcel, handling null pointers. Must be
read with readFromParcel(Parcel)
.
c | The ComponentName to be written. |
---|---|
out | The Parcel in which the ComponentName will be placed. |