Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thiagobustamante/typescript-rest
This is a lightweight annotation-based expressjs extension for typescript.
https://github.com/thiagobustamante/typescript-rest
api decorators es7-decorators expressjs microservice rest restful service typescript typescript-rest
Last synced: 3 days ago
JSON representation
This is a lightweight annotation-based expressjs extension for typescript.
- Host: GitHub
- URL: https://github.com/thiagobustamante/typescript-rest
- Owner: thiagobustamante
- License: mit
- Created: 2016-06-10T13:41:47.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-12-20T07:03:24.000Z (about 1 month ago)
- Last Synced: 2025-01-16T08:09:23.007Z (10 days ago)
- Topics: api, decorators, es7-decorators, expressjs, microservice, rest, restful, service, typescript, typescript-rest
- Language: TypeScript
- Size: 2.26 MB
- Stars: 523
- Watchers: 25
- Forks: 109
- Open Issues: 72
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome - typescript-rest - This is a lightweight annotation-based expressjs extension for typescript. (TypeScript)
- awesome-list-microservice - typescript-rest - based expressjs extension for typescript. (typescript)
README
[](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";
@Path("/hello")
class HelloService {
@Path(":name")
@GET
sayHello( @PathParam('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;
}
}
@Path("/hello")
class HelloRestService {
@Inject
private helloService: HelloService;
@Path(":name")
@GET
sayHello( @PathParam('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.