initial commit

Author: Umed Khudoiberdiev

.gitignore

@@ -0,0 +1,3 @@
+node_modules
+src/**/*.js
+src/**/*.js.map

README.md

@@ -0,0 +1,13 @@
+# Example how to use Express and TypeORM with TypeScript
+
+1. clone repository 
+2. run `npm i`
+3. edit `ormconfig.json` and change your database configuration (you can also change a database type, but don't forget to install specific database drivers)
+4. run `npm start`
+5. open `http://localhost:3000/posts` and you'll empty array
+6. use curl, postman or other tools to send http requests to test your typeorm-based API
+
+## How to use CLI?
+
+1. install `typeorm` globally: `npm i -g typeorm`
+2. run `typeorm -h` to show list of available commands

ormconfig.json

@@ -0,0 +1,28 @@
+[
+  {
+    "name": "default",
+    "driver": {
+      "type": "mysql",
+      "host": "localhost",
+      "port": 3306,
+      "username": "test",
+      "password": "test",
+      "database": "test"
+    },
+    "autoSchemaSync": true,
+    "entities": [
+      "src/entity/*.js"
+    ],
+    "subscribers": [
+      "src/subscriber/*.js,"
+    ],
+    "migrations": [
+      "src/migration/*.js"
+    ],
+    "cli": {
+      "entitiesDir": "src/entity",
+      "migrationsDir": "src/migration",
+      "subscribersDir": "src/subscriber"
+    }
+  }
+]

package.json

@@ -0,0 +1,42 @@
+{
+  "name": "typeorm-typescript-express-example",
+  "version": "0.0.1",
+  "description": "Example how to use Express and TypeORM with TypeScript.",
+  "license": "MIT",
+  "readmeFilename": "README.md",
+  "author": {
+    "name": "Umed Khudoiberdiev",
+    "email": "pleerock.me@gmail.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/typeorm/typescript-express-example.git"
+  },
+  "bugs": {
+    "url": "https://github.com/typeorm/typescript-express-example/issues"
+  },
+  "tags": [
+    "orm",
+    "typescript",
+    "typescript-orm",
+    "typeorm-sample",
+    "typeorm-example",
+    "typeorm-express-example"
+  ],
+  "devDependencies": {
+    "@types/body-parser": "^1.16.0",
+    "express": "^4.15.2",
+    "typescript": "^2.1.5"
+  },
+  "dependencies": {
+    "@types/express": "^4.0.35",
+    "@types/node": "^7.0.4",
+    "body-parser": "^1.17.1",
+    "mysql": "^2.12.0",
+    "reflect-metadata": "^0.1.9",
+    "typeorm": "0.0.9"
+  },
+  "scripts": {
+    "start": "tsc && node src/index.js"
+  }
+}

src/controller/PostGetAllAction.ts

@@ -0,0 +1,18 @@
+import {Request, Response} from "express";
+import {getEntityManager} from "typeorm";
+import {Post} from "../entity/Post";
+
+/**
+ * Loads all posts from the database.
+ */
+export async function postGetAllAction(request: Request, response: Response) {
+
+    // get a post repository to perform operations with post
+    const postRepository = getEntityManager().getRepository(Post);
+
+    // load a post by a given post id
+    const posts = await postRepository.find();
+
+    // return loaded posts
+    response.send(posts);
+}

src/controller/PostGetByIdAction.ts

@@ -0,0 +1,24 @@
+import {Request, Response} from "express";
+import {getEntityManager} from "typeorm";
+import {Post} from "../entity/Post";
+
+/**
+ * Loads post by a given id.
+ */
+export async function postGetByIdAction(request: Request, response: Response) {
+
+    // get a post repository to perform operations with post
+    const postRepository = getEntityManager().getRepository(Post);
+
+    // load a post by a given post id
+    const post = await postRepository.findOneById(request.params.id);
+
+    // if post was not found return 404 to the client
+    if (!post) {
+        response.status(404);
+        response.end();
+    }
+
+    // return loaded post
+    response.send(post);
+}

src/controller/PostSaveAction.ts

@@ -0,0 +1,21 @@
+import {Request, Response} from "express";
+import {getEntityManager} from "typeorm";
+import {Post} from "../entity/Post";
+
+/**
+ * Saves given post.
+ */
+export async function postSaveAction(request: Request, response: Response) {
+
+    // get a post repository to perform operations with post
+    const postRepository = getEntityManager().getRepository(Post);
+
+    // create a real post object from post json object sent over http
+    const newPost = postRepository.create(request.body);
+
+    // save received post
+    await postRepository.persist(newPost);
+
+    // return saved post back
+    response.send(newPost);
+}

src/entity/Category.ts

@@ -0,0 +1,12 @@
+import {Table, PrimaryColumn, Column} from "typeorm";
+
+@Table()
+export class Category {
+
+    @PrimaryColumn("int", { generated: true })
+    id: number;
+
+    @Column()
+    name: string;
+
+}

src/entity/Post.ts

@@ -0,0 +1,22 @@
+import {Table, PrimaryColumn, Column, ManyToMany, JoinTable} from "typeorm";
+import {Category} from "./Category";
+
+@Table()
+export class Post {
+
+    @PrimaryColumn("int", { generated: true })
+    id: number;
+
+    @Column()
+    title: string;
+
+    @Column("text")
+    text: string;
+
+    @ManyToMany(type => Category, {
+        cascadeInsert: true
+    })
+    @JoinTable()
+    categories: Category[];
+
+}

src/index.ts

@@ -0,0 +1,29 @@
+import "reflect-metadata";
+import {createConnection} from "typeorm";
+import {Request, Response} from "express";
+import * as express from "express";
+import * as bodyParser from "body-parser";
+import {ROUTES} from "./routes";
+
+// create connection with database
+// note that its not active database connection
+// TypeORM creates you connection pull to uses connections from pull on your requests
+createConnection().then(async connection => {
+
+    // create express app
+    const app = express();
+    app.use(bodyParser.json());
+
+    // register all routes
+    ROUTES.forEach(route => {
+        app[route.method](route.path, (request: Request, response: Response, next: Function) => {
+            route.action(request, response)
+                .then(() => next)
+                .catch(err => next(err));
+        });
+    });
+
+    // run app
+    app.listen(3000);
+
+}).catch(error => console.log("Error: ", error));

src/migration/.gitkeep

@@ -0,0 +1,24 @@
+import {postGetAllAction} from "./controller/PostGetAllAction";
+import {postGetByIdAction} from "./controller/PostGetByIdAction";
+import {postSaveAction} from "./controller/PostSaveAction";
+
+/**
+ * All application routes.
+ */
+export const ROUTES = [
+    {
+        path: "/posts",
+        method: "get",
+        action: postGetAllAction
+    },
+    {
+        path: "/posts/:id",
+        method: "get",
+        action: postGetByIdAction
+    },
+    {
+        path: "/posts",
+        method: "post",
+        action: postSaveAction
+    }
+];

src/routes.ts

@@ -0,0 +1,15 @@
+{
+    "version": "2.0.2",
+    "compilerOptions": {
+        "lib": ["es5", "es6"],
+        "target": "es6",
+        "module": "commonjs",
+        "moduleResolution": "node",
+        "emitDecoratorMetadata": true,
+        "experimentalDecorators": true,
+        "sourceMap": true
+    },
+    "exclude": [
+        "node_modules"
+    ]
+}