Api服务

模块可以集中管理后端 Api 调用，把 Api 调用包装为服务资源，从而方便在任何模块访问

创建Api服务

TIP

右键菜单 - [模块路径]: Zova Create/Service

依据提示输入 service 的名称，比如menu，VSCode 插件会自动添加 service 的代码骨架

以模块home-layout为例，通过调用 Api/home/layout/menu/select获取菜单。那么，可以按如下方式定义 Api 服务：

src/suite/a-home/modules/home-layout/src/service/menu.ts

export default (app: ZovaApplication) => {
  return {
    select: () => app.meta.$api.get<any, ServiceMenuEntity[]>('/home/layout/menu/select'),
  };
};

• 关于$api的用法，参见：API

使用Api服务

可以通过 Scope 实例直接访问 Api 服务

src/suite/a-home/modules/home-layout/src/bean/model.menu.ts

const data = await this.scope.service.menu.select();

跨模块使用Api服务

import { ScopeModuleHomeLayout } from 'zova-module-home-layout';

export class TestA {
  @UseScope()
  $$scopeModuleHomeLayout: ScopeModuleHomeLayout;

  protected async __init__() {
    const data = await this.$$scopeModuleHomeLayout.service.menu.select();
  }
}

举例：CRUD

下面以 Todo 的 CRUD 为例：

定义Api服务

src/suite/a-demo/modules/demo-todo/src/service/todo.ts

export default (app: ZovaApplication) => {
  return {
    select: () => app.meta.$api.get<any, ServiceTodoEntity[]>('/demo/todo/select'),
    get: (params: ServiceTodoGetParams) => app.meta.$api.get<any, ServiceTodoEntity>('/demo/todo/get', { params }),
    insert: (params: ServiceTodoIntertParams) =>
      app.meta.$api.post<any, void, ServiceTodoIntertParams>('/demo/todo/insert', params),
    update: (params: ServiceTodoUpdateParams) =>
      app.meta.$api.post<any, void, ServiceTodoUpdateParams>('/demo/todo/update', params),
    delete: (params: ServiceTodoDeleteParams) =>
      app.meta.$api.post<any, void, ServiceTodoDeleteParams>('/demo/todo/delete', params),
  };
};

使用Api服务

src/suite/a-demo/modules/demo-todo/src/bean/model.todo.ts

await this.scope.service.todo.select();
await this.scope.service.todo.get(params);
await this.scope.service.todo.insert(params);
await this.scope.service.todo.update(params);
await this.scope.service.todo.delete(params);