Click framework 快速入门指南


 
 
本章讨论的是如何快速组建一个web应用程序。只涉及基本的使程序能运行成功的部分, 不涉及IDE的配置。
该快速入门程序包含在Examples文件夹下。

接下去的主题将涵盖:

web应用结构
Jar文件
Welcome File
Home Page
框架模板
日志
入门工程快速生成


web应用结构

首先在你的web程序WEB-INF 目录下添加click.xml 和web.xml 配置文件。
click.xml
你的click.xml应该包含:
Java代码 复制代码
  1. <?xml version="1.0" encoding="UTF-8"?>    
  2. <click-app>    
  3.   
  4.   <pages package="com.quickstart.page"/>   
  5.   
  6. </click-app>    


web.xml
你的web.xml应该包含
Java代码 复制代码
  1. <?xml version="1.0" encoding="UTF-8"?>   
  2. <web-app>   
  3.   
  4.   <servlet>   
  5.     <servlet-name>ClickServlet</servlet-name>   
  6.     <servlet-class>net.sf.click.ClickServlet</servlet-class>   
  7.     <load-on-startup>0</load-on-startup>   
  8.   </servlet>   
  9.      
  10.   <servlet-mapping>   
  11.     <servlet-name>ClickServlet</servlet-name>   
  12.     <url-pattern>*.htm</url-pattern>   
  13.   </servlet-mapping>   
  14.      
  15.   <welcome-file-list>   
  16.     <welcome-file>redirect.html</welcome-file>   
  17.   </welcome-file-list>   
  18.      
  19. </web-app>  
<?xml version="1.0" encoding="UTF-8"?>
<web-app>

  <servlet>
    <servlet-name>ClickServlet</servlet-name>
    <servlet-class>net.sf.click.ClickServlet</servlet-class>
    <load-on-startup>0</load-on-startup>
  </servlet>
  
  <servlet-mapping>
    <servlet-name>ClickServlet</servlet-name>
    <url-pattern>*.htm</url-pattern>
  </servlet-mapping>
  
  <welcome-file-list>
    <welcome-file>redirect.html</welcome-file>
  </welcome-file-list>
  
</web-app>


Jar文件

把如下jar文件添加到你的程序的WEB-INF/lib目录下:
click-1.x.jar
click-extras-1.x.jar

你可以在Click 的dist目录下获得这些文件。

Welcome File

为确保默认的请求被转发到 home page, 我们将在web程序根目录下新建
redirect.html。 文件内容:
Java代码 复制代码
  1. <html>   
  2. <head><meta http-equiv="Refresh" content="0;URL=home.htm"></head>   
  3. </html>    
<html>
<head><meta http-equiv="Refresh" content="0;URL=home.htm"></head>
</html>  


在web.xml中配置redirect.html, 使默认的请求都由该文件来提供服务。
当浏览器执行redirect.html 时, 它将被转发到home.html页面。

Home Page

现在我们准备来添加我们的第一个Click页面来作为我们应用程序的主页。
首先我们定义一个class HomePage , 确保该class文件部署到应用程序
的 WEB-INF/classes 目录 。
Java代码 复制代码
  1. package com.quickstart.page;   
  2.   
  3. import net.sf.click.Page;   
  4.   
  5. public class HomePage extends Page {   
  6.   
  7. }   
package com.quickstart.page;

import net.sf.click.Page;

public class HomePage extends Page {

} 


我们在web主目录下添加相应的主页home.htm 。
Java代码 复制代码
  1. <html>   
  2. <head>   
  3.   <title>Home</title>   
  4.   <link rel="stylesheet" type="text/css" href="style.css" title="Style"/>   
  5. </head>   
  6.   
  7. <body>   
  8.     
  9.   <div id="header">   
  10.     <span id="title">Home</span>   
  11.   </div>   
  12.   
  13.   <div id="container">   
  14.     <b>Welcome</b> to Home page your application starting point.   
  15.   </div>   
  16.     
  17. </body>   
  18. </html>   
<html>
<head>
  <title>Home</title>
  <link rel="stylesheet" type="text/css" href="style.css" title="Style"/>
</head>

<body>
 
  <div id="header">
    <span id="title">Home</span>
  </div>

  <div id="container">
    <b>Welcome</b> to Home page your application starting point.
  </div>
 
</body>
</html> 


在你的主目录下添加 style.css文件
Java代码 复制代码
  1. body {   
  2.     font-family: Arial;   
  3. }   
  4.   
  5. #header {   
  6.     background-color: navy;   
  7. }   
  8.   
  9. #title {   
  10.     color: white;    
  11.     font-size: 18px;   
  12.     font-weight: bolder;   
  13. }   
  14.   
  15. #container {    
  16.     padding-top: 1em;   
  17.     padding-left: 1.5em;   
  18.     position: relative;   
  19.     z-index: 0;   
  20. }   
  21.   
  22. h3.title {   
  23.     margin-top: 0em;   
  24.     margin-bottom: 1em;   
  25. }  
body {
	font-family: Arial;
}

#header {
	background-color: navy;
}

#title {
	color: white; 
	font-size: 18px;
	font-weight: bolder;
}

#container { 
	padding-top: 1em;
	padding-left: 1.5em;
	position: relative;
	z-index: 0;
}

h3.title {
	margin-top: 0em;
	margin-bottom: 1em;
}


现在如果你web应用被部署到quickstart, 你应该能够生成如下请求:
http://localhost:8080/quickstart/
你的浏览器被定位到HomePage , 你应该能看到如下页面:


在这个例子中,Click将对文件home.htm的请求自动映射到HomePage class,
并使用该class来处理请求。

框架模板(Border Template)

现在我们打算建立一个页面框架模板,以便应用程序页面有一个统一的风格。
首先在web根目录下建立文件border-template.htm。 此文件包含如下内容。
Java代码 复制代码
  1. <html>   
  2. <head>   
  3. <title>Click Quickstart - $title</title>   
  4. <link rel="stylesheet" type="text/css" href="$context/assets/style.css" title="Style"/>   
  5. </head>   
  6.   
  7. <body>   
  8.     
  9.   <div id="header">   
  10.     <span class="title">$title</span>   
  11.   </div>   
  12.      
  13.   <div id="container">   
  14.     #parse($path)   
  15.   </div>   
  16.     
  17. </body>   
  18. </html>   
<html>
<head>
<title>Click Quickstart - $title</title>
<link rel="stylesheet" type="text/css" href="$context/assets/style.css" title="Style"/>
</head>

<body>
 
  <div id="header">
    <span class="title">$title</span>
  </div>
  
  <div id="container">
    #parse($path)
  </div>
 
</body>
</html> 

现在我们定义BorderPage 类, 并将border-template.htm 文件指定为他的
模板。

Java代码 复制代码
  1. package com.quickstart.page;   
  2.   
  3. import net.sf.click.Page;   
  4.   
  5. public class BorderPage extends Page {   
  6.   
  7.    public String getTemplate() {   
  8.       return "border-template.htm";   
  9.    }   
  10.   
  11. }  
package com.quickstart.page;

import net.sf.click.Page;

public class BorderPage extends Page {

   public String getTemplate() {
      return "border-template.htm";
   }

}


我们命名模板文件为border-template.htm , 以便它不会自动地被Click映射
我们的BorderPage 类。
现在我们修改HomePage 类, 使其继承自BorderPage , 并定义一个title字段。

Java代码 复制代码
  1. public class HomePage extends BorderPage {   
  2.   
  3.     public String title = "Home";   
  4.   
  5. }   
public class HomePage extends BorderPage {

    public String title = "Home";

} 


修改home.htm, 将页面borber去掉。 home.html内容如下:
Java代码 复制代码
  1. <b>Welcome</b> to Home page your application starting point.   
<b>Welcome</b> to Home page your application starting point. 

修改后的web应用程序文件如下:



现在, 如果你将浏览器请求定位到更新后的页面,你应该能够看到和前面同样的页面。

日志


Click有一些自带的日志功能, 它们可以帮助你显示页面模板何时自动映射到
页面class。 可以在click.xml中添加debug模块来激活debug日志。

Java代码 复制代码
  1. <?xml version="1.0" encoding="UTF-8"?>    
  2. <click-app>    
  3.   
  4.   <pages package="com.quickstart.page"/>   
  5.   
  6.   <mode value="debug"/>   
  7.   
  8. </click-app>    
<?xml version="1.0" encoding="UTF-8"?> 
<click-app> 

  <pages package="com.quickstart.page"/>

  <mode value="debug"/>

</click-app>  


click应用启动的时候,它将打印如下日志信息:
Java代码 复制代码
  1. [Click] [debug] automapped pages:   
  2. [Click] [debug] /border-template.htm -> CLASS NOT FOUND   
  3. [Click] [debug] /home.htm -> com.quickstart.page.HomePage   
  4. [Click] [info ] initialized in debug mode    
[Click] [debug] automapped pages:
[Click] [debug] /border-template.htm -> CLASS NOT FOUND
[Click] [debug] /home.htm -> com.quickstart.page.HomePage
[Click] [info ] initialized in debug mode  

click告诉我们 border-template.htm 模板没有映射到任何page类,但是
home.htm 模板被映射到HomePage 类,我们还可以得出click正运行在debug
模式下。

当向我们的主页发送一个请求时, 我们可以得到如下输出:
Java代码 复制代码
  1. [Click] [debug] GET http://localhost:8080/quickstart/home.htm   
  2. [Click] [info ] renderTemplate: /home.htm,border-template.htm - 46 ms   
  3. [Click] [info ] handleRequest:  /home.htm - 62 ms    
[Click] [debug] GET http://localhost:8080/quickstart/home.htm
[Click] [info ] renderTemplate: /home.htm,border-template.htm - 46 ms
[Click] [info ] handleRequest:  /home.htm - 62 ms  


它告诉我们ClickServlet收到的http请求。然后我们看到绘制页面home.htm
和模板border-template.htm 用掉了41毫秒。最后,我们可以看到处理请求
共用掉了62毫秒。
如果你想获得更多的debuging信息, 你可以将应用模式设置为trace。
现在, 我们向浏览器发送一个请求:
http://localhost:8080/quickstart/home.htm?user=malcolm&password=secret

我们可以看到请求参数被记录下来,这对调试post方式提交的表单很有用处。
Java代码 复制代码
  1. [Click] [debug] GET http://localhost:8080/quickstart/home.htm   
  2. [Click] [trace]    request param: password=secret   
  3. [Click] [trace]    request param: user=malcolm   
  4. [Click] [trace]    invoked: HomePage.<<init>>   
  5. [Click] [trace]    invoked: HomePage.onSecurityCheck() : true  
  6. [Click] [trace]    invoked: HomePage.onInit()   
  7. [Click] [trace]    invoked: HomePage.onGet()   
  8. [Click] [trace]    invoked: HomePage.onRender()   
  9. [Click] [info ]    renderTemplate: /user/home.htm,border-template.htm - 6 ms   
  10. [Click] [trace]    invoked: HomePage.onDestroy()   
  11. [Click] [info ] handleRequest:  /home.htm - 24 ms    
[Click] [debug] GET http://localhost:8080/quickstart/home.htm
[Click] [trace]    request param: password=secret
[Click] [trace]    request param: user=malcolm
[Click] [trace]    invoked: HomePage.<<init>>
[Click] [trace]    invoked: HomePage.onSecurityCheck() : true
[Click] [trace]    invoked: HomePage.onInit()
[Click] [trace]    invoked: HomePage.onGet()
[Click] [trace]    invoked: HomePage.onRender()
[Click] [info ]    renderTemplate: /user/home.htm,border-template.htm - 6 ms
[Click] [trace]    invoked: HomePage.onDestroy()
[Click] [info ] handleRequest:  /home.htm - 24 ms  


  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值