CRUD Controller

CRUD (Create, Read, Update, Delete) controller gives you an easy way to implement CRUD endpoints based on an ORM model.

Overview
CRUD Controller provide a factory for creating CRUD endpoints based on ORM Module without coding.
The CRUD Controller was created for reduce boilerplate implementation of CRUD endpoints
​
CRUDControllerFactory
Using the CRUDControllerFactory we can create enpoints using an ORM Model, the ORM model should extend the @sugoi/ORM ModelAbstract
The CRUDControllerFactory  expose the of(model: ModelAbstract, options?: ICRUDOptions) method
Example
​
@ServerModule({
    controllers: [
        CRUDControllerFactory.of(MyModel) // Will create '/MyModel' uri based endpoints
    ],
    services: [],
    modules: []
})
export class Bootstrap {
}
Endpoints
GET '/'
The GET endpoint without any parameter used for searching based on query parameters.
GET '/:id'
The GET endpoint with an id parameter used for query based on id.
POST '/'
The POST endpoint will create a new record in DB based on the request body.
PUT '/:id'
The PUT endpoint will update the record in DB based on the id with the request body.
DELETE '/:id'
The DELETE endpoint will delete the record from DB based on the id.
CRUDController Options
While creating a CRUD Controller we are able to pass some options to the factory for defining the endpoint, authorization, permissions and roles.
{
    endpoint?: string;
    authorized?: boolean;
    permissions?: Array<string | number>; 
    roles?: Array<string | number>;
}
Example
@ServerModule({
    controllers: [
        CRUDControllerFactory.of(MyModel,{
            endpoint: '/MyModelCrud', 
            authorized: true, 
            roles: [ROLES.ADMIN, ROLES.AUTHOR],
        }) // Will create '/MyModelCrud' uri based endpoints
    ],
    services: [],
    modules: []
})
export class Bootstrap {
}
Set allowed methods
By default all of the CRUD endpoints are toggled on, we can change it by using thesetAllowedMethods(...methods: Array<HTTP_METHOD> static method
Example
@ServerModule({
    controllers: [
        CRUDControllerFactory.of(MyModel).setAllowedMethods(
                                HTTP_METHOD.GET,
                                HTTP_METHOD.POST,
                                HTTP_METHOD.PUT
                            )
    ],
    services: [],
    modules: []
})
export class Bootstrap {
}

Variable binding (Injection)

Next - @sugoi/server

Response handling

Last modified 4yr ago