框架目标
OneRing是一个跨平台的桌面应用框架。和Adobe AIR类似，它支持用html/js/css制作用户界面，与之不同的是，它的应用为本地程序，可以直接访问操作系统的数据。
架构
一个OneRing应用程序分为两个部分：框架部分和应用部分。
框架部分
框架部分为通用框架，各应用都一样。其提供各操作系统上的界面展现，为本地窗口内嵌一个WebKit浏览器，并提供一致的js接口让应用和操作系统功能进行交互。
框架以运行时库的形式提供。
框架以系统原生语言编写，提供其他语言的绑定。
应用部分
应用部分为一个web server，负责应用逻辑，用html/css描述界面，用js提供用户交互。
运行流程
- 应用启动时，会加载框架的运行时库，注册应用url的访问方法（如WSGI），并调用框架的loop函数。
- loop函数会访问应用的 /init URL，得到一个json数据，描述初始应用窗口的相关参数，如位置、大小、窗口属性、初始页面url等。
- 框架根据该数据创建窗口，并让该窗口内的浏览器访问初始页面url，渲染用户界面，然后等待UI事件。
- 用户在界面上操作时，可以通过超链接改变整个窗口内容，也可以使用AJAX技术更新窗口内部分内容。
- 应用可以让浏览器调用ONERING名字空间下的js函数，和操作系统进行交互，该名字空间由url onering://onering/onering.js 加载。
- 应用通过 bind(event, function) 函数监听窗口更改大小、移动等操作系统UI事件。
- 可以使用pub/sub机制主动推送消息给浏览器。
- 调用 ONERING.exit() 可以退出应用；所有窗口都关闭后也会退出应用。
Python应用示例
#!/usr/bin/env python
import json
import web
import onering
urls =(
'/init','init',
'/','index',
)
class init:
def GET(self):
web.header('Content-Type','application/json')
return json.dumps({'width':400,'height':300,'url':'/'})
class index:
def GET(self):
web.header('Content-Type','text/html')
return"""<html>
<head><script type="text/javascript" src="onering://onering/onering.js"></script></head>
<body>
<p>Hello, world!</p>
<button onclick="javascript:ONERING.exit()">Exit</button>
</body></html>"""
app = web.application(urls, globals())
if __name__ == '__main__':
onering.register_wsgi_app("demo", app.wsgifunc())
onering.loop("demo")
各组件之间的交互
一个OneRing应用中，存在三个需要互相通讯的组件:
- 操作系统 OS ，控制窗口行为（如最小化窗口），及操作系统相关界面元素（如系统通知图标）
- 运行在WebKit内的javascript，控制界面内元素（如程序界面里的按钮）
- WSGI应用，控制HTML/JS的生成逻辑，以及应用相关的后台逻辑
js -> os
当js需要通知os对js所在窗口做某个行为（如最小化），通过调用 onering.js 中的get_current_window()返回值（为Window对象）的相应方法实现：
var current_window = ONERING.get_current_window();
current_window.minimize();
当js需要os执行整个应用层面的操作时（如结束应用），通过调用 onering.js 中的函数实现：
ONERING.exit();
当js需要os创建一个新窗口时，通过调用createWindow函数实现，并获得新建窗体的句柄实例：
new_window = ONERING.createWindow('/a_dialog',400,300);
当js需要向另一个窗口做某个os行为时（如隐藏另一个窗口），通过调用窗体的句柄实例的方法实现：
new_window.hide();
os -> js
js可以通过bind机制，关注操作系统发生的时间（如窗口大小改变）：
current_window.bind('resize',function(event){
if(event.width <300){
$('#sidebar').hide();
}
});
js -> app
js可以通过类AJAX调用，从app获取数据。
ONERING.getJSON('/userdata.json',function(data){
...
});
app -> js
app希望向窗体内的js主动推送消息时，可以采用pub/sub机制。
首先js通知框架自己关注的事件:
current_window.subscribe("a_file_scanned",function(fileinfo){
...
});
然后当app希望发送消息时，调用onering框架提供的publish方法：
for fileinfo in scan_files():
onering.publish("a_file_scanned", fileinfo);
其中的fileinfo为可以转化为JSON的python对象（即 json.dumps(fileinfo) 不会抛出异常）。