Add route to post comments

Author: sebprunier

api/doc/api_data.js

@@ -247,6 +247,72 @@ define({ "api": [
     "filename": "src/server.js",
     "groupTitle": "Wines"
   },
+  {
+    "type": "post",
+    "url": "/wines/:id/comments",
+    "title": "Comment",
+    "name": "Comment",
+    "group": "Wines",
+    "parameter": {
+      "fields": {
+        "Parameter": [
+          {
+            "group": "Parameter",
+            "type": "String",
+            "optional": false,
+            "field": "id",
+            "description": "<p>the id of the wine</p>"
+          },
+          {
+            "group": "Parameter",
+            "type": "String",
+            "optional": false,
+            "field": "title",
+            "description": "<p>title of the comment.</p>"
+          },
+          {
+            "group": "Parameter",
+            "type": "String",
+            "optional": false,
+            "field": "content",
+            "description": "<p>content of the comment.</p>"
+          }
+        ]
+      }
+    },
+    "success": {
+      "examples": [
+        {
+          "title": "Success-Response:",
+          "content": "HTTP/1.1 201 Created",
+          "type": "json"
+        }
+      ]
+    },
+    "error": {
+      "fields": {
+        "Error 4xx": [
+          {
+            "group": "Error 4xx",
+            "type": "String",
+            "optional": false,
+            "field": "404",
+            "description": "<p>Not found - No wine corresponding to given 'id'</p>"
+          },
+          {
+            "group": "Error 4xx",
+            "type": "String",
+            "optional": false,
+            "field": "400",
+            "description": "<p>Bad request - missing 'title' or 'content' attribute in body</p>"
+          }
+        ]
+      }
+    },
+    "version": "0.0.0",
+    "filename": "src/server.js",
+    "groupTitle": "Wines"
+  },
   {
     "type": "get",
     "url": "/wines/:id/comments",

api/doc/api_data.json

@@ -247,6 +247,72 @@
     "filename": "src/server.js",
     "groupTitle": "Wines"
   },
+  {
+    "type": "post",
+    "url": "/wines/:id/comments",
+    "title": "Comment",
+    "name": "Comment",
+    "group": "Wines",
+    "parameter": {
+      "fields": {
+        "Parameter": [
+          {
+            "group": "Parameter",
+            "type": "String",
+            "optional": false,
+            "field": "id",
+            "description": "<p>the id of the wine</p>"
+          },
+          {
+            "group": "Parameter",
+            "type": "String",
+            "optional": false,
+            "field": "title",
+            "description": "<p>title of the comment.</p>"
+          },
+          {
+            "group": "Parameter",
+            "type": "String",
+            "optional": false,
+            "field": "content",
+            "description": "<p>content of the comment.</p>"
+          }
+        ]
+      }
+    },
+    "success": {
+      "examples": [
+        {
+          "title": "Success-Response:",
+          "content": "HTTP/1.1 201 Created",
+          "type": "json"
+        }
+      ]
+    },
+    "error": {
+      "fields": {
+        "Error 4xx": [
+          {
+            "group": "Error 4xx",
+            "type": "String",
+            "optional": false,
+            "field": "404",
+            "description": "<p>Not found - No wine corresponding to given 'id'</p>"
+          },
+          {
+            "group": "Error 4xx",
+            "type": "String",
+            "optional": false,
+            "field": "400",
+            "description": "<p>Bad request - missing 'title' or 'content' attribute in body</p>"
+          }
+        ]
+      }
+    },
+    "version": "0.0.0",
+    "filename": "src/server.js",
+    "groupTitle": "Wines"
+  },
   {
     "type": "get",
     "url": "/wines/:id/comments",

api/doc/api_project.js

@@ -8,7 +8,7 @@ define({
   "apidoc": "0.2.0",
   "generator": {
     "name": "apidoc",
-    "time": "2016-03-13T21:01:05.404Z",
+    "time": "2016-03-14T13:20:36.863Z",
     "url": "http://apidocjs.com",
     "version": "0.15.1"
   }

api/doc/api_project.json

@@ -8,7 +8,7 @@
   "apidoc": "0.2.0",
   "generator": {
     "name": "apidoc",
-    "time": "2016-03-13T21:01:05.404Z",
+    "time": "2016-03-14T13:20:36.863Z",
     "url": "http://apidocjs.com",
     "version": "0.15.1"
   }

api/package.json

@@ -3,7 +3,8 @@
   "description": "React Workshop API",
   "version": "0.0.0",
   "dependencies": {
-    "express": "4.13.4"
+    "express": "4.13.4",
+    "body-parser": "1.15.0"
   },
   "devDependencies": {
     "apidoc": "0.15.1"

api/src/server.js

@@ -1,5 +1,5 @@
 var express = require('express');
-var app = express();
+var bodyParser = require('body-parser');
 
 var BordeauxWines = require('./data/bordeaux-wines.json');
 var BurgundyWines = require('./data/burgundy-wines.json');
@@ -35,9 +35,11 @@ var Comments = {
   }]
 };
 
+// Create Server
+var app = express();
+app.use(bodyParser.json());
 // Serve API documentation
 app.use(express.static('doc'));
-
 // Configure CORS
 app.use(function(req, res, next) {
   res.header("Access-Control-Allow-Origin", "*");
@@ -215,6 +217,41 @@ app.get('/api/wines/:id/comments', function (req, res) {
   }
 });
 
+/**
+ * @api {post} /wines/:id/comments Comment
+ * @apiName Comment
+ * @apiGroup Wines
+ *
+ * @apiParam {String} id the id of the wine
+ * @apiParam {String} title    title of the comment.
+ * @apiParam {String} content  content of the comment.
+ *
+ * @apiSuccessExample {json} Success-Response:
+ *     HTTP/1.1 201 Created
+ *
+ * @apiError {String} 404 Not found - No wine corresponding to given 'id'
+ * @apiError {String} 400 Bad request - missing 'title' or 'content' attribute in body
+ */
+app.post('/api/wines/:id/comments', function (req, res) {
+  var id = req.params.id;
+  if (!WinesById[id]) {
+    res.sendStatus(404);
+  } else {
+    var body = req.body;
+    if (!body.title || !body.content) {
+        res.sendStatus(400);
+    } else {
+      var newComment = {
+        date: new Date(),
+        title: body.title,
+        content: body.content
+      };
+      Comments[id] = (Comments[id] || []).concat(newComment);
+      res.sendStatus(201);
+    }
+  }
+});
+
 /**
  * @api {get} /regions All
  * @apiName All