##Features

• contain most of Jetty Web Server features(JSP,Servlet)
• custom Realm Basic Authorization for each WebApp
• network change listener for dynamic dns(see:Custom dynamic DNS implementation,Configure dynamic DNS)

##Install Jetty4A

• donwload apk Jy4a-1.0.0.apk
• build apk by yourself.

##Deploy Web App

• convert .war file to .j4a by war2j4a tools
• copy the .j4a file to /jetty4a/webapp

##Use Code

• clone the code:

   cd <target directory>
   git clone https://github.com/Centny/Centny
   git clone https://github.com/Centny/Jetty4A
  

• open the Jetty4A project by ADT

##Install war2j4a tools

• make sure your DX_HOME(where contain dx tools direcotyr) environment value had configured.

• run blew script in console:

   cd */Jetty4A/script
   chmod +x war2j4a
   sudo cp war2j4a /usr/local/bin
  

##Develop Normal Web App if the web app is normal .war app,you can convert it to .j4a file by war2j4a.

##Develop Custom Web App if yout want to develop web app by using Jetty API,like adding handler by code/Using Basic Authorization:

• Prepare jetty-all-server-8.*.jar,jsch-*.jar,servlet-api-3.*.jar,commons-io-*.jar,you can download by yourself or you can copy from */Jetty4A/libs
• open eclipse User Libraries panel and add library by name Jetty4A,then add all jars in step one to Jetty4A library.
• New dynamic web project in eclipse
• Add Jetty4A library to project build path.
• if yout want to add ant build for yout project,donwload sample build.xml to project and modify it.
• see detail:

**Note:**see example project Jetty4A/J4AWebDev

##Start Web Server by JUnit

• add jetty4a.properties file in src/:

   #configure jetty4a.
   J4A_LOG_CLASSES=
   J4A_LOG_LEVEL=DEBUG
   J4A_LISTEN_PORT=8080
   org.eclipse.jetty.util.log.class=org.centny.jetty4a.server.log.Jetty4ALog
   org.eclipse.LEVEL=INFO
   j4a.dnsdynamic.class=org.centny.jetty4a.server.api.DnsDynamicOrgImpl
   j4a.connector.builder.class=org.centny.jetty4a.server.api.DefaultConnectorBuilder
   org.centny.LEVEL=DEBUG
  

• add JUnit test class:

   public class WebDevTest {
   private static int listenPort__ = 8080;
   @Test
   public void testMgw() throws Exception {
   	JettyDevServer.initWebDev();
   	try {
   		String sport = System.getProperty("J4A_LISTEN_PORT");
   		listenPort__ = Integer.parseInt(sport);
   	} catch (Exception e) {
   		listenPort__ = 8080;
   	}
   	JettyServer jds = JettyServer.createServer(JettyDevServer.class,
   			listenPort__);
   	jds.start();
   	jds.join();
   }
   }
  

##Using Custom Base Authroization

• create a normal web app

• add Jetty4A library to project(see Develop Custom Web App)

• add base authorization configure to web.xml:

  <security-constraint>
   <web-resource-collection>
     <web-resource-name>WDevRealm</web-resource-name>
     <url-pattern>/*</url-pattern>
   </web-resource-collection>
   <auth-constraint>
     <role-name>log</role-name>
   </auth-constraint>
  </security-constraint>
  <login-config>
   <auth-method>BASIC</auth-method>
   <realm-name>WDevRealm</realm-name>
  </login-config>
  

• create Realm.properties file in WEB-INF,add content like below:

   #the admin for J4AWebLog
   #default password:j4a
   admin: CRYPT:adj7rHs7GA9YQ,log,wdir,dev
   #default password:log
   log: CRYPT:lo9V8yD.yQMps,log
   #default password:wdir
   wdir: CRYPT:wdHLqn0AYYU4w,wdir
  

  **Note:**about how to create Hash Realm file,see Jetty document.

• add a class org.centny.wdev.WebDev extends ServerListener

```
File wrealm = new File(this.croot, "Realm.properties");
if (wrealm.exists()) {
	this.log.info("initial WDev Realm...");
	hls = new HashLoginService("WDevRealm");
	hls.setConfig(wrealm.getAbsolutePath());
	hls.setRefreshInterval(60);
	try {
		hls.start();
	} catch (Exception e) {
		this.log.warn("initial WDev Realm error", e);
		this.hls = null;
	}
} else {
	this.log.info("WDev Realm file not found...");
	this.hls = null;
}
```

add code to initWebApp method to make affectived:

```
if (this.hls != null) {
	wapp.getSecurityHandler().setLoginService(hls);
}
```

• add web.properties file to setting ServerListener or WebContext configure:

   #------------------------------------------------------------------------------
   #  Properties external.
   #  it can use all android default env and system properties field.
   #  like 
   #   EXTERNAL_STORAGE the external storage path.
   #  external env name:
   #   J4A_EDIR   the jetty4a external path.
   #   J4A_DDIR   the jetty4a deploy path.
   #   J4A_LDIR   the jetty4a log path.
   #   J4A_CDIR   the jetty4a configure path.
   #------------------------------------------------------------------------------
   #the Web configure.
   WebName=J4AWebDev
   ServerListener=org.centny.wdev.WebDev
   #configure for the WebAppContext,it will be used when web.xml exist.
   WebResourceBase=$(J4A_LDIR)
   WebContextPath=/log
  

##Configure HttpServlet by code

• add normal HttpServlet as standard Web App:

public class ShowServlet extends HttpServlet { private static final long serialVersionUID = 2342757834042191580L; @Override protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { this.doPost(req, resp); } @Override protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { StringBuffer sb = new StringBuffer(); sb.append(""); // Environment. sb.append("

```
@Override
public Handler create(ClassLoader loader, Properties webp) {
	ContextHandlerCollection chc = new ContextHandlerCollection();
	// add dev path for develop command.
	WebAppContext wapp;
	wapp = new WebAppContext();
	wapp.setParentLoaderPriority(true);
	String wpath = webp.getProperty(J4A_WDIR);
	wapp.setResourceBase(wpath);
	wapp.setContextPath("/dev");
	if (this.hls != null) {
		wapp.getSecurityHandler().setLoginService(hls);
	}
	File web = new File(this.croot, "DevWeb.xml");
	if (web.exists()) {
		wapp.setDescriptor(web.getAbsolutePath());
	}
	wapp.addServlet(new ServletHolder(new ShowServlet()), "/show.cmd");
	chc.addHandler(wapp);
	return chc;
}
```