Webアプリケーションを作成するにあたり、ブラウザへの出力ばかりではなく、フォームを使ってユーザー側からの入力を取得する場合がある。ここではその方法について説明する。
フォームデータの取得の仕方
フォームデータとは、Webページに入力されたデータのことである。このデータには様々なものがある。テキストを入力するテキストフィールド、ラジオボタンの選択、リストからの選択データなどである。
テキスト入力フィールドの例を考えてみよう。
サーブレットが入力されたフォームデータを取得するために、クライアントからリクエスト情報が入っているHttpServletRequestオブジェクトに対してgetParameterメソッドを使う。ラジオボタンのデータはリクエスト情報の中にパラメータとして含まれている。このメソッドにテキスト入力フィールドのパラメータの名前（name）を引数として与えることによって入力されたテキスト入力フィールドのデータを取得することができる。
書き方の基本は簡単だ。
HttpServletRequestオブジェクト. getParameter (パラメータの名前);
実際のHTML画面のフォームデータ入力のコードはこうなる。
<input type="text" name="item1">
その値を取得するサーブレット側のコードはこうなる。
String item1 = request.getParameter("item1");
パラメータを取得するAPI仕様
getParameter(java.lang.String name)
|
戻り値の型 |
java.lang.String |
|
内容 |
リクエストのパラメータの値を文字列として戻す。もしパラメータがなければnullを戻す。リクエストパラメータはリクエストともに送られる付加的な情報である。HTTPサーブレットのために、パラメータが参照文字列か送信されたフォームデータに含まれている。 パラメータがただひとつだけの値を持っていることを確かめた時に、このメソッドを使うべきである。もしパラメータがひとつ以上の値を持っているならば、getParameterValues(java.lang.String)を使うべきである。 もし、複数のパラメータで使うならば、戻される値はgetParameterValuesによって返される配列の最初の値である。（更なる詳細は、仕様を参照してください） 引数：指定されたパラメータの名前 戻り値：パラメータのひとつの値を表す文字列。 参照：getParameterValues(java.lang.String) |
フォームデータを取得するサンプルプログラム
このサンプルプログラムは、フォームデータとしてふたつの項目を入力する。そのデータを取得したサーブレットは、入力項目をそのまま項目１と項目２としてレスポンスの画面に表示する。
サーブレットの配置とプログラムのコードは次のようになっている。
最初にHTMLで書かれたフォームデータ入力画面のコードを示す。
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN" "http://www.w3.org/TR/html4/frameset.dtd">
<html lang="ja">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=Shift_JIS">
</head>
<title>フォームデータの取得サンプル</title>
</head>
<body>
<p>ふたつの項目を入力してください。</p>
<form action="/Servlet/ServletGetParameters" method="get">
<p>項目１：<input type="text" name="item1"></p>
<p>項目２：<input type="text" name="item2"></p>
<p><input type="submit" value="入力実行" style="WIDTH: 200px; HEIGHT: 20px"></p>
</form>
<p>
</body>
</html>
次に、HTML画面からリクエストを受け取るサーブレットのコードを示す。
import java.io.IOException;
import java.io.PrintWriter;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
@WebServlet("/ServletFormData")//[1]
public class ServletFormData extends HttpServlet {//[2]
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {//[3]
response.setContentType("text/html; charset=Shift_JIS");//[4]
String item1 = request.getParameter("item1");//[5]
String item2 = request.getParameter("item2");//[6]
PrintWriter out = response.getWriter();//[7]
out.println("<html><head></head><body>");//[8]
out.println("<p>入力された項目を表示します。</p>");//[9]
out.println("<p>入力項目１：" + item1 + "</p>");//[10]
out.println("<p>入力項目２：" + item2 + "</p>");//[11]
out.println("</body></html>");//[12]
}
}
実行結果
ブラウザにURL：http://localhost:8080/Servlet/formdata.htmlを入力し、Enterを押す。
表示されるブラウザ画面：
項目1に「aaa」項目２に「bbb」と入力し、入力実行ボタンを押す。
表示されるブラウザ画面：
サンプルプログラムの説明
それでは簡単にプログラムの解説をしてゆこう。
- [1] アノテーションの宣言をする。
- [2] HttpServletを継承して、ServletFormDataクラスを定義する。
- [3] doGet()メソッドをオーバーライドして定義する。
- [4] Content Typeを設定する。
- [5] 入力されたフォームデータの項目１を取得し、変数item1に代入する。
- [6] 入力されたフォームデータの項目２を取得し、変数item2に代入する。
- [7] HTMLを出力するためのPrintWriterオブジェクトを取得する。
- [8]-[12] PrintWriterオブジェクトに「入力された項目を表示します。」と表示し、続いて項目１の値（変数item1）と項目2（変数item2）の値を表示するHTMLコードを出力する。
まとめ
サンプルプログラムをご覧頂いてもわかる通り、フォームを使って入力されたデータを元に様々な処理を行う事ができる。HTMLとして出力している部分を中心に、自分なりに色々と変更してみよう。
