此模板提供了一个 Node.js 入门项目,预配置了 GraphQL 用于 API,Redis 用于缓存和临时数据存储,JWT 用于身份验证和授权,以及Sequelize 用于连接到关系数据库(例如 PostgreSQL 或 MySQL)的 ORM。该项目具有模块化结构,可让您立即开发具有集成和可扩展功能的现代 Web 应用程序。
此项目旨在让使用 GraphQL API 更轻松地开发后端应用程序,该 API 使用 Redis 进行数据缓存,并使用 JWT 来保护 API。 Sequelize 用作 ORM 来促进与关系数据库的交互。此外,还有中间件可以更轻松地处理身份验证、验证和日志记录。
首先,将此模板存储库克隆到本地计算机:
git clone https://gitlab.com/dioarafi1/graphify-api.git cd graphify-api
如果您从头开始,请使用以下命令初始化新项目:
git clone https://gitlab.com/dioarafi1/graphify-api.git cd graphify-api
克隆存储库或创建新项目后,运行命令来安装所需的依赖项:
mkdir blog-api cd blog-api npm init -y
这将安装 package.json 文件中列出的所有依赖项。
在项目根目录创建.env文件,并为Redis、JWT、数据库添加以下配置:
yarn install
根据您的数据库配置更改用户、密码和 mydatabase。
如果没有配置数据库,请运行命令初始化Sequelize并创建模型:
DATABASE_URL="postgresql://user:password@localhost:5432/mydatabase" JWT_SECRET="your_jwt_secret_key" REDIS_HOST="localhost" REDIS_PORT="6379"
这将在您的项目中创建配置、模型和迁移目录结构。接下来,为应用程序创建必要的模型,例如 User 和 Post,并执行迁移以在数据库中创建表。
yarn sequelize init
确保数据库正在运行(例如使用 PostgreSQL 或 MySQL)。
安装 Apollo Server 和 GraphQL 的依赖项:
yarn sequelize db:migrate
之后,创建 GraphQL 服务器配置文件、架构和解析器。您可以通过以下方式配置 GraphQL 服务器:
yarn add apollo-server graphql
定义查询和突变的 GraphQL 架构:
import { ApolloServer } from 'apollo-server-express'; import express from 'express'; import { typeDefs, resolvers } from './graphql'; import { authenticateJWT } from './middlewares/auth'; import { sequelize } from './config/database'; const app = express(); // Gunakan middleware JWT app.use(authenticateJWT); // Inisialisasi Apollo Server const server = new ApolloServer({ typeDefs, resolvers, context: ({ req }) => ({ user: req.user }), }); server.applyMiddleware({ app }); const PORT = process.env.PORT || 4000; app.listen(PORT, async () => { console.log(`Server running at http://localhost:${PORT}${server.graphqlPath}`); await sequelize.authenticate(); console.log('Database connected'); });
实现查询和突变的解析器:
import { gql } from 'apollo-server-express'; export const typeDefs = gql` type User { id: ID! username: String! } type Post { id: ID! title: String! content: String! user: User! } type Query { posts: [Post] post(id: ID!): Post users: [User] } type Mutation { createPost(title: String!, content: String!): Post register(username: String!, password: String!): User login(username: String!, password: String!): String # JWT token } `;
要使用热重载在开发环境中运行服务器,请使用以下命令:
import { Post, User } from '../models'; import jwt from 'jsonwebtoken'; import bcrypt from 'bcryptjs'; export const resolvers = { Query: { posts: () => Post.findAll(), post: (_, { id }) => Post.findByPk(id), users: () => User.findAll(), }, Mutation: { createPost: async (_, { title, content }, { user }) => { if (!user) throw new Error('Authentication required'); const post = await Post.create({ title, content, userId: user.id }); return post; }, register: async (_, { username, password }) => { const hashedPassword = await bcrypt.hash(password, 10); const user = await User.create({ username, password: hashedPassword }); return user; }, login: async (_, { username, password }) => { const user = await User.findOne({ where: { username } }); if (!user) throw new Error('User not found'); const match = await bcrypt.compare(password, user.password); if (!match) throw new Error('Invalid password'); const token = jwt.sign({ userId: user.id }, process.env.JWT_SECRET!, { expiresIn: '1h' }); return token; }, }, };
服务器将在 http://localhost:4000 运行,您可以访问 GraphQL Playground 来测试 API 查询和突变。
此项目目录结构旨在分隔应用程序的不同部分,使其更加模块化且易于维护:
yarn dev
要准备生产项目,请使用以下命令将 TypeScript 构建为 JavaScript:
/myapp ├── src │ ├── middlewares # Berisi middleware untuk otentikasi (JWT), caching (Redis), dan validasi │ ├── routes # Definisi endpoint API dan resolver GraphQL │ ├── services # Logika bisnis utama dan pengolahan data │ ├── app.ts # File utama untuk inisialisasi aplikasi dan middleware │ ├── graphql # Menyimpan konfigurasi GraphQL, schema, dan resolvers │ ├── models # Model Sequelize untuk mengelola database relasional │ ├── config # File konfigurasi global untuk Redis, JWT, database, dll │ ├── index.ts # Entry point aplikasi, menginisialisasi server dan middleware │ ├── resolvers # Berisi resolver GraphQL untuk query dan mutasi │ ├── server.ts # File untuk setup Apollo Server dan konfigurasi GraphQL │ ├── schema # Definisi schema GraphQL │ ├── types # TypeScript types dan interfaces untuk GraphQL dan lainnya │ └── utils # Berisi helper dan fungsi utility ├── .env # File konfigurasi environment (Redis, JWT Secret, Database URL) ├── package.json # Metadata proyek dan dependensi └── tsconfig.json # Konfigurasi TypeScript
输出将位于 dist/ 文件夹中,并准备好部署到生产服务器。
此项目可以通过以下步骤部署到 Heroku、AWS 或 DigitalOcean 等平台:
按照上述步骤,您现在可以使用 Redis、JWT 和 Sequelize 运行和开发 GraphQL API 应用程序。
以上是Node.js 入门项目包括 GraphQL、Redis、JWT 和 Sequelize的详细内容。更多信息请关注PHP中文网其他相关文章!