typescript-rest
Version:
A Library to create RESTFul APIs with Typescript
129 lines (94 loc) • 3.33 kB
Markdown
[](https://badge.fury.io/js/typescript-rest)
[](https://codecov.io/gh/thiagobustamante/typescript-rest)
[](https://snyk.io/test/github/thiagobustamante/typescript-rest?targetFile=package.json)
[](https://bettercodehub.com/)
# REST Services for Typescript
This is a lightweight annotation-based [expressjs](http://expressjs.com/) extension for typescript.
It can be used to define your APIs using decorators.
**Table of Contents**
- [REST Services for Typescript](#)
- [Installation](#installation)
- [Configuration](#configuration)
- [Basic Usage](#basic-usage)
- [Using with an IoC Container](#using-with-an-ioc-container)
- [Documentation](https://github.com/thiagobustamante/typescript-rest/wiki)
- [Boilerplate Project](#boilerplate-project)
## Installation
This library only works with typescript. Ensure it is installed:
```bash
npm install typescript -g
```
To install typescript-rest:
```bash
npm install typescript-rest --save
```
## Configuration
Typescript-rest requires the following TypeScript compilation options in your tsconfig.json file:
```typescript
{
"compilerOptions": {
"experimentalDecorators": true,
"emitDecoratorMetadata": true,
"target": "es6" // or anything newer like esnext
}
}
```
## Basic Usage
```typescript
import * as express from "express";
import {Server, Path, GET, PathParam} from "typescript-rest";
("/hello")
class HelloService {
(":name")
sayHello( ('name') name: string ): string {
return "Hello " + name;
}
}
let app: express.Application = express();
Server.buildServices(app);
app.listen(3000, function() {
console.log('Rest Server listening on port 3000!');
});
```
That's it. You can just call now:
```
GET http://localhost:3000/hello/joe
```
## Using with an IoC Container
Install the IoC container and the serviceFactory for the IoC Container
```bash
npm install typescript-rest --save
npm install typescript-ioc --save
npm install typescript-rest-ioc --save
```
Then add a rest.config file in the root of your project:
```json
{
"serviceFactory": "typescript-rest-ioc"
}
```
And you can use Injections, Request scopes and all the features of the IoC Container. It is possible to use it with any other IoC Container, like Inversify.
Example:
```typescript
class HelloService {
sayHello(name: string) {
return "Hello " + name;
}
}
("/hello")
class HelloRestService {
private helloService: HelloService;
(":name")
sayHello( ('name') name: string): string {
return this.sayHello(name);
}
}
```
## Complete Guide
Check our [documentation](https://github.com/thiagobustamante/typescript-rest/wiki).
## Boilerplate Project
You can check [this project](https://github.com/vrudikov/typescript-rest-boilerplate) to get started.