Remult 是一个全栈 CRUD 库，它利用 TypeScript 模型来简化开发，并提供了类型安全的 API 客户端和查询构建器。在软件开发中，为了确保系统功能正常，必须管理和同步两个数据模型：服务器模型和客户端模型。服务器模型指定数据库结构和 API，而客户端模型定义 API 的传入传出数据。然而，维护单独的模型集和验证器可能会导致冗余，增加维护开销，以及模型不同步时出错的可能性。

Remult 通过提供一个集成模型来解决这个问题。该模型定义了数据库模式，暴露了简单的 CRUD API，并支持客户端集成，使开发人员能够轻松地查询数据库，并且可以确保类型安全。

定义实体
Remult 使用装饰器将基本的 JavaScript 类转换为 Remult 实体。开发人员可以向类中添加 Entity 装饰器，并对每个属性应用相关的字段装饰器，从而轻松地完成这项工作。使用装饰器，Remult 简化了创建实体及相关字段的过程，提高了开发人员的高效。

// 堆代码 duidaima.com
import { Entity, Fields } from "remult"
@Entity("contacts", {
  allowApiCrud: true
})
export class Contact {
  @Fields.autoIncrement()
  id = 0
  @Fields.string()
  name = ""
  @Fields.string()
  number = ""
}

服务器端设置
要开始使用 Remult，请将其与所选服务器上必要的实体一起注册。幸运的是，Remult 针对几个流行的服务器框架提供了开箱即用的集成，包括 Express、Fastify、Next.js、Nest 和 Koa。

import express from "express";
import { remultExpress } from "remult/remult-express";
import Contact from "../shared/Contact.ts";
const app = express();
app.use(
  remultExpress({
    entities: [
      Contact
    ]
  })
);
 

客户端集成
配置完后端和实体后，下一步是将 Remult 与应用程序的前端集成。幸运的是，Remult 的客户端集成被设计成库无关的。也就是说，它可以使用浏览器 fetch 功能或 Axios 进行操作。为了说明这一点，请看下面的例子：

import { useEffect, useState } from "react"
import { remult } from "remult"
import { Contact } from "./shared/Contact"
const contactsRepo = remult.repo(Contact)
export default function App() {
  const [contacts, setContacts] = useState<Contact[]>([])


  useEffect(() => {
    contactsRepo.find().then(setContact)
  }, [])


  return (
    <div>
      <h1>Contacts</h1>
      <ul>
        {contacts.map(contact => {
          return (
            <div key={contact.id}>
              {contact.name} | {contact.phone}
            </div>
          )
        })}
      </ul>
    </div>
  )
}

从这个例子可以看出，将 Remult 集成到应用程序前端非常简单、灵活。然后，开发人员就可以在整个栈中无缝地利用 Remult 的强大功能了。

Remult 是遵循MIT许可的开源软件。欢迎通过 Remult GitHub存储库做贡献。

GitHub地址：https://github.com/remult/remult