ServiceExtensionAbility

ServiceExtensionAbility模塊提供ServiceExtension服務(wù)擴展相關(guān)接口的能力。

說(shuō)明：

本模塊首批接口從API version 9開(kāi)始支持。后續版本的新增接口，采用上角標單獨標記接口的起始版本。
本模塊接口僅可在Stage模型下使用。

導入模塊

import ServiceExtension from '@ohos.application.ServiceExtensionAbility';

權限

無(wú)

開(kāi)發(fā)前請熟悉鴻蒙開(kāi)發(fā)指導文檔：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

屬性

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

系統API : 此接口為系統接口，三方應用不支持調用。

ServiceExtensionAbility.onCreate

onCreate(want: Want): void;

Extension生命周期回調，在創(chuàng )建時(shí)回調，執行初始化業(yè)務(wù)邏輯操作。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

示例：

class ServiceExt extends ServiceExtension {
  onCreate(want) {
    console.log('onCreate, want:' + want.abilityName);
  }
}

ServiceExtensionAbility.onDestroy

onDestroy(): void;

Extension生命周期回調，在銷(xiāo)毀時(shí)回調，執行資源清理等操作。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

系統API : 此接口為系統接口，三方應用不支持調用。

示例：

class ServiceExt extends ServiceExtension {
  onDestroy() {
    console.log('onDestroy');
  }
}

ServiceExtensionAbility.onRequest

onRequest(want: Want, startId: number): void;

Extension生命周期回調，如果是startAbility拉起的服務(wù)，會(huì )在onCreate之后回調。每次拉起服務(wù)都會(huì )回調，startId會(huì )遞增。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

示例：

class ServiceExt extends ServiceExtension {
  onRequest(want, startId) {
    console.log('onRequest, want:' + want.abilityName);
  }
}

ServiceExtensionAbility.onConnect

onConnect(want: Want): rpc.RemoteObject;

Extension生命周期回調，如果是connectAbility拉起的服務(wù)，會(huì )在onCreate之后回調。返回一個(gè)RemoteObject對象，用于和客戶(hù)端進(jìn)行通信。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

返回值：

示例：

import rpc from '@ohos.rpc'
class StubTest extends rpc.RemoteObject{
    constructor(des) {
        super(des);
    }
    onConnect(code, data, reply, option) {
    }
}
class ServiceExt extends ServiceExtension {
  onConnect(want) {
    console.log('onConnect , want:' + want.abilityName);
    return new StubTest("test");
  }
}

ServiceExtensionAbility.onDisconnect

onDisconnect(want: Want): void;

Extension的生命周期，斷開(kāi)服務(wù)連接時(shí)回調。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

示例：

class ServiceExt extends ServiceExtension {
  onDisconnect(want) {
    console.log('onDisconnect, want:' + want.abilityName);
  }
}

ServiceExtensionAbility.onReconnect

onReconnect(want: Want): void;

當新客戶(hù)端在所有以前的客戶(hù)端連接之后嘗試連接到服務(wù)擴展時(shí)調用

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

示例：

class ServiceExt extends ServiceExtension {
  onDisconnect(want) {
    console.log('onDisconnect, want:' + want.abilityName);
  }
}

ServiceExtensionAbility.onConfigurationUpdated

onConfigurationUpdated(config: Configuration): void;

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

示例：

class ServiceExt extends ServiceExtension {
    onConfigurationUpdated(config) {
        console.log('onConfigurationUpdated, config:' + JSON.stringify(config));
    }
}

ServiceExtensionAbility.dump

dump(params: Array): Array;

轉儲客戶(hù)端信息時(shí)調用。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

示例：

class ServiceExt extends ServiceExtension {
    dump(params) {
        console.log('dump, params:' + JSON.stringify(params));
        return ["params"]
    }
}

審核編輯 黃宇