• 第七章 模板
    • 7.1 模板文件的位置" level="2">7.1 模板文件的位置
    • 7.2 模板参数传递" level="2"> 7.2 模板参数传递
      • 7.2.1 向模板传递返回值" level="3"> 7.2.1 向模板传递返回值
    • 7.3 参考" level="2"> 7.3 参考
    • 7.4 演示项目" level="2"> 7.4 演示项目

    第七章 模板

    目前ActFramework支持的模板引擎:

    注意 如果要使用非Rythm模板引擎需要在pom.xml文件中分别加入响应的依赖:

    Beelt依赖:

    1. <dependency>
    2.     <groupId>org.actframework</groupId>
    3.     <artifactId>act-beetl</artifactId>
    4.     <version>1.0.0</version>
    5. </dependency>

    Freemarker依赖:

    1. <dependency>
    2.     <groupId>org.actframework</groupId>
    3.     <artifactId>act-freemarker</artifactId>
    4.     <version>1.0.1</version>
    5. </dependency>

    Mustache依赖:

    1. <dependency>
    2.     <groupId>org.actframework</groupId>
    3.     <artifactId>act-mustache</artifactId>
    4.     <version>1.0.0</version>
    5. </dependency>

    Thymeleaf依赖:

    1. <dependency>
    2.     <groupId>org.actframework</groupId>
    3.     <artifactId>act-thymeleaf</artifactId>
    4.     <version>1.0.0</version>
    5. </dependency>

    Velocity依赖:

    1. <dependency>
    2.     <groupId>org.actframework</groupId>
    3.     <artifactId>act-velocity</artifactId>
    4.     <version>1.0.0</version>
    5. </dependency>

    7.1 模板文件的位置" class="reference-link">7.1 模板文件的位置

    ActFramework依照以下管理访问模板文件:

    1. /src/main/resources/{template-plugin-id}/{controller-class}/{action-method}.{fmt-suffix}

    假设你的控制器类是

    1. package com.mycom.myprj;
    3. public class MyController {
    5.     @GetAction("/")
    6.     public void home() {
    7.     }
    9.     @GetAction("/foo")
    10.     public Foo getFoo() {
    11.         return Foo.instance();
    12.     }
    13. }

    对应与home()和getFoo()响应方法的两个模板文件分别为:

    1. /src/main/resources/rythm/com/mycom/myprj/MyController/home.html
    2. /src/main/resources/rythm/com/mycom/myprj/MyController/getFoo.html

    如果你的应用需要对发送到/foo的请求支持application/json格式, 你可以创建json格式模板文件如下: 

    1. /src/main/resources/rythm/com/mycom/myprj/MyController/getFoo.json

    7.2 模板参数传递" class="reference-link"> 7.2 模板参数传递

    ActFramework使用ASM对响应方法做了增强，因此你不必像在Spring MVC应用中那样显示指定参数

    一个SpringMVC的响应方法：

    1. public String foo(String a, String b, int c, ModelMap modelMap) {
    2.     modelMap.put("a", a);
    3.     modelMap.put("b", b);
    4.     modelMap.put("c", c);
    5.     modelMap.put("abc", a + b + c);
    6.     return "/path/to/the/template";
    7. }

    用ActFramework重写上面的方法:

    1. public Result foo(String a, String b, int c) {
    2.     String abc = a + b + c;
    3.     return render(a, b, c, abc);
    4. }

    在Rythm引擎中申明参数:

    1. @args String a, String b, int c
    2. <pre>
    3. a = @a
    4. b = @b
    5. c = @c
    6. </pre>

    注意 其他模板不需要参数声明

    7.2.1 向模板传递返回值" class="reference-link"> 7.2.1 向模板传递返回值

    如果你的控制器需要向模板传递函数返回值

    1. public Foo getFoo() {
    2.     return dao.findOne();
    3. }

    在模板中通过result名字来引用返回值:

    1. @args Foo result
    2. Foo is @foo

    7.3 参考" class="reference-link"> 7.3 参考

    7.4 演示项目" class="reference-link"> 7.4 演示项目

    你可以在github或者码云上访问模板引擎演示项目

    该演示项目展示了:

    • 如何在项目中集成多个模板引擎
    • 在开发模式下各个模板引擎对错误显示的支持

    返回目录