本章讨论的是如何快速组建一个web应用程序。只涉及基本的使程序能运行成功的部分, 不涉及IDE的配置。
该快速入门程序包含在Examples文件夹下。
接下去的主题将涵盖:
web应用结构
Jar文件
Welcome File
Home Page
框架模板
日志
入门工程快速生成
web应用结构
首先在你的web程序WEB-INF 目录下添加click.xml 和web.xml 配置文件。
click.xml
你的click.xml应该包含:
- <?xml version="1.0" encoding="UTF-8"?>
- <click-app>
- <pages package="com.quickstart.page"/>
- </click-app>
web.xml
你的web.xml应该包含
- <?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>
<?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。 文件内容:
- <html>
- <head><meta http-equiv="Refresh" content="0;URL=home.htm"></head>
- </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 目录 。
- package com.quickstart.page;
- import net.sf.click.Page;
- public class HomePage extends Page {
- }
package com.quickstart.page; import net.sf.click.Page; public class HomePage extends Page { }
我们在web主目录下添加相应的主页home.htm 。
- <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>
<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文件
- 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;
- }
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。 此文件包含如下内容。
- <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>
<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 文件指定为他的
模板。
- package com.quickstart.page;
- import net.sf.click.Page;
- public class BorderPage extends Page {
- public String getTemplate() {
- return "border-template.htm";
- }
- }
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字段。
- public class HomePage extends BorderPage {
- public String title = "Home";
- }
public class HomePage extends BorderPage { public String title = "Home"; }
修改home.htm, 将页面borber去掉。 home.html内容如下:
- <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日志。
- <?xml version="1.0" encoding="UTF-8"?>
- <click-app>
- <pages package="com.quickstart.page"/>
- <mode value="debug"/>
- </click-app>
<?xml version="1.0" encoding="UTF-8"?> <click-app> <pages package="com.quickstart.page"/> <mode value="debug"/> </click-app>
当click应用启动的时候,它将打印如下日志信息:
- [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] [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
模式下。
当向我们的主页发送一个请求时, 我们可以得到如下输出:
- [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
[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方式提交的表单很有用处。
- [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
[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
Click framework 快速入门指南
最新推荐文章于 2024-07-19 17:37:28 发布