Servlet Данные формы

Во многих случаях вам нужно передать некоторую информацию из браузера на веб-сервер и в конечном итоге в серверную программу. Браузер использует два метода для передачи этой информации на веб-сервер, а именно метод GET и метод POST.

Метод GET

Метод GET отправляет закодированную информацию пользователя, добавленную к запросу страницы. Страница и закодированная информация разделяются символом ?, как показано ниже:

http://www.test.com/hello?key1=value1&key2=value2

Метод GET — это метод по умолчанию для передачи информации из браузера на веб-сервер. Он создаёт длинную строку, которая отображается в адресной строке браузера. Если вы хотите передать пароли или другую конфиденциальную информацию на сервер, не используйте метод GET. У метода GET есть ограничение по размеру: строка запроса может содержать не более 1024 символов.

Эта информация передаётся с использованием заголовка QUERY_STRING, и к ней можно получить доступ через переменную среды QUERY_STRING. Servlet используетdoGet()метод для обработки этого типа запроса.

Метод POST

Ещё один надёжный способ передачи информации серверной программе — метод POST. Метод POST упаковывает информацию в основном так же, как метод GET, но вместо отправки информации в виде текстовой строки после символа ? в URL он отправляет информацию отдельным сообщением. Сообщение отправляется серверной программе в форме стандартного вывода, и вы можете разобрать и использовать этот стандартный вывод. Сервлет использует метод doPost() для обработки запросов этого типа.

Использование сервлета для чтения данных формы

Сервлет обрабатывает данные формы, и эти данные автоматически разбираются с помощью разных методов в зависимости от ситуации:

  • getParameter():Вы можете вызвать метод request.getParameter(), чтобы получить значение параметра формы.
  • getParameterValues():Если параметр встречается более одного раза, вызовите этот метод, и он вернёт несколько значений, например для флажков.
  • getParameterNames():Если вы хотите получить полный список всех параметров текущего запроса, вызовите этот метод.

Пример использования метода GET с URL

Ниже приведён простой URL, который передаст два значения программе HelloForm с использованием метода GET.

http://localhost:8080/TomcatTest/HelloForm?name=Example&url=www.example.com

Ниже приведена программа-сервлет, которая обрабатывает ввод из веб-браузера.HelloForm.javaМы будем использовать методgetParameter(), чтобы легко получить доступ к переданной информации:

package com.example.test;

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;

/**
 * Servlet implementation class HelloForm
 */
@WebServlet("/HelloForm")
public class HelloForm extends HttpServlet {
    private static final long serialVersionUID = 1L;
       
    /**
     * @see HttpServlet#HttpServlet()
     */
    public HelloForm() {
        super();
        // TODO Auto-generated constructor stub
    }

    /**
     * @see HttpServlet#doGet(HttpServletRequest request, HttpServletResponse response)
     */
    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        // 设置响应内容类型
        response.setContentType("text/html;charset=UTF-8");

        PrintWriter out = response.getWriter();
        String title = "使用 GET 方法读取表单数据";
        // 处理中文
        String name =new String(request.getParameter("name").getBytes("ISO-8859-1"),"UTF-8");
        String docType = "<!DOCTYPE html> \n";
        out.println(docType +
            "<html>\n" +
            "<head><title>" + title + "</title></head>\n" +
            "<body bgcolor=\"#F0F0F0\">\n" +
            "<h1 align=\"center\">" + title + "</h1>\n" +
            "<ul>\n" +
            "  <li><b>站点名</b>:"
            + name + "\n" +
            "  <li><b>网址</b>:"
            + request.getParameter("url") + "\n" +
            "</ul>\n" +
            "</body></html>");
    }
    
    // 处理 POST 方法请求的方法
    public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        doGet(request, response);
    }
}
Затем мы в файлеweb.xmlсоздаём следующую запись:
<?xml version="1.0" encoding="UTF-8"?>
<web-app>
  <servlet>
    <servlet-name>HelloForm</servlet-name>
    <servlet-class>com.example.test.HelloForm</servlet-class>
  </servlet>
  <servlet-mapping>
    <servlet-name>HelloForm</servlet-name>
    <url-pattern>/TomcatTest/HelloForm</url-pattern>
  </servlet-mapping>
</web-app>

Теперь введите следующее в адресную строку браузера:http://localhost:8080/TomcatTest/HelloForm?name=Example&url=www.example.com, и убедитесь, что сервер Tomcat был запущен перед выполнением указанной выше команды. Если всё пройдёт хорошо, вы получите следующий результат:


Пример использования метода GET с формой

Ниже приведён простой пример, в котором используются HTML-форма и кнопка отправки для передачи двух значений. Мы будем использовать тот же Servlet HelloForm для обработки ввода.

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Example(example.com)</title>
</head>
<body>
<form action="HelloForm" method="GET">
网址名:<input type="text" name="name">
<br />
网址:<input type="text" name="url" />
<input type="submit" value="提交" />
</form>
</body>
</html>

Сохраните этот HTML в файл hello.html, структура каталогов выглядит следующим образом:

Попробуйте ввести имя веб-сайта и URL, затем нажмите кнопку "Submit". Демонстрация в формате GIF выглядит следующим образом:


Пример использования метода POST с формой

Давайте внесём небольшое изменение в указанный выше Servlet, чтобы он мог обрабатывать как методы GET, так и POST. Следующая программа ServletHelloForm.javaиспользует методы GET и POST для обработки ввода, переданного веб-браузером.

Примечание: если данные, отправленные формой, содержат китайские символы, требуется преобразование кодировки:

String name =new String(request.getParameter("name").getBytes("ISO8859-1"),"UTF-8");
package com.example.test;

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;

/**
 * Servlet implementation class HelloForm
 */
@WebServlet("/HelloForm")
public class HelloForm extends HttpServlet {
    private static final long serialVersionUID = 1L;
       
    /**
     * @see HttpServlet#HttpServlet()
     */
    public HelloForm() {
        super();
        // TODO Auto-generated constructor stub
    }

    /**
     * @see HttpServlet#doGet(HttpServletRequest request, HttpServletResponse response)
     */
    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        // 设置响应内容类型
        response.setContentType("text/html;charset=UTF-8");

        PrintWriter out = response.getWriter();
        String title = "使用 POST 方法读取表单数据";
        // 处理中文
        String name =new String(request.getParameter("name").getBytes("ISO8859-1"),"UTF-8");
        String docType = "<!DOCTYPE html> \n";
        out.println(docType +
            "<html>\n" +
            "<head><title>" + title + "</title></head>\n" +
            "<body bgcolor=\"#F0F0F0\">\n" +
            "<h1 align=\"center\">" + title + "</h1>\n" +
            "<ul>\n" +
            "  <li><b>站点名</b>:"
            + name + "\n" +
            "  <li><b>网址</b>:"
            + request.getParameter("url") + "\n" +
            "</ul>\n" +
            "</body></html>");
    }
    
    // 处理 POST 方法请求的方法
    public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        doGet(request, response);
    }
}

Теперь скомпилируйте и разверните указанный выше Servlet и протестируйте его с помощью hello.html, используя метод POST, как показано ниже:

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Example(example.com)</title>
</head>
<body>
<form action="HelloForm" method="POST">
网址名:<input type="text" name="name">
<br />
网址:<input type="text" name="url" />
<input type="submit" value="提交" />
</form>
</body>
</html>

Ниже приведён фактический вывод указанной выше формы. Попробуйте ввести имя веб-сайта и URL, затем нажмите кнопку "Submit". Демонстрация в формате GIF выглядит следующим образом:


Передача данных флажков в программу Servlet

Когда нужно выбрать более одного варианта, используйте флажки.

Ниже приведён пример HTML-кода, checkbox.html, форма с двумя флажками.

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Example(example.com)</title>
</head>
<body>
<form action="CheckBox" method="POST" target="_blank">
<input type="checkbox" name="example" checked="checked" /> Example
<input type="checkbox" name="google"  /> Google
<input type="checkbox" name="taobao" checked="checked" /> 淘宝
<input type="submit" value="选择站点" />
</form>
</body>
</html>

Ниже представлена программа сервлета CheckBox.java, которая обрабатывает ввод флажка (checkbox), переданный веб-браузером.

package com.example.test;

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;

/**
 * Servlet implementation class CheckBox
 */
@WebServlet("/CheckBox")
public class CheckBox extends HttpServlet {
    private static final long serialVersionUID = 1L;
    
    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        
        // 设置响应内容类型
        response.setContentType("text/html;charset=UTF-8");

        PrintWriter out = response.getWriter();
        String title = "读取复选框数据";
        String docType = "<!DOCTYPE html> \n";
            out.println(docType +
                "<html>\n" +
                "<head><title>" + title + "</title></head>\n" +
                "<body bgcolor=\"#F0F0F0\">\n" +
                "<h1 align=\"center\">" + title + "</h1>\n" +
                "<ul>\n" +
                "  <li><b>Example按教程标识:</b>: "
                + request.getParameter("example") + "\n" +
                "  <li><b>Google 标识:</b>: "
                + request.getParameter("google") + "\n" +
                "  <li><b>淘宝标识:</b>: "
                + request.getParameter("taobao") + "\n" +
                "</ul>\n" +
                "</body></html>");
    }
    
    // 处理 POST 方法请求的方法
    public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        doGet(request, response);
    }
}

Настройте соответствующий web.xml:

<?xml version="1.0" encoding="UTF-8"?>
<web-app>
  <servlet>
    <servlet-name>CheckBox</servlet-name>
    <servlet-class>com.example.test.CheckBox</servlet-class>
  </servlet>
  <servlet-mapping>
    <servlet-name>CheckBox</servlet-name>
    <url-pattern>/TomcatTest/CheckBox</url-pattern>
  </servlet-mapping>
</web-app>

Приведённый выше пример отобразит следующий результат:


Чтение всех параметров формы

Ниже приведён общий пример, использующий методgetParameterNames()класса HttpServletRequest для чтения всех доступных параметров формы. Этот метод возвращает перечисление, содержащее имена параметров в неопределённом порядке.

Получив перечисление, мы можем перебрать его стандартным способом, используя методhasMoreElements(), чтобы определить, когда остановиться, и используя методnextElement(), чтобы получить имя каждого параметра.

import java.io.IOException;
import java.io.PrintWriter;
import java.util.Enumeration;

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

/**
 * Servlet implementation class ReadParams
 */
@WebServlet("/ReadParams")
public class ReadParams extends HttpServlet {
    private static final long serialVersionUID = 1L;
       
    /**
     * @see HttpServlet#HttpServlet()
     */
    public ReadParams() {
        super();
        // TODO Auto-generated constructor stub
    }

    /**
     * @see HttpServlet#doGet(HttpServletRequest request, HttpServletResponse response)
     */
    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        // 设置响应内容类型
        response.setContentType("text/html;charset=UTF-8");
        PrintWriter out = response.getWriter();
        String title = "读取所有的表单数据";
        String docType =
            "<!doctype html public \"-//w3c//dtd html 4.0 " +
            "transitional//en\">\n";
            out.println(docType +
            "<html>\n" +
            "<head><meta charset=\"utf-8\"><title>" + title + "</title></head>\n" +
            "<body bgcolor=\"#F0F0F0\">\n" +
            "<h1 align=\"center\">" + title + "</h1>\n" +
            "<table width=\"100%\" border=\"1\" align=\"center\">\n" +
            "<tr bgcolor=\"#949494\">\n" +
            "<th>参数名称</th><th>参数值</th>\n"+
            "</tr>\n");

        Enumeration paramNames = request.getParameterNames();

        while(paramNames.hasMoreElements()) {
            String paramName = (String)paramNames.nextElement();
            out.print("<tr><td>" + paramName + "</td>\n");
            String[] paramValues =
            request.getParameterValues(paramName);
            // 读取单个值的数据
            if (paramValues.length == 1) {
                String paramValue = paramValues[0];
                if (paramValue.length() == 0)
                    out.println("<td><i>没有值</i></td>");
                else
                    out.println("<td>" + paramValue + "</td>");
            } else {
                // 读取多个值的数据
                out.println("<td><ul>");
                for(int i=0; i < paramValues.length; i++) {
                out.println("<li>" + paramValues[i]);
            }
                out.println("</ul></td>");
            }
            out.print("</tr>");
        }
        out.println("\n</table>\n</body></html>");
    }

    /**
     * @see HttpServlet#doPost(HttpServletRequest request, HttpServletResponse response)
     */
    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        // TODO Auto-generated method stub
        doGet(request, response);
    }

}

Теперь попробуйте вышеуказанный сервлет со следующей формой:

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Example(example.com)</title>
</head>
<body>

<form action="ReadParams" method="POST" target="_blank">
<input type="checkbox" name="maths" checked="checked" /> 数学
<input type="checkbox" name="physics"  /> 物理
<input type="checkbox" name="chemistry" checked="checked" /> 化学
<input type="submit" value="选择学科" />
</form>

</body>
</html>

Настройте соответствующий web.xml:

<?xml version="1.0" encoding="UTF-8"?>
<web-app>
  <servlet>
    <servlet-name>ReadParams</servlet-name>
    <servlet-class>com.example.test.ReadParams</servlet-class>
  </servlet>
  <servlet-mapping>
    <servlet-name>ReadParams</servlet-name>
    <url-pattern>/TomcatTest/ReadParams</url-pattern>
  </servlet-mapping>
</web-app>

Теперь вызов сервлета с вышеуказанной формой даст следующий результат:

Вы можете попробовать использовать вышеуказанный сервлет для чтения других данных формы, таких как текстовые поля, радиокнопки или раскрывающиеся списки и т. д.

Другие расширения