Spring MVC 标签之checkbox与checkboxes

checkbox标签

这个标签生成一个“checkbox”类型的HTML“input”标签。

让我们假设我们的User有比如新闻订阅和其他一组业余爱好这样的偏好。下面就是一个Preferences类的例子：

public class Preferences {     private boolean receiveNewsletter;     private String[] interests;     private String favouriteWord;     public boolean isReceiveNewsletter() {         return receiveNewsletter;     }     public void setReceiveNewsletter(boolean receiveNewsletter) {         this.receiveNewsletter = receiveNewsletter;     }     public String[] getInterests() {         return interests;     }     public void setInterests(String[] interests) {         this.interests = interests;     }     public String getFavouriteWord() {         return favouriteWord;     }     public void setFavouriteWord(String favouriteWord) {         this.favouriteWord = favouriteWord;     } }

form.jsp如下：

<%-- Approach 1: Property is of type java.lang.Boolean --%>                                                                                                           Subscribe to newsletter?: Interests:                 <%-- Approach 2: Property is of an array or of type java.util.Collection --%>                 Quidditch: <form:checkbox path="preferences.interests" value="Quidditch"/>                 Herbology:                 Defence Against the Dark Arts:                     value="Defence Against the Dark Arts"/>             Favourite Word:                 <%-- Approach 3: Property is of type java.lang.Object --%>                 Magic: <form:checkbox path="preferences.favouriteWord" value="Magic"/>

有三种checkbox标签的使用方法满足你对checkbox的需求。

·        第一种用法：若绑定值是java.lang.Boolean类型，则值为true时，input(checkbox)就标记为选中。其value属性对应于setValue(Object)值的属性的解析值。

·        第二种用法：若绑定值是array或java.util.Collection类型，则当设定的setValue(Object)值出现在绑定的Collection中时，input(checkbox)就标记为选中。

·        第三种用法：若绑定值为其他类型，则当设定的setValue(Object)与其绑定值相等时，input(checkbox)才标记为选中。

 

注意，不管使用哪种方法，生成的HTML结构都是相同的。

下面是包含一些checkbox的HTML片段：

   

   

Interests:	Quidditch:                 Herbology:                 Defence Against the Dark Arts:             value="Defence Against the Dark Arts"/>

也许没有注意到的是在每个checkbox背后还隐藏了其他字段（field）。当一个HTML页面中的checkbox没有被选中时，它的值不会在表单提交时作为HTTP请求参数的一部分发送到服务器端，因此我们需要给这个HTML的奇怪动作想出一个变通方案，来让Spring的表单数据绑定可以工作。checkbox标签遵循了Spring现有的惯例，就是对于每个checkbox都包含了一个下划线（"_"），再跟上一个隐藏参数。这样一来，就相当于告诉Spring“这个checkbox在表单中是可见的，并且希望表单数据将要被绑定到的对象能够反映出任意的checkbox的状态”。

checkboxes 标签

这个标签生成多个“checkbox”类型的HTML“input”标签。

这一节建立在上一节checkbox标签的例子之上。有时倾向于并不在JSP页面中列出全部可能的业余爱好，而是想在运行时提供一个可用选项的清单，并把它传递给相应标签。这就是checkboxes标签的目标。传入一个Array、List，或者Map，并把可用选项包含在“items”属性中。典型的情况是，这个绑定的属性是一个集合，这样它才能持有用户选择的多个值。下面是使用了这个标签的JSP的一个例子：

Interests:                 <%-- Property is of an array or of type java.util.Collection --%>                 path="preferences.interests"items="${interestList}"/>

 

这个例子假定了“interestList”是一个List，作为模型属性它包含了用于被选择的字符串的值。而在使用一个Map的情况下，map条目的键被用作值，map条目的值被用作显示的文本标记。也可以使用一个定制的对象，提供“itemValue”属性存放值，“itemLabel”属性存放文本标记。