摘要：配置和編碼格式使用提供過濾器處理字符編碼。請求從不改變資源的狀態(tài)，無副作用。中添加，采用默認配置已經(jīng)足夠面對大多數(shù)場景注入?yún)⒖兼溄邮职咽纸棠阏献顑?yōu)雅框架我的編碼習(xí)慣接口定義設(shè)計最佳實踐

打開IDEA -> Create New Project
勾選Create from archetype

選擇使用的maven的本地位置,這個根據(jù)實際情況選擇就好

這一步會填寫項目名稱,根據(jù)實際來就好了。

一個空的項目就已經(jīng)完成了。

創(chuàng)建java文件夾

設(shè)置java文件夾為Sources Root，只有在Rources RootxiaIRDEA才提供創(chuàng)建Java文件的選項

創(chuàng)建Package

選擇Deployment

選擇帶exploded的

然后OK，添加剛才的tomcat到配置里面

運行tomcat

運行成功

以上完成基礎(chǔ)的搭建，下面會引入框架

         
     ...
     
    
        5.0.4.RELEASE
    
    
    
    
        ...
        
        
        
            org.springframework
            spring-core
            ${spring.version}
        
        
            org.springframework
            spring-beans
            ${spring.version}
        
        
            org.springframework
            spring-context
            ${spring.version}
        
        
        
            org.springframework
            spring-jdbc
            ${spring.version}
        
        
            org.springframework
            spring-tx
            ${spring.version}
        
        
        
            org.springframework
            spring-web
            ${spring.version}
        
        
            org.springframework
            spring-webmvc
            ${spring.version}
        
        
            org.springframework
            spring-test
            ${spring.version}
        
        
        ...
        
    

    ...

創(chuàng)建resources目錄下的配置文件

如上配置，加入了一個InternalResourceViewResolver（視圖解析器），這個視圖解析器根據(jù)Controller的方法返回字符串或者ModelAndView，找到對應(yīng)的視圖（頁面），可以再視圖中加入EL表達式等代碼綁定數(shù)據(jù)。
InternalResourceViewResolver中包含兩個參數(shù)prefix和suffix，他們分別是視圖解析器的前綴和后綴，比如，上面配置了prefix的值為‘/WEB-INF/jsp/’，那么當(dāng)Controller返回字符串‘index’時，視圖解析器回找到‘/WEB-INF/jsp/index’；如果再加上suffix屬性，值為‘.jsp’，那么視圖解析器就會去找‘/WEB-INF/jsp/index.jsp’。

    Archetype Created Web Application

    
    
        characterEncodingFilter
        org.springframework.web.filter.CharacterEncodingFilter
        
            encoding
            UTF-8
        
        
            forceEncoding
            true
        
    
    
        characterEncodingFilter
        /*
    

    
    
        SpringMVC
        org.springframework.web.servlet.DispatcherServlet
        
            contextConfigLocation
            classpath:conf/spring-*.xml
        
        1
    
    
        SpringMVC
        /
    

如上面代碼所示，這樣配置的目的是把請求交給Spring框架的DispatcherServlet處理，由它找到請求路徑所對應(yīng)的Controller，把請求交由這個Controller處理。

         
    ...
         
    
    
        ...
        
        
        
            jstl
            jstl
            1.2
        
        
            taglibs
            standard
            1.1.2
        
        
            javax.servlet
            javax.servlet-api
            3.1.0
        
        
        ...
        
    
    
    ...
    

創(chuàng)建UserController.java和userIndex.jsp文件

創(chuàng)建UserController.java

@Controller
@RequestMapping("/user")
public class UserController {

    @RequestMapping("/index")
    public ModelAndView index(ModelAndView modelAndView){
        modelAndView.setViewName("/user/userIndex");
        return modelAndView;
    }
}

創(chuàng)建userIndex.jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" %>



    


User Index

此時，運行系統(tǒng)，可通過Spring注解進入jsp頁面，如：/user/index

pom.xml 引入 mybatis 和 jdbc

         
     ...
     
     
     
        ...
     
        
        
            mysql
            mysql-connector-java
            5.1.37
            runtime
        
        
        
            org.mybatis
            mybatis
            3.4.5
        
        
            org.mybatis
            mybatis-spring
            1.3.1
        
    
        ...
        
    
    
    ...

創(chuàng)建數(shù)據(jù)庫mybatis

create database mybatis;

創(chuàng)建表user

CREATE TABLE user(
    id INT PRIMARY KEY auto_increment,
    username VARCHAR ( 20 ),
    password VARCHAR ( 20 ),
    sex VARCHAR ( 10 ),
    address VARCHAR ( 20 ) 
);

在 resources 目錄下創(chuàng)建 jdbc.properties

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3307/mybatis?useUnicode=true&characterEncoding=utf8
jdbc.username=root
jdbc.password=root

創(chuàng)建UserMapper

public interface UserMapper {

    /**
     * 查詢一個用戶
     *
     * @param  id 用戶id
     * @return User
     */
    public User getUser(Integer id) throws Exception;

    /*
     * 新增用戶
     * @param user
     * @return
     * @throws Exception
     */
    public int insertUser(User user) throws Exception;

    /*
     * 修改用戶
     * @param user
     * @param id
     * @return
     * @throws Exception
     */
    public int updateUser(User user) throws Exception;

    /*
     * 刪除用戶
     * @param id
     * @return
     * @throws Exception
     */
    public int deleteUser(Integer id) throws Exception;

    /*
     * 查詢所有的用戶信息
     * @return
     * @throws Exception
     */
    public List getUsers() throws Exception;
}

創(chuàng)建UserMapper.xml

    
    
        
        
        
        
        
    

    
    
    
    
    
        insert into user (username,password,sex,address) values
        (#{username},#{password},#{sex},#{address})
    

    
        update user set
        address=#{address} where
        id=#{id}
    

    
        delete from user where
        id=#{id}
    

    

    
    
        select * from user where id=#{id}
    

    
        select * from user
    

User

public class User {

    private Integer id;
    private String username;
    private String password;
    private String sex;
    private String address;

    // getter and setter
    
}

UserService.java

public interface UserService {

    /**
     * 查詢一個用戶
     *
     * @param  id 用戶id
     * @return User
     */
    public User getUser(Integer id) throws Exception;

    /*
     * 新增用戶
     * @param user
     * @return
     * @throws Exception
     */
    public int insertUser(User user) throws Exception;

    /*
     * 修改用戶
     * @param user
     * @param id
     * @return
     * @throws Exception
     */
    public int updateUser(User user) throws Exception;

    /*
     * 刪除用戶
     * @param id
     * @return
     * @throws Exception
     */
    public int deleteUser(Integer id) throws Exception;

    /*
     * 查詢所有的用戶信息
     * @return
     * @throws Exception
     */
    public List getUsers() throws Exception;
}

UserServiceImpl.java

@Service
@Transactional
public class UserServiceImpl implements UserService {

    @Autowired
    UserMapper userMapper;

    /**
     * 查詢一個用戶
     *
     * @param  id 用戶id
     * @return User
     */
    public User getUser(Integer id)  throws Exception {
        return userMapper.getUser(id);
    }

    /*
     * 新增用戶
     * @param user
     * @return
     * @throws Exception
     */
    public int insertUser(User user) throws Exception {
        return userMapper.insertUser(user);
    }

    /*
     * 修改用戶
     * @param user
     * @param id
     * @return
     * @throws Exception
     */
    public int updateUser(User user) throws Exception {
        return userMapper.updateUser(user);
    }

    /*
     * 刪除用戶
     * @param id
     * @return
     * @throws Exception
     */
    public int deleteUser(Integer id) throws Exception {
        return userMapper.deleteUser(id);
    }

    /*
     * 查詢所有的用戶信息
     * @return
     * @throws Exception
     */
    public List getUsers() throws Exception {
        return userMapper.getUsers();
    }
}

classpath:spring/spring-mvc.xml
# 改成 -->
classpath:spring/spring-*.xml

創(chuàng)建相應(yīng)文件

public class ResultBean implements Serializable {

    /**
     * 錯誤代碼
     */
    private static final int SUCCESS = 0; // 成功
    private static final int CHECK_FAIL = 1; // 失敗
    private static final int UNKNOWN_EXCEPTION  = -99; // 拋出異常
    /**
     * 接口返回狀態(tài)碼，0表示成功，其他的看對應(yīng)定義
     *
     * 推薦：
     * 0  ： 表示成功
     * >0 :  表示已知的異常（需要在調(diào)用的地方多帶帶處理）
     * <0 :  表示未知的異常（不需要多帶帶處理，調(diào)用方統(tǒng)一處理）
     */
    private int code = SUCCESS; // 返回狀態(tài)

    /**
     * 返回信息（出錯的時候使用）
     */
    private String msg = "success";

    /**
     * 返回的數(shù)據(jù)
     */
    private T data;

    /**
     * 請求正確（新增、修改、刪除信息），返回調(diào)用
     */
    public ResultBean() {
        super();
    }

    /**
     * 請求數(shù)據(jù)正確，返回調(diào)用
     * @param data 返回數(shù)據(jù)
     */
    public ResultBean(T data) {
        super();
        this.data = data;
    }

    /**
     * 請求出錯，返回調(diào)用
     * @param msg 錯誤提醒語句
     */
    public ResultBean(String msg) {
        this.code = CHECK_FAIL;
        this.msg = msg;
    }

    /**
     * 請求異常，返回調(diào)用
     * @param e 異常
     */
    public ResultBean(Throwable e) {
        super();
        this.msg = e.toString();
        this.code = UNKNOWN_EXCEPTION;
    }
    
    /**
     * getter and setter
     * 
     * 因為屬性是private的，所以屬性必須有g(shù)etter才能在被獲取
     */

}

使用四種HTTP方法POST，GET，PUT，DELETE可以提供CRUD功能（創(chuàng)建，獲取，更新，刪除）。

獲?。菏褂肎ET方法獲取資源。GET請求從不改變資源的狀態(tài)，無副作用。GET方法是冪等的。GET方法具有只讀的含義。因此，你可以完美的使用緩存

創(chuàng)建：使用POST創(chuàng)建新的資源。對同一URL進行多次請求會生成多份資源，所以POST不是冪等的

更新：使用PUT創(chuàng)建或更新現(xiàn)有資源。對同一URL多次PUT都是相同的，所以PUT方法是冪等的

刪除：使用DELETE刪除現(xiàn)有資源，有副作用，但DELETE方法是冪等的

冪等操作的特點是其任意多次執(zhí)行所產(chǎn)生的影響均與一次執(zhí)行的影響相同

完成UserController的編碼

/**
 * 用戶信息管理
 */
@Controller
public class UserController {

    @Autowired
    private UserService userService;

    /*
     * 獲取用戶列表
     *
     * @return
     * @throws Exception
     */
    @ResponseBody
    @GetMapping("/users")
    public ResultBean> getUsers() throws Exception {

        List users = userService.getUsers();

        return new ResultBean>(users);
    }

    /*
     * 新增用戶信息
     *
     * @return
     * @throws Exception
     */
    @ResponseBody
    @PostMapping("/users")
    public ResultBean insertUser(@RequestBody User user) throws Exception {

        int result = userService.insertUser(user);

        if (result > 0) {
            return new ResultBean();
        } else {
            return new ResultBean("新增失敗");
        }
    }

    /*
     * 獲取用戶信息
     *
     * @param id 用戶id
     * @return
     * @throws Exception
     */
    @ResponseBody
    @GetMapping("/users/{id}")
    public ResultBean getUser(@PathVariable Integer id) throws Exception {

        User user = userService.getUser(id);

        return new ResultBean(user);
    }

    /*
     * 修改用戶信息
     *
     * @return
     * @throws Exception
     */
    @ResponseBody
    @PutMapping("/users/{id}")
    public ResultBean updateUser(@PathVariable Integer id, @RequestBody User user) throws Exception {

        user.setId(id);
        int result = userService.updateUser(user);

        if (result > 0) {
            return new ResultBean();
        } else {
            return new ResultBean("修改失敗");
        }

    }

    /*
     * 刪除用戶信息
     *
     * @param id 用戶id
     * @return
     * @throws Exception
     */
    @ResponseBody
    @DeleteMapping("/users/{id}")
    public ResultBean deleteUser(@PathVariable Integer id) throws Exception {

        int result = userService.deleteUser(id);

        if (result > 0) {
            return new ResultBean();
        } else {
            return new ResultBean("刪除失敗");
        }
    }
}

使用@RequestBody注解常用來處理content-type不是默認的application/x-www-form-urlcoded編碼的內(nèi)容，比如說：application/json或者是application/xml等，本例子目標是處理application/json
使用@PathVariable Integer id映射@RequestMapping("/users/{id}") / @GetMapping("/users/{id}") / @DeleteMapping("/users/{id}")等請求中的{id}

fastjson是阿里巴巴的開源JSON解析庫，它可以解析JSON格式的字符串，支持將Java Bean序列化為JSON字符串，也可以從JSON字符串反序列化到JavaBean。

         
    ...
         
    
    
        ...
        
        
            com.alibaba
            fastjson
            1.2.47
        
        
        ...
        
    
    
    ...
    

/conf/spring-mvc.xml中添加FastJson，F(xiàn)astJson采用默認配置已經(jīng)足夠面對大多數(shù)場景

    ...

    
    
        
            
        
    

    ...

手把手教你整合最優(yōu)雅SSM框架
我的編碼習(xí)慣-接口定義
RESTful API 設(shè)計最佳實踐