了解 Ant 1.6 的新特性以及它们如何影响您组织编译过程的方式。

虽然 Ant 版本的 1.5.x 系列在任务级方面有很大的改善，但它没有改变人们使用 Ant 的方式。而 Ant 1.6 却有所不同。它增加了几个新特性，以支持大型或非常复杂的编译情况。但是，要充分利用它们的功能，用户可能需要稍微调整它们的编译过程。

本文重点介绍了其中的三种新特性 — <macrodef>、<import>、<subant> 任务，表明使用它们可以有什么收获，以及它们如何影响您组织编译设置的方式。

宏

大多数编译工程师迟早会面临必须执行相同的任务组合但在几个地方配置稍微有点不同的情况。一个常见的例子是创建一个web 应用程序存档，对于开发系统、测试系统和生产系统有着不同的配置。

让我们假设 web 应用程序拥有依赖于目标系统的不同的 web 部署描述符，并为开发环境使用了一个不同的 JSP 集合以及一个不同的资料库集合。配置信息将放在属性中，创建 web 存档的任务看起来将类似于

  <target name="war" depends="jar">
    <war destfile="${war.name}"
         webxml="${web.xml}">
      <lib refid="support-libraries"/>
      <lib file="${jar.name}"/>
      <fileset dir="${jsps}"/>
    </war>
</target>

其中 support-libraries 是引用一个在其它位置定义的 <fileset> ，该引用指向您的应用程序所需的附加资料库的一个公共集合。

如果您只想一次创建一个 web 存档，那么您只需要正确地设置属性。比如说，您可以从一个您的目标专有的属性文件中加载它们。

利用 Ant 1.5 创建存档

现在，假定您想为测试系统和生产系统同时创建存档，以确保您真正为两个系统打包了相同的应用程序。利用 Ant 1.5，您可能使用 <antcall> 来调用拥有不同属性设置的 "war" 目标，类似：

  <target name="production-wars">
    <antcall target="war">
      <param name="war.name" value="${staging.war.name}"/>
      <param name="web.xml" value="${staging.web.xml}"/>
    </antcall>
    <antcall target="war">
      <param name="war.name" value="${production.war.name}"/>
      <param name="web.xml" value="${production.web.xml}"/>
    </antcall>
</target>

当然，这假定两个目标系统都将使用相同的 jar 和 JSP。

但这种方法有一个主要缺点 — 就是速度慢。<antcall> 重新分析编译文件，并为每一次调用重新运行调用的目标所依赖的所有目标。在上面的例子中，"jar" 目标将被运行两次。我们希望这对第二次调用没有影响，因为 "war" 目标依赖于它。

利用 Ant 1.6 创建存档

使用 Ant 1.6，您可以忘掉用 <antcall> 来实现宏的方法，相反您可以通过参数化现有的任务来创建一个新的任务。因而上面的例子将变为：

  <macrodef name="makewar">
    <attribute name="webxml"/>
    <attribute name="destfile"/>
    <sequential>
      <war destfile="@{destfile}"
           webxml="@{webxml}">
        <lib refid="support-libraries"/>
        <lib file="${jar.name}"/>
        <fileset dir="${jsps}"/>
      </war>
    </sequential>
  </macrodef>

这定义了一个名称为 makewar 的任务，该任务可以和任何其它的任务一样使用。该任务有两个必需的属性，webxml 和 destfile。要使属性可选，我们必需在任务定义中提供一个默认值。这个示例假定 ${jar.name} 和 ${jsps} 在编译期间为常量，从而它们仍然作为属性指定。注意，属性在使用任务时展开而不是在定义宏的地方展开。

所用任务的特性几乎完全和属性一样，它们通过 @{} 而不是 ${} 展开。与属性不同，它们是可变的，也就是说，它们的值可以（并将）随着每一次调用而改变。它们也只在您的宏定义程序块内部可用。这意味着如果您的宏定义还包含了另一个定义了宏的任务，那么您内部的宏将看不到包含的宏的属性。

于是新的 production-wars 目标将类似于：

  <target name="production-wars">
    <makewar destfile="${staging.war.name}"
             webxml="${staging.web.xml}"/>
    <makewar destfile="${production.war.name}"
             webxml="${production.web.xml}"/>
</target>

这个新的代码段不仅执行得快一些，而且也更易读，因为属性名称提供了更多的信息。

宏任务还可以定义嵌套的元素。<makewar> 定义中的 <war> 任务的嵌套 <fileset> 可以是这种嵌套元素的一种。可能开发目标需要一些额外的文件或想从不同的位置中挑选 JSP 或资源。以下代码段将一个可选的嵌套 <morefiles> 元素添加到了 <makewar> 任务中

  <macrodef name="makewar">
    <attribute name="webxml"/>
    <attribute name="destfile"/>
    <element name="morefiles" optional="true"/>
    <sequential>
      <war destfile="@{destfile}"
           webxml="@{webxml}">
        <lib refid="support-libraries"/>
        <lib file="${jar.name}"/>
        <fileset dir="${jsps}"/>
        <morefiles/>
      </war>
    </sequential>
  </macrodef>

调用将类似于：

  <makewar destfile="${development.war.name}"
           webxml="${development.web.xml}">
    <morefiles>
      <fileset dir="${development.resources}"/>
      <lib refid="development-support-libraries"/>
    </morefiles>
  </makewar>

这就像 <morefiles> 的嵌套元素直接在 <war> 任务内部使用的效果一样。

即使迄今为止的示例仅显示了包装单个任务的 <macrodef>，但它不限于此。

下面的宏不仅将创建 web 存档，还将确保包含最终存档的目录在试图写入之前存在。在一个实际的编译文件中，您可能在调用任务之前使用一个设置目标来完成这个操作。

  <macrodef name="makewar">
    <attribute name="webxml"/>
    <attribute name="destfile"/>
    <element name="morefiles" optional="true"/>
    <sequential>
      <dirname property="@{destfile}.parent"
               file="@{destfile}"/>
      <mkdir dir="${@{destfile}.parent}"/>
      <war destfile="@{destfile}"
           webxml="@{webxml}">
        <lib refid="support-libraries"/>
        <lib file="${jar.name}"/>
        <fileset dir="${jsps}"/>
        <morefiles/>
      </war>
    </sequential>
  </macrodef>

这里注意两件事情：

首先，特性在属性展开之前展开，因此结构 ${@{destfile}.parent} 将展开一个名称包含了 destfile 特性的值和 ".parent" 后缀的属性。这意味着您可以将特性展开嵌入到属性展开中，而不是将属性展开嵌入特性展开中。

其次，这个宏定义了属性，该属性的名称基于一个特性的值，因为 Ant 中的属性是全局的并且不可改变。第一次尝试使用

      <dirname property="parent"
               file="@{destfile}"/>

相反将不会在 "production-wars" 目标中的第二次 <makewar> 调用产生期望的结果。第一次调用将定义一个新的名称为 parent 的属性，该属性指向父目录 ${staging.war.name}。第二次调用将查看这个属性但不会修改它的值。

预期 Ant 未来的版本将支持某些类型的限定范围的属性，这种属性只在宏执行期间定义。在此之前，使用特性的名称来构建属性名称是一种变通办法，潜在的副作用是要创建大量的属性。

提示：如果您查看您的编译文件时发现使用了 <antcall> 代替宏，那么强烈建议您考虑使用 macrodef 将其转换成真正的宏。性能影响可能非常显著，并且还可能产生更易读和更易于维护的编译文件。

导入

将一个编译文件分成多个文件有几个原因。

1. 文件可能变得太大，需要分成几个单独的部分，以便更易于维护。
2. 您有某个功能集是多个编译文件公用的，您想共享它。

共享公用功能/在 Ant 1.6 之前包含文件

在 Ant 1.6 之前，您唯一的选择是实体包含的 XML 方法，类似于：

  <!DOCTYPE project [
      <!ENTITY common SYSTEM "file:./common.xml">
  ]>
  
  <project name="test" default="test" basedir=".">
  
    <target name="setup">
      ...
</target>
  
    &common;
  
    ...
  
</project>

摘自 Ant 常见问题解答。

这种方法有两个主要的缺点。您不能使用 Ant 属性指向您想包含的文件，因此被迫在您的编译文件中对位置进行硬编码。您想包含的文件只是一个 XML 文件的一部分，它可能没有一个根元素，因而使用支持 XML 的工具进行维护更加困难。

共享公用功能/使用 Ant 1.6 包含文件

Ant 1.6 自带了一个名称为 import 的新任务，您现在可以使用它。上面的示例将变为

  <project name="test" default="test" basedir=".">
  
    <target name="setup">
      ...
</target>
  
    <import file="common.xml"/>
  
    ...
  
</project>

因为它是一个任务，因此您可以使用 Ant 所有的特性来指定文件位置。主要的差异是被导入的文件本身必须是一个有效的 Ant 编译文件，因而必须有一个名称为 project 的根元素。如果您想从实体包含转换到导入，那么您必须在导入的文件的内容首尾放上 <project> 标记；然后 Ant 将在读取文件时再次划分它们。

注意文件名称由 Ant 任务根据编译文件的位置（而不是指定的基本目录）确定。如果您没有设置项目的 basedir 属性或将其设为 "."，那么您将不会注意到任何差异。如果您需要根据基本目录解析一个文件，那么您可以使用一个属性作为变通办法，类似于：

  <property name="common.location" location="common.xml"/>
  <import file="${common.location}"/>

属性 common.location 将包含文件 common.xml 的绝对路径，并已根据导入项目的基本目录解析。

使用 Ant 1.6，所有的任务都可能放在目标之外或之内，除了两个例外。<import> 一定不能嵌入到目标中，<antcall> 一定不能在目标外使用（否则它将创建一个无限循环）。

而 <import> 可做的不仅仅是导入另一个文件。

首先，它定义了名称为 ant.file.NAME 的特殊属性，其中 NAME 替换为每一个导入文件的 <project> 标记的名称属性。这个属性包含了导入文件的绝对路径，导入文件可用来根据它自己的位置（而不是导入文件的基本目录）定位文件和资源。

这意味着 <project> 的名称属性在 <import> 任务环境中变得更加重要。它还用来为在被导入的编译文件中定义的目标提供别名。如果导入了以下文件

<project name="share">
    <target name="setup">
      <mkdir dir="${dest}"/>
</target>
</project>

导入编译文件可以查看作为 "setup" 或 "share.setup" 的目标。后者在目标覆盖的上下文中变得非常重要。

让我们假定有一个包含了多个独立的组件（每个组件拥有它自己的编译文件）的编译系统。这些编译文件几乎相同，因此我们决定将公用功能转移到一个共享和已导入的文件中。为了简单起见，我们只介绍 Java 文件的编译和创建结果的一个 JAR 存档。共享的文件将类似于

  <project name="share">
    <target name="setup" depends="set-properties">
      <mkdir dir="${dest}/classes"/>
      <mkdir dir="${dest}/lib"/>
</target>
    <target name="compile" depends="setup">
      <javac srcdir="${src}" destdir="${dest}/classes">
        <classpath refid="compile-classpath"/>
</javac>
</target>
    <target name="jar" depends="compile">
      <jar destfile="${dest}/lib/${jar.name}" basedir="${dest}/classes"/>
</target>
</project>

这个文件不会作为一个独立的 Ant 编译文件进行工作，因为它没有定义 "setup" 所依赖的 "set-properties" 目标。

组件 A 的编译文件可能类似于

  <project name="A" default="jar">
    <target name="set-properties">
      <property name="dest" location="../dest/A"/>
      <property name="src" location="src"/>
      <property name="jar.name" value="module-A.jar"/>
      <path id="compile-classpath"/>
</target>
    <import file="../share.xml"/>
</project>

它仅设置适当的环境，然后将全部的编译逻辑交给被导入的文件负责。注意该编译文件创建了一个空的路径作为编译 CLASSPATH，因为它是自包含的。模块 B 依赖于 A，它的编译文件将类似于

  <project name="B" default="jar">
    <target name="set-properties">
      <property name="dest" location="../dest/B"/>
      <property name="src" location="src"/>
      <property name="jar.name" value="module-B.jar"/>
      <path id="compile-classpath">
        <pathelement location="../dest/A/module-A.jar"/>
      </path>
</target>
    <import file="../share.xml"/>
</project>

您将注意到该编译文件与 A 的编译文件几乎一样，因此似乎有可能将大多数的 set-properties 目标也推送到 shared.xml 中。实际上，我们可以假定有一个对 dest 和 src 目标一致的命名惯例，以实现这一目的。

  <project name="share">
    <target name="set-properties">
      <property name="dest" location="../dest/${ant.project.name}"/>
      <property name="src" location="src"/>
      <property name="jar.name" value="module-${ant.project.name}.jar"/>
</target>

    ... contents of first example above ...
</project>

ant.project.name 是一个内置的属性，它包含了最外面的 <project> 标记的名称属性的值。因此，如果模块 A 的编译文件导入了 share.xml，那么它将拥有值 A。

注意，所有的文件都与导入编译文件的基本目录相关，因此 scr 属性的实际值依赖于导入文件。

为此，A 的编译文件将简单地变为

<project name="A" default="jar">
    <path id="compile-classpath"/>
    <import file="../share.xml"/>
</project>

B 的编译文件将变为

  <project name="B" default="jar">
    <path id="compile-classpath">
      <pathelement location="../dest/A/module-A.jar"/>
    </path>
    <import file="../share.xml"/>
</project>

现在假定 B 增加了一些 RMI 接口，需要在编译类之后但在创建 jar 之前运行 <rmic>。这就是目标覆盖能派上用场的地方。如果我们在导入编译文件中定义了一个目标，该目标与被导入的编译文件中的一个目标名称相同，那么将使用导入编译文件中的目标。例如，B 可以使用：

  <project name="B" default="jar">
    <path id="compile-classpath">
      <pathelement location="../dest/A/module-A.jar"/>
    </path>
    <import file="../share.xml"/>

    <target name="compile" depends="setup">
      <javac srcdir="${src}" destdir="${dest}/classes">
        <classpath refid="compile-classpath"/>
</javac>
      <rmic base="${dest}/classes" includes="**/Remote*.class"/>
</target>
</project>

在上面的示例中将使用 "compile" 目标，而不是 share.xml 中的目标；然而，不幸的是，这只是从共享那里复制 <javac> 任务。一种更好的解决方案是：

  <project name="B" default="jar">
    <path id="compile-classpath">
      <pathelement location="../dest/A/module-A.jar"/>
    </path>
    <import file="../share.xml"/>

    <target name="compile" depends="share.compile">
      <rmic base="${dest}/classes" includes="**/Remote*.class"/>
</target>
</project>

这只是使 B 的 "compile" 在原来的 "compile" 目标使用之后运行 <rmic>。

如果我们想在编译之前生成一些 Java 源代码（例如通过 XDoclet)，我们可以使用类似下面的方法：

    <import file="../share.xml"/>

    <target name="compile" depends="setup,xdoclet,share.compile"/>
    <target name="xdoclet">
       .. details of XDoclet invocation omitted ..
</target>

因此您可以完全覆盖一个目标或通过在原始目标之前或之后运行任务来增强它。

这里要注意一个危险。目标覆盖机制使导入编译文件依赖于在导入文件中使用的名称属性。如果任何人修改了导入文件的名称属性，那么导入编译文件将被破坏。Ant 开发社区目前正在讨论在 Ant 的一个未来的版本中为此提供一个解决方案。

提示：如果您在编译文件中发现了非常常见的结构，那么值得尝试将文件重构为一个（一些）共享文件，并在必要时使用目标覆盖。这可以使您的编译系统更加一致，并让您能够重用编译逻辑。

Subant

在某种意义上，subant 是两种任务合二为一，因为它了解操作的两种模式。

如果您使用 <subant> 的 genericantfile 属性，那么它的工作方式和 <antcall> 一样，调用包含任务的同一个编译文件中的目标。与 <antcall> 不同，<subant> 获取目录的列表或集合，并将为每一个目录调用一次目标，以设定项目的基本目录。如果您想在任意数量的目录中执行完全一样的操作，那么这非常有用。

第二种模式不使用 genericantfile 属性，而获取一个编译文件的列表和集合进行迭代，以在每一个编译文件中调用目标。这种工作方式类似于在一个循环中使用 <ant> 任务。

第二种形式的典型情景是几个能够独立编译的模块的一个编译系统，但是该系统需要一个主编译文件来一次性编译所有的模块。

在 Ant 1.6 之前构建主编译文件

在导入部分中讨论的例子使用了这样一个主编译文件。

  <target name="build-all">
    <ant dir="module-A" target="jar"/>
    <ant dir="module-B" target="jar"/>
</target>

在 Ant 1.6 之前的 Ant 中。

使用 Ant 1.6 构建主编译文件

在 Ant 1.6 中使用 <subant>，这可以重写为

 
  <target name="build-all">
    <subant target="jar">
      <filelist dir=".">
        <file name="module-A/build.xml"/>
        <file name="module-B/build.xml"/>
      </filelist>
    </subant>
</target>

这看起来并没有很大的改善，因为您仍然必须单独指定每一个子编译文件。相反如果您转用 <fileset>，那么情况将有所改观。

  <target name="build-all">
    <subant target="jar">
      <fileset dir="." includes="module-*/build.xml"/>
    </subant>
</target>

这将自动发现所有模块的编译文件。如果您增加了一个模块 C，主编译文件中的目标不需要修改。

但小心。与 <filelist> 或 <path>（也被 <subant> 支持）不同，<fileset> 是无序的。在我们的例子中，模块 B 依赖于模块 A，因此我们需要确保首先编译模块 A，而使用 <fileset> 没有办法这么做。

如果编译完全彼此独立或者它们对于一个给定的操作彼此独立，那么 <fileset> 仍然有用。模块 B 的文档目标可能完全不依赖于模块 A，同样还有从您的 SCM 系统中更新源代码的目标。

如果您想将编译文件的自动发现与根据编译的相互依赖性对编译进行排序结合在一起，那么您将必须编写一个定制的 Ant 任务。基本的想法是编写一个使用 <fileset> 的任务（让我们目前称之为 <buildlist>），确定依赖关系并计算 <subant> 必须使用的顺序。然后它创建一个以正确的顺序包含编译文件的 <path>，然后将对这个路径的一个引用放到项目中。调用将类似于

  <target name="build-all">
    <buildlist reference="my-build-path">
      <fileset dir="." includes="module-*/build.xml"/>
    </buildlist>
    <subant target="jar">
      <buildpath refid="my-build-path"/>
    </subant>
</target>

这个假想的 buildlist 任务已经在 Ant 用户邮件列表和 bug 跟踪系统中进行了讨论。很有可能 Ant 的一个将来的版本中将包含这样的一个任务。

在 Ant 1.6 中已经增加了大量的新特性。这些新功能中的许多功能使得编译模板易于创建、构造和定制。特别是 <import> 和 <target> 进行了覆盖。<import>、<macrodef> 和 <subant> 特性很有可能使得 Ant 编译可高度重用。<scriptdef>（本文中未讨论）对于需要一些脚本但不想用 Java 编写定制任务的人而言可能非常有吸引力。

UI Tags
Validation Examples

Resource bundles are searched in the following order:

1.) ActionClass.properties
2.)BaseClass.properties (all the way to Object.properties)
3.) Interface.properties (every interface and sub-interface)
4.) package.properties (every of every base class, all the way to java/lang/package.properties)

7.
http://forum.javaeye.com/viewtopic.php?t=11073&start=0
http://www.opensymphony.com/webwork/wikidocs/Transparent%20web-app%20I18N.html

http://localhost:8080/webwork_test/hello/hello.action?set_locale=zh_CN
http://localhost:8080/webwork_test/hello/hello.action?set_locale=en_US

测试通过,自定义语种问题解决.


相关链接:
http://forum.javaeye.com/viewtopic.php?t=11073&start=0



8.
今天发现5.8.4版本的myeclipse的tag属性面板挺好用的.good.


9.
有关webwork的javascript验证能力参看以下帖子:
http://www.hibernate.org.cn/viewtopic.php?t=9126&postdays=0&postorder=asc&start=0

http://forum.javaeye.com/allbloglist.php?page=15

http://scud.blogdriver.com/scud/index.html

在执行 ant setup的时候，在compile-module的时候，总是说找不到valuelist的类，后来发现AppFuse的jar都添加到了builde.xml中，于是我也把valuelist.jar添加过去了，发现问题解决了，方法如下：

AppFuse执行Setup后自动将valuelist.jar复制到Tomcat下：

在appfuse\lib\lib.properties中添加如下内容：

#
# ValueList
#
valuelist.version=0.1.7
valuelist.dir=${lib.dir}
valuelist.jar=${valuelist.dir}/valuelist.jar

将properties.xml中添加：
<!-- Web -->
<path id="web.compile.classpath">
    <pathelement location="${dist.dir}/${webapp.name}-dao.jar"/>
    <pathelement location="${dist.dir}/${webapp.name}-service.jar"/>
    <pathelement location="${struts.jar}"/>
    <pathelement location="${strutsmenu.jar}"/>
    <pathelement location="${displaytag.jar}"/>
    <pathelement location="${jakarta-oro.jar}"/>
    <pathelement location="${commons-digester.jar}"/>
    <pathelement location="${commons-logging.jar}"/>
    <pathelement location="${commons-beanutils.jar}"/>
    <pathelement location="${commons-collections.jar}"/>
    <pathelement location="${commons-fileupload.jar}"/>
    <pathelement location="${commons-lang.jar}"/>
    <pathelement location="${commons-validator.jar}"/>
    <pathelement location="${servletapi.jar}"/>
    <pathelement location="${valuelist.jar}"/>                    //这是我添加的
    <fileset dir="${javamail.dir}" includes="*.jar"/>
    <fileset dir="${spring.dir}" includes="*.jar"/>
    <fileset dir="${jstl.dir}/lib" includes="jstl.jar"/>
</path>

在builde.xml中添加：
<war destfile="${webapp.dist}/${webapp.war}"
            webxml="${webapp.target}/WEB-INF/web.xml" compress="true">
            <fileset dir="${webapp.target}" excludes="**/web.xml,**/*-resources.xml"/>
            <metainf dir="${webapp.dist}" includes="context.xml"/>

            <classes dir="${build.dir}/web/classes">
                <exclude name="**/database.properties"/>
            </classes>

            <lib file="${dist.dir}/${webapp.name}-dao.jar"/>
            <lib file="${dist.dir}/${webapp.name}-service.jar"/>

            <webinf dir="${struts.dir}" includes="*.xml"/>
            <webinf dir="web/WEB-INF" includes="*-resources.xml"/>
           
            <lib file="${clickstream.jar}"/>
            <lib dir="${struts.dir}" includes="*.jar"/>
            <lib dir="${jstl.dir}/lib">
                <include name="jstl.jar"/>
                <include name="standard.jar"/>
            </lib>
            <lib dir="${javamail.dir}" includes="*.jar"/>  
            <lib file="${log4j.jar}"/>
            <lib file="${strutsmenu.jar}"/>
     <lib file="${valuelist.jar}"/>                             //这是我添加的内容
            <lib dir="${displaytag.dir}" includes="*.jar"/>
            <lib file="${hibernate.jar}"/>
            <lib dir="${hibernate.dir}/lib">
                <include name="odmg*.jar"/>
                <include name="dom4j*.jar"/>
                <include name="cglib*.jar"/>
                <include name="ehcache*.jar"/>
                <include name="oscache*.jar"/>
            </lib>
            <lib dir="${spring.dir}" includes="*.jar"/>
            <lib file="${sitemesh.jar}"/>
            <lib dir="${velocity.dir}" includes="*.jar"/>  
            <lib file="${urlrewrite.jar}"/>
        </war>
    </target>

                                                                                                    兔八哥

关于URLEncoder的解析问题     

      在http://rabbit8.blogchina.com/blog/article_144619.789425.html后，有个朋友留言，说在百度试验的结果和我文章中说的不一致，我做了个实验，证实JDK的帮助没错，原因如下：

我的试验代码如下：
public static void main(String[] args) {
        URLEncoder urle = null;
       
        //得到默认：%A8%B9
        System.out.println("默认：" +   urle.encode("ü")); 
        try {
            //得到GBK：%A8%B9
            System.out.println("GBK：" +  urle.encode("ü", "GBK"));
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
        }
        try {
            //得到UTF-8：%C3%BC
            System.out.println("UTF-8：" +  urle.encode("ü", "UTF-8"));
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
        }
    }
 
      如果用UltraEdit来查看"ü"的ASCII的话，得到的结果如图：
 
      可见，UltraEdit使用的是操作系统默认的编码方式(实际上，MS采用的也不是GBK，而是另一种编码，但效果和GBK差不多)，所以它显示的ASCII的编码为A8 B9,就是第一和第二种情况的结果。而第三种情况才是JDK帮助中所声明的情况。
 
      我查看了百度，提交了一下，结果和我预期的是一样的！

      如果你查看页面的源文件，会看到百度的charset为gb2312,而帮助中明确提到例子使用的是UTF-8编码，所以出现了不一致的问题，也正是因为这个原因，所以JDK中决定要废弃public static String encode(String s)方法，因为这个方法的编码的字符集依赖于程序运行的系统的默认的字符集！
 
                                                                     兔八哥
                                                             2005-2-15 17：41
 

关于AppFuse中使用中文编码的问题

      这2个月一直被DisplayTag折腾，如果DisplayTag的链接或者排序的列中有汉字，那么排序或者翻页都会查询不到结果或报错（如果你处理的好，可能会显示没有可以显示的数据）。

      我一直以为这个问题是因为DisplayTag的开发者们没有考虑到中文的问题，因为项目进度很紧，所以就把排序的功能给屏蔽了，虽然经过了大量的测试，但都没有发现翻页时候也存在这个问题（AppFuse自动生成的页面的默认显示25行，如果超过25行会自动分页），直到前天，测试人员才发现这个问题，按照我的理解要修改DisplayTag的源码，后来又想通过自己写过滤器试试，幸运的是在我动手干之前，先和倦兔聊了几句，结果倦兔说他也遇到过这个问题，指出如果在server.xml中添加URIEncoding="GBK"就可以解决问题，我试了一下，果然可以，但这是为什么呢？

      在AppFuse中有一个Spring的过滤器，对请求的编码进行转换，这种做法很通用，即使是在以前，我们自己写这个过滤器也不麻烦，而且这个代码在网上随处可见，难道是Spring的过滤器没有起作用吗?也不是，如果没起作用，那么我在Struts中的Action中通过request.getParmeter接收到参数应该是乱码？而且我记得这种做法在Tomcat4.1.24中没有任何问题，那是为什么？和倦兔讨论了一下，我们都没有找到答案。

      于是，我就通过google搜索"URIEncoding",找到一堆文章，我读了几篇文章，其中有一篇提到：Tomcat5中对Post和Get请求不再采用相同的处理策略了，而在Tomcat4中采用的处理策略是相同的。于是我想："我的提交的请求明明是Post，我又没有用Get请求，那Spring的过滤器就应该起作用，为什么结果会这样呢？"，我的一个jsp中的Form的代码如下：

    <html:form action="editGj" method="post" styleId="gjForm"
        focus="mc" onsubmit="return validateGjForm(this)">
    看，我的代码明明是使用的是Post方法，为什么结果不正确呢？
      我的跳转到下一页的代码是：
      <a href="?d-449687-p=2&mc=%D7%A8%D2%B5&;
                  excelname=%D7%A8%D2%B5%C3%FB%B3%C6.xls">下一页</a>
      加粗的部分就是我的翻页的链接。如果你立刻就看出了我的问题，那么你就可以不用往下看了，呵呵。如果你没有看出问题，请继续，Come On Baby！！！
      我采用的真的是Post方法吗？我的form的提交采用的是Post方法，这是没错的，那么链接采用的是Post方法吗？

      不是！！！！它采用的是Get方法进行提交的，这就是问题的答案了!
      Post和Get提交有什么区别吗？

      简单的说：Post是将地址传送一次，将form的数据单独提交，而Get则是将地址和参数一起传送，传送的不止是form的数据，但传送的数据的长度有字节限制，另外还有安全问题。如果感兴趣，你可以用google搜一下，会找到很多资料。

http://www.javaworld.com.tw/jute/post/view?age=0&bid=9&ppg=1&sty=1&id=44042&tpg=1

      另外，对于编码解码的问题，我还有一句要说，理论上，如果编码的charset和解码的charset是一致的话，那么就应该没有乱码的问题，但是，对于某些特殊的字符来说，如果采用的charset不对，则可能在解码的时候不能显示，所以要选择好字符集，我推荐在处理简体汉字的时候使用GBK。网上也有推荐UTF-8的，具体使用哪种依情况而定。

       以上是我的总结，若有错误，请指正，谢谢！

      明天，我就放假了，祝我的朋友们春节快乐，万事胜意！

                                                                                   兔八哥

                                                           2005年2月4日14:04

      另外，我昨晚看了看Tomcat5自带的Servlet Example中过滤器的实现，其中就有关于处理编码的过滤器SetCharacterEncodingFilter，还有另外一个是处理用户输入的过滤器，叫HTMLFilter，用于将用户输入的字符转化为HTML格式的字符，如将">"转换为">"，这个过滤器稍加修改就可以用在自己的项目上了，呵呵！

1.在web.xml中添加,/WEB-INF/classes/standardJspApplicationContext.xml。
<context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>/WEB-INF/applicationContext-*.xml,/WEB-INF/classes/standardJspApplicationContext.xml</param-value>
</context-param>
   
2.把valuelist.tld拷贝到WEB-INF下。
3.在taglibs.jsp中添加valuelist.tld。
4.将standardJspApplicationContext.xml、i18n.properties、microsoftLook.properties、simpleLook.properties、classicLook.properties文件复制到/WEB－INF/classes下。
5.在applicationContext-resources.xml的<beans></beans>中添加：
  <bean id="resourceI18nBundle" class="org.springframework.context.support.ResourceBundleMessageSource">
    <property name="basename"><value>i18n</value></property>
  </bean>
  和
   
  <bean id="valueListHandler" singleton="true"
        class="net.mlw.vlh.DefaultValueListHandlerImpl">   
    <property name="config.adapters">
      <map>
     
        <entry key="userlist">
          <bean class="net.mlw.vlh.adapter.hibernate.Hibernate20Adapter">
            <property name="sessionFactory"><ref bean="sessionFactory"/></property>
            <property name="defaultNumberPerPage"><value>2</value></property>
            <property name="defaultSortColumn"><value>lastName</value></property>
            <property name="defaultSortDirection"><value>asc</value></property>
            <property name="hsql">
              <value>
                FROM org.appfuse.model.User AS vo
                /~name: WHERE vo.lastName LIKE {name} ~/
                /~sortColumn: ORDER BY vo.[sortColumn] [sortDirection]~/
              </value>
            </property>
          </bean>
        </entry>
       
        <!--entry key="players2">
          <bean class="net.mlw.vlh.adapter.hibernate.Hibernate20Adapter">
            <property name="sessionFactory"><ref bean="mySessionFactory"/></property>
            <property name="defaultNumberPerPage"><value>20</value></property>
            <property name="defaultSortColumn"><value>lastName</value></property>
            <property name="defaultSortDirection"><value>asc</value></property>
            <property name="namedQuery"><value>playerList</value></property>
          </bean>
        </entry-->
       
       
      </map>
    </property>
   
  </bean>
 
  上面配置中的"sessionFactory"为原来配置好的。
  "defaultNumberPerPage"为每页显示的记录行数。
  "defaultSortColumn"排序列。
  "org.appfuse.model.User"为POJO的名字。
 
6.将相关的样式表的内容合并到原有的样式表中。
7.将valuelist.jar添加到类路径下。

8:如果为行添加onclick事件，注意要对"&"进行转义－document.location='editUser.html?username=<c:out value="${User.username}"/>\&from=list';：
<vlh:root value="valueList" configName="classicLook" url="?" includeParameters="*" >

<table width="600" border="0" cellspacing="0" cellpadding="0">
      <tr>
        <td align="left" nowrap="true">
          <c:out value="${list.valueListInfo.totalNumberOfEntries}"/> Total
          - Page (<c:out value="${list.valueListInfo.pagingPage}"/> of <c:out value="${list.valueListInfo.totalNumberOfPages}"/>)
          &nbsp;
        </td>
        <td align="right">
          <vlh:paging pages="5"><c:out value="${page}"/>&nbsp;</vlh:paging>
        </td>
      </tr>
      <tr>
        <td colspan="2">
          Export to: &nbsp;&nbsp;
    <vlh:filter url="example-export-format.jsp?format=excel&">
      <img src="images/export_excel.png" border="0"> Excel
    </vlh:filter>
    <vlh:filter url="example-export-format.jsp?format=csv&">
      <img src="images/export_csv.png" border="0"> CSV
    </vlh:filter>
   
    <table width="450" class="classicLook" cellspacing="0" cellpadding="0">
      <vlh:row bean="User">
 <vlh:attribute name="onclick">
   document.location='editUser.html?username=<c:out value="${User.username}"/>\&from=list';
        </vlh:attribute>

        <vlh:column title="username"   property="username"   sortable="desc" />
        <vlh:column title="firstName"   property="firstName"   sortable="desc" />
        <vlh:column title="lastname"   property="lastName"   sortable="desc" />
        <vlh:column title="email"     property="email"     sortable="desc" />
      </vlh:row>
    </table>
 </td>
      </tr>
    </table>
   
  </vlh:root>

======================================================================
为ValueList添加高亮
1.添加vlh:attribute：<vlh:attribute name="onmouseout">javascript:mouseout(this);</vlh:attribute>。
添加完attribute后的内容如下：

  <vlh:root value="list" url="?" includeParameters="*" >
    <vlh:retrieve name="nbaPlayers" />
   
    <table width="650" class="classicLook" cellspacing="0" cellpadding="0">
      <vlh:row bean="player">
        <vlh:attribute name="onmouseover">javascript:toggle(this);</vlh:attribute>
 <vlh:attribute name="onmouseout">javascript:mouseout(this);</vlh:attribute>
        <vlh:attribute name="id"><%=("player-"+playerRowNumber)%></vlh:attribute>
        <vlh:attribute name="align" value="center" />
       
        <vlh:column title="playerid"   property="playerid"   sortable="desc"/>
        <vlh:column title="teamname"   property="teamname"   sortable="desc" />
        <vlh:column title="firstname"  property="firstname"  sortable="desc">
          <vlh:attribute name="width" value="150"/>
        </vlh:column>
        <vlh:column title="lastname"   property="lastname"   sortable="desc" attributes="width='150'"/>
        <vlh:column title="status"     property="status"     sortable="desc" />
        <vlh:column title="pos"        property="pos"        sortable="desc" />
      </vlh:row>
    </table>
  </vlh:root>

2.添加js函数，添加完函数后的内容如下：
<script>
  var lastId;
  var lastStyle;
  var previousClass = null;
  function toggle(object)
  {
  if( lastId != undefined )
  {
  document.getElementById(lastId).className = lastStyle;
  }
  lastId = object.id;
  lastStyle = object.className;
  previousClass=this.className;
  object.className = "selected";
  }

  function mouseout(object){
   object.className = previousClass;
  }
</script>

DT编译成功了，Struts Menu从数据库取数据组建菜单的试验成功了......

这几天又开始做技术实验了，被折磨的有点情绪化，不过一切还算顺利，多亏朋友们的帮忙！

昨晚在家读DisplayTag的源代码，发现DisplatyTag（以下简称DT）翻页时候不是从缓存中读取的数据，它又重新向数据库发出请求，和我调试程序时发现的一样，它的动作大致是这样的：

      向数据库发送请求，一次读取所有数据的所有字段（我强调"所有"字段，并不是select *,而是读取你的语句中指定的全部的字段，我强调的是相对于lazy-load方式的部分读取），然后根据pagesize(一页显示数据的行数)和当前页号读取数据的子集，当翻到其他页时，又获取所有数据的所有字段，再过滤出显示的子集......，这样的效率不是差，而是很差，我昨天看了一下DT的JIRA的文字，发现这个问题早在2004年的5月份就有人提出了，而那个人就是ValueList的作者，而且你还会发现很多开发者提供的改进方案和参考实现，而且DT的开发组也同意添加提高分页效率的特性，但到现在也还没有实现，有些让人失望！据说ValueList对这方面做的很好，但ValueList的文档太少了，而且集成到AppFuse中还要自己改写模板，目前有些骑虎难下，明天开始折腾ValueList，希望一切顺利，菩萨保佑，呵呵

      今天试了一下从数据库中读取数据来生成Struts Menu的菜单，结果发现如果一页中放入2个Struts Menu的菜单，则会有一个有问题，我看了一下源码，发现是在一个js文件中的函数引起的，Struts Menu首先初始化菜单，然后扩展，在扩展的时候，把点击的菜单写到Cookies中，如果同一个页面有2个的声明，则第二个菜单的折叠的部分不能展开，我的一个同事折腾了将近一周，就是因为这个问题。

      昨晚终于在倦兔的帮助下，使用Maven编译DT成功了，这样我可以放心的修改DT，然后编译、打包。但我要权衡一下和改用ValueList的工作量，目前暂不打算修改DT了。

      Maven把所有下载的jar文件放在Window的Documents and Settings/你的用户名/.mave目录下，你可以把其他人的这个目录下的文件都拷贝过来（注意要保持原来的目录结构）直接用就行了。

      Matt Raible关于DT、ValueList、DataGrid的简短介绍：http://raibledesigns.com/comments/rd/sunsets/there_s_a_new_sorting

                                                                                                               兔八哥

                                                                                                       2005-3-1 18:21

今天，同事终于把ValueList的实验做完了，ValueList0.1.7新添了许多新功能，但是，今天看到"王者之剑"的留言，又读了一下源码，发现ValueList也是取回数据库的全部数据，只是把需要返回页面的数据返回了，并不是我想的使用Hibernate的分页方法进行查询数据库的

    今天，同事终于把ValueList的实验做完了，ValueList0.1.7新添了许多新功能，但是，今天看到"王者之剑"在我的Blog上的留言，有点不太相信ValueList也是取回所有的数据。
   
    刚才，我抽空看了一下ValueList的Hibernate20Adapter的源码，结果发现果然是把所有的数据都取回来了，但比DT稍强一些的是，它没有把所有的Object都放入request中，只是把当前页要显示的Object放入了，但这样也同样耗费数据库资源，同样需要循环，不同的是，耗费的网络资源少些，因为，它传回的对象只有一页的对象。

    但结果并不是我想像的，我以为，它会自己像Hibernate那样，根据不同的数据库采用分页算法，使用Criteria Query设定返回在指定范围的数据。
实验结果有点让我失望，但毕竟比DT要强一些，不知道DT的1.1是不是也是这样解决的，如果是的话，那不用等它的正式版本了，在JIRA上已经有参考实现了。

    但学习ValueList还是有所收获的，看到了另一种显示实现的方式，而且ValueList的确比DT强，界面虽然不漂亮(0.1.7已经很有DT的意思了，通过自己定制样式表，可以作出漂亮的外观)，但比较灵活,这个工具值得继续关注。
   
    使用ValueList需要注意的一点是，如果使用MVC框架（不知道其他的框架是否这样），从一个Controller转发到一个View上，如果ValueList的URL属性为""或者"？"，翻页图标的URL为上一个操作的URL，这和ValueList中提到的刷新按钮有点相似，我又看了一下DT的用法，也需要指定URL，对于解决重复提交的问题，可以使用Struts的token来解决，我问了一下倦兔，倦兔说WebWork和Spring都有类似的解决方案，在此也感谢倦兔推荐ValueList!^_^

    刚才和天天加班的段兄（SkyHero）聊了一下，感觉实在不行要自己改代码了，比较郁闷（本来想偷懒的，呵呵。
祝段兄的加班生活早点结束，你的女朋友还在茫茫人海中等你去找她，不要把大好时光都浪费在计算机上！^_^

    昨天，和朋友开车去天津，在滨江路上转了一天，我在94年取过一次，发现十年后再看天津已经不是以前的那个城市了，看来是我的看法变了！不过昨天天津的气温有15度，很是舒服，好久没有这样放松了，希望每隔2个月，能出去转转！

                                                                                                                                   兔八哥

                                                                                                                             2005-3-7 19:38

和倦兔聊了一下，他告诉我的解决方法竟然如此简单：在Tomcat的server.xml的Connector部分添加URIEncoding="GBK"，我的server.xml添加后内容如下：

<Connector  URIEncoding="GBK" port="8080"
               maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
               enableLookups="false" redirectPort="8443" acceptCount="100"
               debug="0" connectionTimeout="20000"
               disableUploadTimeout="true" />

不用读DisplayTag的源码了，也可以安心过个年了，谢谢倦兔！！！

以下内容是我翻译的JDK的帮助。

URLEncoder类：

用于HTML的form中数据编码的类。

这个类包含将字符串转换为application/x-www-form-urlencoded MIME 格式的静态方法.

如果想了解HTML的编码细则，请参考HTML规范。

编码规则如下：

字符"a"-"z"，"A"-"Z"，"0"-"9"，"."，"-"，"*"，和"_" 都不被编码，维持原值，

空格" "被转换为加号"+"。

所有其他的字符都被认为是不安全的，首先都根据指定的编码scheme被转换为1个或者多个字节。[凭什么认为其他的字符都是不安全的？看来这些规范的制订者中没有中国人呀！]

然后每个字节都被表示成"%xy"格式的由3个字符组成的字符串，xy是字节的2位16进制的表达（xy is the two-digit hexadecimal representation of the byte），推荐的编码scheme为UTF-8,然而，出于兼容性的考虑，如果没有制定编码的scheme，那么将使用当前操作系统的编码的scheme。

如：如果编码scheme是UTF-8，

"The string ü@foo-bar"将被转换为"The+string+%C3%BC%40foo-bar" 。

因为载UTF-8中字符ü被编码成2个字节C3 (十六进制) 和BC (十六进制)， 字符@被编码成一个字节40 (十六进制)。

起始于:JDK1.0

这个类共有2个重载方法：

public static String encode(String s,  String enc)  throws UnsupportedEncodingException。起始于：JDK1.4

和即将被废弃的方法：public static String encode(String s)。（因为这个方法的编码的字符集依赖于程序运行的系统的默认的字符集）。

第一个方法的作用是：根据指定的encode scheme 将一个字符串翻译成application/x-www-form-urlencoded格式。

注意: W3C推荐UTF-8。

参数:

s - 将要被翻译的字符串。

enc - 编码用的character。

 返回:翻译后的字符串。

抛出异常: UnsupportedEncodingException - 如果不支持制定的编码

起始于:1.4

另请参考:URLDecoder.decode(java.lang.String, java.lang.String)

类URLDecoder的作用和URLEncoder的作用相反，方法类似，这里就不再赘述了。

      如果你想知道你的字符串被编码后的值是什么样，你可以打开www.baidu.com，然后输入你要编码后的数值，然后提交，你可以在地址栏看到你被编码后的字符串，这个方法是Jason告诉我的，呵呵！

如果想解决DisplayTag的问题，就要修改源代码了，下一步就是读源代码，头疼ing......

                                                                                                           兔八哥

                                                                                                   2005-2-2下午16:30

DisplayTag的默认的URL默认为上一次的URL，如果上一次的URL包含中文的话，则会被进行URLEncode，所以在翻页的时候，又会把进行了URLEncode后的数据再次进行URLEncode，所以翻页就没有数据，因为这部分功能被封装在DisplayTag中，于是，我又开始郁闷了......

如汉字"专业"被编码后为"%D7%A8%D2%B5"，于是DisplayTag就将这个编码作为连接的关键字，如果再次提交，则这个编码还会被编码，所以查询结果一定就不对了！！！

下面的内容是我分析这个问题的由来：

---------------------------------------------------------------------------------------------------

刚才到网上查找了些资料，找到HTML4.0.1的规范中关于URLEncode的部分，我把我关心的内容翻译了一下：

http://www.w3.org/TR/html401/interact/forms.html#h-17.13.4.1

其中相关内容如下在17.13.3 Processing form data：

提交时，HTML的规范处理如下：

1.标识successful controls （概念可以在上文中查找）。

2.构建form的数据集。

3.根据form的enctype的设置，对form的数据集进行Encode。

4.提交已经Encode的数据集。

HTML规范中指出Content type和Languange code是不区分大小写的。

详情参见:http://www.w3.org/TR/html401/types.html#type-content-type

"&" 表示"&"。关于charset的详细内容见:http://www.w3.org/TR/html401/charset.html#entities

有一个小发现：Frame中的target的值的列表原来是在HTML的规范中制定的，呵呵：

http://www.w3.org/TR/html401/types.html#type-content-type

6.16 Frame target names

下面的target的名字是规范中声明的有特殊含义的保留字。

_blank  在一个没有指定名字的新窗口中打开页面。(new, unnamed window)

_self  在同一个窗口中打开。（load the document in the same frame as the element that refers to this target）

_parent  在当前窗口的父窗口中打开，如果当前窗口没有父窗口，那么就等同于_self

_top  在最开始的窗口中转载，如果当前框架没有parent，那就等于_self。

关键部分在这里了：http://www.w3.org/TR/html401/interact/forms.html#h-17.13.4.1

form的默认的content type是：application/x-www-form-urlencoded

form提交content type的数据必须用下列规则进行编码（encode）：

空格被封装为"+"，其他的保留字封装后的值在 [RFC1738]中可以查到。RF1738的规范：http://www.ietf.org/rfc/rfc1738.txt。

其他的非英文字符和非数字的字符都被编码为"%HH"，

HH是将字符的ASCII的编码转换为16进制后的字符。行尾是"CR LF"  (如：`%0D%0A')。

控件的名字和数值之间使用"="分隔，多个控件之间用"&"分隔。

------------------------------------------------------------------------------------------------------------------

      它最大的价值就是为我们提供了一个Web开发的新的方式和思路，尽管这些技术在国外都已进很流行了，但在国内能够将Hibernate、Struts、Spring、DBUnit、Ant、Log4J、Struts Menu、Xdoclet、SiteMesh、Velocity、JUnit、JSTL、WebWork这些技术集成到一个框架中的还不多见，所以即使不使用它的全部功能，它也给我们提供了一个很好的借鉴、学习的机会。

      AppFuse的作者 matt raible是当今开源世界一个比较活跃的开发者，它是AppFuse、Struts Menu的作者，也是XDoclet、DisplayTag等一些著名开源项目的积极参与者，《Hibernate In Action》的作者就在感谢的名单里面提到他，XDoclet的下载版本中所带的Hibernate标签部分的例子就是他写的，他还是2004年Apache技术年会的主讲人之一。（这些都是我这2个多月来搜集到的，呵呵）

       通过关注AppFuse，我们可以看到目前国外的主流开发都使用了哪些技术，开发方式是什么样的，可能达到什么样的结果，而在以前，是很少能够看到这样完整的例子的。

       AppFuse的另一个启示是：我们可以依靠开源软件的功能降低开发成本，而且可以阅读开源软件的代码提高所在团队的整体实力。

       但是通过2个月的实际学习和使用，我也遇到一系列的问题，因为AppFuse是将其他的一些类库或者框架集成在一起的，集成的技术众多，而且有一些技术在国内甚至很少有人知道，资料也比较少，所以虽然作者经过了一些测试，但都是基于英文编码的，而对于中文编码来说，还潜在的存在着一些问题，虽然不是AppFuse的问题，但却降低了开发速度，下面是我在开发过程中遇到过的问题，有些解决了，有些还没有解决：

一．Struts

1．  AppFuse中默认的MVC框架是Struts，而且使用的是LookupDispatchAction，并且使用的是按钮（button），在XP下用IE浏览效果还可以，但如果在2000或者98下，就使外观很难看，而且当时我还遇到一个问题：如果按钮显示中文，则在DisplayTag中翻页失灵，而且报错，后来我把BaseAction的相关方法改变了，才可以使用，因为国内的客户都比较重视界面，所以后来我将那些按钮都改成图片了，当然也要添加一些方法了，有点麻烦！

从AppFuse开始

Features include Container Managed Authentication (CMA), Remember Me, Self Registration, Password Hint and GZip Compression. The fuse to start your apps.

作者的介绍:
http://today.java.net/pub/a/today/2004/07/15/thefuse.html
官方网站:
http://raibledesigns.com/wiki/Wiki.jsp?page=AppFuse
http://appfuse.dev.java.net/
http://jroller.com/page/raible