Ringo.js嵌入集成：java-web应用嵌入JsgiServlet

  从这篇开始会逐渐介绍集成改造Ringo.js成为我心目中的东西，而不光是学习使用。

  ringo.js作为一个基于jvm的运行时，与java交互是非常重要的部分。但是，官方文档主要描述ringo作为运行时如何利用底层java库。而我其实需要的是ringo如何嵌入到已有java运行框架。

  找了半天，终于有一个切入点：jsgi集成。

  jsgi：

  jsgi是啥？osgi？不是，完全不是。jsgi来源是wsgi，python的web框架标准。jsgi同样也是common-js的标准之一。

  此外这里是扩展阅读：http://www.sitepen.com/blog/2010/01/19/commonjsjsgi-the-emerging-javascript-application-server-platform/

  JsgiServlet类

  ok既然Ringo.js实现了jsgi，其必然存在一个调用入口。这个就是这次主要讲的JsgiServlet类。显而易见，是一个Servlet实现，那么它本身可以配置到web.xml并设置webpath接管部分入口访问路径。其实我主要目的是研究它内部如何实现，以便更好实现集成目标。而现在主要描述它怎么工作，当然其中一些内容是阅读了源码之后才知道的。官方似乎没有提供直接的文档。

  另外提一句，整体查看代码时，可做为样例程序的类有两个：JsgiServlet以及RingoShell。httpServer模块使用时JsgiServlet会被默认使用。这也是Ringo.js入门中helloWorld例子的request处理部分如此写法原因。

  集成使用JsgiServlet

 而这里主要是想描述一下JsgiServlet嵌入已有javaweb的使用方式。

1.将rhino包以及ringo-core jar包（还有ringo-module jar包）放入web应用目录WEB-INF/lib目录下。

 ringo-module包内部其实是默认的module实现，与下载的ringo-home目录下的module目下内容一致。这个包主要是为了当engine在home目录下找不到module等系统模块库路径时，自动从默认jar包中读取。

2.将JsgiServlet注册到web.xml

	
		ringo
		org.ringojs.jsgi.JsgiServlet
		
			
			optlevel
			0
		
		
		
			app-module
			main
		
		
		
			app-name
			app
		
		
		
			ringo-home
			/WEB-INF
		
		
		
			module-path
			WEB-INF/app
		
		
			production
			false
		
		
			verbose
			false
		
		
			legacy-mode
			false
		
	
	
		ringo
		/rjs/*
	

这个配置我写的比官方的复杂的多。其实官方的文档中没有描述其实这个servlet有很多参数可配置。其中有一些非常重要。我是阅读代码时才知道的。

3.创建web注册时配置的应用：WEB-INF/app/main.js

export("app");
function app(request){
	print("do requset...");
    return {
        status: 200,
        headers: {"Content-Type": "text/plain"},
        body: ["Hello World"]
    };
};

4.启动服务器调试
结果看到内容。

可以尝试修改js中代码调试一写行为。

注意点

ringo-home目录其实是指定ringo软件本身的目录默认在web目录的WEB-INF。其实如果已经导入module的jar包， ringo-home下 没有module目录会自动读取jar。 如果存在module目录，则ringo将不会去读jar中的默认module文件。

默认： ringo-home为 WEB-INF目录，内部engine初始化时使用的应用目录其实是web的 应用目录对应的文件系统，context.getRealPath('/');