`
yingfang05
  • 浏览: 122931 次
  • 性别: Icon_minigender_1
  • 来自: 重庆
社区版块
存档分类
最新评论

基于AJAX和JSF打造丰富的互联网组件之Weblets篇

    博客分类:
  • jsf
阅读更多
为了在JSF开发中联合使用AJAX和Mozilla XUL技术,组件创建者必须提供这些技术所需要的任何资源文件(例如图象,式样表或脚本等)。为一个JSF组件库提供资源文件的标准方式是直接从Web应用程序根文件系统中提供服务。这些资源通常用一个档案文件(如一个ZIP文件)打包,并且独立于JSF组件库发行。

本篇将介绍一种新的开源工程Weblets(http://weblets.dev.java.net)。这个工程的目标是,为JSF组件开发者提供一种工具以便开发者可以直接从JAR中提取资源文件,而不是从Web应用程序根文件系统中提供相应的服务。不象使用定义在web.xml文件中的静态配置的URL映射的传统Web应用程序,它们需要一种基于现有的组件库JAR文件进行动态配置的URL映射。实质上,Weblets为开发者提供了一种非常容易的打包Web应用程序的方法—Web应用程序实现代码可以与其资源文件驻留在同一个Java JAR文件中。

一、资源装载

让我们假定,我们有一个JSF组件,它需要有一个JavaScript文件myScript.js服务于客户端。这个JavaScript文件为组件所用以实现与用户某种程度的丰富交互。传统情况下,这个JavaScript文件是由Web应用程序服务的—经由一个硬编码到JSF组件的实际的生成器代码中的相对路径确定。这样以来,需要Web开发者发布以独立文档文件形式交付和打包的其它相关资源。

值得注意的是,JSF HTML基本RenderKit并没有任何图象,式样,或脚本;因此,在Faces资源打包问题方面没有标准的解决方案。

下面的示例生成器代码展示了一种从Web应用程序根文件系统下提供一个JavaScript文件(/myresources/myScript.js)服务的可安装方法。

ViewHandler handler = context.getApplication().getViewHandler();String resourceURL = handler.getResourceURL(context,"/myresources/myScript.js");out.startElement("script", null);out.writeAttribute("type", "text/javascript", null);out.writeAttribute("src", resourceURL, null);out.endElement("script");

尽管这种可安装的方法方便了JSF组件作者,但是它也确实增加了Web开发者的安装负担—他们必须记住:每当把该组件库升级到一个新的版本时都要提取可安装的文档。因此,我们非常需要一种新的方法来把我们程序的其它资源打包到相同的包含Renderer类的JAR文件中,以便简化Web开发者使用我们的组件库进行发布的问题。

二、使用Weblets

这个开源Weblets工程的主要思想是,用一种通用的可扩展的方式解决资源打包问题,以便它可以被所有JSF组件创作者所利用,而同时把最小的安装任务交给Web开发者来完成。

其实,一个Weblet充当一个“调停人”的作用—它解释来自于客户端的请求,并且使用简短的Web URL从一个JAR文件中提供资源服务。不同于Servlet或Filter方式,一个Weblet可以在一个JAR内部进行注册和配置,这样以来组件库生成器、它们的资源文件还有Weblet配置文件(weblets-config.xml)都可以被打包到相同的JAR文件中。对所有的组件库来说,Weblet容器只能在Web应用程序配置文件(web.xml)中注册一次。当把组件库升级到新版本时,不需要独立地发布其它可安装程序。

值得注意的是,所有由Weblets所服务的资源都是内部资源,只能为生成器所使用。任何由应用程序所提供的资源(例如图像),都以组件属性值方式提供并且从根上下文中作为外部资源加载。

三、Weblet架构分析

尽管Weblets被设计由任何Web客户端所使用,但是,通过使用一种定制的ViewHandler和WebletsViewHandler,Weblets实现已经与JSF集成到一起。在主JSF页面生成期间,WebletsViewHandler负责把Weblet特定的资源URL转换成实际的由浏览器使用以请求Weblet托管的资源的URL。

在收到为主页面生成的标注后,浏览器使用一个独立的请求下载其它各个资源。这其中的每个请求(下载一种Weblet托管的资源)被WebletsPhaseListener所拦截,这样以来,WebletContainer必须把Weblet托管的资源文件进行“流化”而从组件库JAR中导出。

WebletContainer的设计目的是,尽可能利用浏览器缓存。这样以来,通过最小化Weblet托管的资源文件的请求数量,从而可以大大提高整体数据生成性能。

为了确保灵活性和进行优化,并且避免与现有Web应用程序资源发生冲突,Web开发者可以配置Weblets以覆盖由组件作者所提供的任何缺省的设置。

四、把Weblets应用于组件库

Weblets是使用weblets-config.xml文件进行配置的,它必须存储在组件库JAR的/META-INF目录下。配置一个Weblet类似于配置一个Servlet或一个过滤器(Filter)。在weblets-config.xml文件中的每一个Weblet入口都有一个Weblet名字、实现类和初始化参数。Weblet映射把一个特别的URL模式与一个特定的Weblet名(例如,org.myapp.html)相关联。Weblet名和默认的URL模式定义该Weblet托管的资源的公共API。特别注意,在你的组件库的各个发行版本之间不应修改这些名称和URL模式以便实现向后兼容性。

Weblets配置文件weblets-config.xml

<?xml version="1.0" encoding="UTF-8" ?><weblets-config xmlns="http://weblets.dev.java.net/config" ><weblet><weblet-name>org.myapp.html</weblet-name><weblet-class>net.java.dev.weblets.packaged.PackagedWeblet</weblet-class><init-param><param-name>package</param-name><param-value>org.myapp.faces.renderer.html.resources</param-value></init-param></weblet><weblet-mapping><weblet-name>org.myapp.html</weblet-name><url-pattern>/myresources/*</url-pattern></weblet-mapping></weblets-config>

使用1.0版本控制的Weblets配置文件以便提高软件生效效率

<?xml version="1.0" encoding="UTF-8" ?>
<weblets-config xmlns="http://weblets.dev.java.net/config" >
<weblet>
<weblet-name>org.myapp.html</weblet-name>
<weblet-class>net.java.dev.weblets.packaged.PackagedWeblet</weblet-class>
<weblet-version>1.0</weblet-version>
<init-param>
<param-name>package</param-name>
<param-value>org.myapp.faces.renderer.html.resources</param-value>
</init-param>
</weblet>
<weblet-mapping>
<weblet-name>org.myapp.html</weblet-name>
<url-pattern>/myapp/*</url-pattern>
</weblet-mapping>
</weblets-config>

 我们的组件库把资源打包到org.myapp.faces.renderer.html.resources中,并且通过使用默认的URL映射(/myresources/*)使其可用于浏览器中。
PackagedWeblet是一个内置Weblet实现,可以使用ClassLoader从一个特定的Java包中读它并且把相应的结果“流回”到浏览器端。包初始化参数告诉PackagedWeblet,当实现Weblet托管的资源请求时,应该把哪一个Java包作为根使用。

五、Weblet版本控制

  Weblets还为组件库的版本控制提供内置的支持。这用于允许浏览器在可能的情况下缓存打包的资源(例如myScript.js),从而阻止不必要的与Web服务器之间的来回通讯。

  在每次浏览器生成页面时,它都确保所有的为该页面所用的资源可以使用。在该页面的初始生成期间,通过从Web服务器下载一个新的副本,浏览器用每一个资源URL的内容填充它的缓存。当它这样做时,浏览器从响应信息头部记下Last-Modified和Expires时间戳。如果当前时间比Expires时间戳还晚,那么被缓冲的内容已经到期。

  在下一次生成这一页面时,浏览器检查是否本地缓冲资源已经过期。如果它没有过期,则重用本地缓冲的副本。否则,将向Web服务器发出一种新的请求,包括在If-Modified-Since请求头中的Last-Modified信息。通过指示浏览器缓存尚待更新,或者通过使用响应头中的更新的Last-Modified和Expires时间戳把新的资源内容“流回”到浏览器,Web服务器作出响应。

  Weblets使用版本控制机制来利用浏览器缓存行为,这样,打包的资源就可以被下载并且被尽可能有效地缓冲。当缓存被“倒空”或当组件库在Web服务器端已经升级时,浏览器仅仅需要检查新的更新即可。

通过指定一个Weblet版本,你可以指示被打包的资源不会发生改变,直到版本号发生改变为止。因此,版本号作为在运行时刻由WebletsViewHandler(例如,/myresources$1.0/myScript.js)决定的资源URL的一部分被包括在内。当WebletContainer服务这一请求时,它从URL中提取版本号并且确定资源应该被缓冲并且从未到期。一旦一个新版本的组件库被发布到Web应用程序,在运行时刻由WebletsViewHandler创建的资源URL(例如,/myresources$2.0/myScript.js)就会改变,这样浏览器中的myScript.js的缓冲副本版本1.0不再有效,因为URL已经发生变化。

在开发期间,被打包资源的内容可能经常发生变化,所以,使浏览器保持回检以便使Web服务器检测最新的资源URL目录是非常重要的。默认情况下,每当生成主Web页面(且Weblet版本被从weblets-config.xml中忽略时)时,即进行这种检查。

  作为选择,Weblet配置允许组件创作者把-SNAPSHOT添加到版本号上。例如,1.0-SNAPSHOT(见下面的代码)说明这个文件正处于开发中。

<?xml version="1.0" encoding="UTF-8" ?>
<weblets-config xmlns="http://weblets.dev.java.net/config" >
<weblet>
<weblet-name>org.myapp.html</weblet-name>
<weblet-class>net.java.dev.weblets.packaged.PackagedWeblet </weblet-class>
<weblet-version>1.0-SNAPSHOT</weblet-version>
...
</weblet>
...
</weblets-config>

  安全性

  当从一个JAR中服务打包资源时,特别注意一定不要使Java类文件或另外的敏感信息为URL所存取。在桌面Java应用程序中,资源文件经常存储在一个子包“resources”中,它位于使用资源文件的Java实现类的下面。同样的策略也适于在JSF组件库中打包的资源,并且还具有安全方面的优点—可以确保仅有资源文件可为URL所存取。所有另外的JAR文件内容,包括Java实现类,都不是URL可存取的,因为“resources”包和任何“resources”的子包中都不存在Java类。

  Weblets协议

  在讨论了如何配置Weblets后,现在我们来看一下如何在我们的生成器中引用由Weblet所定义的资源。这个由Weblet合同所定义的语法用于返回一个到JSF页面的适当的URL,如下所示:

<prefix><weblet name><resource>

  在此,prefix指示这是一种Weblet托管的资源,而且它的后面即跟着Weblet名字和要求的资源。

  以前,在我们的Renderer类中,我们把URL /myresources/myScript.js作为一个参数传递到ViewHandler的getResourceURL()方法。在下面的示例代码中,我们通过使用Weblet协议也可以实现这一功能。

ViewHandler handler = context.getApplication().getViewHandler();
String resourceURL = handler.getResourceURL(context, "weblet://org.myapp.html/myScript.js");
out.startElement("script", null);
out.writeAttribute("type", "text/javascript", null);
out.writeAttribute("src", resourceURL, null);
out.endElement("script");

  这种类似Weblet协议的语法方便使用而且也很容易理解。这种语法以weblet://开始,后面跟着Weblet名,例如org.myapp.html,最后跟着路径信息或资源文件,例如/myScript.js。注意,URL映射和版本号都没有包括到Weblet资源语法中。Weblet URL映射和版本号由WebletsViewHandler所使用来创建一种该Weblet将会服务的资源URL。

  当组件创作者没有使用Weblets时,他不会使用weblet://资源路径语法并且将发行一个独立的可安装的zip。当组件创作者使用Weblets时,他开始在生成器中使用weblet://资源路径语法,并且把这些资源包括到JAR中。实际上,在同一个组件库中的相同版本的资源中混合使用这些方法并无多大益处。

六、在JSF应用程序中使用Weblets

  为了帮助Web开发者简化安装,组件创作者应该为它们的组件库选择一个缺省的URL映射。组件创作者不需要把任何Weblet特定的配置添加到web.xml文件,因为WebletsPhaseListener能够被自动激活以服务于针对Weblet托管资源的输入请求。


七、小结

  作为一个新的开源工程,Weblets为Web客户端和JSF组件开发社区提供一种“事实上”通用的和可配置的资源加载工具。这种工具的主要优点在于,它能够简化JSF组件及其资源的打包,并用最小开支来安装和建立针对特定Web应用程序工程的JSF组件库。

  总之,本文探讨了一种打包JSF组件资源的新方式。现在,通过包括一个合适的weblets-config.xml文件并使用weblet://协议风格的语法来引用Weblet托管的资源,你应该能够在你自己的组件库中利用Weblets。
分享到:
评论

相关推荐

    ajax4jsf实例

    Ajax4JSF 是基于JSF 1.x 和 RichFaces 3.x 的一个组件库,旨在简化JSF应用中的Ajax集成。它提供了多种预定义的Ajax行为和组件,使得开发人员能够通过声明式的方式在JSF页面上添加Ajax特性,提高用户体验。 ### 2. ...

    ajax4jsf-demo

    Ajax4JSF 是针对JSF的扩展,它提供了一套方便的Ajax行为和组件,使得开发者能够在JSF页面上添加Ajax功能。这些组件和行为可以方便地与现有的JSF组件集成,而无需深入理解底层的XMLHttpRequest实现。 **4. Demo 示例...

    jboss-ajax4jsf-1.1.1-src

    在深入研究这个项目时,开发者首先需要了解JSF和Ajax的基础知识,然后可以查看源码以理解Ajax4jsf如何处理Ajax请求和响应,以及如何在JSF组件中集成Ajax功能。此外,通过运行示例或测试代码,开发者能够快速上手并...

    ajax4jsf使用中文手册

    手册提供了丰富的示例代码和步骤,帮助读者理解和实践Ajax4JSF。从简单的按钮点击触发Ajax请求,到复杂的表单验证和数据网格的异步加载,都有详细的讲解。 总的来说,"Ajax4JSF使用中文手册"是JSF开发者实现Ajax...

    ajax4jsf.zip

    本压缩包“ajax4jsf.zip”包含了开发Ajax4JSF应用所需的所有关键组件和库文件,确保开发者可以顺利地开始项目。 **一、Ajax4JSF的核心概念** 1. **组件库**: Ajax4JSF提供了一系列预先封装好的UI组件,这些组件...

    Ajax4jsf 用户手册

    该框架使得在JSF环境中实现Ajax功能变得更加简单,无需编写JavaScript代码,而是通过一组组件和API来实现。 ### 1. **开始使用Ajax4jsf** - **环境需求**:首先,你需要一个支持Ajax4jsf的Java版本以及JavaServer ...

    seam+jsf+richfaces+ajax4jsf 电子书

    RichFaces是一个基于JSF的扩展库,它提供了大量的富客户端组件和Ajax功能。这些组件可以增强用户的交互体验,如滑动面板、数据网格、图表等。RichFaces使用AJAX技术实现局部页面更新,降低了服务器的负载,提升了...

    JSF全套(JSF入门教+ LIB+ Ajax4JSF使用手册 )

    学习Ajax4JSF,你将掌握如何在JSF应用中集成Ajax,创建异步交互,以及使用其提供的各种Ajax组件,如`a4j:support`和`a4j:commandButton`。 5. **JSF项目的创建**:这部分教程会指导你从零开始创建一个完整的JSF项目...

    ajax4jsf-1.1.1.jar.zip

    "ajax4jsf-1.1.1.jar" 是Ajax4JSF库的核心组件,它包含了一组预定义的UI组件和行为,以及用于处理Ajax请求和响应的底层实现。开发者可以将这个JAR文件添加到他们的项目类路径中,以便利用Ajax4JSF的功能。这个JAR...

    ajax 4jsf用户指南中文版

    - Ajax4jsf的结构概览,包括核心组件和工作原理。 - 如何发送Ajax请求及如何决定请求的内容。 - 如何确定请求后需要更新的页面元素。 - **Ajax请求**: - 发送Ajax请求的方式和方法。 - 决定发送哪些数据给...

    ajax4jsf中文用户指南

    Ajax4JSF(Ajax for JavaServer Faces)是一个开源框架,专为JavaServer Faces(JSF)应用程序添加Ajax功能。这个框架使得开发者无需编写JavaScript代码就能实现丰富的用户界面和交互性。Ajax4JSF充分利用JSF的优势...

    ajax4jsf使用手册

    Ajax4JSF(Ajax for JavaServer Faces)是一个开源的、基于JavaServer Faces(JSF)技术的组件库,它为JSF应用程序提供了丰富的Ajax功能,增强了用户界面的交互性和响应性。这个框架使得开发者能够轻松地在JSF应用中...

    ajax4jsf jar

    ajax4jsf jar ajax4jsf jar

    ajax4jsf教程

    3. **Ajax4JSF集成**:Ajax4JSF将AJAX功能无缝集成到JSF中,通过提供一组预定义的AJAX行为和组件,使得开发者可以轻松实现AJAX化的JSF应用。 ### 二、Ajax4JSF安装与配置 1. **依赖库**:首先,需要在项目中添加...

    jsf+facelets+ajax4jsf的全部jar包

    通常,这需要在项目的类路径中添加相应的jar,配置web.xml以启用Facelets和Ajax4jsf,然后在Facelets页面中使用Ajax4jsf的组件和行为。 6. **开发实践**:在实际开发中,开发者可以通过JSF的Managed Beans定义业务...

    Ajax4JSF用户指南

    Ajax4JSF还提供了内建的皮肤功能,允许用户自定义组件的外观和感觉。此外,框架支持多种Java版本、JSF实现、Web服务器以及主流浏览器。为了适应不同的开发环境,Ajax4JSF可以与其他IDE集成,例如Exadel VCP,以简化...

    jsf+spring+hibernate+ajax4jsf

    这个整合涉及四个关键组件:JavaServer Faces (JSF),Spring框架,Hibernate ORM,以及Ajax4jsf(基于RichFaces的Ajax解决方案)。下面我们将详细探讨这些技术及其整合。 **JavaServer Faces (JSF)** 是一个Java...

    编写JSF用户自定义UI组件(之五)

    这篇博文“编写JSF用户自定义UI组件(之五)”可能深入探讨了如何创建和使用自定义组件的过程,虽然描述部分为空,但我们可以基于标题推测其主要内容。 1. **JSF组件体系结构**:JSF组件是由UIComponent类及其子类...

    Ajax4jsf references

    例如,与jQuery相比,Ajax4jsf在处理JSF事件和组件更新时更为便捷,更适合那些已经使用JSF框架构建应用的项目。 总之,Ajax4jsf是JavaServer Faces开发者的一个强大工具,通过其提供的组件和标签,可以极大地提升...

Global site tag (gtag.js) - Google Analytics