spring学习（一）—— spring mvc

目的

了解Spring mvc

学习对象

https://github.com/spring-projects/spring-mvc-showcase

学习收获

1. 自定义注解

// 以下是注解接口
Target(value={ElementType.FIELD, ElementType.METHOD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface MaskFormat {
	String value();
}

// 以下是使用注解
@MaskFormat("(###) ###-####")
private String masked;

　　

2. RequestMapping注解

• 可修饰类 和 方法，对应的url按层级累加
• 可指定Get/Post方法

@Controller
@RequestMapping("/data")
public class RequestDataController {

	@RequestMapping(value="param", method=RequestMethod.GET)
	public @ResponseBody String withParam(@RequestParam String foo) {  // 对应url  /data/param?foo=bar
		return "Obtained 'foo' query parameter value '" + foo + "'";
	}

	@RequestMapping(value="path/{var}", method=RequestMethod.GET)
	public @ResponseBody String withPathVariable(@PathVariable String var) { // 对应url /data/path/bar
		return "Obtained 'var' path variable value '" + var + "'";
	}
}

@Controller
public class MappingController {
        @RequestMapping("/mapping/path")   
	public @ResponseBody String byPath() { // 最常见的
		return "Mapped by path!";
	}
	@RequestMapping(value="/mapping/path/*", method=RequestMethod.GET)
	public @ResponseBody String byPathPattern(HttpServletRequest request) { // 模式匹配到一组 url
		return "Mapped by path pattern ('" + request.getRequestURI() + "')";
	}
}
    

3. java bean就是基础的对象类，每个属性可通过注解添加限制，也可用于json的转化

@XmlRootElement
public class JavaBean {
        @NotNull
        private String fruit;

        @NotEmpty // 非空
	private String name;
	
	@Min(21) // 限定取值范围
	private int age;

        @DateTimeFormat(iso=ISO.DATE)
	@Past  // 必须是过去的时间，相反的是 Future
	private Date birthDate;
        
        @MaskFormat("(###) ###-####") //  自定义的格式
	private String phone;

        @NumberFormat(style=Style.PERCENT)
	private BigDecimal percent;        

        public JavaBean() {  // 构造方法1
	}

	public JavaBean(String foo) { // 构造方法2
		this.foo = foo;
	}

	@Override
	public String toString() { // java bean作为最基础的对象类，一般会重构toString方法
		return "JavaBean {foo=[" + foo + "]]}";
	}
}

// 一些场景下（如调用接口）可通过序列化的对象 根据java bean定义反转义回来
String json = MapUtils.getString(params,"json");
JavaBean aBean = JsonUtil.toObject(json, JavaBean.class);  

4. 通过mock测试页面访问 或者 调用其他第三方服务

日常项目中，不可避免会涉及多个系统的交互，如前后端的交互、多个后端系统间的交互、子系统间的交互。为了避免开发进度受上游服务的影响，可在确定好页面url或接口形式后，通过调用方通过mock测试数据来模拟交互，确定好测试用例，也方便了每次相关代码有修改进行回归测试。junit提供了对应的方法以方便测试。

import org.junit.Test;

public class SimpleControllerTests {

	@Test
	public void simple() throws Exception {
		standaloneSetup(new SimpleController()).build()
			.perform(get("/simple"))  // 模拟浏览器访问url
			.andExpect(status().isOk())  // andExpect 断言 判断请求返回的内容
			.andExpect(content().contentType("text/plain;charset=ISO-8859-1"))
			.andExpect(content().string("Hello world!")); // 内容是...
	}

}


public class StandardArgumentsControllerTests {
	private MockMvc mockMvc;

	@Before  
	public void setup() throws Exception { // @org.junit.Before下需要实现setup类似于初始化的方法
		this.mockMvc = standaloneSetup(new StandardArgumentsController()).alwaysExpect(status().isOk()).build(); // alwaysExpect
	}

	@Test
	public void request() throws Exception {
		this.mockMvc.perform(get("/data/standard/request")) // mock-get方法
				.andExpect(content().string(startsWith(
						"request = org.springframework.mock.web.MockHttpServletRequest@")));
	}

       @Test
       public void requestBody() throws Exception {
           this.mockMvc.perform(
             post("/data/body")  // mock-post方法
            .contentType(MediaType.TEXT_PLAIN)
            .content("foo".getBytes()))
            .andExpect(content().string("Posted request body 'foo'"));

}

5. 在本地启动jetty服务，运行java服务

详细步骤

a.  导入如上代码库工程到ide（如IDEA），系统自动选择maven构建和spring mvc依赖，导入后ide会花几分钟自动安装依赖，安装完后ide上可看到各级代码

b.  在项目根目录下执行mvn package 打包，执行完后，在target目录下产生spring-mvc-showcase.war

c.  在ide右上角绿色的运行按钮前，点击选择‘run/debug configurations’，进入设置子界面，点击左上角➕，找到jetty server，选择local 并进行简单的配置

d.  本地启动jetty服务 /opt/jetty/bin/jetty.sh start

Usage: jetty.sh [-d] {start|stop|run|restart|check|supervise} [ CONFIGS ... ] 

/o/opt/jetty/bin/jetty.sh check  // 另外check选项可以查询到jetty相关的配置路径  /usr/local/jetty-8/etc/jetty.xml中addConnector部分配置了jetty.port
Checking arguments to Jetty: 
START_INI      =  /usr/local/jetty-8/start.ini
JETTY_HOME     =  /usr/local/jetty-8
JETTY_BASE     =  /usr/local/jetty-8
JETTY_CONF     =  /usr/local/jetty-8/etc/jetty.conf 
JETTY_PID      =  /usr/local/jetty-8/jetty.pid
JETTY_START    =  /usr/local/jetty-8/start.jar
JETTY_LOGS     =  /usr/local/jetty-8/logs
JETTY_STATE    =  /usr/local/jetty-8/jetty.state
CLASSPATH      =  /Library/Java/JavaVirtualMachines/jdk1.8.0_91.jdk/Contents/Home/lib/dt.jar:/Library/Java/JavaVirtualMachines/jdk1.8.0_91.jdk/Contents/Home/lib/tools.jar
JAVA           =  /usr/bin/java
JAVA_OPTIONS   =   -Djetty.home=/usr/local/jetty-8 -Djetty.base=/usr/local/jetty-8 -Djava.io.tmpdir=/var/folders/hw/b3s7kxc173jfpf3kbty232m80000gn/T/
JETTY_ARGS     =   etc/jetty-started.xml
RUN_CMD        =  /usr/bin/java -Djetty.home=/usr/local/jetty-8 -Djetty.base=/usr/local/jetty-8 -Djava.io.tmpdir=/var/folders/hw/b3s7kxc173jfpf3kbty232m80000gn/T/ -jar /usr/local/jetty-8/start.jar etc/jetty-started.xml

e. 在ide中点击右上角绿色运行按钮，运行war服务，注意观察terminal日志输出，判断是否成功启动服务

22:09:25 [Scanner-0] DispatcherServlet - Servlet 'appServlet' configured successfully
[2016-09-18 10:09:26,015] Artifact spring-mvc-showcase.war: Artifact is deployed successfully
[2016-09-18 10:09:26,017] Artifact spring-mvc-showcase.war: Deploy took 3,604 milliseconds

d. 打开浏览器访问

http://127.0.0.1:8081/

按上面提示再跳转到

http://127.0.0.1:8081/spring-mvc-showcase/ 进入项目首页

也可以直接访问单个请求入口，如 http://127.0.0.1:8081/spring-mvc-showcase//mapping/path

总结 

面对一种新的语言，结合简单的demo学习主要的语法和特性，了解适用的场景。通过实例的代码结构，思考如果自己从0建立一个新项目如何处理