转自: http://blog.youkuaiyun.com/oxcow/archive/2009/07/12/4341603.aspx
开发环境:
jdk:1.6
IDE:eclipse3.5 wtp
Tomcat:6.0
click包:click-2.1.0-RC1-incubating
开始进行入门级HelloWorld程序。
1、新建web项目click-hello
2、导入包click-2.1.0-RC1-incubating.jar(核心包)、click-extras-2.1.0-RC1- incubating.jar(扩展包)。
3、配置web.xml。添加ClickServlet,代码如下
- < servlet >
- < servlet-name > click-servlet </ servlet-name >
- < servlet-class > org.apache.click.ClickServlet </ servlet-class >
- < load-on-startup > 0 </ load-on-startup >
- </ servlet >
- < servlet-mapping >
- < servlet-name > click-servlet </ servlet-name >
- < url-pattern > *.htm </ url-pattern >
- </ servlet-mapping
目前Click只支持以.htm作为扩展后缀进行拦截。
4、在web.xml同级目录下新建Click配置文件click.xml。如下:
- <? xml version = "1.0" encoding = "UTF-8" standalone = "yes" ?>
- < click-app charset = "UTF-8" >
- </ click-app >
这里目前先不用配置任何信息,在后续完善过程在进行配置。
5、现在开始创建页面类。创建包example.click.hello.page,在该包下创建Java类HelloWorld.代码如下:
- package example.click.hello.page;
- import java.util.Date;
- import org.apache.click.Page;
- @SuppressWarnings ( "serial" )
- public class HelloWorld extends Page {
- //声明一个私有的时间变量。
- private Date time = new Date();
- public HelloWorld() {
- addModel("time" , time); //将该时间变量添加到页面模型map里
- }
- }
6、创建页面helloWorld.htm,这里我们将helloWorld.htm直接放在webRoot下。代码如下:
- <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd" >
- < html >
- < head >
- < meta http-equiv = "Content-Type" content = "text/html; charset=UTF-8" >
- < title > Insert title here </ title >
- </ head >
- < body >
- < h1 > HelloWorld--now time : $time </ h1 >
- </ body >
- </ html >
$time 对应HelloWorld.java、addModel("time", time)中的time
7、修改click.xml文件,确保helloWorld.htm能对应到类HelloWorld.java。在<click- app></click-app>中添加代码
- < click-app charset = "UTF-8" >
- < pages package = "example.click.hello.page" />
- < mode value = "debug" />
- </ click-app >
- <mode value="debug" />声明后台日志的模式是什么,这里设置为debug级别。
- 除此之外还有development (开发模式info)、profile (规范输出模式info)、production (生产模式warn)、trace (跟踪模式)
- pages有属性automapping默认为true该属性将决定是否自动映射除WEB-INF下所有page到相应的类。
8、启动tomcat,在浏览器地址中输入http://localhost:8080/click-demo/helloWorld.htm即可 看到效果。
这里有几点值得注意的地方。
- 如果仅在click.xml中声明包名让Click自己去定位( automapping ="true" ) 页面对应类,则需要注意页面名称跟类名之间的关系。
- 对应规则为:
- change-password.htm => ChangePassword
change_password.htm => ChangePassword
changePassword.htm => ChangePassword
ChangePassword.htm => ChangePassword - customer.htm => CustomerPage
change-password.htm => ChangePasswordPage - 除自动映射外可以强制配置
- < pages package = "example.click.hello.page" >
- < page path = "helloWorld.htm" classname = "HelloWorld" /> </ pages >
- 如果我们将页面helloWorld.htm不直接放在 webRoot下,而是放在page/helloWorld.htm下,那么要想让Click自己知道对应的类,则我们需要将click.xml文件修正 为<pages package="example.click.hello"/>。以此类推如果是放在click/hello/page /hellWorld.htm下,则我们的click.xml文件只需要配置成<pages package="example"/>即可。如果不遵循该规则,则只能在click.xml配置文件中显示声明出来。