鸿蒙开发：ArkTS接口与对象

在鸿蒙开发中，ArkTS（Ark Type Script）是一种基于 TypeScript 的声明式开发语言，它结合了声明式 UI 和逻辑编程能力。在 ArkTS 中，接口（Interface）和对象（Object）是构建类型安全和结构化数据的重要工具。以下是关键知识点和示例：

一、接口（Interface）

接口用于定义对象的结构类型，确保对象符合特定的属性或方法规范。

1. 定义接口

// 定义一个包含 name 和 age 的接口
interface Person {
  name: string;
  age: number;
  // 可选属性用 ? 标记
  address?: string;
}

2. 实现接口
   对象或类必须实现接口的所有必填属性：

const person: Person = {
  name: 'Alice',
  age: 25,
  // address 可选，无需提供
};

// 错误示例：缺少必填属性 age
// const invalidPerson: Person = { name: 'Bob' };

3. 接口继承
   接口可以继承其他接口：

interface Student extends Person {
  studentId: string;
}

const student: Student = {
  name: 'Charlie',
  age: 20,
  studentId: 'S12345'
};

4. 函数参数类型约束
   接口可用于约束函数参数：

function printPerson(person: Person) {
  console.log(`Name: ${person.name}, Age: ${person.age}`);
}

printPerson(person); // 正确
// printPerson({ name: 'Dave' }); // 错误：缺少 age

二、对象（Object）

在 ArkTS 中，对象通常是数据模型或组件状态的载体，支持响应式更新。

1. 响应式对象（@State）
   使用 @State 装饰器将对象标记为响应式，属性变化自动触发 UI 更新：

@State message: string = 'Hello ArkTS';

// 修改响应式对象
message = 'Welcome to HarmonyOS';

2. 对象与接口结合
   确保对象类型安全：

interface User {
  id: number;
  username: string;
  email: string;
}

@State user: User = {
  id: 1,
  username: 'arkts_dev',
  email: 'dev@example.com'
};

// 错误示例：缺少 email 属性
// @State invalidUser: User = { id: 2, username: 'test' };

3. 对象解构与扩展

// 解构对象属性
const { username, email } = user;

// 合并对象（展开运算符）
const newUser = { ...user, email: 'new@example.com' };

4. 动态对象属性
   使用索引签名定义动态属性：

interface DynamicObject {
  [key: string]: any;
}

const data: DynamicObject = {
  key1: 'value1',
  key2: 123
};

三、实际应用场景

组件 Props 类型约束
定义组件输入参数的类型：

@Component
struct MyComponent {
  @Prop user: User; // 确保传入的 user 符合 User 接口
}

2.API 响应数据处理
定义后端返回的数据结构：

interface ApiResponse {
  code: number;
  data: User[];
  message: string;
}

async fetchUsers(): Promise<ApiResponse> {
  // 调用 API 并返回符合接口的数据
}

3.状态管理
使用响应式对象管理复杂状态：

@State appState: {
  isLoading: boolean;
  error: string | null;
} = {
  isLoading: false,
  error: null
};

四、注意事项

必填属性：接口中未标记为可选（?）的属性必须实现。
类型兼容性：对象属性类型需与接口严格匹配。
响应式限制：直接修改对象属性可能不会触发更新，需使用 @State 或 set 方法。
性能优化：避免在频繁更新的场景中使用大型响应式对象。