Debian環境下Swagger與GraphQL如何結合使用

在Debian環境下，要將Swagger與GraphQL結合使用，你需要遵循以下步驟：

1. 安裝Node.js和npm：首先，確保你已經在Debian系統上安裝了Node.js和npm。如果沒有，請訪問Node.js官方網站并按照說明進行安裝。

2. 安裝GraphQL：接下來，你需要安裝GraphQL。在終端中運行以下命令：

npm install graphql

3. 安裝Apollo Server：Apollo Server是一個流行的GraphQL服務器庫。要安裝它，請運行以下命令：

npm install apollo-server

4. 安裝Swagger UI Express：Swagger UI Express是一個將Swagger文檔集成到你的應用程序中的庫。要安裝它，請運行以下命令：

npm install swagger-ui-express

5. 創建一個簡單的GraphQL API：在你的項目中創建一個名為index.js的文件，并添加以下代碼以創建一個簡單的GraphQL API：

const { ApolloServer, gql } = require('apollo-server');

// 構建一個簡單的GraphQL schema
const typeDefs = gql`
  type Query {
    hello(name: String): String
  }
`;

// 提供schema的解析器
const resolvers = {
  Query: {
    hello: (_, { name }) => `Hello, ${name || 'World'}`,
  },
};

// 創建一個Apollo Server實例
const server = new ApolloServer({ typeDefs, resolvers });

// 啟動服務器
server.listen().then(({ url }) => {
  console.log(`Server is running at ${url}`);
});

6. 集成Swagger UI：在index.js文件中，添加以下代碼以集成Swagger UI：

const swaggerUi = require('swagger-ui-express');
const YAML = require('yamljs');

// 讀取Swagger文檔
const swaggerDocument = YAML.load('./swagger.yaml');

// 將Swagger UI添加到Express應用中
server.express.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument));

7. 創建Swagger文檔：在項目根目錄下創建一個名為swagger.yaml的文件，并添加以下內容：

swagger: '2.0'
info:
  title: GraphQL API
  description: A simple GraphQL API with Swagger documentation
  version: '1.0.0'
host: localhost:4000
basePath: /
schemes:
  - http
paths:
  /:
    get:
      summary: Returns a hello message
      parameters:
        - name: name
          in: query
          type: string
          required: false
      responses:
        '200':
          description: A hello message
          schema:
            type: object
            properties:
              hello:
                type: string

8. 運行你的應用程序：在終端中運行以下命令以啟動你的應用程序：

node index.js

現在，你的應用程序已經在Debian環境下運行，并且Swagger UI已經集成到GraphQL API中。你可以通過訪問http://localhost:4000/api-docs來查看Swagger文檔。