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的更多细节,我觉得我已经找到了一个非常具备高效生产力的框架.

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章