node-simple-router
Version:
Yet another minimalistic router for node.js
75 lines (61 loc) • 3.46 kB
HTML
<div>
<div class="page-header">
<h1>Getting started</h1>
</div>
<h3>
<a name="install" class="anchor" href="#install"><span class="octicon octicon-link"></span></a>
<span style="color: #4169e1;">Step 1: </span><span>Install</span>
</h3>
<p>From Node Package Manager:</p>
<pre><code class="bg bash">npm install node-simple-router</code></pre>
<p>From source:</p>
<pre><code class="bg bash">git clone https://github.com/sandy98/node-simple-router</code></pre>
<hr/>
<h3>
<a name="test" class="anchor" href="#test"><span class="octicon octicon-link"></span></a>
<span style="color: #4169e1;">Step 2: </span><span>Test</span>
</h3>
<pre>cd to your installation directory and run <code class="bg bash">npm test</code><br/>then point your browser to <em>http://localhost:8000</em> and review the info<br/>and above all, try the examples.</pre>
<hr/>
<h3>
<a name="doit" class="anchor" href="#doit"><span class="octicon octicon-link"></span></a>
<span style="color: #4169e1;">Step 3: </span><span>Run your server</span>
</h3>
<div class="list-group">
<div class="list-group-item">
<p class="list-group-item-text">
You can roll your own, or use the sample server that NSR provides by means of the mk-server utility:<br/>
<code class="bg bash">mk-server js</code> will provide a barebones server (<em>server.js</em>) with some example routes ready to run.<br/>
In order for this to work, you must have installed NSR global, like so:<br/>
<code class="bg bash">sudo npm install -g node-simple-router</code>, or have the .bin directory of NSR in your path by whatever means you see fit.<br/>
Either case, the basic steps are the same:<br/>
</p>
</div>
<div class="list-group-item">
<h4 class="list-group-item-heading">Import 'http'</h4>
<p class="list-group-item-text"><code class="bg js">var http = require('http');</code></p>
</div>
<div class="list-group-item">
<h4 class="list-group-item-heading">Import NSR</h4>
<p class="list-group-item-text"><code class="bg js">var Router = require('node-simple-router');</code></p>
</div>
<div class="list-group-item">
<h4 class="list-group-item-heading">Instantiate the router</h4>
<p class="list-group-item-text"><code class="bg js">var router = Router(); // may also be router = new Router();</code></p>
</div>
<div class="list-group-item">
<h4 class="list-group-item-heading">Add some routes</h4>
<p class="list-group-item-text"><code class="bg js">router.get("/hello", function(request, response) {response.end("Hello, World!"};});</code></p>
</div>
<div class="list-group-item">
<h4 class="list-group-item-heading">Create an http server using router as the handler</h4>
<p class="list-group-item-text"><code class="bg js">var server = http.createServer(router);</code></p>
</div>
<div class="list-group-item">
<h4 class="list-group-item-heading">Finally, make it listen on your chosen port and you're in business</h4>
<p class="list-group-item-text"><code class="bg js">server.listen(1234);</code></p>
</div>
</div>
<hr/>
<a href="/documents">Read more...</a>
</div>