【HarmonyOS NEXT】鸿蒙中Interface实例实现的书写格式

油墨香^_^

261人浏览 · 2026-07-13 22:50:51

油墨香^_^ · 2026-07-13 22:50:51 发布

在HarmonyOS NEXT开发中，接口（Interface） 作为类型契约，是构建可扩展、松耦合系统的核心工具。它的实现方式根据应用场景主要分为两类：类（Class）实现接口用于多态和复杂业务逻辑，对象字面量实现接口用于数据约束。

以下是详细的书写格式与实战解析。

📝 核心语法：两种实现方式

1. 类（Class）实现接口：面向对象多态

当一个类需要具备某种行为或能力时，通过 implements 关键字来实现接口。这是最正式、最常用的方式，尤其适用于需要创建多个实例、包含业务方法的场景。

基础格式：

typescript

// 1. 定义接口：行为的契约
interface Controlable {
    turnOn(): void      // 方法签名
    turnOff(): void
    readonly deviceId: string // 只读属性
}

// 2. 类实现接口
class SmartBulb implements Controlable {
    // 必须实现接口中声明的所有属性和方法
    readonly deviceId: string
    
    constructor(id: string) {
        this.deviceId = id
    }

    turnOn(): void {
        console.log(`${this.deviceId} 灯泡已开启`)
    }

    turnOff(): void {
        console.log(`${this.deviceId} 灯泡已关闭`)
    }
}

// 3. 使用
const bulb = new SmartBulb('BULB_001')
bulb.turnOn() // 输出: BULB_001 灯泡已开启

多接口实现： 一个类可以同时实现多个接口，用逗号 , 分隔，使类型具备多种能力。

typescript

// 定义两个独立能力接口
interface Communicable {
    send(data: string): void
}

interface Storable {
    save(data: string): void
}

// 智能终端同时实现通信和存储能力
class SmartTerminal implements Communicable, Storable {
    send(data: string): void {
        console.log(`发送数据: ${data}`)
    }
    
    save(data: string): void {
        console.log(`保存数据: ${data}`)
    }
}

2. 对象字面量实现接口：轻量级数据约束

对于简单数据对象（如列表项、配置参数），无需创建类，直接使用对象字面量实现接口，非常高效。

基础格式：

typescript

// 1. 定义接口：数据的形状
interface FansItem {
    name: string
    avatar: Resource     // 鸿蒙资源类型
    title: string
    isFollow: boolean
}

// 2. 使用对象字面量实现接口
const fanData: FansItem = {
    name: '华为终端',
    avatar: $r('app.media.icon'), // 直接赋值
    title: '官方账号',
    isFollow: false
}

// 在组件中作为数组使用
@Component
struct FanList {
    // 数组中的每个对象都符合 FansItem 接口约束
    playerList: FansItem[] = [
        {
            name: '黑马程序员',
            avatar: $r('app.media.flower'),
            title: '领取课程源码+资料',
            isFollow: true
        },
        {
            name: '央视新闻',
            avatar: $r('app.media.flower'),
            title: '官方新闻账号',
            isFollow: false
        }
    ]
    // ... build() 中使用 ForEach 渲染
}

🔍 Interface vs Class：到底用哪个？

理解两者的本质区别，能帮助你在项目中做出正确选择。

维度	Interface（接口）	Class（类）
核心定义	类型约束的契约（蓝图）	创建对象的模板（生产车间）
内容	只能定义属性和方法的签名	可以包含属性、方法的具体实现
实例化	❌ 不能被实例化	✅ 可以用 `new` 关键字创建对象
关键语法	`interface` 关键字	`class`、`constructor`、`implements`
适用场景	定义数据结构、定义行为标准	封装数据和行为、创建复杂对象

一句话总结：想定义"长什么样"（形状）用 Interface；想定义"怎么造"（实现）用 Class，并用 Class 去 implements Interface。

🚀 进阶技巧与最佳实践

1. 泛型约束：让接口更通用

通过泛型，你可以创建更灵活的接口，并利用 extends 关键字约束泛型类型必须满足某个接口。

typescript

// 可哈希的接口
interface Hashable {
    hash(): number
}

// 泛型容器，约束 Key 必须实现 Hashable
class HashMap<Key extends Hashable, Value> {
    set(key: Key, value: Value) {
        const hashKey = key.hash() // 安全，因为 key 一定有 hash 方法
        // ...存储逻辑
    }
}

// 使用
class UserId implements Hashable {
    id: number
    constructor(id: number) { this.id = id }
    hash(): number {
        return this.id
    }
}

const userMap = new HashMap<UserId, string>()
userMap.set(new UserId(1001), "张三") // 合法

2. 接口继承：扩展契约

接口可以继承其他接口，实现能力的组合和复用。

typescript

interface Style {
    color: string
}

// ExtendedStyle 拥有 color 和 width 两个属性
interface ExtendedStyle extends Style {
    width: number
}

class Button implements ExtendedStyle {
    color: string = 'red'
    width: number = 100
}

3. 接口隔离原则（ISP）

避免创建"胖接口"。将一个大接口拆分为多个职责单一的小接口，让实现类按需实现，降低耦合。

typescript

// ❌ 不推荐：接口过于臃肿
interface AllInOneDevice {
    print(): void
    scan(): void
    fax(): void
}

// ✅ 推荐：按能力拆分
interface Printer { print(): void }
interface Scanner { scan(): void }
interface Fax { fax(): void }

// 简单打印机只需实现 Printer
class SimplePrinter implements Printer {
    print(): void { /*...*/ }
}
// 多功能一体机按需组合
class AllInOne implements Printer, Scanner, Fax {
    // 实现所有方法
}