表单ajax和servlet

一、前言

对于后端开发来说,经常要和前端进行联系的两个面就是:1、表单form提交至servlet。2、ajax提交至servlet进行处理。

显然,有必要对这两个常用的功能进行一次梳理。

1、一个中文乱码的坑

在表单传值和后台进行交流的时候,一个最大的坑就是中文的乱码问题了。这个坑的具体分析不过多阐述,最佳实践就是: 使用post 方式进行数据的提交,后台设置字符集过滤器,对requestresponse 的字符集都设置为utf-8

2、表单form的enctype字段

HTML表单如何打包数据文件是由enctype这个属性决定的。enctype有以下几种取值:

  • application/x-www-form-urlencoded在发送数据之前,编码所有字符(空格被编码为’+’,特殊字符被编码为ASCII十六进制字符,中文会被编码,英文不会)。此时,数据是以编码后的字符串形式进行传输。
  • multipart/form-data 不对字符编码。在使用包含文件上传控件的表单时,必须使用该值。此时,数据是以二进制流的形式进行传输。
  • text/plain 空格转换为 “+” 加号,但不对特殊字符编码。

默认值是enctype=application/x-www-form-urlencoded,所以表单的内容会按URL规则编码,然后根据表单的提交方法:

  • method="get" ,编码后的表单内容附加在请求连接后
  • method="post" ,编码后的表单内容作为post请求的正文内容

二、使用action 的表单

前端的表单,在填写了数据之后将数据发送给后端进行处理。这里,我们所指的表单意为通过action 字段进行提交,通过ajax 模拟提交的情况放在下一大点中讨论。

而这里的表单又分为2种情况:

  1. 表单form单纯的只有数据项,只提交文本数据,通常是key-value 的形式,对于复选框亦如此。
  2. 表单form既有文本数据项,又有文件数据,即包含<input type="file" ...> 字段。

1、只提交文本数据的表单

例如表单:

<form action="/webapp/formServlet" method="post">
    <input type="text" name="username">
    <!-- 单选框 -->
    <input type="radio" name="sex" value="male">male
    <input type="radio" name="sex" value="female">female
    <!-- 下拉框 -->
    <select name="education">
        <option value="primary">primary</option>
        <option value="middle">middle</option>
        <option value="high">high</option>
    </select>
    <!-- 复选框 -->
    <input type="checkbox" name="hobby" value="basket">basket
    <input type="checkbox" name="hobby" value="tennis">tennis
    <input type="checkbox" name="hobby" value="football">football
    <input type="submit" value="提交">
</form>

在servlet中获取数据:

String username = request.getParameter("username");
String sex = request.getParameter("sex");
String education = request.getParameter("education");
String[] hobby = request.getParameterValues("hobby");

解读

数据编码: 对于纯文本的表单,其字段enctype=application/x-www-form-urlencoded 是默认值,表示表单的数据进行url编码,如:表单的数据被编码成username=123&password=222

传输方式: 数据传输方式method : 如果使用get ,那么该字符串会追加到请求的url地址后面;而如果使用post ,那么打开调试台,查看Form Data 项也可以查看到字符串。

这种表单提交数据的方式最为简单。

2、提交文本数据和文件数据的表单

例如表单:

<form action="/webapp/formServlet" method="post" enctype="multipart/form-data">
    <input type="text" name="username">
    <input type="password" name="password">
    <input type="file" name="file">
    <input type="submit" value="提交">
</form>

在servlet中获取数据以及保存文件:

因为传输过来的是二进制流,因此无法使用getParameter() 等现成的方法来获取值。推荐使用apache upload 框架来进行数据的读取操作。当然,servlet也有原生的方法来获取,参考(https://docs.oracle.com/javaee/7/tutorial/servlets011.htm#BABFGCHB) 、(https://docs.oracle.com/javaee/7/tutorial/servlets016.htm#BABDGFJJ) 。

解读

传输方式: 因为是二进制流, 所以method 只能使用post 进行提交,无法使用get

3、servlet的处理再谈一谈

既然我们在servlet中可以获取到表单传过来的值了,那么我们的返回又应该是什么样的呢?对于使用action 提交的表单,我们的servlet必须将请求转发或者使用重定向,以此进行页面的切换(跳转)。如果想携带新的数据,只能在请求转发的request 对象上进行数据的添加。

请求转发:

request.setAttribute("msg","登录成功!");  // 携带数据
request.getRequestDispatcher("/success.jsp").forward(request,response);

重定向:

response.sendRedirect("/webapp/success.jsp");

解读

很明显,直接使用action 提交是很不好的。因为在提交至servlet时,地址栏的路径会变成指向servlet的路径,而这时候,如果使用请求转发的话,那么地址栏的路径并不会改变,这样就不是很优雅。而如果使用重定向的话,就无法携带数据,对于常见的登录验证(需要错误信息)就无法完成了。另一个缺点就是,无论是请求转发还是重定向,原本填写的表单数据都被清空,这样是极为糟糕的。

表单提交的最常见场景,往往就是用户登录或者是文件上传,这些都需要服务器做出反馈,鉴于上面所说的缺点,我们就不会使用action 的表单,而是使用更为强大ajax技术。

三、使用ajax技术,模拟表单提交

前言:

我们先聊一聊ajax技术,ajax是发起一个http请求,当然可以携带数据,这个数据是以字符串的形式来传输的。当然,这个请求被发送至servlet进行处理,servlet返回处理后的信息,这个信息被ajax的回调函数所接受,然后ajax就可以进行相应的操作了。

当使用ajax时,可以没有表单的存在,因为我们不需要action 了,我们只需要得到要传输的数据即可。同时,对于type="submit" 字段也要小心设置,因为我们其实可以不设置该值,或者在js事件中进行表单提交的判断。

区别:

ajax的过程和表单提交几乎差不多,不同的是:ajax发出的http请求并不是浏览器发出的请求,因此servlet是没有办法影响页面的跳转的 ,所以要想进行页面的跳转只能是ajax的回调函数中进行处理。并且大多数时候,servlet的处理也会返回json 数据至前台。这里的话,就涉及到json 数据的反序列化和java 对象(或者是MapList )的序列化了。

缓存: ajax发出的请求通常会被浏览器缓存,因此我们可以应该拒绝缓存。通常是在url地址后面追加一个随机字符参数,而使用jquery的ajax可以设置cache:false 这个属性就ok了。

jquery的ajax:

因为原生的ajax技术代码较多,因此我们使用jquery封装好的ajax函数来讲解其用法。在jQuery中,$.ajax() 方法属于最底层的方法,第2层是$.load()$.get(),和$.post(),第3层是$.getScript()$.getJSON() 方法。第2、3层都是调用了第1层来实现的。

1、一个提交后页面自动刷新的坑

有时候,在点击提交之后,页面会自动刷新,我们无法查看相关的数据,这是一个大坑。正确的解决方法,使用<input type="button" value="提交" /> 这个按钮来进行事件绑定并提交。当然,这是针对ajax来用的。

2、 仅发送请求至servlet,接收返回数据

当我们不需要发送数据的时候,其实只需要在一个js的事件中使用ajax就可以了,不需要表单。这种方式实际用的比较少。

一个触发ajax的按钮:

<button id="bt_1">ajax_1</button>

jquery代码:(请求servlet,接收返回数据)

var bt_1=$("#bt_1");
bt_1.on("click",function () {
    $.ajax({
        url:"/webTest/ajax1",  // 请求的servlet
        type:"post",  // 因为没有携带数据,无所谓
        async: true,  // 异步 
        cache: false,  // 不许缓存
        success:function(data){  // 请求成功,200
            console.log(data);
        },
        error:function(error){  // 请求失败
        console.log(error);
        }
    })
})

servlet处理代码:(返回数据)

PrintWriter out = null;
try {
    out = response.getWriter();  // 打开response的输入流
    } catch (IOException e) {
    e.printStackTrace();
}
out.print("I give u a feedback");  // 写入信息到response
out.close();

3、 携带文本数据,发送请求至servlet,接收返回数据

有的时候,我们需要携带一些数据,可以是常见的表单,也可以是一些零散的数据。在这种情况下,我们需要将数据封装成json 数据格式进行传输。

3.1 第一种封装的json 数据:对象形式

jquery代码:

var sub=$("#sub");
sub.on("click",function () {
    $.ajax({
        url:"/webTest/ajax2",
        type:"post",
        async:true,
        cache: false,
        data: {  // json数据(注意,不能使用JSON.stringify()方法,否则出错)
            "username": "liSi",
            "password": "ps"
        },
        success:function(data){
            console.log(data);
        },
        error:function(error){
            console.log(error);
        }
    })
})

servlet处理代码:(接收数据,返回数据)

String username = request.getParameter("username");
String password = request,getParameter("password");

PrintWriter out = null;
try {
    out = response.getWriter();  // 打开response的输入流
    } catch (IOException e) {
    e.printStackTrace();
}
out.print("I give u a feedback");  // 写入信息到response中
out.close();

解读

在这种情况下,封装的json数据因为比较简单,所以数据被编码成字符串发送至servlet,就和之前使用action 的表单提交文本数据的情况一样。

注意,一旦json 数据复杂一点点,如{"username":"liSi","hobby":{"todya":"ttennis"}} ;就无法使用getParameter("hobby") 来获取数据了,这也是下面要将的第二种封装的json 数据。显然,这种封装的json 数据的获取,是一种特殊情况,在大多数不复制的情况是一种很好的方式。

技巧

当我们使用了表单的时候,如果我们只是想传输表单的值,那么就没有必要手工取值化成json形式,jquery提供了相应的方法来简化操作。当然,只是针对文本数据而言。

jquery代码1:

var data_json = $("#form_1").serialize();

data: data_json,

这里通过序列化函数,会自动把表单的数据转化为字符串形式(url),也就是和action 表单提交一致的效果。在servlet中可以直接通过getParameter() 方法来获取参数。

jquery代码2:

var data_json = $("#form_1").serializeArray();

data: data_json,

这里通过序列化函数,会自动把表单的数据转化为json数据格式,省去了手工封装成json的过程。

3.2 第二种封装的json 数据:数组形式

一旦json 数据变复杂,那么在servlet中就无法通过getParameter() 获取数据了。这个时候我们需要把json 数据先字符串化,使得json 在传输的时候就是原数据(打开调试台看到的Form Data 就和json 原数据一样)。

jquery代码:

var sub=$("#sub");
var data_json=[{"sex": '男',"submit":"111"},{"sex": '女',"submit":"222"}];
sub.on("click",function () {
    $.ajax({
        url:"/webTest/ajax2",
        type:"post",
        async:true,
        cache: false,
        data: JSON.stringify(data_json),  // 先序列化json数据
        success:function(data){
            console.log(data);
        },
        error:function(error){
            console.log(error);
        }
    })
})

在这里,json 数据就是比较复杂的了,我们要先使用JSON.stringify() 序列化json 数据。

servlet代码:

BufferedReader reader = request.getReader();  // 获取请求的输出流
String jsonData = "";
jsonData += reader.readLine();
reader.close();

// 获取到一致的json数据
System.out.println(json);  // [{"sex": '男',"submit":"111"},{"sex": '女',"submit":"222"}]

java操作json 数据:

对于得到的json 数据,我们需要反序列,把我们需要的值给取出来。通常是使用json 的解析库,如GSON、fastJson等。这里我们使用GSON来讲解。

由于篇幅的原因,GSON 操作json 数据,序列化与反序列化的内容在另一章中进行讲解。总之,我们可以操作任何复杂的json 数据,并且从中取出我们需要的属性。

解读

得益于json 数据格式,使得前后端之间的数据交流变得十分方便。具体如何在java中操作json,请看有关于json的文章。

3.3 jquery的ajax 技术参数解读

在ajax的代码中,有几个参数比较重要。

**1、 contentType: "application/json;charset=utf-8" **

这个参数是指明提交的数据的数据类型,不指明的话,默认是:

Content-Type: application/x-www-form-urlencoded; charset=UTF-8

而指明了数据格式为json 的话,在后台有些框架可以直接获取,比如说springmvc。

注意: 一旦使用了指明了数据类型是json之后,就应该使用JSON.stringify() 方法来处理json数据。在后台的处理程序中就无法使用getParameter() 方法来获取值了。

2、 dataType:"json"

这个参数是指明返回的数据的数据类型,不指明的话,默认是:"text"

4、 携带文本数据和文件数据,发送请求至servlet,接收返回数据

同样的一句话,只要涉及到文件数据,那么就是二进制流传输,是无法使用getParameter() 直接获取数据的。并且再啰嗦一句,之所以推荐使用ajax,就是因为它可以做到页面不跳转的提交。

4.1 使用FormData对象

我们还是可以选择是否使用表单,这也无所谓。当multiple="multiple" 时,可以一次上传多个文件。

表单:

<form id="form_1">
    <input type="text" name="user" id="user">
    <input type="file" name="file" multiple="multiple" id="file">
    <input type="button" id="sub" value="submit it"/>
</form>

jquery代码:

var formData = new FormData();
var name = $("input").val();

// formData对象放入值
formData.append("name",name);
formData.append("file",$("#file")[0].files[0]);  // 只选择第一个文件

$.ajax({ 
    url : Url, 
    type : 'POST', 
    data : formData, 
    processData : false,  // 告诉jQuery不要去处理发送的数据 
    contentType : false,  // 告诉jQuery不要去设置Content-Type请求头
    success:function(data){
        console.log(data);
    },
    error:function(error){
        console.log(error);
    }
});

当然,我们可以直接传入表单对象。这样更加快速。

var form_1 = document.getElementById("form_1");
var formData = new FormData(form_1);

data: formData,

四、谢幕

关于前端的表单提交数据至后台servlet的总结就先告一段落了。内容上可以分成2块,一是直接使用action 的表单提交,二是使用ajax 技术模拟的表单提交。而在数据上又可以分成2块,一是只含有文本数据,而是含有上传文件。

推荐阅读更多精彩内容