jmaki翻译计划，这是第一篇文章。由于以前没有做过翻译的工作，因此可能很多的语言描述的不是很恰当，请大家帮我指正。
The Sun Web Developer Pack Tutorial chapter3
原文：http://developers.sun.com/docs/web/swdp/r1/tutorial/doc/p11.html
The Sun Web Developer Pack Tutorial
Chapter 3
译者：张丹(Conan Zhang)
2008年2月7日
原文地址
http://developers.sun.com/docs/web/swdp/r1/tutorial/doc/p11.html
难度：入门级
jMaki项目
描述jMaki项目，介绍如何用jMaki创建web应用程序
介绍jMaki项目
jMaki项目是一个轻量级的web2.0应用程序框架，内嵌模板库，数据模型可创建和使用具有ajax特性的widget，通过把服务绑定到widgets上面，使应用可以与外部服务进行通信。
jMaki通过widgets封装，从而适用于变化的服务器端的环境，支持JSP、JSF、Phobos和PHP。本文重点说明JSP中使用jMaki。Phobos中使用jMaki请参考Using jMaki Widgets in a Phobos Application。JSF中使用jMaki请参考Using jMaki Widgets as JavaServer Faces Components。
jMaki项目预封装了一些流行的第三方的widgets组件，它们来自于dojo,script.acu.lous和其他的供应商。如果jMaki没有你需要的widget，你也可以自己封装第三方的widget，或者创建自定义的wdiget。到目前为止的教程没有解释怎么封装或者创建自定义的widget。请查找Project jMaki站点获得相关相息。
对于widgets的使用，jMaki还提供：
- Widgets使用简单, 可以直接设置属性的值，也可以把自己数据源导入给widget。
- 响应widget的事件，得到widgets交互信息，允许widgets访问外部服务。
- NetBeans IDE 5.5.1插件支持，使你可以方便快速地创建jMaki的web应用程序。
什么是jMaki widget?
一个jMaki widget由以下的文件组成：
- component.js: 含有用于封装widget的javascript代码，用来设置用户初始化的事件，现实ajax通信。
- component.htm: 是一个HTML文件，使用模板为客户端渲染widgets。
- component.css: 样式表用来控件widget的显示效果，比如文字的字体。这个文件是可选的。
- widget.json: 是一个Javasctip文件的JSON格式，用来描述widget的属性，接受什么格式。这个文件被NetBeans插件使用，帮助你设置widget.
一些widgets可能需要一个额外的代码。例如，所有的dojo widgets依赖于dojo toolkit库。因此，一些widgets需要额外的库文件实现这些功能。
一个jMaki应用程序像什么？
使用一个或者多个jMaki widgets在应用程序中，你需要包括上面所描述的widget的组成文件和一些额外的资源：
- jmaki.js: 是Javascript的客户端工具，用来调用jMaki widget。
- config.json: 包括第三方类库的配置信息，其中包括本地的信息，应用程序钥匙和指定类库中全局的样式。
- glue.js: 用来把widgets粘在一些。开发者可以用这个文件注册和定义widget事件的监听器，发布一个事件为一个主题，还可以提供一用方式订阅到一个主题。
- ajax-wrapper-comp.jar: 包括服务器端运行时代码，产生模板代码，资源config.json中的链接。
一个jMaki应用程序，例如Dojo金鱼眼(fisheye)widget，基本结构如下图所示，从图中可以看到需要的资源文件。图中libs文件夹包括了第三方库dojo widget的现实代码。
用NetBeans IDE5.5.1的jMaki插件创建一个新的应用程序，NetBeans IDE会自动地组织所有必需的资源在你的程序中。下一节将有关介绍NetBeans IDE 5.5.1插件的详细信息。
创建一个jMaki的web应用程序
NetBeans IDE 5.5.1提供了一个插件升级中心，允许你简单快速地创建jMaki程序。参考Sun Web Developer Pack R1 Plug-In Module for the NetBeans IDE，如何安装这个插件。
NetBeans IDE 5.5.1的jMaki插件，可以简单的拖拉jMaki widgets到jsp网页上，设置相关属性。当你要用这个插件创建网页时，你可以选择模板创建网页。参考jMaki Layouts 。
下面的图展示了创建一个新的web应用程序向导，你可以先“新建项目”，从文件菜单中选择web应用程序。
如上图，创建jMaki的web应用程序，选择jMaki ajax framework，然后选择一个模板的样式就可以开始程序的第一页了。
一旦你创建了网页，你可以从jMaki的面板中方便的拖拉widget组件到页面上。下面的图显示了，怎么拖拉一个widget从jMaki面板到jsp网页上。
了解更多的jMaki插件使用细节，请参考Developing a Web Application Using Project jMaki。
如果你不喜欢用IDE工具，你也可以创建一个空白的工程，导入用Sun web Develop的包。这类工程被叫作jMaki内核(jmaki-core)，路径为<SWDP_INSTALL>/jmaki/samples。它包括了jMaki的所有资源，但是你需要手动的复制你需要的widget的代码从<SWDP_INSTALL>/shared/resources的路径中。这个教程覆盖了NetBeans插件开发jMaki和空白项目开发jMaki应用程序。
原文地址
http://developers.sun.com/docs/web/swdp/r1/tutorial/doc/p11.html
译者：张丹(Conan Zhang)
2008年2月8日
| 
