下表是元字符及其在正则表达式上下文中的行为的一个完整列表：

下面看几个例子：
“^The”：表示所有以”The”开始的字符串（”There”，”The cat”等）；
“of despair$”：表示所以以”of despair”结尾的字符串；
“^abc$”：表示开始和结尾都是”abc”的字符串——呵呵，只有”abc”自己了；
“notice”：表示任何包含”notice”的字符串。

‘*’，’+'和’?'这三个符号，表示一个或一序列字符重复出现的次数。它们分别表示“没有或
更多”，“一次或更多”还有“没有或一次”。下面是几个例子：

“ab*”：表示一个字符串有一个a后面跟着零个或若干个b。（”a”, “ab”, “abbb”,……）；
“ab+”：表示一个字符串有一个a后面跟着至少一个b或者更多；
“ab?”：表示一个字符串有一个a后面跟着零个或者一个b；
“a?b+$”：表示在字符串的末尾有零个或一个a跟着一个或几个b。

也可以使用范围，用大括号括起，用以表示重复次数的范围。

“ab{2}”：表示一个字符串有一个a跟着2个b（”abb”）；
“ab{2,}”：表示一个字符串有一个a跟着至少2个b；
“ab{3,5}”：表示一个字符串有一个a跟着3到5个b。

请注意，你必须指定范围的下限（如：”{0,2}”而不是”{,2}”）。还有，你可能注意到了，’*'，’+'和
‘?’相当于”{0,}”，”{1,}”和”{0,1}”。
还有一个’¦’，表示“或”操作：

“hi¦hello”：表示一个字符串里有”hi”或者”hello”；
“(b¦cd)ef”：表示”bef”或”cdef”；
“(a¦b)*c”：表示一串”a”"b”混合的字符串后面跟一个”c”；

‘.’可以替代任何字符：

“a.[0-9]“：表示一个字符串有一个”a”后面跟着一个任意字符和一个数字；
“^.{3}$”：表示有任意三个字符的字符串（长度为3个字符）；

方括号表示某些字符允许在一个字符串中的某一特定位置出现：

“[ab]“：表示一个字符串有一个”a”或”b”（相当于”a¦b”）；
“[a-d]“：表示一个字符串包含小写的’a'到’d'中的一个（相当于”a¦b¦c¦d”或者”[abcd]“）；
“^[a-zA-Z]“：表示一个以字母开头的字符串；
“[0-9]%”：表示一个百分号前有一位的数字；
“,[a-zA-Z0-9]$”：表示一个字符串以一个逗号后面跟着一个字母或数字结束。

你也可以在方括号里用’^'表示不希望出现的字符，’^'应在方括号里的第一位。（如：”%[^a-zA-Z]%”表
示两个百分号中不应该出现字母）。

为了逐字表达，必须在”^.$()¦*+?{\”这些字符前加上转移字符’\'。

请注意在方括号中，不需要转义字符。

将xstream和xpp3的jar包加入lib中
XStream x = new XStream() ;
List userList = new ArrayList() ;
User user = new User() ;
user.setUserName(“peltason”) ;
user.setPassword(“123″) ;
User user2 = new User() ;
user2.setUserName(“jack”) ;
user2.setPassword(“321″) ;
x.alias(“user”, User.class) ;
userList.add(user) ;
userList.add(user2) ;
System.out.println( x.toXML(userList) ) ;

生成的XML文件内容:
xml 代码
peltason

123

jack

321

（20070326 王咏刚 译自http://docs.google.com/Doc?id=dd2fhx4z_5df5hw8）

(非常酷的Google果汁——Guice 发布一段时间了，今天非常快速地把它的用户指南翻译成了中文，分享给大家。因为只花了3个小时翻译，也没有更多时间校对，肯定有不少错误，希望有心人指正。)

Guice (读作”juice”)是超轻量级的，下一代的，为Java 5及后续版本设计的依赖注入容器。

简介

Java 企业应用开发社区在连接对象方面花了很大功夫。你的Web应用如何访问中间层服务？你的服务如何连接到登录用户和交易管理器？关于这个问题你会发现很多通 用的和特定的解决方案。有一些方案依赖于模式，另一些则使用框架。所有这些方案都会不同程度地引入一些难于测试或者程式化代码重复的问题。你马上就会看 到，Guice 在这方面是全世界做得最好的：非常容易进行单元测试，最大程度的灵活性和可维护性，以及最少的代码重复。

我们使 用一个假想的、简单的例子来展示 Guice 优于其他一些你可能已经熟悉的经典方法的地方。下面的例子过于简单，尽管它展示了许多显而易见的优点，但其实它还远没有发挥出 Guice 的全部潜能。我们希望，随着你的应用开发的深入，Guice 的优越性也会更多地展现出来。

在这个例子中，一个客户对象依赖于一个服务接口。服务接口可以提供任意的服务。我们只是调用这个服务而已。
public interface Service {
void go();
}

对于这个服务接口，我们有一个缺省的实现，但客户对象不应该直接依赖于这个缺省实现。如果我们将来打算使用一个不同的服务实现，我们不希望回过头来修改所有的客户代码。
public class ServiceImpl implements Service {

public void go() {
…
}

}

我们还有一个虚拟的、可用于单元测试的服务实现。
public class MockService implements Service {

private boolean gone = false;

public void go() {
gone = true;
}

public boolean isGone() {
return gone;
}
}

简单工厂模式
在发现依赖注入之前，最常用的是工厂模式。除了服务接口之外，你还有一个既可以向客户提供服务对象，也可以向测试程序提供模拟对象的工厂接口。在这里我们会将服务实现为一个单件模式，以便让示例尽量简化。
public class ServiceFactory {

private ServiceFactory() {}

private static Service instance = new ServiceImpl();

public static Service getInstance() {
return instance;
}

public static void setInstance(Service service) {
instance = service;
}
}

客户程序每次需要服务对象时就直接从工厂获取。
public class Client {

public void go() {
Service service = ServiceFactory.getInstance();
service.go();
}
}

客 户程序足够简单。但客户程序的单元测试代码必须将一个虚拟对象传入工厂，同时要记得在测试后清理。在我们这个简单的例子里，这不算什么难事儿。但当你增加 了越来越多的客户和服务代码后，所有这些虚拟代码和清理代码会让单元测试的开发一团糟。此外，如果你忘记在测试后清理，其他测试可能会得到与预期不符的结 果。更糟的是，测试的成功与失败可能取决于他们被执行的顺序。
public void testClient() {
Service previous = ServiceFactory.getInstance();
try {
final MockService mock = new MockService();
ServiceFactory.setInstance(mock);
Client client = new Client();
client.go();
assertTrue(mock.isGone());
}finally {
ServiceFactory.setInstance(previous);
}
}

最后，注意服务工厂的API把我们限制在了单件这一种应用模式上。即便 getInstance() 可以返回多个实例， setInstance() 也会束缚我们的手脚。转换到非单件模式也意味着转换到了一套更复杂的API。

手工依赖注入

依赖注入模式的目标之一是使单元测试更简单。我们不需要特殊的框架就可以实践依赖注入模式。依靠手工编写代码，你可以得到该模式大约80%的好处。

当上例中的客户代码向工厂对象请求一个服务时，根据依赖注入模式，客户代码希望它所依赖的对象实例可以被传入自己。也就是说：不要调用我，我会调用你。

public class Client {

private final Service service;

public Client(Service service) {
this.service = service;
}

public void go() {
service.go();
}
}

这让我们的单元测试简化了不少。我们可以只传入一个虚拟服务对象，在结束后也不需要多做什么。

public void testClient() {
MockService mock = new MockService();
Client client = new Client(mock);
client.go();
assertTrue(mock.isGone());
}

我们也可以精确地说出客户代码依赖于哪些API。

现在，我们如何把客户代码连接到服务对象呢？手工实现依赖注入的时候，我们可以将所有依赖逻辑都移动到工厂类中。也就是说，我们还需要有一个工厂类来创建客户对象。

public static class ClientFactory {

private ClientFactory() {}

public static Client getInstance() {
Service service = ServiceFactory.getInstance();
return new Client(service);
}
}

手工实现依赖注入需要的代码行数和简单工厂模式差不多。

用 Guice 实现依赖注入
手工为每一个服务与客户实现工厂类和依赖注入逻辑是一件很麻烦的事情。其他一些依赖注入框架甚至需要你显式将服务映射到每一个需要注入的地方。

Guice 希望在不牺牲可维护性的情况下去除所有这些程式化的代码。

使用 Guice，你只需要实现模块类。Guice 将一个绑定器传入你的模块，你的模块使用绑定器来连接接口和实现。以下模块代码告诉 Guice 将 Service 映射到单件模式的 ServiceImpl：

public class MyModule implements Module {
public void configure(Binder binder) {
binder.bind(Service.class)
.to(ServiceImpl.class)
.in(Scopes.SINGLETON);
}
}

模块类告诉 Guice 我们想注入什么东西。那么，我们该如何告诉 Guice 我们想注入到哪里呢？使用 Guice，你可以使用 @Inject 标注你的构造器，方法或字段：

public class Client {

private final Service service;

@Inject
public Client(Service service) {
this.service = service;
}

public void go() {
service.go();
}
}

@Inject 标注使程序员可以很容易地在类中指明哪些方法需要被注入。

为了让 Guice 向 Client 中注入，我们必须直接让 Guice 帮我们创建 Client 的实例，或者，其他类必须包含被注入的 Client 实例。

Guice vs. 手工依赖注入
如你所见，Guice 省去了写工厂类的麻烦。你不需要编写将客户连接到它们所依赖的对象的代码。如果你忘了提供一个依赖关系，Guice 在启动时就会失败。Guice 也会自动处理循环依赖关系。

Guice 允许你通过声明指定对象的作用域。例如，你不用为了将对象存入 HttpSession 而反复编写同样的代码。

在现实世界，不到运行的时候，你通常并不知道具体要使用哪一个实现类。你需要元工厂类或是服务定位器来增强你的工厂模式。Guice 用最少的代价解决了这些问题。

手工实现依赖注入时，你很容易退回到使用直接依赖的旧习惯，特别是当你对依赖注入的概念还不那么熟悉的时候。使用 Guice 可以避免这种问题，可以让你更容易地把事情做对。Guice 使你保持正确的方向。

更多的标注
只要有可能，Guice 就允许你使用标注来绑定对象，减少重复的程式化代码。回到我们的例子，如果你需要一个接口来简化单元测试，但你又不介意编译时的依赖，你可以直接从你的接口指向一个缺省的实现。

@ImplementedBy(ServiceImpl.class)
public interface Service {
void go();
}

这时，如果客户需要一个 Service 对象，且 Guice 无法找到显式绑定，Guice 就会注入一个 ServiceImpl 的实例。

缺省情况下，Guice 每次都注入一个新的实例。如果你想指定不同的作用域规则，你也可以对实现类进行标注。

@Singleton
public class ServiceImpl implements Service {
public void go() {
…
}
}

架构概览
我们可以将 Guice 的架构分成两个不同的阶段：启动和运行。你在启动时创建一个注入器 Injector，在运行时用它来注入对象。

启动
你通过实现 Module 来配置 Guice。你传给 Guice 一个模块对象，Guice 则将一个绑定器 Binder 对象传入你的模块，然后，你的模块使用绑定器来配置绑定。一个绑定通常包含一个从接口到具体实现的映射。例如：

public class MyModule implements Module {
public void configure(Binder binder) {
// Bind Foo to FooImpl. Guice will create a new
// instance of FooImpl for every injection.
binder.bind(Foo.class).to(FooImpl.class);

// Bind Bar to an instance of Bar.
Bar bar = new Bar();
binder.bind(Bar.class).toInstance(bar);
}
}

在这个阶段，Guice 会察看你告诉它的所有类，以及与这些类有关系的类，然后通知你是否有依赖关系的缺失。例如，在一个 Struts 2 应用中，Guice 知道你所有的动作类。Guice 会检查你的动作类以及所有它们所依赖的类，如果有问题会及早报错。

创建一个 Injector 涉及以下步骤：

首先创建你的模块类的实例，并将其传入 Guice.createInjector().
Guice 创建一个绑定器 Binder 并将其传入你的模块。
你的模块使用绑定器来定义绑定。
基于你所定义的绑定，Guice 创建一个注入器 Injector 并将其返回给你。
你使用注入器来注入对象。
运行
现在你可以使用第一阶段创建的注入器来注入对象并内省（introspect）我们的绑定了。Guice 的运行时模型包含了一个管理一定数量绑定的注入器。

键 Key 唯一地指定每一个绑定。 Key 包含了客户代码所依赖的类型以及一个可选的标注。你可以使用标注来区分指向同一类型的绑定。 Key 的类型和标注对应于注入时的类型和标注。

每个绑定有一个提供者 provider，它提供所需类型的实例。你可以提供一个类，Guice 会帮你创建它的实例。你也可以给 Guice 一个你要绑定的实例。你还可以实现你自己的 provider，Guice 可以向其中注入依赖关系。

每一个绑定还有一个可选的作用域。缺省情况下绑定没有作用域，Guice 为每一次注入创建一个新的对象。一个定制的作用域可以使你控制 Guice 创建在何时创建新对象。例如，你可以为每一个 HttpSession 创建一个实例。
自举（Bootstrapping）你的应用

自举（bootstrapping）对于依赖注入非常重要。总是显式地向 Injector 索要依赖，这就将 Guice 用作了服务定位器，而不是一个依赖注入框架。

你 的代码应该尽量少地和 Injector 直接打交道。相反，你应该通过注入一个根对象来自举你的应用。容器可以更进一步地将依赖注入根对象所依赖的对象，并如此迭代下去。最终，在理想情况下，你 的应用中应该只有一个类知道 Injector，每个其他类都应该使用注入的依赖关系。

例如，一个诸如 Struts 2 的 Web 应用框架通过注入所有你的动作类来自举你的应用。你可以通过注入你的服务实现类来自举一个 Web 服务框架。

依赖注入是传染性的。如果你重构一个有大量静态方法的已有代码，你可能会觉得你正在试图拉扯一根没有尽头的线。这是好事情。它表明依赖注入正在帮助你改进代码的灵活性和可测试性。

如 果重构工作太复杂，你不想一次性地整理完所有代码，你可以暂时将一个 Injector 的引用存入某个类的一个静态的字段，或是使用静态注入。这时，请清楚地命名包含该字段的类：比如 InjectorHack 和 GodKillsAKittenEveryTimeYouUseMe。记住你将来可能不得不为这些类提供虚拟类，你的单元测试则不得不手工安装一个注入 器。记住，你将来需要清理这些代码。

绑定依赖关系
Guice 是如何知道要注入什么东西的呢？对启动器来说，一个包含了类型和可选的标注的 Key 唯一地指明了一个依赖关系。Guice 将 key 和实现之间的映射记为一个绑定。一个实现可以包含一个单独的对象，一个需要由 Guice 注入的类，或一个定制的 provider。

当注入依赖关系时，Guice 首先查看显式绑定，即你通过绑定器 Binder 指明的绑定。Binder API 使用生成器（Builder）模式来创建一种领域相关的描述语言。根据约束适用方法的上下文的不同，不同方法返回不同的对象。

例如，为了将接口 Service 绑定到一个具体的实现 ServiceImpl，调用：

binder.bind(Service.class).to(ServiceImpl.class);

该绑定与下面的方法匹配：

@Inject
void injectService(Service service) {
…
}

注: 与某些其他的框架相反，Guice 并没有给 “setter” 方法任何特殊待遇。不管方法有几个参数，只要该方法含有 @Inject 标注，Guice 就会实施注入，甚至对基类中实现的方法也不例外。

不要重复自己

对 每个绑定不断地重复调用 “binder” 似乎有些乏味。Guice 提供了一个支持 Module 的类，名为 AbstractModule，它隐含地赋予你访问 Binder 的方法的权力。例如，我们可以用扩展 AbstractModule 类的方式改写上述绑定：

bind(Service.class).to(ServiceImpl.class);

在本手册的余下部分中我们会一直使用这样的语法。

标注绑定

如果你需要指向同一类型的多个绑定，你可以用标注来区分这些绑定。例如，将接口 Service 和标注 @Blue 绑定到具体的实现类 BlueService 的代码如下：

bind(Service.class)
.annotatedWith(Blue.class)
.to(BlueService.class);

这个绑定会匹配以下方法：

@Inject
void injectService(@Blue Service service) {
…
}

注意，标注 @Inject 出现在方法前，而绑定标注，如 @Blue 则出现在参数前。对构造器也是如此。使用字段注入时，两种标注都直接应用于字段，如以下代码：

@Inject @Blue Service service;

创建绑定标注

刚才提到的标注 @Blue 是从哪里来的？你可以很容易地创建这种标注，但不幸的是，你必须使用略显复杂的标准语法：

/**
* Indicates we want the blue version of a binding.
*/
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.FIELD, ElementType.PARAMETER})
@BindingAnnotation
public @interface Blue {}

幸运的是，我们不需要理解这些代码，只要会用就可以了。对于好奇心强的朋友，下面是这些程式化代码的含义：

@Retention(RUNTIME) 使得你的标注在运行时可见。
@Target({FIELD, PARAMETER}) 是对用户使用的说明；它不允许 @Blue 被用于方法、类型、局部变量和其他标注。
@BindingAnnotation 是 Guice 特定的信号，表示你希望该标注被用于绑定标注。当用户将多于一个的绑定标注应用于同一个可注入元素时，Guice 会报错。
有属性的标注
如果你已经会写有属性的标注了，请跳到下一节。

你也可以绑定到标注实例，即，你可以有多个绑定指向同样的类型和标注类型，但每个绑定拥有不同的标注属性值。如果 Guice 找不到拥有特定属性值的标注实例，它会去找一个绑定到该标注类型的绑定。

例如，我们有一个绑定标注 @Named，它有一个字符属性值。
@Retention(RUNTIME)@Target({ FIELD, PARAMETER })@BindingAnnotationpublic @interface Named { String value();}
如果我们希望绑定到 @Named(“Bob”)，我们首先需要一个 Named 的实现。我们的实现必须遵守关于 Annotation 的约定，特别是 hashCode() 和 equals() 的实现。

class NamedAnnotation implements Named { final String value; public NamedAnnotation(String value) { this.value = value; } public String value() { return this.value; } public int hashCode() { // This is specified in java.lang.Annotation. return 127 * “value”.hashCode() ^ value.hashCode(); } public boolean equals(Object o) { if (!(o instanceof Named)) return false; Named other = (Named) o; return value.equals(other.value()); } public String toString() { return “@” + Named.class.getName() + “(value=” + value + “)”; } public Class<? extends Annotation> annotationType() { return Named.class; }}
现在我们可以使用这个标注实现来创建一个指向 @Named 的绑定。

bind(Person.class)
.annotatedWith(new NamedAnnotation(“Bob”))
.to(Bob.class);

与其它框架使用基于字符串的标识符相比，这显得有些繁琐，但记住，使用基于字符串的标识符，你根本无法这样做。而且，你会发现你可以大量复用已有的绑定标注。

因为通过名字标记一个绑定非常普遍，以至于 Guice 在 com.google.inject.name 中提供了一个十分有用的 @Named 的实现。

隐式绑定
正 如我们在简介中看到的那样，你并不总需要显式声明邦定。如果缺少显式绑定，Guice 会试图注入并创建一个你所依赖的类的新实例。如果你依赖于一个实例，Guice 会寻找一个指向具体实现的 @ImplementedBy 标注。例如，下例中的代码显式绑定到一个具体的、可注入的名为 Concrete 的类。它的含义是，将 Concrete 绑定到 Concrete。这是显式的声明方式，但也有些冗余。

bind(Concrete.class);

删除上述绑定语句不会影响下面这个类的行为：

class Mixer {

@Inject
Mixer(Concrete concrete) {
…
}
}

好吧，你自己来选择：显式的或简略的。无论何种方式，Guice 在遇到错误时都会生成有用的信息。
注入提供者
有 时对于每次注入，客户代码需要一个依赖的多个实例。其它时候，客户可能不想在一开始就真地获取对象，而是等到注入后的某个时候再获取。对于任意绑定类型 T，你可以不直接注入 T 的实例，而是注入一个 Provider<T>，然后在需要的时候调用 Provider<T>.get()，例如：

@Inject
void injectAtm(Provider<Money> atm) {
Money one = atm.get();
Money two = atm.get();
…
}

正如你所看到的那样， Provider 接口简单得不能再简单了，它不会为简单的单元测试添加任何麻烦。

注入常数值

对于常数值，Guice 对以下几种类型做了特殊处理：

基本类型(int, char, …)
基本 wrapper 类型(Integer, Character, …)
Strings
Enums
Classes

首先，当绑定到这些类型的常数值的时候，你不需要指定你要绑定到的类型。Guice 可以根据值判断类型。例如，一个绑定标注名为 TheAnswer：

bindConstant().annotatedWith(TheAnswer.class).to(42);

它的效果等价于：

bind(int.class).annotatedWith(TheAnswer.class).toInstance(42);

当需要注入这些类型的数值时，如果 Guice 找不到显式指向基本数据类型的绑定，它会找一个指向相应的 wrapper 类型的绑定，反之亦然。

转换字符串

如果 Guice 仍然无法找到一个上述类型的显式绑定，它会去找一个拥有相同绑定标识的常量 String 绑定，并试图将字符串转换到相应的值。例如：

bindConstant().annotatedWith(TheAnswer.class).to(“42″); // String!

会匹配：

@Inject @TheAnswer int answer;

转换时，Guice 会用名字去查找枚举和类。Guice 在启动时转换一次，这意味着它提前做了类型检查。这个特性特别有用，例如，当绑定值来自一个属性文件的时候。
定制的提供者
有时你需要手工创建你自己的对象，而不是让 Guice 创建它们。例如，你可能不能为来自第三方的实现类添加 @Inject 标注。在这种情况下，你可以实现一个定制的 Provider。Guice 甚至可以注入你的提供者类。例如：

class WidgetProvider implements Provider<Widget> {

final Service service;

@Inject
WidgetProvider(Service service) {
this.service = service;
}

public Widget get() {
return new Widget(service);
}
}

你可以向这样把 Widget 绑定到 WidgetProvider：

bind(Widget.class).toProvider(WidgetProvider.class);

注 入定制的提供者可以使 Guice 提前检查类型和依赖关系。定制的提供者可以在任意作用域中使用，而不依赖于他们所创建的类的作用域。缺省情况下，Guice 为每一次注入创建一个新的提供者实例。在上例中，如果每个 Widget 需要它自己的 Service 实例，我们的代码也没有问题。通过在工厂类上使用作用域标注，或为工厂类创建单独的绑定，你可以为定制的工厂指定不同的作用域。
示例：与 JNDI 集成
例如我们需要绑定从 JNDI 得到的对象。我们可以仿照下面的代码实现一个可复用的定制的提供者。注意我们注入了 JNDI Context：

package mypackage;

import com.google.inject.*;
import javax.naming.*;

class JndiProvider<T> implements Provider<T> {

@Inject Context context;
final String name;
final Class<T> type;

JndiProvider(Class<T> type, String name) {
this.name = name;
this.type = type;
}

public T get() {
try {
return type.cast(context.lookup(name));
}
catch (NamingException e) {
throw new RuntimeException(e);
}
}

/**
* Creates a JNDI provider for the given
* type and name.
*/
static <T> Provider<T> fromJndi(
Class<T> type, String name) {
return new JndiProvider<T>(type, name);
}
}

感谢范型擦除（generic type erasure）技术。我们必须在运行时将依赖传入类中。你可以省略这一步，但在今后跟踪类型转换错误会比较棘手（当 JNDI 返回错误的类型的时候）。

我们可以使用定制的 JndiProvider 来将 DataSource 绑定到来自 JNDI 的一个对象：

import com.google.inject.*;
import static mypackage.JndiProvider.fromJndi;
import javax.naming.*;
import javax.sql.DataSource;

…

// Bind Context to the default InitialContext.
bind(Context.class).to(InitialContext.class);

// Bind to DataSource from JNDI.
bind(DataSource.class)
.toProvider(fromJndi(DataSource.class, “…”));

限制绑定的作用域
缺省情况下，Guice 为每次注入创建一个新的对象。我们把它称为“无作用域”。你可以在配制绑定时指明作用域。例如，每次注入相同的实例：

bind(MySingleton.class).in(Scopes.SINGLETON);

另一种做法是，你可以在实现类中使用标注来指明作用域。Guice 缺省支持 @Singleton：

@Singleton
class MySingleton {
…
}

是 用标注的方法对于隐式绑定也同样有效，但需要 Guice 来创建你的对象。另一方面，调用 in() 适用于几乎所有绑定类型（显然，绑定到一个单独的实例是个例外）并且会忽略已有的作用域标注。如果你不希望引入对于作用域实现的编译时依赖，in() 还可以接受标注。

可以使用 Binder.bindScope() 为定制的作用域指定标注。例如，对于标注 @SessionScoped 和一个 Scope 的实现 ServletScopes.SESSION：

binder.bindScope(SessionScoped.class, ServletScopes.SESSION);

创建作用域标注

用于指定作用域的标注必须：

有一个 @Retention(RUNTIME) 标注，从而使我们可以在运行时看到该标注。
有一个 @Target({TYPE}) 标注。作用域标注只用于实现类。
有一个 @ScopeAnnotation 元标注。一个类只能使用一个此类标注。

例如：

/**
* Scopes bindings to the current transaction.
*/
@Retention(RUNTIME)
@Target({TYPE})
@ScopeAnnotation
public @interface TransactionScoped {}
尽早加载绑定
Guice 可以等到你实际使用对象时再加载单件对象。这有助于开发，因为你的应用程序可以快速启动，只初始化你需要的对象。但是，有时你总是希望在启动时加载一个对象。你可以告诉 Guice，让它总是尽早加载一个单件对象，例如：

bind(StartupTask.class).asEagerSingleton();

我们经常在我们的程序中使用这个方法实现初始化逻辑。你可以通过在 Guice 必须首先初始化的单件上创建依赖关系来控制初始化顺序。
在不同作用域间注入
你 可以安全地将来自大作用域的对象注入到来自小作用域或相同作用域的对象中。例如，你可以将一个作用域为 HTTP 会话的对象注入到作用域为 HTTP 请求的对象中。但是，在来自较大作用域的对象中注入就是另一件事了。例如，如果你把一个作用域为 HTTP 请求的对象注入到一个单件对象中，最好情况下，你会得到无法在 HTTP 请求中运行的错误信息，最坏情况下，你的单件对象总会引用一个来自第一次请求的对象。在这些时候，你应该注入一个 Provider<T>，然后在需要的时候使用它从较小的作用域中获取对象。这时，你必须确保，在 T 的作用域之外，永远不要调用这个提供者（例如，当目前没有 HTTP 请求且 T 的作用域为请求的时候）。
开发阶段
Guice 明白你的应用开发需要经历不同的阶段。你可以在创建容器时告诉它应用程序运行在哪一个阶段。Guice 目前支持“开发”和“产品”两个阶段。我们发现测试通常属于其中某一个阶段。

在开发阶段，Guice 会在需要时加载单件对象。这样，你的应用可以快速启动，只加载你正在测试的部分。

在产品阶段，Guice 会在启动时加载全部单件对象。这帮助你尽早捕获错误，提前优化性能。

你的模块也可以使用方法拦截和其他基于当前阶段的绑定。例如，一个拦截器可能会在开发阶段检查你是否在作用域之外使用对象。

拦截方法
Guice 使用 AOP Alliance API 支持简单的方法拦截。你可以在模块中使用 Binder 绑定拦截器。例如，对标注有 @Transactional 的方法使用交易拦截器：

import static com.google.inject.matcher.Matchers.*;

…

binder.bindInterceptor(
any(), // Match classes.
annotatedWith(Transactional.class), // Match methods.
new TransactionInterceptor() // The interceptor.
);

尽量让匹配代码多做些过滤工作，而不是在拦截器中过滤。因为匹配代码只在启动时运行一次。

静态注入
静态字段和方法会增加测试和复用的难度，但有的时候你唯一的选择就是保留一个静态的指向 Injector 的引用。

在 这些情况下，Guice 支持注入可访问性较少的静态方法。例如，HTTP 会话对象经常需要被串行化，以支持复制机制。但是，如果你的会话对象依赖于一个作用域为容器生命周期的对象，该怎么办呢？我们可以保留一个易变的引用指向 该对象，但在反串行化的时候，我们该如何再次找到该对象呢？

我们发现更实用的解决方案是使用静态注入：

@SessionScoped
class User {

@Inject
static AuthorizationService authorizationService;
…
}

Guice 从不自动实施静态注入。你必须使用 Binder 显式请求 Injector 在启动后注入你的静态成员：

binder.requestStaticInjection(User.class);

静态注入是一个需要保留的祸害，它会使测试难度加大。如果有办法避开它，你多半会很高兴的。

可选注入
有时你的代码应该在无论绑定是否存在的时候都能工作。在这些情况下，你可以使用 @Inject(optional=true)，Guice 会在有绑定可用时，用一个绑定的实现覆盖你的缺省实现。例如：

@Inject(optional=true) Formatter formatter = new DefaultFormatter();

如果谁为 Formatter 创建了一个绑定，Guice 会基于该绑定注入实例。否则，如果 Formatter 不能被注入(参见隐式绑定)，Guice 会忽略可选成员。

可选注入只能应用于字段和方法，而不能用于构造器。对于方法，如果一个参数的绑定找不到，Guice 就不会注入该方法，即便其他参数的绑定是可用的。

绑定到字符串
只要有可能，我们就尽量避免使用字符串，因为它们容易受错误拼写的影响，对工具不友好，等等。但使用字符串而不是创建定制的标注对于快而脏的代码来说仍是有用的。在这些情况下，Guice 提供了@Named 和 Names。例如，一个到字符串名字的绑定：

import static com.google.inject.name.Names.*;

…

bind(named(“bob”)).to(10);

会匹配下面的注入点：

@Inject @Named(“bob”) int score;

Struts 2支持
要 在 Struts 2.0.6 或更高版本中安装 Guice Struts 2 插件，只要将 guice-struts2-plugin-1.0.jar 包含在你的 Web 应用的 classpath 中，并在 struts.xml 中选择 Guice 作为你的 ObjectFactory 实现即可：

<constant name=”struts.objectFactory” value=”guice” />

Guice 会注入所有你的 Struts 2 对象，包括动作和拦截器。你甚至可以设置动作类的作用域。你也可以在你的 struts.xml 文件中指定 Guice 的 Module：

<constant name=”guice.module” value=”mypackage.MyModule”/>

如果你的所有绑定都是隐式的，你就根本不用定义模块了。

一个计数器的例子
例如，我们试图统计一个会话中的请求数目。定义一个在会话中存活的 Counter 对象：

@SessionScoped
public class Counter {

int count = 0;

/** Increments the count and returns the new value. */
public synchronized int increment() {
return count++;
}
}

接下来，我们可以将我们的计数器注入到动作中：

public class Count {

final Counter counter;

@Inject
public Count(Counter counter) {
this.counter = counter;
}

public String execute() {
return SUCCESS;
}

public int getCount() {
return counter.increment();
}
}

然后在 struts.xml 文件中为动作类创建映射：

<action name=”Count”
class=”mypackage.Count”>
<result>/WEB-INF/Counter.jsp</result>
</action>

以及一个用于显示结果的 JSP 页面：

<%@ taglib prefix=”s” uri=”/struts-tags” %>

<html>
<body>
<h1>Counter Example</h1>
<h3><b>Hits in this session:</b>
<s:property value=”count”/></h3>
</body>
</html>

我们实际上把这个例子做得比需求更复杂，以便展示更多的概念。在现实中，我们不需要使用单独的 Counter 对象，只要把 @SessionScoped 应用于我们的动作类即可。

JMX 集成
参见 com.google.inject.tools.jmx.

附录：注入器如何实施注入
注入器响应注入请求的过程依赖于已有的绑定和相关类型中的标注。这里是关于注入请求如何被实施的一个概要描述：

观察被注入元素的 Java 类型和可选的“绑定标注”。如果类型是 com.google.inject.Provider<T>，就对类型 T 实施。对（类型，标注）对，寻找一个绑定。如果没有，则跳到步骤4。
沿着绑定链检查。如果绑定连接到另一个绑定，则走过这条边，并继续检查，直到到达一个没有连接到后续绑定的绑定为止。我们现在为注入请求找到了最明确的显式绑定。
如果绑定指明一个实例或一个 Provider 实例，所有事情都做完了；使用这个实例来满足请求即可。
此时，如果注入请求使用了标注类型或值，我们就报告错误。
否则，检查绑定的 Java 类型；如果找到了 @ImplementedBy 标注，就实例化该类型。 如果找到了 @ProvidedBy 标注，就实例化提供者类并用它来获取想要的对象。否则试图实例化类型本身。

究竟什么是一个 Calendar 呢？中文的翻译就是日历，那我们立刻可以想到我们生活中有阳(公)历、阴(农)历之分。它们的区别在哪呢？
比如有：
月份的定义 – 阳`(公)历 一年12 个月，每个月的天数各不同；阴(农)历，每个月固定28天
每周的第一天 – 阳(公)历星期日是第一天；阴(农)历，星期一是第一天

实 际上，在历史上有着许多种纪元的方法。它们的差异实在太大了，比如说一个人的生日是”八月八日” 那么一种可能是阳(公)历的八月八日，但也可以是阴(农)历的日期。所以为了计时的统一，必需指定一个日历的选择。那现在最为普及和通用的日历就是 “Gregorian Calendar”。也就是我们在讲述年份时常用 “公元几几年”。Calendar 抽象类定义了足够的方法，让我们能够表述日历的规则。Java 本身提供了对 “Gregorian Calendar” 规则的实现。我们从 Calendar.getInstance() 中所获得的实例就是一个 “GreogrianCalendar” 对象(与您通过 new GregorianCalendar() 获得的结果一致)。
下面的代码可以证明这一点：

import java.io.*;
import java.util.*;
public class WhatIsCalendar{
public static void main(String[] args) {
Calendar calendar = Calendar.getInstance();
if (calendar instanceof GregorianCalendar)
System.out.println(“It is an instance of GregorianCalendar”t;
}
}

Calendar 在 Java 中是一个抽象类(Abstract Class)，GregorianCalendar 是它的一个具体实现。
我们也可以自己的 Calendar 实现类，然后将它作为 Calendar 对象返回(面向对象的特性)。在 IBM alphaWorks 上，IBM 的开发人员实现了多种日历(http://www.alphaworks.ibm.com/tech/calendars)。同样在 Internet 上，也有对中国农历的实现。本文对如何扩展 Calendar 不作讨论，大家可以通过察看上述 Calendar 的源码来学习。
Calendar 与 Date 的转换非常简单：

Calendar calendar = Calendar.getInstance();
// 从一个 Calendar 对象中获取 Date 对象
Date date = calendar.getTime();
// 将 Date 对象反应到一个 Calendar 对象中，
// Calendar/GregorianCalendar 没有构造函数可以接受 Date 对象
// 所以我们必需先获得一个实例，然后设置 Date 对象
calendar.setTime(date);

Calendar 对象在使用时，有一些值得注意的事项：
1. Calendar 的 set() 方法
set(int field, int value) – 是用来设置”年/月/日/小时/分钟/秒/微秒”等值
field 的定义在 Calendar 中
set(int year, int month, int day, int hour, int minute, int second) 但没有
set(int year, int month, int day, int hour, int minute, int second, int millisecond) 前面 set(int,int,int,int,int,int) 方法不会自动将 MilliSecond 清为 0。
另外，月份的起始值为０而不是１，所以要设置八月时，我们用７而不是8。
calendar.set(Calendar.MONTH, 7);
我们通常需要在程序逻辑中将它清为 0，否则可能会出现下面的情况：

import java.io.*;
import java.util.*;
public class WhatIsCalendarWrite{
public static void main(String[] args) throws Exception{
ObjectOutputStream out = new ObjectOutputStream(new FileOutputStream(“calendar.out”t);
Calendar cal1 = Calendar.getInstance();
cal1.set(2000, 7, 1, 0, 0, 0);
out.writeObject(cal1);
Calendar cal2 = Calendar.getInstance();
cal2.set(2000, 7, 1, 0, 0, 0);
cal2.set(Calendar.MILLISECOND, 0);
out.writeObject(cal2);
out.close();
}
}

我们将 Calendar 保存到文件中

import java.io.*;
import java.util.*;
public class WhatIsCalendarRead{
public static void main(String[] args) throws Exception{
ObjectInputStream in = new ObjectInputStream(new FileInputStream(“calendar.out”t);
Calendar cal2 = (Calendar)in.readObject();
Calendar cal1 = Calendar.getInstance();
cal1.set(2000, 7, 1, 0, 0, 0);
if (cal1.equals(cal2))
System.out.println(“Equals”t;
else
System.out.println(“NotEqual”t;
System.out.println(“Old calendar “+cal2.getTime().getTime());
System.out.println(“New calendar “+cal1.getTime().getTime());
cal1.set(Calendar.MILLISECOND, 0);
cal2 = (Calendar)in.readObject();
if (cal1.equals(cal2))
System.out.println(“Equals”t;
else
System.out.println(“NotEqual”t;
System.out.println(“Processed Old calendar “+cal2.getTime().getTime());
System.out.println(“Processed New calendar “+cal1.getTime().getTime());
}
}

然后再另外一个程序中取回来（模拟对数据库的存储），但是执行的结果是：
NotEqual
Old calendar 965113200422 <———— 最后三位的MilliSecond与当前时间有关
New calendar 965113200059 <———–/
Equals
Processed Old calendar 965113200000
Processed New calendar 965113200000
另外我们要注意的一点是，Calendar 为了性能原因对 set() 方法采取延缓计算的方法。在 JavaDoc 中有下面的例子来说明这个问题：
Calendar cal1 = Calendar.getInstance();
cal1.set(2000, 7, 31, 0, 0 , 0); //2000-8-31
cal1.set(Calendar.MONTH, Calendar.SEPTEMBER); //应该是 2000-9-31，也就是 2000-10-1
cal1.set(Calendar.DAY_OF_MONTH, 30); //如果 Calendar 转化到 2000-10-1，那么现在的结果就该是 2000-10-30
System.out.println(cal1.getTime()); //输出的是2000-9-30，说明 Calendar 不是马上就刷新其内部的记录
在 Calendar 的方法中，get() 和 add() 会让 Calendar 立刻刷新。Set() 的这个特性会给我们的开发带来一些意想不到的结果。我们后面会看到这个问题。
2. Calendar 对象的容错性，Lenient 设置
我们知道特定的月份有不同的日期，当一个用户给出错误的日期时，Calendar 如何处理的呢？

import java.io.*;
import java.util.*;
public class WhatIsCalendar{
public static void main(String[] args) throws Exception{
Calendar cal1 = Calendar.getInstance();
cal1.set(2000, 1, 32, 0, 0, 0);
System.out.println(cal1.getTime());
cal1.setLenient(false);
cal1.set(2000, 1, 32, 0, 0, 0);
System.out.println(cal1.getTime());
}
}

它的执行结果是：
Tue Feb 01 00:00:00 PST 2000
Exception in thread “main” java.lang.IllegalArgumentException
at java.util.GregorianCalendar.computeTime(GregorianCalendar.java:1368)
at java.util.Calendar.updateTime(Calendar.java:1508)
at java.util.Calendar.getTimeInMillis(Calendar.java:890)
at java.util.Calendar.getTime(Calendar.java:871)
at WhatIsCalendar.main(WhatIsCalendar.java:12)
当我们设置该 Calendar 为 Lenient false 时，它会依据特定的月份检查出错误的赋值。
3. 不稳定的 Calendar
我们知道 Calendar 是可以被 serialize 的，但是我们要注意下面的问题

import java.io.*;
import java.util.*;
public class UnstableCalendar implements Serializable{
public static void main(String[] args) throws Exception{
Calendar cal1 = Calendar.getInstance();
cal1.set(2000, 7, 1, 0, 0 , 0);
cal1.set(Calendar.MILLISECOND, 0);
ObjectOutputStream out = new ObjectOutputStream(new FileOutputStream(“newCalendar.out”t);
out.writeObject(cal1);
out.close();
ObjectInputStream in = new ObjectInputStream(new FileInputStream(“newCalendar.out”t);
Calendar cal2 = (Calendar)in.readObject();
cal2.set(Calendar.MILLISECOND, 0);
System.out.println(cal2.getTime());
}
}

运行的结果竟然是: Thu Jan 01 00:00:00 PST 1970
它 被复原到 EPOC 的起始点，我们称该 Calendar 是处于不稳定状态。这个问题的根本原因是 Java 在 serialize GregorianCalendar 时没有保存所有的信息，所以当它被恢复到内存中，又缺少足够的信息时，Calendar 会被恢复到 EPOCH 的起始值。Calendar 对象由两部分构成：字段和相对于 EPOC 的微秒时间差。字段信息是由微秒时间差计算出的，而 set() 方法不会强制 Calendar 重新计算字段。这样字段值就不对了。
下面的代码可以解决这个问题：

import java.io.*;
import java.util.*;
public class StableCalendar implements Serializable{
public static void main(String[] args) throws Exception{
Calendar cal1 = Calendar.getInstance();
cal1.set(2000, 7, 1, 0, 0 , 0);
cal1.set(Calendar.MILLISECOND, 0);
ObjectOutputStream out = new ObjectOutputStream(new FileOutputStream(“newCalendar.out”t);
out.writeObject(cal1);
out.close();
ObjectInputStream in =new ObjectInputStream(new FileInputStream(“newCalendar.out”t);
Calendar cal2 = (Calendar)in.readObject();
cal2.get(Calendar.MILLISECOND); //先调用 get()，强制 Calendar 刷新
cal2.set(Calendar.MILLISECOND, 0);//再设值
System.out.println(cal2.getTime());
}
}

运行的结果是: Tue Aug 01 00:00:00 PDT 2000
这个问题主要会影响到在 EJB 编程中，参数对象中包含 Calendar 时。经过 Serialize/Deserialize 后，直接操作 Calendar 会产生不稳定的情况。
4. add() 与 roll() 的区别
add() 的功能非常强大，add 可以对 Calendar 的字段进行计算。如果需要减去值，那么使用负数值就可以了，如 add(field, -value)。
add() 有两条规则：
当被修改的字段超出它可以的范围时，那么比它大的字段会自动修正。如：

Calendar cal1 = Calendar.getInstance();
cal1.set(2000, 7, 31, 0, 0 , 0); //2000-8-31
cal1.add(Calendar.MONTH, 1); //2000-9-31 => 2000-10-1，对吗？
System.out.println(cal1.getTime()); //结果是 2000-9-30

另一个规则是，如果比它小的字段是不可变的（由 Calendar 的实现类决定），那么该小字段会修正到变化最小的值。
以上面的例子，9-31 就会变成 9-30，因为变化最小。
Roll() 的规则只有一条：
当被修改的字段超出它可以的范围时，那么比它大的字段不会被修正。如：

Calendar cal1 = Calendar.getInstance();
cal1.set(1999, 5, 6, 0, 0, 0); //1999-6-6, 周日
cal1.roll(Calendar.WEEK_OF_MONTH, -1); //1999-6-1, 周二
cal1.set(1999, 5, 6, 0, 0, 0); //1999-6-6, 周日
cal1.add(Calendar.WEEK_OF_MONTH, -1); //1999-5-30, 周日

WEEK_OF_MONTH 比 MONTH 字段小，所以 roll 不能修正 MONTH 字段。
Date类介绍
Data和Calendar类：
一、创建一个日期对象r
让我们看一个使用系统的当前日期和时间创建一个日期对象并返回一个长整数的简
单例子. 这个时间通常被称为Java 虚拟机(JVM)主机环境的系统时间.

import java.util.Date;
public class DateExample1 {
public static void main(String[] args) {
// Get the system date/time
Date date = new Date();
System.out.println(date.getTime());
}
}

在星期六, 2001年9月29日, 下午大约是6:50的样子, 上面的例子在系统输出设备上
显示的结果是 1001803809710. 在这个例子中,值得注意的是我们使用了Date 构造
函数创建一个日期对象, 这个构造函数没有接受任何参数. 而这个构造函数在内部
使用了System.currentTimeMillis() 方法来从系统获取日期.如果用
System.out.println(new Date());
则输出形式为：Tue Nov 08 14:28:07 CST 2005
那么, 现在我们已经知道了如何获取从1970年1月1日开始经历的毫秒数了. 我们如
何才能以一种用户明白的格式来显示这个日期呢? 在这里类java.text.
SimpleDateFormat 和它的抽象基类 java.text.DateFormat 就派得上用场了.
二、日期数据的定制格式
假如我们希望定制日期数据的格式, 比方星期六-9月-29日-2001年. 下面的例子展
示了如何完成这个工作:

import java.text.SimpleDateFormat;
import java.util.Date;
public class DateExample2 {
public static void main(String[] args) {
SimpleDateFormat bartDateFormat =
new SimpleDateFormat(“EEEE-MMMM-dd-yyyy”);
Date date = new Date();
System.out.println(bartDateFormat.format(date));
}
}

只要通过向SimpleDateFormat 的构造函数传递格式字符串”EEE-MMMM-dd-yyyy”,
我们就能够指明自己想要的格式. 你应该可以看见, 格式字符串中的ASCII 字符
告诉格式化函数下面显示日期数据的哪一个部分. EEEE是星期, MMMM是月, dd是日
, yyyy是年. 字符的个数决定了日期是如何格式化的.传递”EE-MM-dd-yy”会显示
Sat-09-29-01. 请察看Sun 公司的Web 站点获取日期格式化选项的完整的指示.
三、将文本数据解析成日期对象r
假设我们有一个文本字符串包含了一个格式化了的日期对象, 而我们希望解析这个
字符串并从文本日期数据创建一个日期对象. 我们将再次以格式化字符串
“MM-dd-yyyy” 调用SimpleDateFormat类, 但是这一次, 我们使用格式化解析而不
是生成一个文本日期数据. 我们的例子, 显示在下面, 将解析文本字符串
“9-29-2001″并创建一个值为001736000000 的日期对象.
例子程序:

import java.text.SimpleDateFormat;
import java.util.Date;
public class DateExample3 {
public static void main(String[] args) {
// Create a date formatter that can parse dates of
// the form MM-dd-yyyy.
SimpleDateFormat bartDateFormat = new SimpleDateFormat(“MM-dd-yyyy”);
// Create a string containing a text date to be parsed.
String dateStringToParse = “9-29-2001″;
try {
// Parse the text version of the date.
// We have to perform the parse method in a
// try-catch construct in case dateStringToParse
// does not contain a date in the format we are expecting.
Date date = bartDateFormat.parse(dateStringToParse);
// Now send the parsed date as a long value
// to the system output.
System.out.println(date.getTime());
} catch (Exception ex) {
System.out.println(ex.getMessage());
}
}
}

五、使用标准的日期格式化过程
既然我们已经可以生成和解析定制的日期格式了, 让我们来看一看如何使用内建的
格式化过程. 方法 DateFormat.getDateTimeInstance() 让我们得以用几种不同的
方法获得标准的日期格式化过程. 在下面的例子中, 我们获取了四个内建的日期格
式化过程. 它们包括一个短的, 中等的, 长的, 和完整的日期格式.

import java.text.DateFormat;
import java.util.Date;
public class DateExample4 {
public static void main(String[] args) {
Date date = new Date();
DateFormat shortDateFormat = DateFormat.getDateTimeInstance(DateFormat.SHORT,DateFormat.SHORT);
DateFormat mediumDateFormat =
DateFormat.getDateTimeInstance(DateFormat.MEDIUM,DateFormat.MEDIUM);
DateFormat longDateFormat = DateFormat.getDateTimeInstance(DateFormat.LONG,DateFormat.LONG);
DateFormat fullDateFormat = DateFormat.getDateTimeInstance(DateFormat.FULL,DateFormat.FULL);
System.out.println(shortDateFormat.format(date));
System.out.println(mediumDateFormat.format(date));
System.out.println(longDateFormat.format(date));
System.out.println(fullDateFormat.format(date));
}
}

注意我们在对 getDateTimeInstance的每次调用中都传递了两个值. 第一个参数
是日期风格, 而第二个参数是时间风格. 它们都是基本数据类型int(整型). 考虑
到可读性, 我们使用了DateFormat 类提供的常量: SHORT, MEDIUM, LONG, 和
FULL. 要知道获取时间和日期格式化过程的更多的方法和选项, 请看Sun 公司Web
站点上的解释.
运行我们的例子程序的时候, 它将向标准输出设备输出下面的内容:
9/29/01 8:44 PM
Sep 29, 2001 8:44:45 PM
September 29, 2001 8:44:45 PM EDT
Saturday, September 29, 2001 8:44:45 PM EDT

（1）模板 + 数据模型 = 输出

FreeMarker基于设计者和程序员是具有不同专业技能的不同个体的观念他们是分工劳动的：
设计者专注于表示——创建HTML文件、图片、Web页面的其它可视化方面；
程序员创建系统，生成设计页面要显示的数据。
经常会遇到的问题是：在Web页面（或其它类型的文档）中显示的信息在设计页面时是无效的，是基于动态数据的。在这里，你可以在HTML（或其它要输出的文本）中加入一些特定指令，FreeMarker会在输出页面给最终用户时，用适当的数据替代这些代码。

先来解释一下freemaker的基本语法了，
<# … > 中存放所有freemaker的内容，之外的内容全部原样输出。
<@ … /> 是函数调用
两个定界符内的内容中，第一个符号表示指令或者函数名，其后的跟随参数。freemaker提供的控制包括如下：
<#if condition><#elseif condition><#else> 条件判断
<#list hash_or_seq as var> 遍历hash表或者collection（freemaker称作sequence）的成员
<#macro name param1 param2 … ><#nested param> 宏，无返回参数
<#function name param1 param2><#return val>函数，有返回参数
var?member_function(…) 用函数对var进行转换，freemaker称为build-ins。实际内部实现类似member_function(var, …)
stringA[M .. N] 取子字符串，类似substring(stringA, M, N)
{key:value, key2:value2 …} 直接定义一个hash表
[item0, item1, item2 ...] 直接定义一个序列
hash0[key0] 存取hash表中key对应的元素
seq0[5] 存取序列指定下标的元素
<@function1 param0 param1 … /> 调用函数function1
<@macro0 param0 param1 ; nest_param0 nest_param1 …> nest_body </@macro> 调用宏，并处理宏的嵌套
<#assign var = value > 定义变量并初始化
<#local var = value> 在 macro 或者 function 中定义局部变量并初始化
<#global var = value > 定义全局变量并初始化
${var} 输出并替换为表达式的值
<#visit xmlnode> 调用macro匹配xmlnode本身及其子节点
<#recurse xmlnode> 调用macro匹配xmlnode的子节点

下面是一个例子：

<html>
<head>
  <title>Welcome!</title>
</head>
<body>
  <h1>Welcome ${user}!</h1>
  <p>Our latest product:
  <a href="${latestProduct.url}">${latestProduct.name}</a>!
</body>
</html>

这个例子是在简单的HTML中加入了一些由${…}包围的特定代码，这些特定代码是FreeMarker的指令，而包含FreeMarker的指令的文件就称为模板（Template）。
至于user、latestProduct.url和latestProduct.name来自于数据模型（data model）。
数据模型由程序员编程来创建，向模板提供变化的信息，这些信息来自于数据库、文件，甚至于在程序中直接生成。
模板设计者不关心数据从那儿来，只知道使用已经建立的数据模型。

下面是一个可能的数据模型：

(root)
  |
  +- user = "Big Joe"
  |
  +- latestProduct
      |
      +- url = "products/greenmouse.html"
      |
      +- name = "green mouse"

数据模型类似于计算机的文件系统，latestProduct可以看作是目录。

2、数据模型

（1）基础

在快速入门中介绍了在模板中使用的三种基本对象类型：scalars、hashes 和sequences，其实还可以有其它更多的能力：

• scalars：存储单值

• hashes：充当其它对象的容器，每个都关联一个唯一的查询名字

• sequences：充当其它对象的容器，按次序访问

• 方法：通过传递的参数进行计算，以新对象返回结果

• 用户自定义FTL标记：宏和变换器

通常每个变量只具有上述的一种能力，但一个变量可以具有多个上述能力，如下面的例子：

(root)
 |
 +- mouse = "Yerri"
     |
     +- age = 12
     |
     +- color = "brown">

mouse既是scalars又是hashes，将上面的数据模型合并到下面的模板：

${mouse}       <#-- use mouse as scalar -->
${mouse.age}   <#-- use mouse as hash -->
${mouse.color} <#-- use mouse as hash -->

输出结果是：

Yerri
12
brown

（2）Scalar变量

Scalar变量存储单值，可以是：

• 字符串：简单文本，在模板中使用引号（单引号或双引号）括起

• 数字：在模板中直接使用数字值

• 日期：存储日期/时间相关的数据，可以是日期、时间或日期-时间（Timestamp）；通常情况，日期值由程序员加到数据模型中，设计者只需要显示它们

• 布尔值：true或false，通常在<#if …>标记中使用

（3）hashes 、sequences和集合

有些变量不包含任何可显示的内容，而是作为容器包含其它变量，者有两种类型：

• hashes：具有一个唯一的查询名字和它包含的每个变量相关联

• sequences：使用数字和它包含的每个变量相关联，索引值从0开始

集合变量通常类似sequences，除非无法访问它的大小和不能使用索引来获得它的子变量；集合可以看作只能由<#list …>指令使用的受限sequences

（4）方法

方法变量通常是基于给出的参数计算值。

下面的例子假设程序员已经将方法变量avg放到数据模型中，用来计算数字平均值：

The average of 3 and 5 is: ${avg(3, 5)}
The average of 6 and 10 and 20 is: ${avg(6, 10, 20)}
The average of the price of python and elephant is:
    ${avg(animals.python.price, animals.elephant.price)}

（5）宏和变换器

宏和变换器变量是用户自定义指令（自定义FTL标记），会在后面讲述这些高级特性

（6）节点

节点变量表示为树型结构中的一个节点，通常在XML处理中使用，会在后面的专门章节中讲

3、模板

（1）整体结构

模板使用FTL（FreeMarker模板语言）编写，是下面各部分的一个组合：

• 文本：直接输出
• Interpolation：由${和}，或#{和}来限定，计算值替代输出
• FTL标记：FreeMarker指令，和HTML标记类似，名字前加#予以区分，不会输出
• 注释：由<#–和–>限定，不会输出

下面是以一个具体模板例子：

<html>
<head>
  <title>Welcome!</title>
</head>
<body>
  <#-- Greet the user with his/her name -->
  <h1>Welcome ${user}!</h1>
  <p>We have these animals:
  <ul>
  <#list animals as being>
    <li>${being.name} for ${being.price} Euros
  </#list>
  </ul>
</body>
</html>

注意事项：

• FTL区分大小写，所以list是正确的FTL指令，而List不是；${name}和${NAME}是不同的

• Interpolation只能在文本中使用

• FTL标记不能位于另一个FTL标记内部，例如：

<#if <#include 'foo'>='bar'>...</if>

• 注释可以位于FTL标记和Interpolation内部，如下面的例子：

<h1>Welcome ${user <#-- The name of user -->}!</h1>
<p>We have these animals:
<ul>
<#list <#-- some comment... --> animals as <#-- again... --> being>
...

• 余的空白字符会在模板输出时移除

（2）指令

在FreeMarker中，使用FTL标记引用指令。有三种FTL标记，这和HTML标记是类似的：

• 开始标记：<#directivename parameters>

• 结束标记：</#directivename>

• 空内容指令标记：<#directivename parameters/>

有两种类型的指令：预定义指令和用户定义指令。

用户定义指令要使用@替换#，如<@mydirective>…</@mydirective>（会在后面讲述）。

FTL标记不能够交叉，而应该正确的嵌套，如下面的代码是错误的：

<ul>
<#list animals as being>
  <li>${being.name} for ${being.price} Euros
  <#if use = "Big Joe">
     (except for you)
</#list>
</#if> <#-- WRONG! -->
</ul>

如果使用不存在的指令，FreeMarker不会使用模板输出，而是产生一个错误消息。

FreeMarker会忽略FTL标记中的空白字符，如下面的例子：

<#list
  animals       as
     being
>
${being.name} for ${being.price} Euros
</#list    >

但是，<、</和指令之间不允许有空白字符。

（3）表达式

直接指定值

• 字符串

使用单引号或双引号限定

如果包含特殊字符需要转义，如下面的例子：

${"It's \"quoted\" and
this is a backslash: \\"}

${'It\'s "quoted" and
this is a backslash: \\'}

输出结果是：

It's "quoted" and
this is a backslash: \

It's "quoted" and
this is a backslash: \

下面是支持的转义序列：

有一类特殊的字符串称为raw字符串，被认为是纯文本，其中的\和{等不具有特殊含义，该类字符串在引号前面加r，下面是一个例子：

${r"${foo}"}

${r"C:\foo\bar"}

输出的结果是：

${foo}

C:\foo\bar

• 数字

直接输入，不需要引号

精度数字使用“.”分隔，不能使用分组符号

目前版本不支持科学计数法，所以“1E3”是错误的

不能省略小数点前面的0，所以“.5”是错误的

数字8、+8、08和8.00都是相同的

• 布尔值

true和false，不使用引号

• 序列

由逗号分隔的子变量列表，由方括号限定，下面是一个例子：

<#list ["winter", "spring", "summer", "autumn"] as x>
${x}
</#list>

输出的结果是：

winter
spring
summer
autumn

列表的项目是表达式，所以可以有下面的例子：

[2 + 2, [1, 2, 3, 4], "whatnot"]

可以使用数字范围定义数字序列，例如2..5等同于[2, 3, 4, 5]，但是更有效率，注意数字范围没有方括号

可以定义反递增的数字范围，如5..2

• 散列（hash）

由逗号分隔的键/值列表，由大括号限定，键和值之间用冒号分隔，下面是一个例子：

{"name":"green mouse", "price":150}

键和值都是表达式，但是键必须是字符串

获取变量

• 顶层变量： ${variable}，变量名只能是字母、数字、下划线、$、@和#的组合，且不能以数字开头

• 从散列中获取数据

可以使用点语法或方括号语法，假设有下面的数据模型：

(root)
 |
 +- book
 |   |
 |   +- title = "Breeding green mouses"
 |   |
 |   +- author
 |       |
 |       +- name = "Julia Smith"
 |       |
 |       +- info = "Biologist, 1923-1985, Canada"
 |
 +- test = "title"

下面都是等价的：

book.author.name
book["author"].name
book.author.["name"]
book["author"]["name"]

使用点语法，变量名字有顶层变量一样的限制，但方括号语法没有该限制，因为名字是任意表达式的结果

• 从序列获得数据：和散列的方括号语法语法一样，只是方括号中的表达式值必须是数字；注意：第一个项目的索引是0

序列片断：使用[startIndex..endIndex]语法，从序列中获得序列片断（也是序列）；startIndex和endIndex是结果为数字的表达式

• 特殊变量：FreeMarker内定义变量，使用.variablename语法访问

字符串操作

• Interpolation（或连接操作）

可以使用${..}（或#{..}）在文本部分插入表达式的值，例如：

${"Hello ${user}!"}

${"${user}${user}${user}${user}"}

可以使用+操作符获得同样的结果

${"Hello " + user + "!"}

${user + user + user + user}

${..}只能用于文本部分，下面的代码是错误的：

<#if ${isBig}>Wow!</#if>

<#if "${isBig}">Wow!</#if>

应该写成：

<#if isBig>Wow!</#if>

• 子串

例子（假设user的值为“Big Joe”）：

${user[0]}${user[4]}

${user[1..4]}

结果是（注意第一个字符的索引是0）：

BJ

ig J

序列操作

• 连接操作：和字符串一样，使用+，下面是一个例子：

<#list ["Joe", "Fred"] + ["Julia", "Kate"] as user>
- ${user}
</#list>

输出结果是：

- Joe
- Fred
- Julia
- Kate

散列操作

• 连接操作：和字符串一样，使用+，如果具有相同的key，右边的值替代左边的值，例如：

<#assign ages = {"Joe":23, "Fred":25} + {"Joe":30, "Julia":18}>
- Joe is ${ages.Joe}
- Fred is ${ages.Fred}
- Julia is ${ages.Julia}

输出结果是：

- Joe is 30
- Fred is 25
- Julia is 18

算术运算

• ＋、－、×、／、％，下面是一个例子：

${x * x - 100}
${x / 2}
${12 % 10}

输出结果是（假设x为5）：

-75
2.5
2

操作符两边必须是数字，因此下面的代码是错误的：

${3 * "5"} <#-- WRONG! -->

使用+操作符时，如果一边是数字，一边是字符串，就会自动将数字转换为字符串，例如：

${3 + "5"}

输出结果是：

35

使用内建的int（后面讲述）获得整数部分，例如：

${(x/2)?int}
${1.1?int}
${1.999?int}
${-1.1?int}
${-1.999?int}

输出结果是（假设x为5）：

2
1
1
-1
-1

• 比较操作符

使用=（或==，完全相等）测试两个值是否相等，使用!= 测试两个值是否不相等

=和!=两边必须是相同类型的值，否则会产生错误，例如<#if 1 = “1″>会引起错误

Freemarker是精确比较，所以对”x”、”x “和”X”是不相等的

对数字和日期可以使用<、<=、>和>=，但不能用于字符串

由于Freemarker会将>解释成FTL标记的结束字符，所以对于>和>=可以使用括号来避免这种情况，例如<#if (x > y)>

另一种替代的方法是，使用lt、lte、gt和gte来替代<、<=、>和>=

• 逻辑操作符

&&（and）、||（or）、!（not），只能用于布尔值，否则会产生错误

例子：

<#if x < 12 && color = "green">
  We have less than 12 things, and they are green.
</#if>
<#if !hot> <#-- here hot must be a boolean -->
  It's not hot.
</#if>

• 内建函数

内建函数的用法类似访问散列的子变量，只是使用“?”替代“.”，下面列出常用的一些函数

• • 字符串使用的：

html：对字符串进行HTML编码

cap_first：使字符串第一个字母大写

lower_case：将字符串转换成小写

upper_case：将字符串转换成大写

trim：去掉字符串前后的空白字符

• • 序列使用的：

size：获得序列中元素的数目

• • 数字使用的：

int：取得数字的整数部分（如-1.9?int的结果是-1）

例子（假设test保存字符串”Tom & Jerry”）：

${test?html}
${test?upper_case?html}

输出结果是：

Tom & Jerry
TOM & JERRY

• 操作符优先顺序

（4）Interpolation

Interpolation有两种类型：

1. 通用Interpolation：${expr}

1. 数字Interpolation：#{expr}或#{expr; format}

注意：Interpolation只能用于文本部分

• 通用Interpolation

插入字符串值：直接输出表达式结果

插入数字值：根据缺省格式（由#setting指令设置）将表达式结果转换成文本输出；可以使用内建函数string格式化单个Interpolation，下面是一个例子：

<#setting number_format="currency"/>
<#assign answer=42/>
${answer}
${answer?string}  <#-- the same as ${answer} -->
${answer?string.number}
${answer?string.currency}
${answer?string.percent}

输出结果是：

$42.00
$42.00
42
$42.00
4,200%

插入日期值：根据缺省格式（由#setting指令设置）将表达式结果转换成文本输出；可以使用内建函数string格式化单个Interpolation，下面是一个使用格式模式的例子：

${lastUpdated?string("yyyy-MM-dd HH:mm:ss zzzz")}
${lastUpdated?string("EEE, MMM d, ''yy")}
${lastUpdated?string("EEEE, MMMM dd, yyyy, hh:mm:ss a '('zzz')'")}

输出的结果类似下面的格式：

2003-04-08 21:24:44 Pacific Daylight Time
Tue, Apr 8, '03
Tuesday, April 08, 2003, 09:24:44 PM (PDT)

插入布尔值：根据缺省格式（由#setting指令设置）将表达式结果转换成文本输出；可以使用内建函数string格式化单个Interpolation，下面是一个例子：

<#assign foo=true/>
${foo?string("yes", "no")}

输出结果是：

yes

• 数字Interpolation的#{expr; format}形式可以用来格式化数字，format可以是：

mX：小数部分最小X位

MX：小数部分最大X位

例子：

<#-- If the language is US English the output is: -->
<#assign x=2.582/>
<#assign y=4/>
#{x; M2}   <#-- 2.58 -->
#{y; M2}   <#-- 4    -->
#{x; m1}   <#-- 2.6 -->
#{y; m1}   <#-- 4.0 -->
#{x; m1M2} <#-- 2.58 -->
#{y; m1M2} <#-- 4.0  -->

4、杂项

（1）用户定义指令

宏和变换器变量是两种不同类型的用户定义指令，它们之间的区别是宏是在模板中使用macro指令定义，而变换器是在模板外由程序定义，这里只介绍宏

• 基本用法

宏是和某个变量关联的模板片断，以便在模板中通过用户定义指令使用该变量，下面是一个例子：

<#macro greet>
  <font size="+2">Hello Joe!</font>
</#macro>

作为用户定义指令使用宏变量时，使用@替代FTL标记中的#

<@greet></@greet>

如果没有体内容，也可以使用：

<@greet/>

• 参数

在macro指令中可以在宏变量之后定义参数，如：

<#macro greet person>
  <font size="+2">Hello ${person}!</font>
</#macro>

可以这样使用这个宏变量：

<@greet person="Fred"/> and <@greet person="Batman"/>

输出结果是：

  <font size="+2">Hello Fred!</font>

 and   <font size="+2">Hello Batman!</font>

宏的参数是FTL表达式，所以下面的代码具有不同的意思：

<@greet person=Fred/>

这意味着将Fred变量的值传给person参数，该值不仅是字符串，还可以是其它类型，甚至是复杂的表达式

可以有多参数，下面是一个例子：

<#macro greet person color>
  <font size="+2" color="${color}">Hello ${person}!</font>
</#macro>

可以这样使用该宏变量：

<@greet person="Fred" color="black"/>

其中参数的次序是无关的，因此下面是等价的：

<@greet color="black" person="Fred"/>

只能使用在macro指令中定义的参数，并且对所有参数赋值，所以下面的代码是错误的：

<@greet person="Fred" color="black" background="green"/>
<@greet person="Fred"/>

可以在定义参数时指定缺省值，如：

<#macro greet person color="black">
  <font size="+2" color="${color}">Hello ${person}!</font>
</#macro>

这样<@greet person=”Fred”/>就正确了

宏的参数是局部变量，只能在宏定义中有效

• 嵌套内容

用户定义指令可以有嵌套内容，使用<#nested>指令执行指令开始和结束标记之间的模板片断

例子：

<#macro border>
  <table border=4 cellspacing=0 cellpadding=4><tr><td>
    <#nested>
  </tr></td></table>
</#macro>

这样使用该宏变量：

<@border>The bordered text</@border>

输出结果：

  <table border=4 cellspacing=0 cellpadding=4><tr><td>
    The bordered text
  </tr></td></table>

<#nested>指令可以被多次调用，例如：

<#macro do_thrice>
  <#nested>
  <#nested>
  <#nested>
</#macro>
<@do_thrice>
  Anything.
</@do_thrice>

输出结果：

  Anything.
  Anything.
  Anything.

嵌套内容可以是有效的FTL，下面是一个有些复杂的例子： <@border> <ul> <@do_thrice> <li><@greet person="Joe"/> </@do_thrice> </ul> </@border> }}} 输出结果：

  <table border=4 cellspacing=0 cellpadding=4><tr><td>
      <ul>
    <li><font size="+2">Hello Joe!</font>
    <li><font size="+2">Hello Joe!</font>
    <li><font size="+2">Hello Joe!</font>
  </ul>
  </tr></td></table>

宏定义中的局部变量对嵌套内容是不可见的，例如：

<#macro repeat count>
  <#local y = "test">
  <#list 1..count as x>
    ${y} ${count}/${x}: <#nested>
  </#list>
</#macro>
<@repeat count=3>${y?default("?")} ${x?default("?")} ${count?default("?")}</@repeat>

输出结果：

    test 3/1: ? ? ?
    test 3/2: ? ? ?
    test 3/3: ? ? ?

• 在宏定义中使用循环变量

用户定义指令可以有循环变量，通常用于重复嵌套内容，基本用法是：作为nested指令的参数传递循环变量的实际值，而在调用用户定义指令时，在<@…>开始标记的参数后面指定循环变量的名字

例子：

<#macro repeat count>
  <#list 1..count as x>
    <#nested x, x/2, x==count>
  </#list>
</#macro>
<@repeat count=4 ; c, halfc, last>
  ${c}. ${halfc}<#if last> Last!</#if>
</@repeat>

输出结果：

  1. 0.5
  2. 1
  3. 1.5
  4. 2 Last!

指定的循环变量的数目和用户定义指令开始标记指定的不同不会有问题

调用时少指定循环变量，则多指定的值不可见

调用时多指定循环变量，多余的循环变量不会被创建

（2）在模板中定义变量

在模板中定义的变量有三种类型：

• plain变量：可以在模板的任何地方访问，包括使用include指令插入的模板，使用assign指令创建和替换

• 局部变量：在宏定义体中有效，使用local指令创建和替换

• 循环变量：只能存在于指令的嵌套内容，由指令（如list）自动创建

宏的参数是局部变量，而不是循环变量；局部变量隐藏（而不是覆盖）同名的plain变量；循环变量隐藏同名的局部变量和plain变量，下面是一个例子：

<#assign x = "plain">
1. ${x}  <#-- we see the plain var. here -->
<@test/>
6. ${x}  <#-- the value of plain var. was not changed -->
<#list ["loop"] as x>
  7. ${x}  <#-- now the loop var. hides the plain var. -->
<#assign x = "plain2"> <#-- replace the plain var, hiding does not mater here -->
 8. ${x}  <#-- it still hides the plain var. -->
</#list>
   9. ${x}  <#-- the new value of plain var. -->
<#macro test>
  2. ${x}  <#-- we still see the plain var. here -->
  <#local x = "local">
  3. ${x}  <#-- now the local var. hides it -->
  <#list ["loop"] as x>
    4. ${x}  <#-- now the loop var. hides the local var. -->
  </#list>
  5. ${x}  <#-- now we see the local var. again -->
</#macro>

输出结果：

1. plain
  2. plain
  3. local
    4. loop
  5. local
6. plain
    7. loop
    8. loop
9. plain2

内部循环变量隐藏同名的外部循环变量，如：

<#list ["loop 1"] as x>
  ${x}
  <#list ["loop 2"] as x>
    ${x}
    <#list ["loop 3"] as x>
      ${x}
    </#list>
    ${x}
  </#list>
  ${x}
</#list>

输出结果：

  loop 1
    loop 2
      loop 3
    loop 2
  loop 1

模板中的变量会隐藏（而不是覆盖）数据模型中同名变量，如果需要访问数据模型中的同名变量，使用特殊变量global，下面的例子假设数据模型中的user的值是Big Joe：

<#assign user = "Joe Hider">
${user}          <#-- prints: Joe Hider -->
${.globals.user} <#-- prints: Big Joe -->

（3）名字空间

通常情况，只使用一个名字空间，称为主名字空间

为了创建可重用的宏、变换器或其它变量的集合（通常称库），必须使用多名字空间，其目的是防止同名冲突

• 创建库

下面是一个创建库的例子（假设保存在lib/my_test.ftl中）：

<#macro copyright date>
  <p>Copyright (C) ${date} Julia Smith. All rights reserved.
  <br>Email: ${mail}</p>
</#macro>
<#assign mail = "jsmith@acme.com">

使用import指令导入库到模板中，Freemarker会为导入的库创建新的名字空间，并可以通过import指令中指定的散列变量访问库中的变量：

<#import "/lib/my_test.ftl" as my>
<#assign mail="fred@acme.com">
<@my.copyright date="1999-2002"/>
${my.mail}
${mail}

输出结果：

  <p>Copyright (C) 1999-2002 Julia Smith. All rights reserved.
  <br>Email: jsmith@acme.com</p>
jsmith@acme.com
fred@acme.com

可以看到例子中使用的两个同名变量并没有冲突，因为它们位于不同的名字空间可以使用assign指令在导入的名字空间中创建或替代变量，下面是一个例子：

<#import "/lib/my_test.ftl" as my>
${my.mail}
<#assign mail="jsmith@other.com" in my>
${my.mail}

输出结果：

jsmith@acme.com
jsmith@other.com

数据模型中的变量任何地方都可见，也包括不同的名字空间，下面是修改的库：

<#macro copyright date>
  <p>Copyright (C) ${date} ${user}. All rights reserved.</p>
</#macro>
<#assign mail = "${user}@acme.com">

假设数据模型中的user变量的值是Fred，则下面的代码：

<#import "/lib/my_test.ftl" as my>
<@my.copyright date="1999-2002"/>
${my.mail}

输出结果：

  <p>Copyright (C) 1999-2002 Fred. All rights reserved.</p>
Fred@acme.com   


补充（静态方法的调用）：

方法1：
##定义配置文件 freemarkerstatic.properties
_Validator=com.longyou.util.Validator
_Functions=com.longyou.util.Functions
_EscapeUtils=com.longyou.util.EscapeUtils
/调用代码
${_Functions.toUpperCase("Hello")}<br>
${_EscapeUtils.escape("狼的原野")}

方法2：
${stack.findValue("@package.ClassName@method")}

补充：常用语法

EG.一个对象BOOK

1.输出 ${book.name}

空值判断：${book.name?if_exists },

${book.name?default(‘xxx’)}//默认值xxx

${ book.name!”xxx”}//默认值xxx

日期格式：${book.date?string(‘yyyy-MM-dd’)}

数字格式：${book?string.number}–20

${book?string.currency}–<#– $20.00 –>

${book?string.percent}—<#– 20% –>

插入布尔值：

<#assign foo=ture />

${foo?string(“yes”,”no”)} <#– yes –>

2．逻辑判断

a:

<#if condition>…

<#elseif condition2>…

<#elseif condition3>……

<#else>…

其中空值判断可以写成<#if book.name?? >

b:

<#switch value>

<#case refValue1>

…

<#break>

<#case refValue2>

…

<#break>

…

<#case refValueN>

…

<#break>

<#default>

…

3．循环读取

<#list sequence as item>

…

空值判断<#if bookList?size = 0>

e.g.

<#list employees as e>

${e_index}. ${e.name}

输出:

1. Readonly

2. Robbin

freemarker中Map的使用
<#list testMap?keys as testKey>
< option value=”${testKey}“ >

freemarker的Eclipse插件

• If you use Eclipse 2.x:
  1. Open the Window menu, then Open Perspective -> Install/Update
  2. Click with the right mouse button on the Feature Updates view, then select New -> Site Bookmark
  3. In the displayed dialog box, type “FreeMarker” for Name and “http://www.freemarker.org/eclipse/update” for URL. Leave the “Bookmark type” radio buttons on “Eclipse update site”.
  4. Click Finish
  5. Open the tree node under the newly created update site named “FreeMarker”, select the “FreeMarker X.Y.Z“ feature, and install it using the Install now button in the preview pane.
• If you use Eclipse 3.x:
  1. Help -> Software updates -> Find and install….
  2. Choose “Search for new features to install”.
  3. Click Add Update Site…, and type “FreeMarker” for Name and “http://www.freemarker.org/eclipse/update” for URL.
  4. Check the box of the “FreeMarker” feature.
  5. “Next”-s until it is installed…

案例 1
在这个例子中, 存储过程不能最佳的使用RPC. 数据库必须将这作为一个普通的语言来进行解析，校验参数类型并将参数转换为正确的数据类型，最后才执行这个存储过程.
CallableStatement cstmt = conn.prepareCall (
“{call getCustName (12345)}”);
ResultSet rs = cstmt.executeQuery ();
案例 2
在这个例子中, 存储过程能最佳的执行RPC. 因为程序避免了字面的的参数, 使用特殊的参数来调用存储过程, JDBC驱动能最好以RPC方式直接来执行存储过程. SQL语言上的处理在这里被避免并且执行也得到很大的改善.
CallableStatement cstmt – conn.prepareCall (
“{call getCustName (?)}”);
cstmt.setLong (1,12345);
ResultSet rs = cstmt.executeQuery();
使用Statement而不是PreparedStatement对象
JDBC 驱动的最佳化是基于使用的是什么功能. 选择PreparedStatement还是Statement取决于你要怎么使用它们. 对于只执行一次的SQL语句选择Statement是最好的. 相反, 如果SQL语句被多次执行选用PreparedStatement是最好的.
PreparedStatement 的第一次执行消耗是很高的. 它的性能体现在后面的重复执行. 例如, 假设我使用Employee ID, 使用prepared的方式来执行一个针对Employee表的查询. JDBC驱动会发送一个网络请求到数据解析和优化这个查询. 而执行时会产生另一个网络请求. 在JDBC驱动中，减少网络通讯是最终的目的. 如果我的程序在运行期间只需要一次请求, 那么就使用Statement. 对于Statement, 同一个查询只会产生一次网络到数据库的通讯.
对于使用 PreparedStatement池的情况下, 本指导原则有点复杂. 当使用PreparedStatement池时, 如果一个查询很特殊, 并且不太会再次执行到, 那么可以使用Statement. 如果一个查询很少会被执行,但连接池中的Statement池可能被再次执行, 那么请使用PreparedStatement. 在不是Statement池的同样情况下, 请使用Statement.
使用PreparedStatement的Batch功能
Update 大量的数据时, 先Prepare一个INSERT语句再多次的执行, 会导致很多次的网络连接. 要减少JDBC的调用次数改善性能, 你可以使用PreparedStatement的AddBatch()方法一次性发送多个查询给数据库. 例如, 让我们来比较一下下面的例子.
例 1: 多次执行Prepared Statement
PreparedStatement ps = conn.prepareStatement(
“INSERT into employees values (?, ?, ?)”);
for (n = 0; n < 100; n++) {
ps.setString(name[n]);
ps.setLong(id[n]);
ps.setInt(salary[n]);
ps.executeUpdate();
}
例 2: 使用Batch
PreparedStatement ps = conn.prepareStatement(
“INSERT into employees values (?, ?, ?)”);
for (n = 0; n < 100; n++) {
ps.setString(name[n]);
ps.setLong(id[n]);
ps.setInt(salary[n]);
ps.addBatch();
}
ps.executeBatch();
在 例 1中, PreparedStatement被用来多次执行INSERT语句. 在这里, 执行了100次INSERT操作, 共有101次网络往返. 其中,1次往返是预储statement, 另外100次往返执行每个迭代. 在例2中, 当在100次INSERT操作中使用addBatch()方法时, 只有两次网络往返. 1次往返是预储statement, 另一次是执行batch命令. 虽然Batch命令会用到更多的数据库的CPU周期, 但是通过减少网络往返，性能得到提高. 记住, JDBC的性能最大的增进是减少JDBC驱动与数据库之间的网络通讯.
选择合适的光标类型
选择适用的光标类型以最大限度的适用你的应用程序. 本节主要讨论三种光标类型的性能问题.
对于从一个表中顺序读取所有记录的情况来说, Forward-Only型的光标提供了最好的性能. 获取表中的数据时, 没有哪种方法比使用Forward-Only型的光标更快. 但不管怎样, 当程序中必须按无次序的方式处理数据行时, 这种光标就无法使用了.
对 于程序中要求与数据库的数据同步以及要能够在结果集中前后移动光标, 使用JDBC的Scroll-Insensitive型光标是较理想的选择. 此类型的光标在第一次请求时就获取了所有的数据(当JDBC驱动采用’lazy’方式获取数据时或许是很多的而不是全部的数据)并且储存在客户端. 因此, 第一次请求会非常慢, 特别是请求长数据时会理严重. 而接下来的请求并不会造成任何网络往返(当使用’lazy’方法时或许只是有限的网络交通) 并且处理起来很快. 因为第一次请求速度很慢, Scroll-Insensitive型光标不应该被使用在单行数据的获取上. 当有要返回长数据时, 开发者也应避免使用Scroll-Insensitive型光标, 因为这样可能会造成内存耗尽. 有些Scroll-Insensitive型光标的实现方式是在数据库的临时表中缓存数据来避免性能问题, 但多数还是将数据缓存在应用程序中.
Scroll -Sensitive型光标, 有时也称为Keyset-Driven光标, 使用标识符, 像数据库的ROWID之类. 当每次在结果集移动光标时, 会重新该标识符的数据. 因为每次请求都会有网络往返, 性能可能会很慢. 无论怎样, 用无序方式的返回结果行对性能的改善是没有帮助的.
现 在来解释一下这个, 来看这种情况. 一个程序要正常的返回1000行数据到程序中. 在执行时或者第一行被请求时, JDBC驱动不会执行程序提供的SELECT语句. 相反, 它会用键标识符来替换SELECT查询, 例如, ROWID. 然后修改过的查询都会被驱动程序执行，跟着会从数据库获取所有1000个键值. 每一次对一行结果的请求都会使JDBC驱动直接从本地缓存中找到相应的键值, 然后构造一个包含了’WHERE ROWID=？’子句的最佳化查询, 再接着执行这个修改过的查询, 最后从服务器取得该数据行.
当程序无法像Scroll-Insensitive型光标一样提供足够缓存时, Scroll-Sensitive型光标可以被替代用来作为动态的可滚动的光标.
使用有效的getter方法
JDBC 提供多种方法从ResultSet中取得数据, 像getInt(), getString(), 和getObject()等等. 而getObject()方法是最泛化了的, 提供了最差的性能。 这是因为JDBC驱动必须对要取得的值的类型作额外的处理以映射为特定的对象. 所以就对特定的数据类型使用相应的方法.
要更进一步的改善性能, 应在取得数据时提供字段的索引号, 例如, getString(1), getLong(2), 和getInt(3)等来替代字段名. 如果没有指定字段索引号, 网络交通不会受影响, 但会使转换和查找的成本增加. 例如, 假设你使用getString(“foo”) … JDBC驱动可能会将字段名转为大写(如果需要), 并且在到字段名列表中逐个比较来找到”foo”字段. 如果可以, 直接使用字段索引, 将为你节省大量的处理时间.
例如, 假设你有一个100行15列的ResultSet, 字段名不包含在其中. 你感兴趣的是三个字段 EMPLOYEENAME (字串型), EMPLOYEENUMBER (长整型), 和SALARY (整型). 如果你指定getString(“EmployeeName”), getLong(“EmployeeNumber”), 和getInt(“Salary”), 查询旱每个字段名必须被转换为metadata中相对应的大小写, 然后才进行查找. 如果你使用getString(1), getLong(2), 和getInt(15). 性能就会有显著改善.
获取自动生成的键值
有许多数据库提供了隐藏列为表中的每行记录分配一 个唯一键值. 很典型, 在查询中使用这些字段类型是取得记录值的最快的方式, 因为这些隐含列通常反应了数据在磁盘上的物理位置. 在JDBC3.0之前, 应用程序只可在插入数据后通过立即执行一个SELECT语句来取得隐含列的值.
例如:
//插入行
int rowcount = stmt.executeUpdate (
“insert into LocalGeniusList (name) values (‘Karen’)”);
// 现在为新插入的行取得磁盘位置 – rowid
ResultSet rs = stmt.executeQuery (
“select rowid from LocalGeniusList where name = ‘Karen’”);
这 种取得隐含列的方式有两个主要缺点. 第一, 取得隐含列是在一个独立的查询中, 它要透过网络送到服务器后再执行. 第二, 因为不是主键, 查询条件可能不是表中的唯一性ID. 在后面一个例子中, 可能返回了多个隐含列的值, 程序无法知道哪个是最后插入的行的值.
(译者：由于不同的数据库支持的程度不同，返回rowid的方式各有差异。在SQL Server中，返回最后插入的记录的id可以用这样的查询语句：SELECT @IDENTITY )
JDBC3.0规范中的一个可选特性提供了一种能力, 可以取得刚刚插入到表中的记录的自动生成的键值.
例如:
int rowcount = stmt.executeUpdate (
“insert into LocalGeniusList (name) values (‘Karen’)”,
// 插入行并返回键值
Statement.RETURN_GENERATED_KEYS);
ResultSet rs = stmt.getGeneratedKeys ();
// 得到生成的键值
现在, 程序中包含了一个唯一性ID, 可以用来作为查询条件来快速的存取数据行, 甚至于表中没有主键的情况也可以.
这种取得自动生成的键值的方式给JDBC的开发者提供了灵活性, 并且使存取数据的性能得到提升.
选择合适的数据类型
接 收和发送某些数据可能代价昂贵. 当你设计一个schema时, 应选择能被最有效地处理的数据类型. 例如, 整型数就比浮点数或实数处理起来要快一些. 浮点数的定义是按照数据库的内部规定的格式, 通常是一种压缩格式. 数据必须被解压和转换到另外种格式, 这样它才能被数据的协议处理.
获取ResultSet
由于数据库系统对可滚动光标的支持有 限, 许多JDBC驱动程序并没有实现可滚动光标. 除非你确信数据库支持可滚动光标的结果集, 否则不要调用rs.last()和rs.getRow()方法去找出数据集的最大行数. 因为JDBC驱动程序模拟了可滚动光标, 调用rs.last()导致了驱动程序透过网络移到了数据集的最后一行. 取而代之, 你可以用ResultSet遍历一次计数或者用SELECT查询的COUNT函数来得到数据行数.
通常情况下，请不要写那种依赖于结果集行数的代码, 因为驱动程序必须获取所有的数据集以便知道查询会返回多少行数据.

1.直接返回List结果集，不包括列名信息

List ls = session.createSQLQuery(querySql).list();

如果当前查询SQL里包括多列，则List里每行存放的是Object数组，如果直接查询的是一列，则每行存放的则直接就是查询的哪一列的数据。
也可以在返回的结果数据里指定每一列的类型

List ls2 = session.createSQLQuery(querySql).addScalar(“column_name”, Hibernate.DATE).list();
这样返回的数据的时候Hiberante就会对返回的数据转换成你指定的数据类型.这个是在3.1版本就支持的操作。

2.返回包括列名信息，可以是数据每行转换成一个Map形式。则KEY对应列名，VALUE对应当前列的值。
实现方法如下：

List ls3 = session.createSQLQuery(querySql).setResultTransformer(Criteria.ALIAS_TO_ENTITY_MAP).list();

这样返回的结果集每行就是Map(key:column,value:columnValue);还可以使用其他的一些Hibernate定义好的 一些ResultTransformer方法的实现类。具体可以参考 org.hibernate.criterion.CriteriaSpecification里定义的一些。
当然列可以实现自己的数据组装方法，只需要实现ResultTransformer接口就行了。
注意：ResultTransformer实现新版本的Hibernate才支持
以上例子说明的两种方法是没有Hibernate的mapping对象的概念。直接和JDBC返回的结果差不多。
如果想支持返回数据为Hibernate的Entity可以具体参考Hibernate参考文档里的 Native SQL查询一章的实现方法。