The following topics are covered:
|
|
click.xml
Your click.xml file should contain:<?xml version="1.0" encoding="UTF-8"?> <click-app> <pages package="com.quickstart.page"/> </click-app>web.xml
Your web.xml file should contain:<?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>
<html>
<head><meta http-equiv="Refresh" content="0;URL=home.htm"></head>
</html>
This redirect.html file is configured in our web.xml, and any
default requests will be served this file:
When the browser processes the redirect.html it will redirect to the applications home.htm page.
First we define a HomePage class, and ensure the class file is published to our web applications WEB-INF/classes directory:
package com.quickstart.page; import net.sf.click.Page; public class HomePage extends Page { }Next we add a corresponding Home page home.htm in the web root directory:
<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>
Next add a style.css file to your web root directory:
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;
}
You should now have the following web files:
Now if your web application is deployed to the context path quickstart you should now be able to make the request:
http://localhost:8080/quickstart/Your browser should be redirected to your HomePage and you should see your page rendered as:
HomeWelcome to Home page your application starting point.
|
First create a border-template.htm file in the web root directory. In this file include the HTML content:
<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>Now we define a BorderPage class which specifies its template as the new border-template.htm file:
package com.quickstart.page; import net.sf.click.Page; public class BorderPage extends Page { public String getTemplate() { return "border-template.htm"; } }Note we named the template file border-template.htm so that it is not automatically mapped by Click to our BorderPage class.
Now we are going to modify our HomePage class to extend BorderPage and define a title value.
package com.quickstart.page; public class HomePage extends BorderPage { public String title = "Home"; }Next we modify our home.htm to remove the page border and only include the specific Home page content.
<b>Welcome</b> to Home page your application starting point.You should now have the following web files:
Now if you make browser request to your updated home page you should see identical HTML content being rendered.
HomeWelcome to Home page your application starting point.
|
<?xml version="1.0" encoding="UTF-8"?>
<click-app>
<pages package="com.quickstart.page"/>
<mode value="debug"/>
</click-app>
When the Click application starts up it will write out the following logging messages:
[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 modeClick is telling us here that the border-template.htm template is not mapped to any Page class, while the home.htm template is mapped to our HomePage class. We are also informed that Click is running in debug mode.
When making a request to our home page we may get the following output:
[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 msThis is telling us the HTTP request that the ClickServlet received. Then we can see that it is rendering the page path home.htm and template border-template.htm files in 46 milliseconds. Finally we can see that the total time to handle this request was 62 milliseconds
If you need more detailed debugging information change the application mode to trace. Now if we make the browser request:
http://localhost:8080/quickstart/home.htm?user=malcolm&password=secretWe will see the request parameters logged. This can be very handy for debugging form posts.
[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
There is a lot of good code examples and patterns you can lift into your application.
Once the task has been completed you should have a directory structure something like the one below.ant project-quick-start Buildfile: build.xml project-quick-start: [input] Please enter the project name (e.g. quickstart): quickstart [input] Please enter the root package name (e.g. com.quickstart): com.quickstart [input] Please enter the web app context path: [quickstart] quickstart [copy] Copying 37 files to C:\quickstart\WebContent [copy] Copied 15 empty directories to 1 empty directory under C:\quickstart\WebContent [copy] Copying 1 file to C:\quickstart\WebContent\WEB-INF\lib [copy] Copying 1 file to C:\quickstart\WebContent\WEB-INF\lib [copy] Copying 1 file to C:\quickstart\WebContent\WEB-INF\lib [copy] Copying 1 file to C:\quickstart\lib [copy] Copying 1 file to C:\quickstart\ [copy] Copying 1 file to C:\quickstart\ [copy] Copying 11 files to C:\quickstart\src\com\quickstart BUILD SUCCESSFUL Total time: 18 seconds
|
[quickstart] Project root directory | +---[lib] Build time JAR libs directory | +---[src] Java source files directory | +---[WebContent] Web application root directory | | | +---[admin] Admin role pages directory | | | +---[assets] Application static assets directory | | | +---[click] Click static assets directory | | | +---[META-INF] Tomcat context.xml directory | | | +---[user] User role pages directory | | | +---[WEB-INF] Protected Web Inf directory | | | +---[lib] Run time JAR libs directory | +---build.xml Ant build script file | +---README.txt Read Me description file |
<?xml version='1.0' encoding='utf-8'?> <tomcat-users> <role rolename="user"/> <role rolename="admin"/> <user username="user1" password="password" roles="user"/> <user username="admin1" password="password" roles="user,admin"/> </tomcat-users>For other JEE application server you will need to study their specific security configuration.
Next copy the quickstart.war file to the $TOMCAT\webapps directory and login to your application as the user: admin1 / password
|