Menukar JSON kepada model berasaskan decorator untuk pustaka sequelize-typescript: kelas yang mewarisi Model dengan @Table dan @Column({ type: DataType.*, allowNull }), jenis property TypeScript, serta decorator class-validator untuk validasi.
Ia menyasarkan sequelize-typescript (pustaka di sebalik @nestjs/sequelize NestJS) dan bukan sequelize biasa, jadi laluan import dan ejaan DataType (tanpa s di hujung) berbeza daripada versi JavaScript.
Nama model (lalai MyModel); ia juga menjadi tableName dalam upper snake case pada @Table.invoice.model.ts dan daftarkannya dengan new Sequelize({ ..., models: [Invoice] }) atau SequelizeModule.forFeature([Invoice]) NestJS.{
"invoice_no": "INV-2024-0042",
"amount": 1250.75,
"currency": "EUR",
"paid": false,
"due_date": "2024-07-31",
"memo": ""
}import { Table, Column, Model, DataType } from 'sequelize-typescript';
import { IsNotEmpty, IsOptional } from 'class-validator';
@Table({ tableName: 'INVOICE', timestamps: false })
export class Invoice extends Model<Invoice> {
@Column({ type: DataType.INTEGER, primaryKey: true, autoIncrement: true })
id: number;
@Column({ type: DataType.STRING, allowNull: false, field: 'invoice_no' })
@IsNotEmpty()
invoiceNo: string;
@Column({ type: DataType.DOUBLE, allowNull: false })
@IsNotEmpty()
amount: number;
@Column({ type: DataType.STRING, allowNull: false })
@IsNotEmpty()
currency: string;
@Column({ type: DataType.BOOLEAN, allowNull: false })
@IsNotEmpty()
paid: boolean;
@Column({ type: DataType.DATEONLY, allowNull: false, field: 'due_date' })
@IsNotEmpty()
dueDate: string;
@Column({ type: DataType.STRING, allowNull: false })
@IsOptional()
memo: string;
}memo ialah rentetan kosong: ia bukan NULL, jadi lajurnya kekal allowNull: false, tetapi ia mendapat @IsOptional() dan bukan @IsNotEmpty(). amount menjadi DataType.DOUBLE, dan due_date menjadi DataType.DATEONLY berjenis string, kerana Sequelize memulangkan nilai tarikh sahaja sebagai teks.
{ Table, Column, Model, DataType } daripada sequelize-typescript dan mengisytiharkan kelas sebagai extends Model<Invoice>.@Table({ tableName: 'INVOICE', timestamps: false }), sama seperti penjana JavaScript, jadi lajur createdAt/updatedAt tidak diandaikan.@Column menyatakan type dan allowNull; lajur yang boleh null diberi jenis string | null dan seumpamanya.INTEGER/BIGINT/DOUBLE → number, BOOLEAN → boolean, DATE → Date, DATEONLY → string, JSON → Record<string, unknown> atau tatasusunan bertaip seperti string[].field: 'invoice_no' menunjuk ke lajur asal; kunci id dalam JSON digunakan sebagai primary key dan tidak diduplikasi.@IsNotEmpty(); yang lain mendapat @IsOptional().Apabila anda perlu menyimpan data yang dihantar sebagai JSON oleh sistem bil atau penyelesaian luaran, bina kelas model daripada payload itu dan gunakannya melalui @InjectModel(Invoice).
Eksport data jadual sedia ada sebagai JSON dan tampalkannya untuk mendapat draf model bertaip, daripada menulis semula objek define() menjadi kelas secara manual.
DataType.DECIMAL(12, 2) lebih selamat daripada DataType.DOUBLE.experimentalDecorators dan emitDecoratorMetadata mesti diaktifkan dalam tsconfig supaya decorator berfungsi.useDefineForClassFields (lalai untuk target ES2022 dan ke atas), pengisytiharan property biasa membayangi getter Sequelize. Matikan pilihan itu atau letakkan declare di hadapan property.Model<InvoiceAttributes, InvoiceCreationAttributes> dan bukan Model<Invoice>?sequelize-typescript v2 menerima dua generic; kod yang dijana hanya menghantar kelas itu sendiri. Jika anda mahu Invoice.create({...}) diperiksa jenisnya tanpa medan yang dijana automatik seperti id, isytiharkan interface creation-attributes dan hantarnya sebagai generic kedua.
DataType dan bukan DataTypes?DataType ialah nama yang dieksport oleh sequelize-typescript. Mengimport DataTypes daripada sequelize berfungsi sama, tetapi menggunakan satu nama sahaja bagi setiap fail lebih mudah dibaca.
Tidak. Validasi hanya berlaku apabila anda sendiri memanggil validate(invoice) atau apabila decorator berada pada DTO yang dikendalikan oleh ValidationPipe NestJS. Untuk validasi di peringkat Sequelize, gunakan @Column({ validate: { notEmpty: true } }) atau decorator sequelize-typescript seperti @NotEmpty.