This package has been deprecated

Author message:

Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.

express-audi-decorators

express decorators which utilize the aurelia-dependency-injection library

overview

This is a convience library to make creating routes for express REST services cleaner. It relies on the use of the aurelia-dependency-injection library to create instances of controllers.

getting started

$ npm install express-audi-decorators aurelia-dependency-injection

---

1. Create models, business logic and any data access classes required

UserService.ts

 
import {autoinject} from 'aurelia-dependency-injection';
import {UserRepository} from '../repositories/UserRepository';
 
@autoinject
export class UserService {
    private _userRepository: UserRepository;
 
    constructor(userRepository: UserRepository) {
        this._userRepository = userRepository;
    }
 
    public async getUser(id: number): Promise<User> {
        let user = await this._userRepository.getUser(id);
        return user;
    }
}
 

1. Create your REST API

UserController.ts

import {autoinject} from 'aurelia-dependency-injection';
import {UserService} from '../services/UserService';
import {Response as ExpressResponse} from 'express';
import {Controller, Get, CatchAndSendError, Response, NumParam} from 'express-audi-decorators';
 
@autoinject()
@Controller('/users')
export class UserController {
    private _userService: UserService;
 
    constructor(userService: UserService) {
        this._userService = userService;
    }
 
    @CatchAndSendError()
    @Get('/:userId')
    public async getUser(@Response() res: ExpressResponse, @NumParam('userId') id: number): Promise<void> {
        let user = await this._userService.getUser(id);
        res.location(`/api/users/${user.id}`);
        res.json({user: user});
    }
}
 

1. Set up dependency injection container and start an HTTP listener

index.ts

import {Container} from 'aurelia-dependency-injection';
import {registerController} from 'express-audi-decorators';
import * as express from 'express';
import {Router} from 'express';
import {UserController} from './controllers/UserController';
 
let container = new Container();
container.makeGlobal(); // creates singleton instance of container
 
// can register manually instantiated instances if desired
 
// create express application
const app: express.Application = express();
 
const apiRouter = Router();
 
// register controllers
registerController(apiRouter, UserController);
 
app.use('/api', apiRouter);
 
// run http listener
const server: Server = app.listen(8080, (error: Error) => {
    if (error != null) {
        console.log(error);
    } else {
        console.log('server listening over insecure http on port 8080');
    }
});

1. You should now have a useable api endpoint at:

localhost:8080/api/users/[id]