Spring MVCのチェックボックスとチェックボックスの例
Spring MVCでは、
<form:checkbox/>
はHTMLチェックボックスフィールドをレンダリングするために使用され、チェックボックスの値はJSPページ内にハードコードされています。
<form:checkboxes/>
は複数のチェックボックスのレンダリングに使用されますが、チェックボックスの値は実行時に生成されます。
このチュートリアルでは、レンダリングHTMLチェックボックスフィールドの3つの異なる方法を示します:
1. <form:checkbox/> – 単一のチェックボックス
ブール値を持つ従来の単一チェックボックスを生成します。
public class Customer{
boolean receiveNewsletter;
//...
}
<form:checkbox path="receiveNewsletter"/>
public class Customer{
boolean receiveNewsletter = true;
//...
}
2. <form:checkbox/> – 複数のチェックボックス
複数のチェックボックスを生成し、値をハードコードします。
public class Customer{
String[]favLanguages;
//...
}
<form:checkbox path="favLanguages" value="Java"/>Java <form:checkbox path="favLanguages" value="C++"/>C++ <form:checkbox path="favLanguages" value=".Net"/>.Net
-
デフォルトでチェックされています…
+ “Java”という値のチェックボックスをデフォルトでオンにしたい場合、 ”
favLanguages ** “プロパティを値 “Java”で初期化することができます。例えば :
//SimpleFormController...
@Override
protected Object formBackingObject(HttpServletRequest request)
throws Exception {
Customer cust = new Customer();
cust.setFavLanguages(new String[]{"Java"});
return cust;
}
3. <form:checkboxes/> – 複数のチェックボックス
チェックボックスの値のランタイムリストを生成し、それをSpringのformタグ
<form:checkboxes>
にリンクします。
//SimpleFormController...
protected Map referenceData(HttpServletRequest request) throws Exception {
Map referenceData = new HashMap();
List<String> webFrameworkList = new ArrayList<String>();
webFrameworkList.add("Spring MVC");
webFrameworkList.add("Struts 1");
webFrameworkList.add("Struts 2");
webFrameworkList.add("Apache Wicket");
referenceData.put("webFrameworkList", webFrameworkList);
return referenceData;
}
<form:checkboxes items="${webFrameworkList}" path="favFramework"/>
-
デフォルトでチェック…
“Spring MVC”と “Struts 2″という2つのチェックボックスをデフォルトでチェックする場合は、値 “Spring MVC”と “Struts”を持つ
favFramework ** 2 “となる。例:
//SimpleFormController...
@Override
protected Object formBackingObject(HttpServletRequest request)
throws Exception {
Customer cust = new Customer();
cust.setFavFramework(new String[]{"Spring MVC","Struts 2"});
return cust;
}
-
注意**
<form:checkboxes items="${dynamic-list}" path="property-to-store"/>
複数のチェックボックスの場合、 ”
path
“または ”
property
“の値が ”
チェックボックスの値 – $ \ {dynamic-list}
“のいずれかと等しい限り、一致したチェックボックスは自動的にチェックされます。
完全なチェックボックスの例
完全なSpring MVCチェックボックスの例を考えてみましょう:
1.モデル
チェックボックスの値を格納するための顧客モデルクラス。
File:Customer.java
package com.mkyong.customer.model;
public class Customer{
//checkbox
boolean receiveNewsletter = true;//checked it
String[]favLanguages;
String[]favFramework;
public String[]getFavFramework() {
return favFramework;
}
public void setFavFramework(String[]favFramework) {
this.favFramework = favFramework;
}
public boolean isReceiveNewsletter() {
return receiveNewsletter;
}
public void setReceiveNewsletter(boolean receiveNewsletter) {
this.receiveNewsletter = receiveNewsletter;
}
public String[]getFavLanguages() {
return favLanguages;
}
public void setFavLanguages(String[]favLanguages) {
this.favLanguages = favLanguages;
}
}
2.コントローラー
フォームのチェックボックス値を処理するSimpleFormController。
ファイル:CheckBox Controller.java
package com.mkyong.customer.controller;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.springframework.validation.BindException;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.SimpleFormController;
import com.mkyong.customer.model.Customer;
public class CheckBoxController extends SimpleFormController{
public CheckBoxController(){
setCommandClass(Customer.class);
setCommandName("customerForm");
}
@Override
protected Object formBackingObject(HttpServletRequest request)
throws Exception {
Customer cust = new Customer();
//Make "Spring MVC" and "Struts 2" as default checked value
cust.setFavFramework(new String[]{"Spring MVC","Struts 2"});
//Make "Java" as default checked value
cust.setFavLanguages(new String[]{"Java"});
return cust;
}
@Override
protected ModelAndView onSubmit(HttpServletRequest request,
HttpServletResponse response, Object command, BindException errors)
throws Exception {
Customer customer = (Customer)command;
return new ModelAndView("CustomerSuccess","customer",customer);
}
//Generate the data for web framework multiple checkboxes
protected Map referenceData(HttpServletRequest request) throws Exception {
Map referenceData = new HashMap();
List<String> webFrameworkList = new ArrayList<String>();
webFrameworkList.add("Spring MVC");
webFrameworkList.add("Struts 1");
webFrameworkList.add("Struts 2");
webFrameworkList.add("Apache Wicket");
referenceData.put("webFrameworkList", webFrameworkList);
return referenceData;
}
}
3.バリデーター
シンプルなフォームバリデーターは ”
favLanguages
“プロパティが空でないことを確認します。
File:CheckBoxValidator.java
package com.mkyong.customer.validator;
import org.springframework.validation.Errors;
import org.springframework.validation.Validator;
import com.mkyong.customer.model.Customer;
public class CheckBoxValidator implements Validator{
@Override
public boolean supports(Class clazz) {
//just validate the Customer instances
return Customer.class.isAssignableFrom(clazz);
}
@Override
public void validate(Object target, Errors errors) {
Customer cust = (Customer)target;
if(cust.getFavLanguages().length==0){
errors.rejectValue("favLanguages", "required.favLanguages");
}
}
}
ファイル:message.properties
required.favLanguages = Please select at least a favorite programming language!
4.ビュー
Springのformタグ
<form:checkbox/>
および
<form:checkboxes/>
の使用方法を示すJSPページ。
File:CustomerForm.jsp
<%@ taglib prefix="form" uri="http://www.springframework.org/tags/form"%>
<html>
<head>
<style>
.error {
color: #ff0000;
}
.errorblock {
color: #000;
background-color: #ffEEEE;
border: 3px solid #ff0000;
padding: 8px;
margin: 16px;
}
</style>
</head>
<body>
<h2>Spring's form checkbox example</h2>
<form:form method="POST" commandName="customerForm">
<form:errors path="** " cssClass="errorblock" element="div"/>
<table>
<tr>
<td>Subscribe to newsletter? :</td>
<td><form:checkbox path="receiveNewsletter"/></td>
<td><form:errors path="receiveNewsletter" cssClass="error"/></td>
</tr>
<tr>
<td>Favourite Languages :</td>
<td>
<form:checkbox path="favLanguages" value="Java"/>Java
<form:checkbox path="favLanguages" value="C++"/>C++
<form:checkbox path="favLanguages" value=".Net"/>.Net
</td>
<td><form:errors path="favLanguages" cssClass="error"/>
</td>
</tr>
<tr>
<td>Favourite Web Frameworks :</td>
<td><form:checkboxes items="${webFrameworkList}"
path="favFramework"/></td>
<td><form:errors path="favFramework" cssClass="error"/></td>
</tr>
<tr>
<td colspan="3"><input type="submit"/></td>
</tr>
</table>
</form:form>
</body>
</html>
JSTLを使用して、送信されたチェックボックス値をループして表示します。
File:CustomerSuccess.jsp
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>
<html>
<body>
<h2>Spring's form checkbox example</h2>
Receive Newsletter : ${customer.receiveNewsletter}
<br/>
Favourite Languages :
<c:forEach items="${customer.favLanguages}" var="current">
[<c:out value="${current}"/>] </c:forEach>
<br/>
Favourite Web Frameworks :
<c:forEach items="${customer.favFramework}" var="current">
[<c:out value="${current}"/>] </c:forEach>
<br/>
</body>
</html>
5. Spring Beanの設定
すべてのリンク〜
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-2.5.xsd">
<bean
class="org.springframework.web.servlet.mvc.support.ControllerClassNameHandlerMapping"/>
<bean class="com.mkyong.customer.controller.CheckBoxController">
<property name="formView" value="CustomerForm"/>
<property name="successView" value="CustomerSuccess"/>
<!-- Map a validator -->
<property name="validator">
<bean class="com.mkyong.customer.validator.CheckBoxValidator"/>
</property>
</bean>
<!-- Register the Customer.properties -->
<bean id="messageSource"
class="org.springframework.context.support.ResourceBundleMessageSource">
<property name="basename" value="message"/>
</bean>
<bean id="viewResolver"
class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix">
<value>/WEB-INF/pages/</value>
</property>
<property name="suffix">
<value>.jsp</value>
</property>
</bean>
</beans>
6.デモ
ページにアクセスする –
http://localhost:8080/SpringMVCForm/checkbox.htm
ユーザーがフォームの送信中に言語チェックボックスの値を選択しなかった場合は、エラーメッセージを表示して強調表示します。
フォームが正常に送信された場合は、送信されたチェックボックスの値を表示するだけです。
ソースコードをダウンロードする
ダウンロードする –
SpringMVCForm-CheckBox-Example.zip
（10KB）
参考文献
-
http://tomasjurman.blogspot.com/2009/12/tag-checkboxes-in-spring-mvc.html
-
//struts2/how-to-set-default-value-for-multiple-checkbox-in-struts-2/
