SQL Mapper annotations for NestJS, similar MyBatis.
- Follow NestJS Module injection mode.
- With the TypeScript Decorators, same as Java annotations.
- Similar to MyBatis used in Java.
- Support for the Prepared Statements.
- Support for Entity Injection.
- Support the Connection pools by mysql2 within.
@Param
, @ResultType
, @Select
, @Insert
, @Update
, @Delete
.
Setup SpeedSQL as dependency in package.json file dependencies
"dependencies": {
"speedsql": "latest"
}
- Prepare some entities and configurations.
db.provider.ts
import { createPool, Pool } from 'speedsql';
export const DbProviders = [
{
provide: 'SPEED_POOL',
useFactory: async (): Promise<Pool> => {
return await createPool({
host: 'localhost',
user: 'root',
port: 3306,
password: 'qwer1234',
database: 'test',
});
},
},
];
entity/param.dto.ts
export class ParamDto {
constructor(public name: string, public age: number) {}
}
entity/user.dto.ts
export class UserDto {
constructor(public name: string, public age: number) {}
}
- Import into the Module of NestJS
app.mudule.ts
import { Module } from '@nestjs/common';
import { AppController } from './app.controller';
import { AppService } from './app.service';
import { SpeedService } from 'speedsql';
import { DbProviders } from './db.provider';
@Module({
imports: [],
controllers: [AppController],
providers: [AppService, SpeedService, ...DbProviders],
})
export class AppModule {}
- Define SpeedSQL within Services, use the Decorators as MyBatis.
app.service.ts
import { Injectable } from '@nestjs/common';
import { Delete, Update, Param, ResultType, Insert } from 'speedsql';
import { UserDto } from './entity/user.dto';
import { ParamDto } from './entity/param.dto';
@Injectable()
export class AppService {
@Update('update user set age = #{age} where name = #{name}')
setUserAge(@Param('name') name: string, @Param('age') age: number): number {return;}
@Delete('delete from user where name = #{name}')
deleteUser(@Param('name') name: string): number {return;}
@ResultType(UserDto)
@Select('select `name`, `age` from `user` where `uid` = #{uid} and `name` = #{name}')
getRecords(paramDto: ParamDto): UserDto[] {return;}
@Insert('insert into user (name, age) value (#{name}, #{age})')
addUser(user: UserDto): number {return;}
}
- Use Your Services.
app.controller.ts
import { Controller, Get } from '@nestjs/common';
import { AppService } from './app.service';
import { ParamDto } from './entity/param.dto';
import { UserDto } from "./entity/create-cat.dto";
@Controller()
export class AppController {
constructor(private readonly appService: AppService) {}
@Get()
async getHello() {
await this.appService.setUserAge("zzz", 20);
return "hello world";
}
}
The Connection pools configuration is exactly the same as mysql2's createPool().
The usual format is as follows:
{
host: '127.0.0.1',
user: 'root',
port: 3306,
password: '123456',
database: 'test',
}
Like common NestJS Modules, SpeedSQL uses Asynchronous providers to inject it's Connection Pool for startup.
- Make file
db.provider.ts
import { createPool, Pool } from 'speedsql';
export const DbProviders = [
{
provide: 'SPEED_POOL',
useFactory: async (): Promise<Pool> => {
return await createPool({
host: 'localhost',
user: 'root',
port: 3306,
password: 'qwer1234',
database: 'test',
});
},
},
];
- Put
db.provider.ts
in NestJS app src dir and set it as a provider.
import { Module } from '@nestjs/common';
import { AppController } from './app.controller';
import { AppService } from './app.service';
import { SpeedService } from 'speedsql';
import { DbProviders } from './db.providers';
@Module({
imports: [],
controllers: [AppController],
providers: [AppService, SpeedService, ...DbProviders],
})
export class AppModule {}
@Param
define the named parameters.
As with MyBatis, SpeedSQL is possible to pass a value to a bind parameter as a named parameter to ensure readability and prevent SQL Injection attacks.
Unlike Prepared Statements in mysql2, SpeedSQL can be pass param value with named to make SQL more clearer.
Parameter with named value can support @Select
, @Insert
, @Update
, @Delete
all the CRUD operations.
SpeedSQL has two Parameter with named modes.
Note that you can only choose ONE of the modes at ONE statement.
Object as Parameters
- Creates a conditional entity class with the same attribute and parameter names.
export class ParamDto {
constructor(public name: string, public age: number) {}
}
- Inject values as parameter entities.
import { ResultType, Select } from 'speedsql';
@ResultType(UserDto)
@Select('select `name`, `age` from `user` where `uid` = #{uid} and `name` = #{name}')
getRecords(paramDto: ParamDto): UserDto[]{return;}
- So we can start to use.
const users: UserDto[] = await this.appService.getRecords(
new ParamDto("zzz", 10)
);
Named Value as Parameters
Annotate the parameter value name with the parameter annotation '@Param', which corresponds to the SQL value name.
import { ResultType, Select, Param } from 'speedsql';
@ResultType(UserDto)
@Select(select `name`, `age` from `user` where `uid` = #{uid} and `name` = #{name}')
getRecords(@Param('uid') uid:number, @Param('name') name:string): UserDto[]{return;}
So we can start to use.
const users: UserDto[] = await this.appService.getRecords('zzz', 10);
SpeedSQL uses @ResultType
to annotate the resulting entity.
@ResultType
define the data entity for @Selete returns.
Select returns an array of annotated entity (@ResultType
).
- Create a entity:
export class UserDto {
constructor(public name: string, public age: number) {}
}
- And Select.
import { ResultType, Select, Param } from 'speedsql';
@ResultType(UserDto)
@Select('select `name`, `age` from user where uid = #{uid} and name = #{name} ')
getRecords(@Param('uid') uid:number, @Param('name') name:string): UserDto[] {return;}
- The return Array will contains entities, and field name will correspond to the attributes of the entity.
If the field name and attribute are not the same, the value of different name will be lost. The solution is to use SQL's AS
to alias the field name to correspond to the attributes of the entity.
import { ResultType, Select, Param } from 'speedsql';
@ResultType(UserDto)
@Select('select `realname` as `name`, `age` from user where uid = #{uid} and name = #{name} ')
getRecords(@Param('uid') uid:number, @Param('name') name:string): UserDto[] {return;}
Parameter with named is also supported in @Insert
.
The @Insert
return value is the new inserted ID, which can also be ignored.
import { Insert } from 'speedsql';
@Insert('insert into user (name, age) value (#{name}, #{age})')
addUser(user: UserDto): number {return;}
Parameter with named is also supported in @Update
and @Delete
.
The @Update
and @Delete
returns number is the effected rows, which can also be ignored.
import { Delete, Update, Param } from 'speedsql';
@Update('update user set age = #{age} where name = #{name}')
setUserAge(@Param('name') name: string, @Param('age') age: number): number {return;}
@Delete('delete from user where name = #{name}')
deleteUser(@Param('name') name: string): number {return;}
Github:https://github.com/speedphp/speedsql
The SpeedSQL project follows the open source agreement of the MIT License
.