鴻蒙OS IRemoteObject

IRemoteObject

public interface IRemoteObject

必須由服務(wù)提供者和用戶實現(xiàn)的遠(yuǎn)程對象接口。

該接口可用于查詢或獲取接口描述符、添加或刪除死亡通知、將對象狀態(tài)轉(zhuǎn)儲到特定文件以及發(fā)送消息。

嵌套類摘要

字段摘要

方法總結(jié)

字段詳細(xì)信息

DUMP_TRANSACTION

static final int DUMP_TRANSACTION

指示轉(zhuǎn)儲操作的消息代碼。

INTERFACE_TRANSACTION

static final int INTERFACE_TRANSACTION

指示傳輸?shù)南⒋a。

MAX_TRANSACTION_ID

static final int MAX_TRANSACTION_ID

表示有效消息代碼的最大值。

此常量用于檢查操作的有效性。

MIN_TRANSACTION_ID

static final int MIN_TRANSACTION_ID

指示有效消息代碼的最小值。

此常量用于檢查操作的有效性。

PING_TRANSACTION

static final int PING_TRANSACTION

指示 Ping 操作的消息代碼。

方法詳情

queryLocalInterface

IRemoteBroker queryLocalInterface(String descriptor)

查詢接口描述。

為服務(wù)提供者使用的接口返回一個有效的 IRemoteBroker 對象； 服務(wù)用戶使用的接口返回null，表示該接口不是本地接口。

參數(shù)：

返回:

返回綁定到指定接口描述符的 IRemoteBroker 對象。

sendRequest

boolean sendRequest(int code, MessageParcel data, MessageParcel reply, MessageOption option) throws RemoteException

以同步或異步模式向?qū)Φ冗M(jìn)程發(fā)送 MessageParcel 消息。

如果選項設(shè)置了異步模式，則立即返回響應(yīng)。 如果選項設(shè)置為同步模式，接口將等待對等進(jìn)程的響應(yīng)，直到請求超時。 用戶必須準(zhǔn)備回復(fù)以接收對等進(jìn)程給出的執(zhí)行結(jié)果。

參數(shù)：

返回:

如果方法調(diào)用成功，則返回 true； 否則返回 false。

Throws:

addDeathRecipient

boolean addDeathRecipient(IRemoteObject.DeathRecipient recipient, int flags)

注冊用于接收遠(yuǎn)程對象死亡通知的回調(diào)。

如果與 RemoteProxy 對象匹配的遠(yuǎn)程對象進(jìn)程死亡，則調(diào)用此方法。

參數(shù)：

返回:

如果回調(diào)注冊成功，則返回 true； 否則返回 false。

removeDeathRecipient

boolean removeDeathRecipient(IRemoteObject.DeathRecipient recipient, int flags)

取消注冊用于接收遠(yuǎn)程對象死亡通知的回調(diào)。

參數(shù)：

返回:

如果回調(diào)注銷成功，則返回 true； 否則返回 false。

getInterfaceDescriptor

String getInterfaceDescriptor()

獲取對象的接口描述符。

接口描述符是一個字符串。

返回:

返回接口描述符。

dump

void dump(FileDescriptor fd, String[] args) throws RemoteException

將對象狀態(tài)轉(zhuǎn)儲到特定文件。

參數(shù)：

Throws:

slowPathDump

void slowPathDump(FileDescriptor fd, String[] args) throws RemoteException

將數(shù)據(jù)異步轉(zhuǎn)儲到指定文件。

此方法僅適用于同一設(shè)備上的數(shù)據(jù)轉(zhuǎn)儲。

參數(shù)：

Throws:

isObjectDead

boolean isObjectDead()

檢查對象是否死亡。

返回:

如果對象已死，則返回 true； 否則返回 false。