7月3日

フォームを使いこなす

練習用に新しいプロジェクトを作成してそこにフォームを作成する。
メニューで[新規]-[プロジェクト]を選択。
ウィザードで[Spring]-[Springプロジェクト]を選択。

プロジェクト名: Forms
テンプレート: Simple Spring Web Maven

「完了」をクリックしてプロジェクトを作成する。

Forms プロジェクトを右クリックし、[Maven]-[プロジェクトの更新]を選択。

プロジェクトの更新が終わったら、もう一度 Forms プロジェクトを右クリックし、[実行]-[Maven install]を選択。

Tomcat7サーバーを右クリックして「追加および除去」を選択。
Formsプロジェクトを選択して右側に移動する。
Tomcat7サーバーを再開し、 http://localhost:8080/Forms/ にアクセスする。

「click to enter」と表示されればOK。

文字化け対策をする

src/main/webapp/Web-INF の下にある web.xl を開く。

前回と同様に、web.xml の最後の </web-app> の手前に以下の内容を追加する。
web.xml

	<filter>
		<filter-name>CharacterEncodingFilter</filter-name>
		<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
		<init-param>
			<param-name>encoding</param-name>
			<param-value>UTF-8</param-value>
		</init-param>
		<init-param>
			<param-name>forceEncoding</param-name>
			<param-value>true</param-value>
		</init-param>
	</filter>
	<filter-mapping>
		<filter-name>CharacterEncodingFilter</filter-name>
		<url-pattern>/*</url-pattern>
	</filter-mapping>

FormModelを作成する

プロジェクトエクスプローラで Forms の下にある Javaリソース を展開し、src/main/java を右クリック。
[新規]-[クラス]を選択する。

新規Javaクラスのダイアログで
パッケージ名: jp.abc
名前: FormModel
を入力し「完了」をクリック。

FormModel クラスが作成されるので、インスタンス変数を追加する。
FormModel.java

package jp.abc;

public class FormModel {
	private String input1;
	private String pass1;
	private String area1;
}

メニューバーで[ソース]-[getterおよびsetterの生成]を選択する。
ダイアログで「すべて選択」をクリックし、挿入ポイントで「最後のメンバー」を選択。
「OK」をクリックすると、getter/setterが生成される。

showMessage.jspの変更

テキストp.204 リスト2-4 のとおりに変更する。
taglib ディレクティブが書かれていないので、テキストp.182を参照して追加する。
showMessage.jsp

<!DOCTYPE html>
<%@ taglib prefix="form" uri="http://www.springframework.org/tags/form" %>
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>

<html>
	<head>
		<meta charset="utf-8">
		<title>${title}</title>
	</head>
	<body>
		<h1>${title}</h1>
		<p>${message}</p>
		<table>
			<form:form modelAttribute="formModel">
				<tr><td><form:input path="input1"/></td></tr>
				<tr><td><form:password path="pass1" showPassword="on"/></td></tr>
				<tr><td><form:textarea path="area1" cols="40" rows="3"></form:textarea></td></tr>
				<tr><td><input type="submit" ></td></tr>
			</form:form>
		</table>
	</body>
</html>

mvc-config.xmlの変更

src/main/webapp/WEB-INF の下にある mvc-config.xml を開く。
context:component-scan タグの部分がコメントアウトされているのを修正し、base-package の部分を jp.abc に書き換えて保存する。

mvc-config.xml

<?xml version="1.0" encoding="UTF-8"?>

<beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns:mvc="http://www.springframework.org/schema/mvc" xmlns:context="http://www.springframework.org/schema/context"
	xsi:schemaLocation="http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd
		http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
		http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">

    <context:component-scan base-package="jp.abc"/>

    <mvc:annotation-driven />

	<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
	        <!-- Example: a logical view name of 'showMessage' is mapped to '/WEB-INF/jsp/showMessage.jsp' -->
	        <property name="prefix" value="/WEB-INF/view/"/>
	        <property name="suffix" value=".jsp"/>
	</bean>

</beans>

Controllerを作成する

Javaリソースの下の src/main/java 内の jp.abc パッケージを右クリックし、[新規]-[クラス]を選択する。
名前に MyAppController を入力して「完了」をクリック。
以下のコードを入力する。

MyAppController.java

package jp.abc;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

@Controller
public class MyAppController {

	@RequestMapping(value = "/helo", method = RequestMethod.GET)
	public String helo(Model model) {
		return "showMessage";
	}
}

Tomcat7サーバーを再起動し、http://localhost:8080/Forms/helo にアクセスする。
と、エラーが発生した。
エラーメッセージを確認すると、formModel がないという感じのメッセージがあるので、MyAppControllerをきちんと実装する。

MyAppController.java

package jp.abc;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

@Controller
public class MyAppController {

	@RequestMapping(value = "/helo", method = RequestMethod.GET)
	public String helo(Model model) {
		model.addAttribute("title", "ModelAndView sample");
		model.addAttribute("message", "これはModelAndViewのテストです。");
		FormModel fm = new FormModel();
		model.addAttribute("formModel", fm);
		return "showMessage";
	}
}

これで http://localhost:8080/Forms/helo にアクセスすると、エラーなく showMessage.jsp が表示されるようになった。

「クエリ送信」ボタンをクリックすると、POSTメソッドがサポートされてないというエラーが表示される。
MyAppController.java に、POSTメソッドを受け付けるためのメソッドを追加する。

MyAppController.java

package jp.abc;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.ModelAttribute;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

@Controller
public class MyAppController {

	@RequestMapping(value = "/helo", method = RequestMethod.GET)
	public String helo(Model model) {
		model.addAttribute("title", "ModelAndView sample");
		model.addAttribute("message", "これはModelAndViewのテストです。");
		FormModel fm = new FormModel();
		model.addAttribute("formModel", fm);
		return "showMessage";
	}

	@RequestMapping(value = "/helo", method = RequestMethod.POST)
	public String form(@ModelAttribute FormModel formModel, Model model){
		String res = "<ul><li>" + formModel.getInput1()
				+ "</li><li>" + formModel.getPass1()
				+ "</li><li>" + formModel.getArea1()
				+ "</li></ul>";
		model.addAttribute("title", "sample");
		model.addAttribute("message", res);
		return "showMessage";
	}
}

チェックボックスの利用

チェックボックスは、<form:checkbox/> タグを使用する。

まずはチェックボックスを使えるようにするために、FormModel にチェックボックス用のフィールドを追加する。

FormModel.java

package jp.abc;

public class FormModel {
	private String input1;
	private String pass1;
	private String area1;
	private boolean check1;

	public String getInput1() {
		return input1;
	}
	public void setInput1(String input1) {
		this.input1 = input1;
	}
	public String getPass1() {
		return pass1;
	}
	public void setPass1(String pass1) {
		this.pass1 = pass1;
	}
	public String getArea1() {
		return area1;
	}
	public void setArea1(String area1) {
		this.area1 = area1;
	}
	public boolean isCheck1() {
		return check1;
	}
	public void setCheck1(boolean check1) {
		this.check1 = check1;
	}
}

アクセスしたときにチェックされた状態にするには、FormModel#setCheck1()でtrueを設定すればよい。

MyAppController.java

	@RequestMapping(value = "/helo", method = RequestMethod.GET)
	public String helo(Model model) {
		model.addAttribute("title", "ModelAndView sample");
		model.addAttribute("message", "これはModelAndViewのテストです。");
		FormModel fm = new FormModel();
		fm.setCheck1(true);
		model.addAttribute("formModel", fm);
		return "showMessage";
	}

チェックボックスの値をクエリ送信後の画面に繁栄させるには、form()メソッドで出力されるコードに&lt:li>要素を追加する。

MyAppController.java

	@RequestMapping(value = "/helo", method = RequestMethod.POST)
	public String form(@ModelAttribute FormModel formModel, Model model){
		String res = "<ul><li>" + formModel.getInput1()
				+ "</li><li>" + formModel.getPass1()
				+ "</li><li>" + formModel.getArea1()
				+ "</li><li>" + formModel.isCheck1()
				+ "</li></ul>";
		model.addAttribute("title", "sample");
		model.addAttribute("message", res);
		return "showMessage";
	}

複数のチェックボックスをまとめて作る

複数のチェックボックスをまとめて作るには、<form:checkboxes>タグを使用する。

まずは FormModel に、複数のチェックボックスの値を格納するためのメンバーを用意する。

FormModel.java

package jp.abc;

public class FormModel {
	private String input1;
	private String pass1;
	private String area1;
	private boolean check1;
	private String[] checks;

	public String getInput1() {
		return input1;
	}
	public void setInput1(String input1) {
		this.input1 = input1;
	}
	public String getPass1() {
		return pass1;
	}
	public void setPass1(String pass1) {
		this.pass1 = pass1;
	}
	public String getArea1() {
		return area1;
	}
	public void setArea1(String area1) {
		this.area1 = area1;
	}
	public boolean isCheck1() {
		return check1;
	}
	public void setCheck1(boolean check1) {
		this.check1 = check1;
	}
	public String[] getChecks() {
		return checks;
	}
	public void setChecks(String[] checks) {
		this.checks = checks;
	}
}

次に showMessage.jsp にチェックボックス用の要素を追加する。
showMessage.jsp

<!DOCTYPE html>
<%@ taglib prefix="form" uri="http://www.springframework.org/tags/form" %>
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>

<html>
	<head>
		<meta charset="utf-8">
		<title>${title}</title>
	</head>
	<body>
		<h1>${title}</h1>
		<p>${message}</p>
		<table>
			<form:form modelAttribute="formModel">
				<tr><td><form:input path="input1"/></td></tr>
				<tr><td><form:password path="pass1" showPassword="on"/></td></tr>
				<tr><td><form:textarea path="area1" cols="40" rows="3"></form:textarea></td></tr>
				<tr><td><form:checkbox path="check1" label="checkbox 1"/></td></tr>
				<tr><td>
					<form:checkboxes items="${checkItems}" path="checks" delimiter=" "/>
				</td></tr>
				<tr><td><input type="submit" ></td></tr>
			</form:form>
		</table>
	</body>
</html>

MyAppControllerに複数のチェックボックス用のコードを追加する

getList()メソッドでチェックボックスの要素を生成する。
生成したListをmodelに設定する。

MyAppController.java

package jp.abc;

import java.util.ArrayList;
import java.util.List;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.ModelAttribute;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

@Controller
public class MyAppController {

	private List<String> getList() {
		List<String> list = new ArrayList<String>();
		list.add("Mac OS X");
		list.add("Windows");
		list.add("Linux");
		return list;
	}

	@RequestMapping(value = "/helo", method = RequestMethod.GET)
	public String helo(Model model) {
		model.addAttribute("title", "ModelAndView sample");
		model.addAttribute("message", "これはModelAndViewのテストです。");
		FormModel fm = new FormModel();
		fm.setCheck1(true);
		fm.setChecks(new String[]{"Windows"});
		model.addAttribute("formModel", fm);
		model.addAttribute("checkItems", getList());
		return "showMessage";
	}

	@RequestMapping(value = "/helo", method = RequestMethod.POST)
	public String form(@ModelAttribute FormModel formModel, Model model){
		String res = "<ul><li>" + formModel.getInput1()
				+ "</li><li>" + formModel.getPass1()
				+ "</li><li>" + formModel.getArea1()
				+ "</li><li>" + formModel.isCheck1()
				+ "</li></ul>";
		model.addAttribute("title", "sample");
		model.addAttribute("message", res);
		return "showMessage";
	}
}

コメントを残す

メールアドレスが公開されることはありません。 * が付いている欄は必須項目です