鴻蒙OS ElementName

ElementName

java.lang.Object

|---ohos.bundle.ElementName

public class ElementName
extends Object
implements Sequenceable

包含基本的ability信息，它唯一地標(biāo)識(shí)一個(gè)ability。

您可以使用此類獲取元素中設(shè)置的字段的值，例如設(shè)備 ID、捆綁包名稱和ability名稱。

嵌套類摘要

從接口 ohos.utils.Sequenceable 繼承的嵌套類/接口
Sequenceable.ProducerT

字段摘要

修飾符和類型	字段	描述
static Sequenceable.ProducerElementName	PRODUCER	Creates a ElementName instance from a Parcel.

構(gòu)造函數(shù)摘要

構(gòu)造函數(shù)	描述
ElementName()	用于創(chuàng)建 ElementName 實(shí)例的默認(rèn)構(gòu)造函數(shù)。
ElementName(String deviceId, String bundleName, String abilityName)	用于創(chuàng)建 ElementName 實(shí)例的參數(shù)化構(gòu)造函數(shù)。
ElementName(ElementName elementName)	一種參數(shù)化構(gòu)造函數(shù)，用于通過(guò)從現(xiàn)有參數(shù)復(fù)制參數(shù)來(lái)創(chuàng)建 ElementName 實(shí)例。

方法總結(jié)

修飾符和類型	方法	描述
static ElementName	createRelative(String bundleName, String abilityName, String deviceId)	創(chuàng)建另一個(gè) ElementName 實(shí)例，其中ability的類名稱以包名稱為前綴。
boolean	equals(Object object)	檢查兩個(gè) ElementName 對(duì)象是否包含相同的屬性。
String	getAbilityName()	獲得ability的名稱。
String	getBundleName()	獲取ability的捆綁包名稱。
String	getDeviceId()	獲取ability的唯一設(shè)備ID。
String	getShortClassName()	獲取當(dāng)前 ElementName 實(shí)例中ability的短類名。
String	getURI()	獲取ability的URI。
int	hashCode()	計(jì)算 ElementName 對(duì)象的哈希值。
boolean	marshalling(Parcel out)	將此 Sequenceable 對(duì)象編組為 Parcel。
void	setAbilityName(String name)	設(shè)置ability名稱。
void	setBundleName(String bundleName)	設(shè)置ability的捆綁包名稱。
void	setDeviceId(String deviceId)	設(shè)置設(shè)備ID
static ElementName	unflattenFromString(String elementName)	從使用 getURI() 創(chuàng)建的字符串中恢復(fù) ElementName 實(shí)例。
boolean	unmarshalling(Parcel in)	從 Parcel 中解組此 Sequenceable 對(duì)象。

從類 java.lang.Object 繼承的方法
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

從接口 ohos.utils.Sequenceable 繼承的方法
hasFileDescriptor

字段詳情

PRODUCER

public static final Sequenceable.ProducerElementName PRODUCER

從 Parcel 創(chuàng)建一個(gè) ElementName 實(shí)例。

構(gòu)造函數(shù)詳細(xì)信息

ElementName

public ElementName()

用于創(chuàng)建 ElementName 實(shí)例的默認(rèn)構(gòu)造函數(shù)。

ElementName

public ElementName(String deviceId, String bundleName, String abilityName)

用于創(chuàng)建 ElementName 實(shí)例的參數(shù)化構(gòu)造函數(shù)。

參數(shù):

參數(shù)名稱	參數(shù)描述
deviceId	表示運(yùn)行指定ability的設(shè)備的ID。
bundleName	表示指定ability所屬的捆綁包的名稱。
abilityName	表示ability名稱。

ElementName

public ElementName(ElementName elementName)

一種參數(shù)化構(gòu)造函數(shù)，用于通過(guò)從現(xiàn)有參數(shù)復(fù)制參數(shù)來(lái)創(chuàng)建 ElementName 實(shí)例。

參數(shù):

參數(shù)名稱	參數(shù)描述
elementName	指示 ElementName 對(duì)象。

方法詳情

getDeviceId

public String getDeviceId()

獲取技能的唯一設(shè)備ID。

返回:

返回能力的唯一設(shè)備 ID。

setDeviceId

public void setDeviceId(String deviceId)

設(shè)置設(shè)備ID

參數(shù):

參數(shù)名稱	參數(shù)描述
deviceId	表示設(shè)備ID。 一項(xiàng)ability只有一個(gè)設(shè)備 ID。

Since:

1

getAbilityName

public String getAbilityName()

獲得ability的名稱。

返回:

返回ability的名稱。

setAbilityName

public void setAbilityName(String name)

設(shè)置ability名稱

參數(shù):

參數(shù)名稱	參數(shù)描述
name	表示ability的名稱。

getBundleName

public String getBundleName()

獲取ability的捆綁包名稱。

返回:

返回ability的捆綁包名稱。

setBundleName

public void setBundleName(String bundleName)

設(shè)置ability的捆綁包名稱。

參數(shù):

參數(shù)名稱	參數(shù)描述
bundleName	指示ability的捆綁包名稱。

getURI

public String getURI()

獲取ability的URI。

ability的 URI 由 deviceId、bundleName 和ability名稱屬性確定。

返回:

返回ability的 URI。

marshalling

public boolean marshalling(Parcel out)

從接口復(fù)制的描述：Sequenceable

將此 Sequenceable 對(duì)象編組為 Parcel。

指定者：

接口 Sequenceable 中的編組

參數(shù):

參數(shù)名稱	參數(shù)描述
out	指示將 Sequenceable 對(duì)象編組到的 Parcel 對(duì)象。

返回:

如果編組成功，則返回 true； 否則返回 false。

unmarshalling

public boolean unmarshalling(Parcel in)

從接口復(fù)制的描述：Sequenceable

從 Parcel 中解組此 Sequenceable 對(duì)象。

指定者：

在接口 Sequenceable 中解組

參數(shù):

參數(shù)名稱	參數(shù)描述
in	指示已將 Sequenceable 對(duì)象編組到的 Parcel 對(duì)象。

返回:

如果解組成功，則返回 true； 否則返回 false。

equals

public boolean equals(Object object)

檢查兩個(gè) ElementName 對(duì)象是否包含相同的屬性。

ElementName 包含應(yīng)用程序查詢ability所需的信息。 此類包含應(yīng)用程序的abilityName、bundleName 和 deviceId 屬性。

覆蓋：

類 Object 中的等于

參數(shù):

參數(shù)名稱	參數(shù)描述
object	指示要比較的 ElementName 對(duì)象。

返回:

如果兩個(gè) ElementName 對(duì)象包含相同的屬性，則返回 true； 否則返回 false。

hashCode

public int hashCode()

計(jì)算 ElementName 對(duì)象的哈希值。

ElementName 對(duì)象的哈希值是根據(jù) deviceId、bundleName 和abilityName 屬性計(jì)算的。

覆蓋：

類 Object 中的 hashCode

返回:

返回 ElementName 對(duì)象的哈希值。

createRelative

public static ElementName createRelative(String bundleName, String abilityName, String deviceId)

創(chuàng)建另一個(gè) ElementName 實(shí)例，其中ability的類名稱以包名稱為前綴。

參數(shù):

參數(shù)名稱	參數(shù)描述
bundleName	表示指定ability所屬的捆綁包的名稱。 此參數(shù)不能為空。
abilityName	表示ability的類名。 此參數(shù)不能為空。
deviceId	表示運(yùn)行指定ability的設(shè)備的ID。

返回:

返回創(chuàng)建的 ElementName 實(shí)例。

Throws:

Throw名稱	Throw描述
IllegalArgumentException	如果 abilityName 為 null 或空字符串，則引發(fā)此異常。

getShortClassName

public String getShortClassName()

獲取當(dāng)前 ElementName 實(shí)例中ability的短類名。

短類名不以包名為前綴。 相反，它以句點(diǎn) (.) 開頭，例如 .MainAbility。

返回:

返回當(dāng)前 ElementName 實(shí)例中ability的短類名稱。

unflattenFromString

public static ElementName unflattenFromString(String elementName)

從使用 getURI() 創(chuàng)建的字符串中恢復(fù) ElementName 實(shí)例。

該字符串必須采用 deviceId/bundleName/abilityName 格式，例如 deviceId1/com.abc.hiword/com.abc.hiword.MainAbility。

參數(shù):

參數(shù)名稱	參數(shù)描述
elementName	表示元素名稱的字符串，從getURI()中獲取。 此參數(shù)不能為空。

返回:

返回一個(gè) ElementName 實(shí)例。

Throws:

Throw名稱	Throw描述
IllegalArgumentException	如果 elementName 為 null 或不是指定格式，則引發(fā)此異常。