【翻译】Wicket启示录——理论与实践(三)完
接下来，我们再看看EditContact类，把新建联系人的话和编辑联系人也给实现了，开始吧：
public class EditContact extends BasePage {
public EditContact() {
setModel(new CompoundPropertyModel(new LoadableDetachableModel() {
protected Object load() {
return new Contact();
}
}));
init();
}
public EditContact(final Long contactId) {
setModel(new CompoundPropertyModel(new LoadableDetachableModel() {
protected Object load() {
return WicketApplication.get().getContactDao().get(contactId);
}
}));
init();
}
private void init() {
add(new FeedbackPanel("feedback"));
add(new ContactForm("form", getModel()));
}
private class ContactForm extends Form {
public ContactForm(String id, IModel m) {
super(id, m);
TextField firstName = new TextField("firstName");
firstName.setRequired(true);
firstName.add(StringValidator.maximumLength(15));
add(firstName);
TextField lastName = new TextField("lastName");
lastName.setRequired(true);
lastName.add(StringValidator.maximumLength(20));
add(lastName);
TextField email = new TextField("email");
email.add(StringValidator.maximumLength(150));
email.add(EmailAddressValidator.getInstance());
add(email);
TextArea notes = new TextArea("notes");
notes.add(StringValidator.maximumLength(500));
add(notes);
DropDownChoice group = new DropDownChoice("group");
group.setChoices(new AbstractReadOnlyModel() {
public Object getObject() {
List<String> l = new ArrayList<String>(3);
l.add("Friend");
l.add("Co-Worker");
l.add("Nemesis");
return l;
}
});
add(group);
add(new Button("save") {
public void onSubmit() {
Contact c = (Contact) getForm().getModelObject();
WicketApplication.get().getContactDao().save(c);
setResponsePage(ListContacts.class);
}
});
add(new Button("cancel") {
public void onSubmit() {
setResponsePage(ListContacts.class);
}
}.setDefaultFormProcessing(false));
}
}
}
EditContact类的两个构造函数就可以搞定编辑功能。第一个构造函数不带任何参数，目的是用来创建一个新的联系人。即使是新建一个新实体，这里我们仍然可以使用LoadableDetachableModel类来返回一个new Contact。因为当page存储在PageMap中时，LoadableDetachableModel会确保CompoundPropertyModel不去serialize (序列化)一个数据库中不存在的对象。因此，在这里对要新建的对象设置一些默认值是非常不错的选择，比如我们可以对Contact设置一个默认的Group。
第二个构造函数将Contact的主键id作为参数，从数据库读取该对象后，进行相应的编辑操作。构造函数里还调用了init()方法。该方法很简单，加入了一个FeedbackPanel组件，并且将得到的Contact模型绑定到Form上去。FeedbackPanel是Wicket的一个消息反馈组件，比如说如果用户没有输入用户名，那么后台就会将错误信息通过它来显示到前台页面上。用法与其它组件一样，在markup文件标记下：
<span wicket:id="feedback"></span>
任何验证错误信息都可以通过HTML的<span>元素显示出来．你可以反馈你更希望使用什么风格显示你的错误信息，但那是后话了．
看看Contact的firstName属性所对应的TextField组件设置：
TextField firstName = new TextField("firstName");
firstName.setRequired(true);
firstName.add(StringValidator.maximumLength(15));
add(firstName);
看到了吗，我们在这里设置了Contact的firstName属性所对应的TextField输入的字符串长度不能超过15．别的组件也用了类似的验证，原理是一样的．最后还有一个需要注意的组件是DropDownChoice．它专门用来显示HTML的select元素．在我们的例子中，通过使用DropDownChoice的setChoices()方法将我们Contact的group属性列表值显示在HTML上了：
DropDownChoice group = new DropDownChoice("group");
group.setChoices(new AbstractReadOnlyModel() {
public Object getObject() {
List<String> l = new ArrayList<String>(3);
l.add("Friend");
l.add("Co-Worker");
l.add("Nemesis");
return l;
}
});
上面代码中用到的AbstractReadOnlyModel也是IModel的实现之一，将返回的String列表填充到select元素的option中去，生成的HTML片断如下：
<select>
<option value="Friend">Friend</option>
<option value="Co-Worker">Co-Worker</option>
<option value="Nemesis">Nemesis</option>
</select>
上的例子有点简单，其实DropDownChoice在IChoiceRenderer的帮助下，也可以支持很丰富的自定义对象，那么我也演示一下吧：
public class Group {
private String name;
public Group(String name) {
setName(name);
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}
好的，我们将原来的代码改动一下，请注意看下面：
DropDownChoice group = new DropDownChoice("group");
group.setChoices(new AbstractReadOnlyModel() {
public Object getObject() {
List<Group> l = new ArrayList<Group>(3);
l.add(new Group("Friend"));
l.add(new Group("Co-Worker"));
l.add(new Group("Nemesis"));
return l;
}
});
group.setChoiceRenderer(new IChoiceRenderer() {
public Object getDisplayValue(Object o) {
Group g = (Group) o;
return g.getName();
}
public String getIdValue(Object o) {
Group g = (Group) o;
return g.getName();
}
});
IChoiceRenderer接口允许开发人员决定select元素的option中text,value属性分别是什么．如果你先前用过其它web框架的select元素列表，你会发现Wicket做的比其它都要棒。
最后是两个Button组件：
add(new Button("save") {
public void onSubmit() {
Contact c = (Contact) getForm().getModelObject();
WicketApplication.get().getContactDao().save(c);
setResponsePage(ListContacts.class);
}
});
add(new Button("cancel") {
public void onSubmit() {
setResponsePage(ListContacts.class);
}
}.setDefaultFormProcessing(false));
第一个button是用来保存contact模型后跳转到ListContacts页面．第二个button是用来取消对contact模型的编辑，直接跳转回ListContacts页面．两个button的不同之处在于，除了两个不同的onSubmit()行为事件外，还对cancel button调用setDefaultFormProcessing(false)方法，这样当单击cancel button后，不会执行Form体代码，即上述那些验证，更新Contact模型的操作全部跳过，直接返回ListContacts页面．当单击submit button后，Wicket会经过以下几个步骤：
l 进行输入验证
l 如果输入有效，就将输入值更新相应的模型对象．
l 执行onSubmit()方法．
如果你不想处更新型对象，不想进行什么验证．那好，为你的form加上一个cancel button，非常简单，不需要什么复杂的逻辑处理．
EditContact类也看完了，最后再看一遍相应的markup文件．这一回，你再看markup文件，应该不吃力了吧：
<wicket:extend>
<span wicket:id="feedback"></span>
<form wicket:id="form">
<div id="contacts">
<div class="contact">
<table>
<tr>
<td>
First Name
</td>
<td>
<input wicket:id="firstName" type="text"/>
</td>
</tr>
<tr>
<td>
Last Name
</td>
<td>
<input wicket:id="lastName" type="text"/>
</td>
</tr>
<tr>
<td>
Email
</td>
<td>
<input wicket:id="email" type="text" size="40"/>
</td>
</tr>
<tr>
<td>
Notes
</td>
<td>
<textarea wicket:id="notes" rows="4" cols="40"></textarea>
</td>
</tr>
<tr>
<td>
Group
</td>
<td>
<select wicket:id="group"> </select>
</td>
</tr>
<tr>
<td colspan="3" align="center">
<input wicket:id="save" type="submit" value="Save"/>
<input wicket:id="cancel" type="submit" value="Cancel"/>
</td>
</tr>
</table>
</div>
</div>
</form>
</wicket:extend>
wicket:id属性加上HTML元素就可完全符号我们的Wicket组件．用户只要填写form表单，单击save button就可以创建或更新他的联系人；如果想取消的话，单击cancel按钮，就可以放弃所做的修改，回到联系人列表．
这样完整的实例为我们揭示了Apache的Wicket框架．虽然我们谈的比较基础，但所有的一切完全可以应用到你的Wicket web应用程序中去．
总结
文章已经向你介绍了Wicket的核心概念，并且通过一个完整的实例帮助你巩固它们．致使Wicket成功的核心概念其实就是组件和模型．
组件就是独立的Java代码块和与它配对的markup文件．大多数组件被设计成抽象类，你可以扩展相应的子类，来满足你的领域特定逻辑和需求，如上面用到的Page, Panel, Link, Form和ListView都是如此．
模型作为领域对象与Wicket组件之间的桥梁．模型可以有很多特性，可以最大化功能化．理想情况下，你的组件应该永远通过模型来访问你的领域对象．
我希望你们会喜欢这篇文章，并且它使得你愿意研究Wicket的更多细节，我觉得我已经找到了一个非常具备高效生产力的框架．
全文完