RESTful/SpringMVC实现

注解：

@RestController：Spring 4的新注解。她自动为每个方法加上 @ResponseBody. @RestController可以看做是 @Controller 和@ResponseBody两个注解的组合。
@RequestBody：如果一个方法申明了@RequestBody注解, Spring会基于请求头中的Content-Type使用HTTP Message converters将request body反序列化成对象。
@ResponseBody：是在方法的上注解，如果一个方法申明了@ResponseBody, Spring会基于请求头中的Accept使用HTTP Message converters将对象序列化成response body。在Spring 4中如果使用了@RestController，则可以不用再声明此注解。

返回类型：

ResponseEntity：ResponseEntity很重要。她代表了整个HTTP response. 你可以指定status code, response headers, response body.。她有几种构造方法可以在HTTP Response中传递信息。
MediaType：随@RequestMapping一起使用, 你可以指定生产和消费的类型(使用@Produces或@Consumes属性) 。
例如：
@RequestMapping(value = "/say/{msg}", produces="application/json;charset=UTF-8")
仅当request请求头中的(Accept)类型中包含该指定类型才返回。
@RequestMapping(produces={"text/html", "application/json"})
将匹配Accept:text/html或Accept:application/json。
当你有如下Accept头“Accept：text/html,application/xml,application/json”，将按照顺序进行produces的匹配

作为服务端，@Produces 标注用于指定返回的MIME媒体类型，@Consumes 标注服务端只可接受此MIME媒体类型的请求。。
作为客户端，Content-Type 请求头用于指定返回的MIME媒体类型。**Accept **请求头用于标注客户端只可接受此MIME媒体类型的请求。

//请求的地址  
String url = "http://localhost:9080/springmvc-chapter6/request/ContentType";  
//①创建Http Request(内部使用HttpURLConnection)  
ClientHttpRequest request = new SimpleClientHttpRequestFactory().createRequest(new URI(url), HttpMethod.POST);  
//②设置请求头的内容类型头和内容编码（GBK）  
request.getHeaders().set("Content-Type", "application/json;charset=gbk");  
//③以GBK编码写出请求内容体  
String jsonData = "{\"username\":\"zhang\", \"password\":\"123\"}";  
request.getBody().write(jsonData.getBytes("gbk"));  
//④发送请求并得到响应  
ClientHttpResponse response = request.execute();  
System.out.println(response.getStatusCode());

添加jackson相关包
如果导入jackson-databind.jar，则@ResponseBody注解的方法或@RestController注解的Controller默认返回JSON格式。另外再倒入jackson-dataformat-xml.jar的话默认返回XML，此时如需返回JSON可在请求最后加上".json"。
注：org.codehaus.jackson是旧版本的com.fasterxml.jackson。如果项目中需要jackson-databind，则只需要引入它。jackson-core和jackson-annotations会随它自动引入。

    <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-databind</artifactId>
        <version>${jackson.library}</version>
    </dependency>
    <dependency>
        <groupId>com.fasterxml.jackson.dataformat</groupId>
        <artifactId>jackson-dataformat-xml</artifactId>
        <version>${jackson.library}</version>
    </dependency>

使用@RestController：
服务端：

package com.zzhblh.resource.impl;

import com.zzhblh.entity.account.User;
import com.zzhblh.resource.UserResource;
import org.springframework.http.MediaType;
import org.springframework.stereotype.Component;
import org.springframework.web.bind.annotation.*;

import java.util.Map;


/**
 * Created by chen on 2016/9/2.
 */
@RestController
@RequestMapping("api/user_resource")
public class UserResourceImpl implements UserResource{

    @Override
    @RequestMapping(value = "/user_query", method = RequestMethod.GET, produces = MediaType.APPLICATION_JSON_VALUE)
    public User queryUserInfoById(@RequestParam(value="id") String id) {
        return new User("123","abc");
    }

    @Override
    @RequestMapping(value = "/user_update/{id}", method = RequestMethod.PUT)
    public User updateUserInfo(@PathVariable("id") String id, @RequestBody User user) {
        user.setUserName("new");
        return user;
    }

    @Override
    @RequestMapping(value = "/user_update/map", method = RequestMethod.PUT)
    public User updateUserInfoByMap(@RequestBody Map map) {
        User user = new User();
        user.setUserName(map.get("name").toString());
        return user;
    }

    @Override
    @RequestMapping(value = "/user_create", method = RequestMethod.POST)
    public User createUserInfo(@RequestBody User user) {
        user.setUserName("new");
        return user;
    }

    @Override
    @RequestMapping(value = "/user_delete", method = RequestMethod.DELETE)
    public User deleteUserInfo(@RequestParam(value="id") String id) {
        User user = new User();
        user.setUserName("someone deleted");
        return user;
    }
}

客户端：

package com.zzhblh.sample;

import com.zzhblh.entity.account.User;
import org.springframework.http.*;
import org.springframework.web.client.RestTemplate;

import java.net.URI;
import java.util.HashMap;
import java.util.Map;

/**
 * Created by chen on 2016/9/2.
 */
public class testRest {

    static String REST_SERVICE_URI = "http://localhost:8080/practice-web/api/user_resource";

    private static void getUser(){
        System.out.println("Testing getUser API----------");
        RestTemplate restTemplate = new RestTemplate();
        User user = restTemplate.getForObject(REST_SERVICE_URI+"/user_query?id=123", User.class);
        System.out.println(user);
    }

    private static void updateUser(){
        System.out.println("Testing updateUser API----------");
        RestTemplate restTemplate = new RestTemplate();
        User user = new User("123","old");
        restTemplate.put(REST_SERVICE_URI+"/user_update/123", user, User.class);

        //使用resttemplate的put方法得不到返回值
        HttpHeaders headers = new HttpHeaders();
        headers.setContentType(MediaType.APPLICATION_JSON);
        HttpEntity<User> userRequest = new HttpEntity<User>(user, headers);
        ResponseEntity<User> responseEntity = restTemplate.exchange(REST_SERVICE_URI+"/user_update/123", HttpMethod.PUT, userRequest, User.class);
        System.out.println(responseEntity.getBody().toString());
    }

    private static void updateUserMap(){
        System.out.println("Testing updateUserMap API----------");
        RestTemplate restTemplate = new RestTemplate();
        Map map = new HashMap<String,String>();
        map.put("name","mm");
        restTemplate.put(REST_SERVICE_URI+"/user_update/map", map, Map.class);
    }

    /* POST */
    private static void createUser() {
        System.out.println("Testing create User API----------");
        RestTemplate restTemplate = new RestTemplate();
        User user = new User("123","old");
        user = restTemplate.postForObject(REST_SERVICE_URI+"/user_create", user, User.class);
        System.out.println(user.toString());

        ResponseEntity<User> responseEntity = restTemplate.postForEntity(REST_SERVICE_URI+"/user_create", user, User.class);
        System.out.println(responseEntity.getBody().toString());
    }

    /* DELETE */
    private static void deleteUser() {
        System.out.println("Testing delete User API----------");
        RestTemplate restTemplate = new RestTemplate();
        restTemplate.delete(REST_SERVICE_URI+"/user_delete?id=123");
        System.out.println("deleted");

        //使用resttemplate的put方法得不到返回值
        HttpHeaders headers = new HttpHeaders();
        headers.setContentType(MediaType.APPLICATION_JSON);
        HttpEntity<User> userRequest = new HttpEntity<User>(headers);
        ResponseEntity<User> responseEntity = restTemplate.exchange(REST_SERVICE_URI+"/user_delete", HttpMethod.DELETE, userRequest, User.class);
        System.out.println(responseEntity.getBody().toString());
    }

    public static void main(String args[]){
        getUser();
        updateUser();
        updateUserMap();
        createUser();
        deleteUser();
    }

}

使用@Controller：
服务端：

package com.citic.test.action;
import java.util.ArrayList;
import java.util.List;

import net.sf.json.JSONObject;

import org.apache.log4j.Logger;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.ResponseBody;

import com.citic.test.entity.Person;

/**
 * 基于Restful风格架构测试
 * 
 * @author dekota
 * @since JDK1.5
 * @version V1.0
 * @history 2014-2-15 下午3:00:12 dekota 新建
 */
@Controller
@Scope("prototype")//改为多列模式
public class DekotaAction {

    /** 日志实例 */
    private static final Logger logger = Logger.getLogger(DekotaAction.class);

    @RequestMapping(value = "/hello", produces = "text/plain;charset=UTF-8")
    public @ResponseBody
    String hello() {
        return "你好！hello";
    }

    @RequestMapping(value = "/say/{msg}", produces = "application/json;charset=UTF-8")
    public @ResponseBody
    String say(@PathVariable(value = "msg") String msg) {
        return "{\"msg\":\"you say:'" + msg + "'\"}";
    }

    @RequestMapping(value = "/person/{id:\\d+}", method = RequestMethod.GET)
    public @ResponseBody
    Person getPerson(@PathVariable("id") int id) {
        logger.info("获取人员信息id=" + id);
        Person person = new Person();
        person.setName("张三");
        person.setSex("男");
        person.setAge(30);
        person.setId(id);
        return person;
    }

    @RequestMapping(value = "/person/{id:\\d+}", method = RequestMethod.DELETE)
    public @ResponseBody
    Object deletePerson(@PathVariable("id") int id) {
        logger.info("删除人员信息id=" + id);
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("msg", "删除人员信息成功");
        return jsonObject;
    }

    @RequestMapping(value = "/person", method = RequestMethod.POST)
    public @ResponseBody
    Object addPerson(Person person) {
        logger.info("注册人员信息成功id=" + person.getId());
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("msg", "注册人员信息成功");
        return jsonObject;
    }

    @RequestMapping(value = "/person", method = RequestMethod.PUT)
    public @ResponseBody
    Object updatePerson(Person person) {
        logger.info("更新人员信息id=" + person.getId());
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("msg", "更新人员信息成功");
        return jsonObject;
    }

    @RequestMapping(value = "/person", method = RequestMethod.PATCH)
    public @ResponseBody
    List<Person> listPerson(@RequestParam(value = "name", required = false, defaultValue = "") String name) {

        logger.info("查询人员name like " + name);
        List<Person> lstPersons = new ArrayList<Person>();

        Person person = new Person();
        person.setName("张三");
        person.setSex("男");
        person.setAge(25);
        person.setId(101);
        lstPersons.add(person);

        Person person2 = new Person();
        person2.setName("李四");
        person2.setSex("女");
        person2.setAge(23);
        person2.setId(102);
        lstPersons.add(person2);

        Person person3 = new Person();
        person3.setName("王五");
        person3.setSex("男");
        person3.setAge(27);
        person3.setId(103);
        lstPersons.add(person3);

        return lstPersons;
    }

}

客户端：

<script type="text/javascript">
    (function(window,$){
        var dekota={  
            url:'',
            init:function(){
                dekota.url='<%=basePath%>';
                $.UIkit.notify("页面初始化完成", {status:'info',timeout:500});
                $("#btnGet").click(dekota.getPerson);
                $("#btnAdd").click(dekota.addPerson);
                $("#btnDel").click(dekota.delPerson);
                $("#btnUpdate").click(dekota.updatePerson);
                $("#btnList").click(dekota.listPerson);
            },
            getPerson:function(){
                $.ajax({
                    url: dekota.url + 'person/101/',
                    type: 'GET',
                    dataType: 'json'
                }).done(function(data, status, xhr) {
                    $.UIkit.notify("获取人员信息成功", {status:'success',timeout:1000});
                }).fail(function(xhr, status, error) {
                    $.UIkit.notify("请求失败！", {status:'danger',timeout:2000});
                });
            },
            addPerson:function(){
                $.ajax({
                    url: dekota.url + 'person',
                    type: 'POST',
                    dataType: 'json',
                    data: {id: 1,name:'张三',sex:'男',age:23}
                }).done(function(data, status, xhr) {
                    $.UIkit.notify(data.msg, {status:'success',timeout:1000});
                }).fail(function(xhr, status, error) {
                    $.UIkit.notify("请求失败！", {status:'danger',timeout:2000});
                });
            },
            delPerson:function(){
                $.ajax({
                    url: dekota.url + 'person/109',
                    type: 'DELETE',
                    dataType: 'json'
                }).done(function(data, status, xhr) {
                    $.UIkit.notify(data.msg, {status:'success',timeout:1000});
                }).fail(function(xhr, status, error) {
                    $.UIkit.notify("请求失败！", {status:'danger',timeout:2000});
                });
            },
            updatePerson:function(){
                $.ajax({
                    url: dekota.url + 'person',
                    type: 'POST',//注意在传参数时，加：_method:'PUT'　将对应后台的PUT请求方法
                    dataType: 'json',
                    data: {_method:'PUT',id: 221,name:'王五',sex:'男',age:23}
                }).done(function(data, status, xhr) {
                    $.UIkit.notify(data.msg, {status:'success',timeout:1000});
                }).fail(function(xhr, status, error) {
                    $.UIkit.notify("请求失败！", {status:'danger',timeout:2000});
                });
            },
            listPerson:function(){
                $.ajax({
                    url: dekota.url + 'person',
                    type: 'POST',//注意在传参数时，加：_method:'PATCH'　将对应后台的PATCH请求方法
                    dataType: 'json',
                    data: {_method:'PATCH',name: '张三'}
                }).done(function(data, status, xhr) {
                    $.UIkit.notify("查询人员信息成功", {status:'success',timeout:1000});
                }).fail(function(xhr, status, error) {
                    $.UIkit.notify("请求失败！", {status:'danger',timeout:2000});
                });
            }
        };
        window.dekota=(window.dekota)?window.dekota:dekota;
        $(function(){
            dekota.init();
        });
    })(window,jQuery);

</script>

要点：服务端在类上加上@RestController注解。客户端请求时获取数据用GET,更新用PUT,创建用POST,删除用DELETE。

参考：
http://www.iteye.com/topic/1127120
http://websystique.com/springmvc/spring-mvc-4-restful-web-services-crud-example-resttemplate/
http://www.cnblogs.com/yjmyzz/p/javaee-jax-rs-tutorial.html
关于和jersey可参考：
http://waylau.com/categories/)

最后编辑于：2017.12.03 14:43:41

人面猴
序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
沈念sama阅读 213,099评论 6赞 492
死咒
序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
沈念sama阅读 90,828评论 3赞 387
救了他两次的神仙让他今天三更去死
文/潘晓璐我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
开封第一讲书人阅读 158,540评论 0赞 348
道士缉凶录：失踪的卖姜人
文/不坏的土叔我叫张陵，是天一观的道长。经常有香客问我，道长，这世上最难降的妖魔是什么？我笑而不...
开封第一讲书人阅读 56,848评论 1赞 285
港岛之恋（遗憾婚礼）
正文为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
茶点故事阅读 65,971评论 6赞 385
恶毒庶女顶嫁案：这布局不是一般人想出来的
文/花漫我一把揭开白布。她就那样静静地躺着，像睡着了一般。火红的嫁衣衬着肌肤如雪。梳的纹丝不乱的头发上，一...
开封第一讲书人阅读 50,132评论 1赞 291
城市分裂传说
那天，我揣着相机与录音，去河边找鬼。笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。我是一名探鬼主播，决...
沈念sama阅读 39,193评论 3赞 412
双鸳鸯连环套：你想象不到人心有多黑
文/苍兰香墨我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
开封第一讲书人阅读 37,934评论 0赞 268
万荣杀人案实录
序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
沈念sama阅读 44,376评论 1赞 303
护林员之死
正文独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋以下内容为张勋视角年9月15日...
茶点故事阅读 36,687评论 2赞 327
白月光启示录
正文我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
茶点故事阅读 38,846评论 1赞 341
活死人
序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
沈念sama阅读 34,537评论 4赞 335
日本核电站爆炸内幕
正文年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
茶点故事阅读 40,175评论 3赞 317
男人毒药：我在死后第九天来索命
文/蒙蒙一、第九天我趴在偏房一处隐蔽的房顶上张望。院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
开封第一讲书人阅读 30,887评论 0赞 21
一桩弑父案，背后竟有这般阴谋
文/苍兰香墨我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。一阵脚步声响...
开封第一讲书人阅读 32,134评论 1赞 267
情欲美人皮
我被黑心中介骗来泰国打工，没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。一个月前我还...
沈念sama阅读 46,674评论 2赞 362
代替公主和亲
正文我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
茶点故事阅读 43,741评论 2赞 351

RESTful/SpringMVC实现

推荐阅读更多精彩内容