Initial blog post commit

.gitignore

@@ -0,0 +1,6 @@
+.idea
+npm-debug.log
+node_modules
+.DS_Store
+*/.DS_Store
+*/*/.DS_Store

README.md

@@ -0,0 +1,132 @@
+Making an API happy with hapi
+
+Whether you are building a very simple set of RESTful services or a large scale, cache heavy, and secure set of services, hapi has you covered.  Hapi will help get your server developed quickly with its wide range of configurable options.
+
+Building a Products API
+The following example will walk you through using hapi to build a RESTful set of services for creating and listing out products.  To get started create a directory named ‘ProductsAPI’ and add a package.json file to the directory that looks like the following.
+
+{
+    "name": "ProductsAPI",
+    "version": "0.0.1",
+    "main": "server",
+    "engines": {
+        "node": ">=0.8.0"
+    },
+    "dependencies": {
+        "hapi": "0.8.x"
+    },
+    "private": "true"
+}
+
+Then run npm install.
+
+Create a routes.js file, which will contain the route information and handlers.  When defining the routes we will also be specifying validation requirements.  Therefore, at the top of the file require hapi and assign its Types property to a local variable like below.
+
+var t = require('hapi').Types;
+
+For this example 3 routes will be created.  Below is the code you should use to add the routes, go ahead and add the code to your routes.js file.
+
+module.exports = [
+    { method: 'GET', path: '/products', config: { handler: getProducts, query: { name: t.String() } } },
+    { method: 'GET', path: '/products/{id}', config: { handler: getProduct } },
+    { method: 'POST', path: '/products', config: { handler: addProduct, payload: 'parse', schema: { name: t.String().required().min(3) }, response: { id: t.Number().required() } } }
+];
+
+The routes are exported as an array so that they can easily be included by the server implementation later in the example.  For now please note that within the config object you can define validation requirements.  For the products listing endpoint we are allowing a querystring parameter for name.  When this querystring parameter exists then we will filter the products for the ones that have the matching name.
+
+The second route is a very simple route that demonstrates how a parameter can become part of the path definition.  This route will return a product with the matching ID that’s requested.
+
+In the last route, the one used for creating a product, you will notice that extra validation requirements are added, even those on the response body.  The request body must contain a parameter for name that has a minimum of 3 characters and the response body must contain an ID to be validated.
+
+Next add the handlers to the routes.js file.
+
+function getProducts(request) {
+
+    if (request.query.name) {
+        request.reply(findProducts(request.query.name));
+    }
+    else {
+        request.reply(products);
+    }
+}
+
+function findProducts(name) {
+    return products.filter(function(product) {
+        return product.name.toLowerCase() === name.toLowerCase();
+    });
+}
+
+function getProduct(request) {
+    var product = products.filter(function(p) {
+        return p.id == request.params.id;
+    }).pop();
+
+    request.reply(product);
+}
+
+function addProduct(request) {
+    var product = {
+        id: products[products.length - 1].id + 1,
+        name: request.payload.name
+    };
+
+    products.push(product);
+
+    request.reply.created('/products/' + product.id)({
+        id: product.id
+    });
+}
+
+As you can see in the handlers, hapi provides a simple way to add a response body by using the request.reply function.  Also, in the instance when you have created an item you can use the request.reply.created function to send a 201 response.
+
+Lastly, add a simple array to contain the products that the service will serve.
+
+var products = [{
+        id: 1,
+        name: 'Guitar'
+    },
+    {
+        id: 2,
+        name: 'Banjo'
+    }
+];
+
+The next and final file that needs to be created is server.js.  This will be the entry point for the service.  Create this file and add the following contents.
+
+var hapi = require('hapi');
+var routes = require('./routes');
+
+var config = { name: 'Products', docs: true };
+var http = new hapi.Server('0.0.0.0', 8080, config);
+
+http.addRoutes(routes);
+
+http.start();
+
+In the server.js code above a new instance of the hapi server is started using the configuration specified in config.  By setting docs to true the documentation generator will be enabled.  This provides a set of pages that explain what endpoints are available and the requirements for those endpoints.
+Running the server
+Go ahead and run npm start or node server.js to start the server.  Now you can navigate to http://localhost:8080/docs to see the documentation for the routes.  To see a list of the products navigate to http://locahost:8080/products.  Below is a screenshot of what the response looks like.
+
+
+
+
+Go ahead and append ?name=banjo to the URL to try searching for a product by name.
+
+
+Use curl or a REST console to create a product.  Make a POST request to the products endpoint with a name in the body.  Below is an example of the response headers from making a request to create a product.
+
+
+
+
+Now if you navigate to the Location specified in the response headers you should see the product that you created.
+
+Other features
+There are a lot of different configuration features that you can add to the server.  The extensive list can be found in the readme at https://github.com/walmartlabs/hapi/#server-configuration.
+
+The built-in cache support has providers for mongo and redis.  Setting up cache is as simple as passing cache: true as part of the server configuration.
+
+Additionally, there are several configuration options available on a per route basis.  The full list can be found at https://github.com/walmartlabs/hapi/#route-configuration.  For example, caching expiration times can also be configured on a per route basis.  Also, you can have per-route authentication settings.
+
+Conclusion
+By now you should have a decent understanding of what hapi has to offer.  There are still many other features and options available to you when using hapi that is covered in the documentation.  Please take a look at the github repository and feel free to provide any feedback you may have.
+

package.json

@@ -0,0 +1,12 @@
+{
+    "name": "ProductsAPI",
+    "version": "0.0.1",
+    "main": "server",
+    "engines": {
+        "node": ">=0.8.0"
+    },
+    "dependencies": {
+        "hapi": "0.8.x"
+    },
+    "private": "true"
+}

routes.js

@@ -0,0 +1,54 @@
+var t = require('hapi').Types;
+
+module.exports = [
+    { method: 'GET', path: '/products', config: { handler: getProducts, query: { name: t.String() } } },
+    { method: 'GET', path: '/products/{id}', config: { handler: getProduct } },
+    { method: 'POST', path: '/products', config: { handler: addProduct, payload: 'parse', schema: { name: t.String().required().min(3) }, response: { id: t.Number().required() } } }
+];
+
+var products = [{
+        id: 1,
+        name: 'Guitar'
+    },
+    {
+        id: 2,
+        name: 'Banjo'
+    }
+];
+
+function getProducts(request) {
+
+    if (request.query.name) {
+        request.reply(findProducts(request.query.name));
+    }
+    else {
+        request.reply(products);
+    }
+}
+
+function findProducts(name) {
+    return products.filter(function(product) {
+        return product.name.toLowerCase() === name.toLowerCase();
+    });
+}
+
+function getProduct(request) {
+    var product = products.filter(function(p) {
+        return p.id == request.params.id;
+    }).pop();
+
+    request.reply(product);
+}
+
+function addProduct(request) {
+    var product = {
+        id: products[products.length - 1].id + 1,
+        name: request.payload.name
+    };
+
+    products.push(product);
+
+    request.reply.created('/products/' + product.id)({
+        id: product.id
+    });
+}

server.js

@@ -0,0 +1,9 @@
+var hapi = require('hapi');
+var routes = require('./routes');
+
+var config = { name: 'Products', docs: true, batch: true };
+var http = new hapi.Server('0.0.0.0', 8080, config);
+
+http.addRoutes(routes);
+
+http.start();