初学wicket

转:http://shazhifeng.iteye.com/blog/318688
使用ibatis+wicket+spring开发才想到学一下WICKE，没关系有点基础抓起就学：

1. Wicket组成：A.HTML+A.Java(extends WebPage)+AApplication(extends WebAppliction)，AApplication对象在系统中主要管理相关信息的配置，主要方法是public Class getHomePage(){return A.class;}
2. 通常情况下,Model是被用来为控件提供数据，控件只处理显示内容，而Model通过各种方式来提供所要显示的内容，这样 Model与控件就不存在耦合
3. web.xml配置Web程序:
<servlet>
    <servlet-name>SomeApplication</servlet-name>
    <servlet-class>wicket.protocol.http.WicketServlet</servlet-class>
    <init-param>
     <param-name>applicationClassName</param-name>
     <param-value>AApplicationpath.AApplication</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>SomeApplication</servlet-name>
    <url-pattern>/somepath/*</url-pattern>
</servlet-mapping>
4. Html和Java文件放在同一个Java包下面，名称也一定要相同，否则Wicket找不到相应的模板
5.    Wicket控件是以Component为根的，它作为一个控制类解析Html文件以形成试图，并将Model中的数据正确的放入视图然后生成Html，最终输出到客户端.
6. Wicket如何调用Listener：
1） 有状态的URL：从一个Wicket页面转到另一个Wicket页面，此时原有的Wicket页面上的控件及相关信息都已经保存在Session中了，可以根据相应的参数从Session中取得Listener实例对象，进而调用相应的方法来完成工作，Url如下：
/context/?param1=value1&wicket:interface=<pageMap>:<pageId>:<version>
2） 无状态的URL：通过地址栏的一个链接URL来访问一个Wicket程序，信息并没有保存在Session中，要通过URL传入的参数来处理请求，如下：
/context/?wicket:bookmarkablePage=mypackage.MyClassName&param1=value1& wicket:interface=<componentPath>:<listerInterface>，根据这个信息来转向 相应的页面，再根据指明的componentPath来找到相应的控件，而litenerInterface则是指定了一个接口，该接口中所第一的那个无 参方法将会被调用
7. applicationClassName 是一个Wicket 提供的WebApplication 子类的类名全称。每一个WicketServlet 都需要一个该参数，这样在接到请求后，会将相应的请求转交给这个指定的类。然后由这个Application 真正的处理用户请求，WicketServlet 并不处理具体的用户请求，而是作为一个前端的Facade，负责分发用户请求。
8. wicket的状态管理：
默认情况下，为了方便管理状态，Wicket 提供了一个ISessionStore，并为其提供了一个默认实现HttpSessionStore，用来将控件的相关信息以及Model 保存在HttpSession 中，这样可以有效的对状态进行管理。
      当用户对一个Wicket 应用程序发出请求，并要求回复一个Html 页面的时候，Wicket程序会按照预先的配置找到相应的Page，再使用该Page 输出Html 信息，此时该Page 对象会被放入一个PageMap，成为一个有状态的被管理对象。而这个PageMap 就会通过ISessionStore 被保存起来（默认情况是被保存到HttpSession 中）。PageMap 中放置的对象并不是无限的，必须进行数据更新，移除一些不必要的Page 对象，这样可以保证不占用过多的内存。Wicket 提供了一个PageMap 的管理策略接口
wicket.session.pagemap.IPageMapEvictionStrategy，可以通过这个接口来配置PageMap的数据更新， 可以通过WebApplication 的getSessionSetting来取得和设置这个策略的实现，而Wicket 则提供了一个按照最近使用原则更新数据的默认策略。在程序默认的配置下，PageMap中可以存放5个Page，可以通过重新设置策略来调整 PageMap 的容量。
9. wicket基本控件：
1）信息输出控件
（1）单行信息输出控件Label
Label 是一个用来在网页上显示文字的控件，与通常C/S 程序中的Label 是一样的功能。如果表现在网页上，通常是使用<span>或者是<label>标签来声明这样一个控件。然后在Java 代码中使用相应的代码操作Label 控件。
Label label =new Label("birthday","<span>message</span>");
label.setEscapeModelStrings(falsefalsefalse);//取消语义转义
Label label =new Label("birthday","<span>message</span>");
label.setEscapeModelStrings(false);
（2）多行信息输出控件MutlineLabel
MultiLineLabel 的使用方法和Label 是一样的，两者其实没有太大的区别，只不过它可以将"\n"这种换行符号转换成<BR>从而实现换行。因为在Html 页面中，只认识<BR>。

2） 控件容器
（1）容器面板WebMarkupContainer
WebMarkupContainer 继承自MarkupContainer，表明自身是一个可以容纳其它Wicket控件的Wicket 控件容器，它不需要一个HTML文件作为模板，所以可以直接在声明后使用。通常可以将同一类型的信息包含在一个WebMarkupContainer中， 如果有必要的话，只需要掩藏这个WebMarkupContainer，就可以隐藏所有的控件了 WebMarkupContainerWebMarkupContainer
WebMarkUpContaier container= new WebMarkUpContaier("container");
this.add(container);
container.add(newLabel("birthday","2006-09-09"));

（2）合面板Panel
Panel 继承自WebMarkupContainerWithAssociatedMarkup，而非WebMarkupConta除了表明自身是一个可以容纳其 它Wicket 控件的Wicket 控件容器，另外也表示它需个相应的Html 文件来描述相应的控件。因此WebMarkUpContaier 作一个功能控件而出现（它不需要一个相应的Html）Panel 主要是作为一个基类出现，可以用来定义相应的Wicket 控件以及它们的布局，Panel可以实例化

（3）边框控件Border
其实Border在很大程度上与WebMarkupContainer没有任何区别，从字面上理解Border主要可以为一组控件提供边界显示， Wicket 小组要提供这个Border 控件也许是为了支持Swing吧。它继承自WebMarkupContainerWithAssociatedMarkup，与Panel 相似，需要相应的Html 文件。
Border border=new BoxBorder("border");
this.add(border);
border.add(new Label("birthday","2006-09-09"));

（4）包含控件Include
如果有几个页面都包含了相同的Html 代码，那么可以考虑将这些Html 代码放置在一个独立的Html 文件中，然后使用Include 控件包含这个Html 文件，Include 控件与Jsp中的Include 功能差不多，只过Jsp包含的include 是可以使用动态的Jsp 文件，而Wicket 的include 则只能使用静态的Html 文件。
this.add(new Include("include","common.Html"));

3）超链接控件
（1）普通链接控件Link
Wicket中的Link，不仅仅是可以链接到Wicket程序内部的页面，而且还是一个容器，可以包含Label，Image 等信息，点击Link 中的所有内容都会触发Link的链接事件。
Link点击后，在服务器端可以通过onClick 来捕获点击事件，用来进行业务处理，如计数器等，还可以通过setResponsePage(new MyPage(obj.getId(), ...))进行页面转向。不过如果仅仅是进行页面转向，建议使用PageLink来进行页面转向，会更加方便和灵活。
Link link =new Link("link") {
public void onClick() {
count++;
}
};
（2）外部链接控件ExternalLink
Wicket 不仅仅支持程序内部的链接，而且还支持对外部的链接。通过使用
ExternalLink这个控件，方便地连接到外部网站，这样的功能在做友情链接，或者商务合作时，是非常有用的。
this.add(new ExternalLink("externalLink","http://www.sina.com.cn","新浪"));

（3）页面链接控件PageLink
在Wicket应用程序中，每一个链接最终指向的都是一个WebPage的实例。所以如果仅仅页面转向，建议使用PageLink。
add(new PageLink("pageLink",new IPageLink() {
public Page getPage() {
return new MyPage();
}
public Class getPageIdentity() {
return MyPage.class;
}
}));
（4）书签链接控件BookmarkablePageLink
事实上每一个Application 都可以拥有多个WebPage，但只能有一个默认的WebPage。Wicket 通过Bookmark（书签）使一个Application能访问多个WebPage。
PageParameters parameters =new PageParameters();
parameters.put("message","放置参数");
this.add(newnewnew BookmarkablePageLink("pageLink",LinkPage.class,parameters));

（5）文件下载链接DownloadLink
文件下载链接分成两种，一种是静态的，如在网络目录下的文件，用户可以直接访问该文件，还有一种是动态的内容，比如为了安全，文件存放在用户不可见的本地 目录中。前者可以直接在链接中写入地址，方便用户下载，而后者，则要通过流的方式来写回客户端以实现下载。Wicket 提供了一个 DownloadLink 的链接控件来处理后者，方便程序员开发此类应用。
File file=File.createTempFile("new",".txt");
this.add(new DownloadLink("downloadLink",file));

（6）弹出窗口设置PopupSetting
其实弹出窗口并不是一个确定的控件，它是通过一个PopupSettting 的配置类来描述弹出窗口的信息，然后在客户端的浏览器上生成相应的JavaScript 代码，然后点击该连接的时候，会弹出一个由配置指定信息的窗口
BookmarkablePageLink popupLink =new BookmarkablePageLink("popupLink",SmartLinkPage.class);
PopupSettings popupSettings =new PopupSettings();
popupSettings.setHeight(400);
popupSettings.setWidth(400);
popupLink.setPopupSettings(popupSettings);

html中的設置
<html>
    <body>
      <a wicket:id ="popupLink">彈出窗口</a>
    </body>
</html>

4）表单输入控件
（1）表单控件Form
Form 控件封装了Html 的Form标签，它不仅可以将服务端的信息显示成客户端Html代码，而且还可以对客户端提交的数据进行验证。一个表单被提交以后，会调用Form 对象实例的onSubmit 方法来进行业务处理，但在
该方法被调用以前，Wicket还会进行一些额外的处理，包括数据验证，更新Model中的数据。如果用户指定了使用Cookie，可能还会更新 Cookie 中的内容，最后才会调用这个onSubmit 方法，也就是说只有在所有的数据都被验证通过以后，而且相应上下文环境被正确设置以后，onSubmit 才会被调用，不会形成脏数据。
Form form=new Form("form") {
protected void onSubmit() {
// 这里用来进行Form提交后的业务处理
}
};
form.add(...);
// 在这里添加表单中的输入控件
this.add(form);
（2）信息输出控件FeedbackPanel
表单在被提交以后，通常需要验证信息，并根据错误类型输出错误信息，方便用户正确输入数据。为了输出错误信息，Wicket 提供了一个FeedbackPanel 控件来处理相关的信息。它其实并不是Form的一部分，只不过它主要被Form所使用，所以也将它放在这里进行说明。
this.add(new FeedbackPanel("feedback"));
Form form=new Form("form") {
protectedvoid onSubmit() {
info("the formwas submitted!");
// 这里用来在FeedbackPanel输出信息
}
};
form.add(...)
// 在这里添加表单中的输入控件
this.add(form);

（3）Button控件
Form 必须在提交以后，才能向服务器端进行数据传输（可以直接使用<input
type="submit" value="submit">)。如果想使用更灵活的方式来提交表单，Wicket 也提供了对Button 的支持，而且Wicket 的Button并不仅仅只是用来提交表单数据，还可以完成更多的功能，象Link等，事实上，当点击了一个Form 中的Button以后，它会先提交数据，由Form 来调用
onSubmit 方法处理数据，然后再根据相关的参数来调用指定Button 的onSubmit 事件。这个转换操作是通过Form 的delegateSubmit 方法来进行处理的，如果想修改这一个逻辑处理，就重载这个方法。Wicket 的Button 中另外提供了一个setDefaultFormProcessing(boolean)方法。默认值为true，也就是在默认情况下，会先调用Form 的onSubmit 方法，然后才调用Button自身的onSubmit 方法。
Button button2 =new Button("button2") {
protected void onSubmit() {
info("button2.onSubmit executed");
}
};
button2.setDefaultFormProcessing(false);

（4）图片按钮ImageButton
ImageButton与Button并没有什么质的区别，只是显示的不是文字而是图片而已，它的事件调用与Button 相同，而其它的内容可以参考Image。

（5）提交链接SubmitLink
在Html 页面中，提交表单很多时候不一定要通过Button来提交，可能是通过JavaScript 来提交Form。所以Wicket提供了一个SubmitLink控件，它同样可以提交一个表单，它的特点在于，这个控件可以放置在表单的内部，也可以放 置在表单的外部，这样就更加灵活了。如果在一个表单的外部来使用一个SubmitLink，为这个SubmitLink 指定它要提交的Form，在内部使用时就不需要指定Form，但要将这个链接加入到Form 中。
Form form=new Form("form");
add(form);
SubmitLink internal =new SubmitLink("internal");
form.add(internal);
// 这里在Form的内部添加一个Link
SubmitLink external =new SubmitLink("external",form);
add(external);
// 这里在Form的外部添加一个Link

（6）输入文本控件TextField
TextField 对应着Html 上的<input type="text">，用户可以通过该控件输入数据。
Form form=new Form("form");
this.add(form);
form.add(new TextField("text"));
form.add(new TextField("integer",Integer.class));

（7）支持数据必填的文本控件RequiredTextField
其实这个控件与TextField 并没有什么大的区别，只不过它在内部初始化的时候就自动添加了一个RequiredValidator，能够自动验证相应的数据不为空。之所以提供这样一 个类，主要还是方便程序员处理一些简单的数据验证，也可以通过调用TextField 的setRequired(true)来实现这个功能。

（8）密码输入控件PasswordTextField
PasswordTextField 对应着Html上的<input type="password">，用户可以通过该控件显示或者填写密码信息。
（9）多行输入文本控件TextArea
TextArea 对应着Html 上的<textarea>，用户可以通过该控件显示或者填写多行文本信息。
（10）选择框控件CheckBox
Checkbox 对应着Html 上的<input type="Checkbox">，可以通过该控件显示选择框。
（11）多选框控件CheckBoxMultipleChoice
事实上，选择框通常是多个出现，而不是单独出现，允许用户选择多个元素，所以Wicket 提供了个多选框控件来支持多个元素的选择。CheckBoxMultipleChoice 提供了一个IChoiceRender 接口，用来输出要显示的文字，你可以实现这样一个接口，来定制特定的文字信息。
（12）增强的多选框控件
在编写Web程序的时候，通常会使用表格来输出一个数据列表，并为每一行都提供了一个选择框，而且为了方便用户进行操作，通常还会提供一个选择框进行全选/取消全选的操作。为了方便此类程序的开发，Wicket 提供了一个增强的多选框。基本使用方法:
首先使用一个CheckGroup来包含所有要全选/取消全选的CheckBox，然后再使用CheckGroupSelector 对Group中所有的CheckBox 进行客户端的全选/取消全选。
（13）下拉框控件DropDownChoice
（14）单选列表框控件ListChoice
（15）多选列表框控件ListMultipleChoice
（16）单选组合框控件RadioChoice
（17）图像控件Image
Wicket 所提供的Image 控件功能非常强大，不仅可以显示一个静态的图像，还可以在服务器端生成动态图像显示在客户端。这样就为图表的显示提供了方便的处理。使用静态图像必须提供 一个已有的图像文件，而使用动态图像则只需要重载一个renderer 方法以动态输出图像。
this.add(new Image("static","test.gif"));
//在当前目录下放置一个test.gif文件
add(new Image("dynamic",new RenderedDynamicImageResource(100, 100){
protected nboolean render(Graphics2D graphics) {
graphics.drawString("测试",10,10);
return true;}
}));
（18）文件上传控件FileUploadField
文件上传是开发Web程序的一个难点，通常要利用各种组件，如Jakarta 提供的commons-upload 来上传文件。
Wicket 提供了一个更加容易使用的文件上传控件。
final FileUploadField fileUploadField =new FileUploadField("image");
Form form=new Form("form") {
protected void onSubmit() {
final FileUpload upload =fileUploadField.getFileUpload();
if (upload !=null) {
try {
upload.writeTo(new File("d:\\1.txt"));
} catch (IOException e) {
e.printStackTrace();
}
}
super.onSubmit();
}
};
form.add(fileUploadField);
form.setMultiPart(true);
// 在Wicket中使用文件上传控件
// 还要记住一定要调用setMultiPart(true)这个方法来允许文件上传
form.setMaxSize(Bytes.kilobytes(1000));
// 如果你有文件大小的限制，通过setMaxSize来设置数值。

5）.数据列表控件
Wicket提供了一个普通的数据列表控件ListView 和支持数据分页的列表控件PageableListView。
（1）简单的数据分页控件ListView
ListView 与我们前面使用的控件有很大的不同，一是因为它本身是控件容器，能够支持子控件；二是它的子控件是通过循环来加入的；第三就是它的子控件会具有相同的名 称，从逻辑上来讲是相等的。所以它提供了一个populateItem 抽象方法，用户通过重载这个方法来循环加入子控件。ListView 可以与任何控件一起组合使用，通常是与表格一同出现，这是因为表格可以逐行处理数据。
（2）支持数据分页的列表控件PageableListView
大部分情况下，要显示的数据不会只有几条，而是成千上万条数据，难道要在一个页面上同时显示这么多数据吗?Wicket 提供了一个PageableListView，它支持数据分页处理另外为支持分页操作，它一般是与PagingNavigator 一起使用，后者为它来提供"上一页","下一页"等分页操作。
6）日历控件DatePicker
DatePicker 并不能单独存在，它除了自己以外，还需要一个TextField，它只是显示一张图片，用户在点击这张图片以后，会使用JavaScript 弹出一个日期选择框，允许用户选择一个日期，然后将用户选择的日期填充到预先设定的TextField 中。
TextField dateField =new TextField("dateField",Date.class);
this.add(dateField);
this.add(new DatePicker("dateFieldPicker",dateField));
// 在DatePicker的构造函数，要传递一个TextField给它，
// 这样，它才可以将选择的数据正确的填充到文本框中。

10. 为控件添加Css 和JavaScript
在Html 模板中通过<wicket:head>来添加CSS 样式信息
在Java代码中通过AttributeModifier添加样式表:::

11. Wicket的 Html标签
wicket:id，<wicket:message>，<wicket:remove>，<wicket: link>，<wicket:panel>和<wicket:head>，<wicket:child>和 <wicket:extend>