Add Examples / edit README / remove tests

Author: simonwep

.gitignore

@@ -24,4 +24,6 @@
 hs_err_pid*
 
 *.idea
-*.iml
+*.iml
+
+/src/tests

README.md

@@ -1,3 +1,5 @@
+
+
 ![Java Express Logo](https://image.ibb.co/mCdxtm/java_express.png)
 
 Small clone of the node-js express framework written in pure Java 8.
@@ -11,25 +13,26 @@ If you have downloaded the lastest [release](https://github.com/Simonwep/java-ex
 Express app  = new Express();
 
 app.get("/", (req, res) -> {
-	res.send("Hello World");
+   res.send("Hello World");
 });
 
 app.listen(3000);
 ```
 First of all we've create an new Express instance, named `app` then we create an root context `/` for the request-method `get`. 
 Quick reference:
 * [URL Basics](#url-basics)
-	* [URL Parameter](#url-parameter)
-	* [URL Querys](#url-querys)
-	* [Cookies](#cookies)
-	* [Form Data](#form-data)
+   * [URL Parameter](#url-parameter)
+   * [URL Querys](#url-querys)
+   * [Cookies](#cookies)
+   * [Form Data](#form-data)
 * [HTTP - Request and Response object](#http---request-and-response-object)
-	* [Response Object](#response-object)
-	* [Request Object](#request-object)
+   * [Response Object](#response-object)
+   * [Request Object](#request-object)
 * [Middleware](#middleware)
-	* [Tutorial](#tutorial)
+   * [Create own middleware](#create-own-middleware)
 * [License](#license)
 
+Every following code can be also found in [this package](https://github.com/Simonwep/java-express/tree/master/src/examples).
 # URL Basics
 
 ## URL Parameter
@@ -38,9 +41,9 @@ Sometime you want to create dynamic URL where some parts of the URL's are not st
 Example request: `GET`  `/posts/john/all`:
 ```java
 app.get("/posts/:user/:type", (req, res) -> {
-	String user = req.getParam("user"); // Contains 'john'
-	String type = req.getParam("type"); // Contains 'all'
-	res.send("User: " + user + ", type: " + type); // Send: "User: john, type: all"
+   String user = req.getParam("user"); // Contains 'john'
+   String type = req.getParam("type"); // Contains 'all'
+   res.send("User: " + user + ", type: " + type); // Send: "User: john, type: all"
 });
 ```
 
@@ -50,9 +53,9 @@ If you make an request which contains querys, you can access the querys over `re
 Example request: `GET`  `/posts?page=12&from=john`:
 ```java
 app.get("/posts", (req, res) -> {
-	String page = req.getQuery("page"); // Contains '12'
-	String from = req.getQuery("from"); // Contains 'John'
-	res.send("Page: " + page + ", from: " + from); // Send: "Page: 12, from: John"
+   String page = req.getQuery("page"); // Contains '12'
+   String from = req.getQuery("from"); // Contains 'John'
+   res.send("Page: " + page + ", from: " + from); // Send: "Page: 12, from: John"
 });
 ```
 
@@ -62,18 +65,18 @@ With `req.getCookie(NAME)` you can get an cookie by his name, and with `res.setC
 Example request: `GET`  `/setcookie`:
 ```java
 app.get("/setcookie", (req, res) -> {
-	Cookie cookie = new Cookie("username", "john");
-	res.setCookie(cookie);
-	res.send("Cookie has been set!");
+   Cookie cookie = new Cookie("username", "john");
+   res.setCookie(cookie);
+   res.send("Cookie has been set!");
 });
 ```
 
 Example request: `GET`  `/showcookie`:
 ```java
 app.get("/showcookie", (req, res) -> {
-	Cookie cookie = req.getCookie("username");
-	String username = cookie.getValue();
-	res.send("The username is: " + username); // Prints "The username is: john"
+   Cookie cookie = req.getCookie("username");
+   String username = cookie.getValue();
+   res.send("The username is: " + username); // Prints "The username is: john"
 });
 ```
 
@@ -82,22 +85,22 @@ Over `req.getFormQuery(NAME)` you receive the values from the input elements of
 Example HTML-Form:
 ```html
 <form action="http://localhost/register" method="post">
-	<input type="text" name="email" placeholder="Your E-Mail">
-	<input type="text" name="username" placeholder="Your username">
-	<input type="submit">
+   <input type="text" name="email" placeholder="Your E-Mail">
+   <input type="text" name="username" placeholder="Your username">
+   <input type="submit">
 </form>
 ```
 **Attention: Currently, File-inputs don't work, if there is an File-input the data won't get parsed!**
 Now type, for the example below, `john` in username and `john@gmail.com` in the email field.
 Java code to handle the post request and access the form elements:
 ```java
 app.post("/register", (req, res) -> {
-	String email = req.getFormQuery("email");
-	String username = req.getFormQuery("username");
-	// Process data
-	
-    // Prints "E-Mail: john@gmail.com, Username: john"
- 	res.send("E-Mail: " + email + ", Username: " + username); 
+  String email = req.getFormQuery("email");
+  String username = req.getFormQuery("username");
+  // Process data
+   
+  // Prints "E-Mail: john@gmail.com, Username: john"
+  res.send("E-Mail: " + email + ", Username: " + username); 
 });
 ```
 
@@ -107,13 +110,13 @@ app.post("/register", (req, res) -> {
 Over the response object, you have serveral possibility like setting cookies, send an file and more. Below is an short explanation what methods exists:
 ```java
 app.get("/res", (req, res) -> {
-	// res.send();                     // Send empty response
-	// res.send("Hello World");        // Send an string
-	// res.send("chart.pdf");          // Send an file
-	// res.setStatus(200);             // Set the response status
-	// res.getStatus();                // Returns the current response status
-	// res.setCookie(new Cookie(...)); // Send an cookie
-	// res.isClosed();                 // Check if already something has been send to the client
+  // res.send();                     // Send empty response
+  // res.send("Hello World");        // Send an string
+  // res.send("chart.pdf");          // Send an file
+  // res.setStatus(200);             // Set the response status
+  // res.getStatus();                // Returns the current response status
+  // res.setCookie(new Cookie(...)); // Send an cookie
+  // res.isClosed();                 // Check if already something has been send to the client
 });
 ```
 The response object calls are comments because **you can only call the .send(xy) once each request!**
@@ -122,22 +125,22 @@ The response object calls are comments because **you can only call the .send(xy)
 With the request object you receive serveral data from the client which can be easily parsed by the given functions:
 ```java
 app.get("/req/", (req, res) -> {
-	// req.getURI();                        // Request URI
-	// req.getHost();                       // Request host (mostly localhost)
-	// req.getMethod();                     // Request method (here GET)
-	// req.getContentType();                // Request content type, is here null because it's an GET request
-	// req.getBody();                       // Request body inputstream
-	// req.getUserAgent();                  // Request user-agent
-	// req.getParam("parameter");           // Returns an url parameter
-	// req.getQuery("queryname");           // Returns an url query by key
-	// req.getFormQuery("formqueryname");   // Returns an form input value
-	// req.getFormQuerys();                 // Returns all form querys
-	// req.getCookie("user");               // Returns an cookie by name
-	// req.getCookies();                    // Returns all cookies
-	// req.hasAuthorization();              // Check if the request contains an authorization header
-	// req.getAuthorization();              // Returns the authorization header
-	// req.getMiddlewareContent("name");    // Returns data from middleware
-	// req.pipe(new OutputStream() {...});  // Pipe the body to an outputstream
+   // req.getURI();                        // Request URI
+   // req.getHost();                       // Request host (mostly localhost)
+   // req.getMethod();                     // Request method (here GET)
+   // req.getContentType();                // Request content type, is here null because it's an GET request
+   // req.getBody();                       // Request body inputstream
+   // req.getUserAgent();                  // Request user-agent
+   // req.getParam("parameter");           // Returns an url parameter
+   // req.getQuery("queryname");           // Returns an url query by key
+   // req.getFormQuery("formqueryname");   // Returns an form input value
+   // req.getFormQuerys();                 // Returns all form querys
+   // req.getCookie("user");               // Returns an cookie by name
+   // req.getCookies();                    // Returns all cookies
+   // req.hasAuthorization();              // Check if the request contains an authorization header
+   // req.getAuthorization();              // Returns the authorization header
+   // req.getMiddlewareContent("name");    // Returns data from middleware
+   // req.pipe(new OutputStream() {...});  // Pipe the body to an outputstream
 });
 ```
 
@@ -157,52 +160,97 @@ Or create an inline-middleware:
 ```java
 // Global context, you can also pass an context if you want
 app.use((req, res) -> {
-	// Handle data
+   // Handle data
 });
 ```
-## Tutorial
+## Create own middleware
 
 Now we take a look how we can create own middlewares. Here we create an simple PortParser which parse / extract the port-number for us:
 ```java
 public class PortMiddleware implements HttpRequest, ExpressFilter {
 
-	/**
-	 * From interface HttpRequest, to handle the request.
-	 */
-	@Override
-	public void handle(Request req, Response res) {
-		
-		// Get the port
-		int port = req.getURI().getPort();
-		
-		// Add the port to the request middleware map
-		req.addMiddlewareContent(this, port);
-
-		/**
-		 * After that you can use this middleware by call:
-		 *	app.use(new PortMiddleware());
-		 *	
-		 * Than you can get the port with:
-		 *	int port = (Integer) app.getMiddlewareContent("PortParser");
-		 */
-	}
-
-	/**
-	 * Defines the middleware.
-	 *
-	 * @return The middleware name.
-	 */
-	@Override
-	public String getName() {
-		return "PortParser";
-	}
+   /**
+    * From interface HttpRequest, to handle the request.
+    */
+   @Override
+   public void handle(Request req, Response res) {
+      
+      // Get the port
+      int port = req.getURI().getPort();
+      
+      // Add the port to the request middleware map
+      req.addMiddlewareContent(this, port);
+
+      /**
+       * After that you can use this middleware by call:
+       *   app.use(new PortMiddleware());
+       *   
+       * Than you can get the port with:
+       *   int port = (Integer) app.getMiddlewareContent("PortParser");
+       */
+   }
+
+   /**
+    * Defines the middleware.
+    *
+    * @return The middleware name.
+    */
+   @Override
+   public String getName() {
+      return "PortParser";
+   }
 }
 ```
 No we can, as we learned above, include it with:
 ```java
 // Global context, you can also pass an context if you want
 app.use(new PortMiddleware());
 ```
+## Existing Middlewares
+There are already some basic middlewares included:
+
+#### Static File serving
+If you want to allocate some files, like js-librarys or css files you can use the [static](https://github.com/Simonwep/java-express/blob/master/src/express/middleware/Static.java) middleware. But you can also provide other files like mp4 etc.
+Example:
+```java
+ app.use(new Static("examplepath\\test_statics"));
+```
+Now you can access every files in the `test_statics` over the root adress `\`.
+#### Cookie Session
+Java Express also includes an simple cookie-session middleware:
+```java
+// You should use an meaningless cookie name for serveral security reasons, here f3v4.
+// Also you can specify the maximum age of the cookie from the creation date, here 3000. 
+app.use(new CookieSession("f3v4", 9000));
+```
+To use a session cookie we need to get the data from the middleware which is actually an `SessionCookie`:
+```java
+ // Cookie session example
+app.get("/session", (req, res) -> {
+
+   /**
+   * CookieSession named his data "Session Cookie" which is
+   * an SessionCookie so we can Cast it.
+   */
+   SessionCookie sessionCookie = (SessionCookie) req.getMiddlewareContent("SessionCookie");
+   int count;
+   
+   // Check if the data is null, we want to implement an simple counter
+   if (sessionCookie.getData() == null) {
+   
+      // Set the default data to 1 (first request with this session cookie)
+      count = (Integer) sessionCookie.setData(1);
+   
+   } else {
+      // Now we know that the cookie has an integer as data property, increase it
+      count = (Integer) sessionCookie.setData((Integer) sessionCookie.getData() + 1);
+   }
+
+   // Send an info message
+   res.send("You take use of your session cookie " + count + " times.");
+});
+```
+
 # License
 
-This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details
+This project is licensed under the MIT License - see the [LICENSE.md](https://choosealicense.com/licenses/mit/) file for details