What is the purpose of the @ nestjs /graphql package in Nest. Js ?

在 Nest.js 框架中，@nestjs/graphql 包是用于构建 GraphQL API 的。GraphQL 是一种用于 API 的查询语言，它允许客户端请求它们需要的确切数据，而不是传统 REST API 那样可能返回超出所需的额外数据。

主要功能

1. 定义 Schema: 使用 @nestjs/graphql，我们可以利用装饰器和 TypeScript 的类型安全功能来定义 GraphQL schema。例如，我们可以使用 @ObjectType() 装饰器来定义 GraphQL 的类型，使用 @Field() 来表示类型中的字段。

   typescript
   @ObjectType()
   class User {
     @Field(type => Int)
     id: number;
   
     @Field()
     firstName: string;
   
     @Field()
     lastName: string;
   
     @Field()
     email: string;
   }
   

2. 解析器 (Resolvers): 在 Nest.js 中，解析器用于处理对特定类型或字段的查询。使用 @Resolver() 装饰器来标识一个类作为解析器。例如，创建一个 UserResolver 来处理用户相关的数据请求。

   typescript
   @Resolver(of => User)
   export class UserResolver {
     constructor(private readonly userService: UserService) {}
   
     @Query(returns => User)
     async user(@Args('id') id: string): Promise<User> {
       return this.userService.findById(id);
     }
   }

3. 与依赖注入系统集成: 和 Nest.js 的其他部分一样，@nestjs/graphql 完全支持依赖注入，这意味着你可以在解析器中注入服务或提供者，以处理业务逻辑或数据库交互。

4. Code-first 与 Schema-first 开发方式: @nestjs/graphql 支持两种开发风格：Code-first 和 Schema-first。在 Code-first 方法中，你先编写 TypeScript 类和装饰器，然后框架会自动为你生成 GraphQL schema。而在 Schema-first 方法中，你先编写 GraphQL schema 定义，然后基于这个 schema 创建对应的解析器和类。

例子：用户查询

假设我们需要实现一个功能，允许客户端查询用户信息。我们可以定义一个 User 类型和一个 UserResolver 解析器，然后通过 GraphQL 查询来获取用户数据。

graphql
query {
  user(id: "123") {
    firstName
    lastName
    email
  }
}

在上述查询中，客户端明确请求了 firstName、lastName 和 email 字段，@nestjs/graphql 使得处理这样的请求变得直接和高效。

总之，@nestjs/graphql 包在 Nest.js 中提供了一种强大且灵活的方式来构建和管理 GraphQL API，使得开发者能够以一种类型安全和模块化的方式来开发应用程序。