2017.10.1 AJAX技术对RESTful的前端实现

RESTful API的设计，是以请求方式GET、POST、PUT等为动作，URL为动作请求的资源名词的标准来设计的。

但是在实际应用中，光靠HTML其实无法完成除了GET和POST之外的请求方法，那么DELETE和PUT方法如果完成呢？RESTful怎么投入到应用呢？
可能有人想到通过form表单来向后端提交数据，但是form表单在HTML标准中是只支持POST和GET方法的。

鉴于现有条件，光靠HTML不能发送PUT和DELETE请求，我们这里用到了 语言的Ajax技术来辅助实现RESTful。

在传统的Internet编程中，如果想得到服务器后端数据，或者发送客户端信息到服务器，需要建立一个HTML form然后只能以GET或者POST方法将数据发送到服务器端。
用户需要点击”Submit”按钮来发送数据信息，然后等待服务器响应请求，页面重新加载。 这样服务器每次都会返回一个新的页面， 响应有可能很慢并且用户交互不友好。

使用AJAX技术， 就可以使 通过 HttpRequest对象直接与服务器进行交互。
通过HTTP Request，不但可以在HTTP协议请求中加入Request Method:GET(POST、PUT、DELETE)的HTTP头,来模拟多种HTTP请求， 还可以做到异步发送请求到web服务器并且接受web服务器返回的信息(不用重新加载页面，既做到免刷新)，在回调函数中对服务器返回的数据在HTML中进行动态渲染，并且展示给用户的还是同一个页面。

总结AJAX技术作用：
1、通过JS自带的 HttpRequest对象，实现多种HTTP请求，弥补HTML标签只能完成POST和GET请求的缺陷。
2、不用重新请求页面，仅仅以JS线程和服务器后端互动，得到后端数据后可以在回调函数中完成前端页面的动态渲染，做到免刷新技术。

下面是在Springboot框架中的实例演示，笔者的Spingboot文件结构如下所示：

在ViewController控制器中添加以下路由实现方法，来作为展示的基础页面：
@RequestMapping("/ajax")
public String ajax() {
System.out.println(">> ViewController.ajax() is called!");
return "ajax";
}

在ajax.html中，主要内容如下：

<button id="get">GET（获取数据）</button><button id="post">POST（添加数据）</button><button id="put">PUT（更新数据）</button><button id="delete">DELETE（删除数据）</button> 

并且通过引用的方式来调用Jquery(一个JS框架，可以使用封装好的AJAX方法)和一个自定义JS文件：

<!--使用jquery框架--><  type="text/ " src="js/jquery.min.js"></ ><!--JS实现AJAX部分--><  type="text/ " src="js/main.js"></ >

main.js内容如下(如读者不熟悉 的使用，可以看注释来了解功能)：

/** * Created by Doublestar on 2017/10/1. */$(document).ready(function(){   //在HTML文档加载完成后执行    //GET方法    $("#get").click(function(){ //HTML中id为get的HTML标签的点击动作        $.ajax({            url:'http://localhost:8080/product',    //请求的URL地址            type:'GET', //请求方法，GET、POST、PUT、DELETE在这里设置            timeout:5000,    //超时时间            dataType:'text',    //返回的数据格式：json/ /html/ /jsonp/text            success:function(data,textStatus,jqXHR){    //成功的回调函数                $("#result").html(data) //设置id为result的标签的html内容为返回的data数据            },            error:function(xhr,textStatus){ //失败的回调函数                $("#result").html(textStatus)            }        })    })//POST方法    $("#post").click(function(){        $.ajax({            url:"http://localhost:8080/product/?id=1&name=测试POST&age=21",            type:'POST', //请求方法，GET、POST、PUT、DELETE在这里设置            timeout:5000,    //超时时间            dataType:'text',    //返回的数据格式：json/ /html/ /jsonp/text            success:function(data,textStatus,jqXHR){                $("#result").html(data)            },            error:function(xhr,textStatus){                $("#result").html(textStatus)            }        })    })//PUT方法    $("#put").click(function(){        $.ajax({            url:'http://localhost:8080/product/1/?name=测试PUT&age=22',            type:'PUT', //请求方法，GET、POST、PUT、DELETE在这里设置            timeout:5000,    //超时时间            dataType:'text',    //返回的数据格式：json/ /html/ /jsonp/text            success:function(data,textStatus,jqXHR){                $("#result").html(data)            },            error:function(xhr,textStatus){                $("#result").html(textStatus)            }        })    })//DELETE方法    $("#delete").click(function(){        $.ajax({            url:'http://localhost:8080/product/1',            type:'DELETE', //请求方法，GET、POST、PUT、DELETE在这里设置            timeout:5000,    //超时时间            dataType:'text',    //返回的数据格式：json/ /html/ /jsonp/text            success:function(data,textStatus,jqXHR){                $("#result").html(data)            },            error:function(xhr,textStatus){                $("#result").html(textStatus)            }        })    })})

最后的浏览器效果如下:

以上是实例演示基础的内容，接下来介绍具体的请求执行：
User类代码：

package com.hello.data;public class User {    private Long id;    private String name;    private Integer age;    public Long getId() {        return id;    }    public void setId(Long id) {        this.id = id;    }    public String getName() {        return name;    }    public void setName(String name) {        this.name = name;    }    public Integer getAge() {        return age;    }    public void setAge(Integer age) {        this.age = age;    }}

在DataController中，笔者写了四个路由分别来响应对应的GET、POST、PUT和DELETE方法（讲解略）：

//使用User类来存储数据实现增删改查static Map<Long, User> users = Collections.synchronizedMap(new HashMap<Long, User>());    @GetMapping("/product")    public List<User> getInfo(){        List<User> r = new ArrayList<User>(users.values());        return r;    }    @PostMapping("/product")    public String addInfo(@ModelAttribute User user){        users.put(user.getId(), user);        return "success";    }    @PutMapping("/product/{id}")    public String putInfo(@PathVariable Long id, @ModelAttribute User user){        // 处理"/users/{id}"的PUT请求，用来更新User信息        User u = users.get(id);        u.setName(user.getName());        u.setAge(user.getAge());        users.put(id, u);        return "success";    }    @DeleteMapping("/product/{id}")    public String delInfo(@PathVariable Long id){        // 处理"/users/{id}"的DELETE请求，用来删除User        users.remove(id);        return "success";    }

这四个路由对应的处理方法，对应上文对main.js展示中AJAX的URL。
下面我们来看执行效果：
首先我们点击GET按钮获取数据，发现为空
[]

再点击POST按钮，显示执行成功，并且再点击GET查看，发现多了一条数据
[{"id":1,"name":"测试POST","age":21}]

再点击PUT按钮来尝试更新数据，发现数据更新为
[{"id":1,"name":"测试PUT","age":22}]

最后，我们尝试删除这条数据，删除成功后，GET查看数据发现已经清空为
[]

至此，使用AJAX技术对于RESTful API的实现演示结束了，笔者在这里使用了JAVAEE的Spingboot框架，但是上文所讲技术移植性很强，除了对于后端实现部分，其他部分均可以在PHP、Python等后端环境下正常工作（读者如有细节问题，可以结合阅读代码理解）。
感谢阅读
作者：Doublestar
博客：https://www.yourhome.ren