项目实践技术点积累

2016-08-16 本文已影响92人韬韬不绝

velocity

标签内使用判断语句，修改标签属性

<li #if(${module}=="users") class="active" #end><a href="/admin/users">账号管理</a></li>

使用模板布局，并传输参数

#set($module="users")
#parse( '/admin/nav_bar.html' )

让velocity解析url上的参数

在application.properties上添加配置：

spring.velocity.exposeRequestAttributes=true

velocity页面中文乱码问题

需要添加以下三个配置项

spring.velocity.charset=UTF-8
spring.velocity.properties.input.encoding=UTF-8
spring.velocity.properties.output.encoding=UTF-8

velocity 中的null值处理

后台传的值为null，默认情况下，velocity会把变量 ${variable} 直接显示出来，而不会解析为空字符串。
如果要解析为空字符串，需把变量写成 $!{variable}
可以用#if("$!{varName}" == "") 来判断变量空值。

Spring-boot

全局配置

Spring MVC 拦截器

Spring MVC中拦截器是实现了HandlerInterceptor接口的Bean

preHandle()：预处理回调方法，若方法返回值为true，请求继续（调用下一个拦截器或处理器方法）；若方法返回值为false，请求处理流程中断，不会继续调用其他的拦截器或处理器方法，此时需要通过response产生响应；
postHandle()：后处理回调方法，实现处理器的后处理（但在渲染视图之前），此时可以通过modelAndView对模型数据进行处理或对视图进行处理
afterCompletion()：整个请求处理完毕回调方法，即在视图渲染完毕时调用
大部分时候可能只需要实现其中的preHandle()方法。

public class Interceptor extends HandlerInterceptorAdapter {

    public boolean preHandle(HttpServletRequest request,
                             HttpServletResponse response,
                             Object handler) throws Exception {
        System.out.println("This is interceptor.");
        return true;
    }
}

Spring 异常处理

不要在``@Controller中自己进行异常处理逻辑。即使它只是一个Controller相关的特定异常，在@Controller中添加一个@ExceptionHandler方法处理。
对于自定义的异常，可以考虑对其加上@ResponseStatus注解
使用@ControllerAdvice处理通用异常（例如资源不存在、资源存在冲突等）

Controller部分

URL处理方法

@Controller 注解标记这是个控制器。

@RequestMapping("/hello") 注解可以配置请求路由，每一个类中都可以包含一个或多个@RequestMapping注解的方法。可以标记在类上，也可以标记在方法上。

@ResponseBody 注解表示处理函数直接将函数的返回值传回到浏览器端显示。如果不标记该注解，则默认会根据返回的字符串去模板目录下查询同名的HTML模板文件。

@RestController注解：在Controller上标注了@RestController,这样相当于Controller的所有方法都标注了@ResponseBody。Spring 4.x中支持。

URL中的变量可以用{variableName}来表示，同时在方法的参数中加上@PathVariable("variableName")，那么当请求被转发给该方法处理时，对应的URL中的变量会被自动赋值给被@PathVariable注解的参数（能够自动根据参数类型赋值）。
如果用@RequestParam注解可以解析HTTP请求中Body中的内容。

@RequestMapping("/posts/{id}")
public String post(@PathVariable("id") int id) {
    return String.format("post %d", id);
}

@RequestMapping("/test")
 public String test(@RequestParam("name") String name){
  return "name=" + name;
 }

页面redirect重定向

Spring MVC通过返回值中添加redirect:前缀来完成此类重定向，如果需要封装参数，可以使用RedirectView。

@RequestMapping(value = "/", method = RequestMethod.POST)
public String create(@Valid Post post, BindingResult result) {
    Post p = Data.add(post);
    return "redirect:/posts/" + p.getId();
}

forward跳转后给页面传参

@RequestMapping(value = "/create")
public String create(@Valid Post post, HttpServletRequest request) {
    request.setAttribute("status",1);
    return "forward:/admin/index";
}

Spring boot 自定义返回JSON（不使用对象）

Spring boot 如果在Controller上标记@ResponseBody，则框架会对响应信息默认进行JSON格式转换，如果返回对象，则会把对象格式化为标准JSON。
但是如果开发者想自定义JSON时，总不能每个JSON都去创建一个Entity类，这里建议使用返回Map的形式，也会被框架格式化为JSON。

@RequestMapping("/posts/{id}")
@ResponseBody
public String post(@PathVariable("id") int id) {
  Map<String,String> ret = new HashMap<String, String>(); 
  ret.put("success", "true");
  ret.put("updateRows", String.valueOf(i));
  return ret;
}

错误处理

发现错误以后，需要重新返回创建文章的页面并把错误提示给用户：

@RequestMapping(value = "/", method = RequestMethod.POST)
public String create(@Valid Post post, BindingResult result) {
    if (result.hasErrors()) {
        return "create";
    }
    Data.posts.add(post);
    return "createResult";
}

模板中获取错误信息：

<form action="/posts/" method="post" th:object="${post}">
  <div class="form-group">
    <label for="title">标题</label>
    <input type="text" class="form-control"
           id="title" name="title" th:field="*{title}"
           placeholder="文章的标题" autofocus=""/>
    <p th:if="${#fields.hasErrors('title')}" th:errors="*{title}">标题长度必须在2-30之间</p>
  </div>
  <div class="form-group">
    <label for="content">内容</label>
    <textarea class="form-control" id="content" name="content" th:field="*{content}"
              placeholder="文章的内容" rows="18"></textarea>
    <p th:if="${#fields.hasErrors('content')}" th:errors="*{content}">内容不可为空</p>
  </div>
  <button type="submit" class="btn pull-right btn-primary">保存</button>
</form>

具体例子参考：http://course.tianmaying.com/web-development/lesson/form-validation#

Spring数据绑定

如果某个功能提交的请求参数较多，Spring支持在@RequestMapping注解的方法中使用对象来进行参数绑定。

@RequestMapping(value = "/posts", method = RequestMethod.POST)
public String create(Post post) {
    Data.posts.add(post);
    return "createResult";
}

本质上Post post参数实际上是由Spring创建并设置相应的字段，所以需要保证Post类有默认构造函数。

数据处理部分

Spring data JPA 使用更新操作

需要用@Modifying来标记这是个更新语句。
需要在Service方法上标记@Transactional事务注解，否则更新/删除操作会报错。

@Modifying
@Transactional
@Query("update User u set u.enable = :enable where u.id = :id")
public int enableUser(@Param("id") Long id,  @Param("enable") Boolean enable);

如果是对整条数据的更新，也可以通过传入对象来更新，注意对象需设置id，否则会变成add操作。

   qa.setId(id);
   Qa qaSave = qaService.saveQa(qa);

Spring 事务处理

直接在需要添加事务的service上标注@Transactional 注解就OK了，非常简单。