Overview

JMWS(Java micro web server) is a simple httpd for Java.

• Web server
• Web app server - Host your Micro Service like REST API
• Has basic http operations POST/GET
• Supports RFC 2388 multipart message.
  (File uploading and something.)

Purpose

• Debug your web site
• Debug your micro services logic
• Debug your front end apps - JMWS runs straightforward without unnecessary caching.
• Embedded server

It is licensed under MIT.

Quick start

Example Code 1 : Publish your directory to WEB

• Run Example1.java and open http://localhost with your browser.

Example1.java

package com.example;

import org.riversun.jmws.WebServer;

public class Example1 {

	public static void main(String[] args) {

		final int port = 80;
		final WebServer server = new WebServer(port);

		// Publish "/usr/local/htdocs" for "/"
		server.addDirectory("/", "/usr/local/htdocs");

		server.startServer();
	}
}

Example Code 2 : Publish your REST API( GET Style) to WEB

• Run Example2.java and open
  http://localhost/example?str1=apple&str2=pen
  with your browser.
  
  
• You will get

{"result":"apple-pen" }

Example2.java

package com.example;

import java.io.*;
import org.riversun.jmws.*;
import org.riversun.jmws.core.*;

public class Example2 {

	public static void main(String[] args) {

		final int port = 80;

		final WebServer server = new WebServer(port);

		server.addService("/example", new MicroService() {

			@Override
			public void service(HttpReq req, HttpRes res) throws Exception {

				res.setContentType("application/json; charset=UTF-8");

				String str1 = req.asString("str1");
				String str2 = req.asString("str2");

				String resultText = (str1 != null ? str1 : "") + "-" + (str2 != null ? str2 : "");

				String responseJsonText = "{\"result\":\"" + resultText + "\" }";

				OutputStream os = res.getOutputStream();
				PrintWriter out = new PrintWriter(os);
				out.println(responseJsonText);
				out.flush();
				out.close();

			}
		});

		server.startServer();
	}
}

Example Code 3 : Publish your REST API (JSON POST Style) to WEB

Example3.java

package com.example;

import java.io.*;
import org.riversun.jmws.*;
import org.riversun.jmws.core.*;

public class Example3
{
	public static void main(String[] args)
	{

		final int port = 80;

		final WebServer server = new WebServer(port);

		server.addService("/json_api", new MicroService() {

			@Override
			public void service(HttpReq req, HttpRes res) throws Exception {

				// Do handle request
				final StringBuffer sb = new StringBuffer();

				String line = null;
				BufferedReader reader = req.getReader();
				while ((line = reader.readLine()) != null) {
					sb.append(line);
				}
				final String requestJsonText = sb.toString();

				System.out.println(requestJsonText);

				// Do respond
				res.setContentType("application/json; charset=UTF-8");

				String responseJsonText = "{\"result\":\"" + "somthing" + "\" }";

				OutputStream os = res.getOutputStream();
				PrintWriter out = new PrintWriter(os);
				out.println(responseJsonText);
				out.flush();
				out.close();

			}
		});

	}
}

Tips

• If you want to stop the server.

server.stopServer();

• Add listener for server status callback

server.setServerCallback(new ServerCallBack() {
			@Override
			public void onServerStatUpdated(EServerStatus serverStatus, String message) {
				System.out.println("serverStatus=" + serverStatus + " message=" + message);
			}
		});

Downloads

maven

• You can add dependencies to maven pom.xml file.

<dependency>
  <groupId>org.riversun</groupId>
  <artifactId>jmws</artifactId>
  <version>1.2.0</version>
</dependency>