ElementName

java.lang.Object
- ohos.bundle.ElementName

所有已实现的接口:

Sequenceable
```
public class ElementName
extends Object
implements Sequenceable
```
Contains basic Ability information, which uniquely identifies an ability.
You can use this class to obtain values of the fields set in an element, such as the device ID, bundle name, and ability name.

从以下版本开始:

1

嵌套类概要
- 从接口继承的嵌套类/接口 ohos.utils.Sequenceable
  Sequenceable.Producer<T>

字段概要

字段
限定符和类型字段说明

static Sequenceable.Producer<ElementName> PRODUCER
Creates a ElementName instance from a Parcel.

字段
限定符和类型	字段	说明
`static Sequenceable.Producer<ElementName>`	`PRODUCER`	Creates a `ElementName` instance from a `Parcel`.

构造器概要

构造器
构造器	说明
`ElementName()`	Default constructor used to create an `ElementName` instance.
`ElementName(String deviceId, String bundleName, String abilityName)`	A parameterized constructor used to create an `ElementName` instance.
`ElementName(ElementName elementName)`	A parameterized constructor used to create an `ElementName` instance by copying parameters from an existing one.

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法	说明
`static ElementName`	`createRelative(String bundleName, String abilityName, String deviceId)`	Creates another `ElementName` instance where the class name of the ability is prefixed with the package name.
`boolean`	`equals(Object object)`	Checks whether two `ElementName` objects contain the same attributes.
`String`	`getAbilityName()`	Obtains the name of an ability.
`String`	`getBundleName()`	Obtains the bundle name of an ability.
`String`	`getDeviceId()`	Obtains the unique device ID of an ability.
`String`	`getShortClassName()`	Obtains the short class name of the ability in the current `ElementName` instance.
`String`	`getURI()`	Obtains the URI of an ability.
`int`	`hashCode()`	Calculates the hash value of an `ElementName` object.
`boolean`	`marshalling(Parcel out)`	Marshals this `Sequenceable` object into a `Parcel`.
`void`	`setAbilityName(String name)`	Sets the ability name.
`void`	`setBundleName(String bundleName)`	Sets the bundle name for an ability.
`void`	`setDeviceId(String deviceId)`	Sets the device ID.
`static ElementName`	`unflattenFromString(String elementName)`	Restores an `ElementName` instance from the string created using `getURI()`.
`boolean`	`unmarshalling(Parcel in)`	Unmarshals this `Sequenceable` object from a `Parcel`.

从类继承的方法 java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

从接口继承的方法 ohos.utils.Sequenceable
hasFileDescriptor

- 字段详细资料
  - PRODUCER
```
public static final Sequenceable.Producer<ElementName> PRODUCER
```
    Creates a ElementName instance from a Parcel.
    
    从以下版本开始:
    
    4
- 构造器详细资料
  - ElementName
```
public ElementName()
```
    Default constructor used to create an ElementName instance.
    
    从以下版本开始:
    
    1
  - ElementName
```
public ElementName(String deviceId,
                   String bundleName,
                   String abilityName)
```
    A parameterized constructor used to create an ElementName instance.
    
    参数:
    
    deviceId - Indicates the ID of the device running the specified ability.
    
    bundleName - Indicates the name of the bundle to which the specified ability belongs.
    
    abilityName - Indicates the ability name.
    
    从以下版本开始:
    
    1
  - ElementName
```
public ElementName(ElementName elementName)
```
    A parameterized constructor used to create an ElementName instance by copying parameters from an existing one.
    
    参数:
    
    elementName - Indicates the ElementName object.
    
    从以下版本开始:
    
    1
- 方法详细资料
  - getDeviceId
```
public String getDeviceId()
```
    Obtains the unique device ID of an ability.
    
    返回:
    
    Returns the unique device ID of the ability.
    
    从以下版本开始:
    
    1
  - setDeviceId
```
public void setDeviceId(String deviceId)
```
    Sets the device ID.
    
    参数:
    
    deviceId - Indicates the device ID. An ability has only one device ID.
    
    从以下版本开始:
    
    1
  - getAbilityName
```
public String getAbilityName()
```
    Obtains the name of an ability.
    
    返回:
    
    Returns the name of the ability.
    
    从以下版本开始:
    
    1
  - setAbilityName
```
public void setAbilityName(String name)
```
    Sets the ability name.
    
    参数:
    
    name - Indicates the name of the ability.
    
    从以下版本开始:
    
    1
  - getBundleName
```
public String getBundleName()
```
    Obtains the bundle name of an ability.
    
    返回:
    
    Returns the bundle name of the ability.
    
    从以下版本开始:
    
    1
  - setBundleName
```
public void setBundleName(String bundleName)
```
    Sets the bundle name for an ability.
    
    参数:
    
    bundleName - Indicates the bundle name for the ability.
    
    从以下版本开始:
    
    1
  - getURI
```
public String getURI()
```
    Obtains the URI of an ability.
    The URI of an ability is determined by the deviceId, bundleName, and abilityName attributes.
    
    返回:
    
    Returns the URI of the ability.
    
    从以下版本开始:
    
    1
  - marshalling
```
public boolean marshalling(Parcel out)
```
    从接口复制的说明: Sequenceable
    
    Marshals this Sequenceable object into a Parcel.
    
    指定者:
    
    marshalling 在接口中 Sequenceable
    
    参数:
    
    out - Indicates the Parcel object to which the Sequenceable object will be marshaled..
    
    返回:
    
    Returns true if the marshalling is successful; returns false otherwise.
    
    另请参阅:
    
    Sequenceable.marshalling(Parcel)
  - unmarshalling
```
public boolean unmarshalling(Parcel in)
```
    从接口复制的说明: Sequenceable
    
    Unmarshals this Sequenceable object from a Parcel.
    
    指定者:
    
    unmarshalling 在接口中 Sequenceable
    
    参数:
    
    in - Indicates the Parcel object into which the Sequenceable object has been marshaled.
    
    返回:
    
    Returns true if the unmarshalling is successful; returns false otherwise.
    
    另请参阅:
    
    Sequenceable.unmarshalling(Parcel)
  - equals
```
public boolean equals(Object object)
```
    Checks whether two ElementName objects contain the same attributes.
    ElementName contains information required for an application to query an ability. This class contains the abilityName, bundleName, and deviceId attributes of an application.
    
    覆盖:
    
    equals 在类中 Object
    
    参数:
    
    object - Indicates the ElementName object to compare.
    
    返回:
    
    Returns true if the two ElementName objects contain the same attributes; returns false otherwise.
    
    从以下版本开始:
    
    1
    
    另请参阅:
    
    Object.hashCode(), HashMap
  - hashCode
```
public int hashCode()
```
    Calculates the hash value of an ElementName object.
    The hash value of an ElementName object is calculated based on the deviceId, bundleName, and abilityName attributes.
    
    覆盖:
    
    hashCode 在类中 Object
    
    返回:
    
    Returns the hash value of the ElementName object.
    
    从以下版本开始:
    
    1
    
    另请参阅:
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - createRelative
```
public static ElementName createRelative(String bundleName,
                                         String abilityName,
                                         String deviceId)
```
    Creates another ElementName instance where the class name of the ability is prefixed with the package name.
    
    参数:
    
    bundleName - Indicates the name of the bundle to which the specified ability belongs. This parameter cannot be null.
    
    abilityName - Indicates the class name of the ability. This parameter cannot be null.
    
    deviceId - Indicates the ID of the device running the specified ability.
    
    返回:
    
    Returns the created ElementName instance.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if abilityName is null or an empty string.
    
    从以下版本开始:
    
    3
  - getShortClassName
```
public String getShortClassName()
```
    Obtains the short class name of the ability in the current ElementName instance.
    The short class name is not prefixed with the package name. Instead, it starts with a period (.), for example, .MainAbility.
    
    返回:
    
    Returns the short class name of the ability in the current ElementName instance.
    
    从以下版本开始:
    
    3
  - unflattenFromString
```
public static ElementName unflattenFromString(String elementName)
```
    Restores an ElementName instance from the string created using getURI().
    The string must be in the format deviceId/bundleName/abilityName, for example, deviceId1/com.abc.hiword/com.abc.hiword.MainAbility.
    
    参数:
    
    elementName - Indicates the string representing the element name, which is obtained from getURI(). This parameter cannot be null.
    
    返回:
    
    Returns an ElementName instance.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if elementName is null or is not in the specified format.
    
    从以下版本开始:
    
    3

类 ElementName

嵌套类概要

从接口继承的嵌套类/接口 ohos.utils.Sequenceable

字段概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

从接口继承的方法 ohos.utils.Sequenceable

字段详细资料

PRODUCER

构造器详细资料

ElementName

ElementName

ElementName

方法详细资料

getDeviceId

setDeviceId

getAbilityName

setAbilityName

getBundleName

setBundleName

getURI

marshalling

unmarshalling

equals

hashCode

createRelative

getShortClassName

unflattenFromString