apache Click框架入门
开发环境: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配置文件中显示声明出来。
页:
[1]