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/