Springboot快速入门与整合

 

第一部分.搭建一个springboot工程

    1、创建一个Maven工程(打包方式为jar)

    2、pom文件引入依赖

    <parent>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-parent</artifactId>
		<version>1.3.3.RELEASE</version>
    </parent>
	<dependencies>
		<dependency>
             <!-SpringBoot web 组件 -->
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-web</artifactId>
		</dependency>
	</dependencies>

spring-boot-starter-parent作用

在pom.xml中引入spring-boot-start-parent，它可以提供dependency management，也就是说依赖管理，引入以后在引入其它dependency的时候就不需要申明version了。

spring-boot-starter-web作用

springmvc、tomcat、模板引擎等等一系列核心组件

3、创建一个HelloWorldController

package cn.itcats.controller;

import java.util.HashMap;
import java.util.Map;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.servlet.ModelAndView;

//标识该接口全部返回json格式   @ResponseBody+@Controller
@RestController
@EnableAutoConfiguration
public class HelloWorldController {
	@RequestMapping("/index")
	public String index(){
		return "success";
	}
	
	@RequestMapping("/getMap")
	public Map<String,String> getMap(){
		Map<String,String> map = new HashMap<String, String>();
		map.put("hello", "world");
		map.put("hi", "hello");
		return map;
	}
	
	
}

4、创建启动类App.java

@ComponentScan(basePackages = "cn.itcats.controller")
@EnableAutoConfiguration
public class App {
	public static void main(String[] args) {
		SpringApplication.run(App.class, args);
	}
}

5、运行

http://localhost:8080/index

http://localhost:8080/getMap

备注：

@RestController

在上加上RestController 表示修饰该Controller所有的方法返回JSON格式,直接可以编写Restful接口,相当于@Controller+@RequestBody

 

@EnableAutoConfiguration

让 Spring Boot根据应用所声明的依赖来对 Spring 框架进行自动配置
这个注解告诉Spring Boot根据添加的jar依赖猜测你想如何配置Spring。由于spring-boot-starter-web添加了Tomcat和Spring MVC，将假定你正在开发一个web应用并相应地对Spring进行设置。

 

@ComponentScan(basePackages = "cn.itcats.controller")

控制器扫包范围

 

第二部分.静态资源访问

在我们开发Web应用的时候，需要引用大量的js、css、图片等静态资源。

默认配置

Spring Boot默认提供静态资源目录位置需置于classpath下，目录名需符合如下规则：

/static

/public

/resources        

/META-INF/resources

举例：我们可以在src/main/resources/目录下创建static文件夹，在该位置放置一个图片文件1.jpg。启动程序后，尝试访问http://localhost:8080/1.jpg。如能显示图片，配置成功。

第三部分.全局捕获异常

• @ExceptionHandler(RuntimeException.class)  表示拦截运行时异常异常
• @ControllerAdvice 是 controller 的一个辅助类，最常用的就是作为全局异常处理的切面类
• @ControllerAdvice 可以指定扫描范围
• @ControllerAdvice 约定了几种可行的返回值，如果是直接返回 model 类的话，需要使用 @ResponseBody 进行 json 转换
  • 返回 String，表示跳到某个 view
  • 返回 modelAndView
  • 返回 model + @ResponseBody
  • 返回 map + @ResponseBody

package cn.itcats.controller;

import java.util.HashMap;
import java.util.Map;

import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseBody;

//作为Controller注解的辅助注解,是全局异常处理的切面类
@ControllerAdvice
public class GlobalExceptionHandler {
    //@ExceptionHandler需要申明对什么异常进行拦截
	@ExceptionHandler(RuntimeException.class)
	@ResponseBody
	public Map<String,String> exceptionHandler(){
		Map<String,String> map = new HashMap<String, String>();
		map.put("errorCode", "500");
		map.put("errorMsg", "系统错误");
		return map;
	}
}

第四部分.渲染Web页面(模板引擎)

渲染Web页面

在之前的示例中，我们都是通过@RestController来处理请求，所以返回的内容为json对象。那么如果需要渲染html页面的时候，要如何实现呢？

模板引擎

在动态HTML实现上Spring Boot依然可以完美胜任，并且提供了多种模板引擎的默认配置支持，所以在推荐的模板引擎下，我们可以很快的上手开发动态网站。

Spring Boot提供了默认配置的模板引擎主要有以下几种：

• Thymeleaf
• FreeMarker
• Velocity
• Groovy
• Mustache

Spring Boot建议使用这些模板引擎，避免使用JSP，若一定要使用JSP将无法实现Spring Boot的多种特性，具体可见后文：支持JSP的配置

当你使用上述模板引擎中的任何一个，它们默认的模板配置路径为：src/main/resources/templates。当然也可以修改这个路径，具体如何修改，可在后续各模板引擎的配置属性中查询并修改。

 

4.1、使用Freemarker模板引擎渲染web视图

1、pom文件引入:

<!-- 引入freeMarker的依赖包. -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>

2、在src/main/resources/创建一个templates文件夹,创建文件后缀为*.ftl

<!DOCTYPE html>
<html>
        <head lang="en">
        <meta charset="UTF-8" />
        <title>测试freemarker</title>
    </head>

    <body>
	  ${name}
    </body> 
</html>

3、后台代码:

package cn.itcats.controller;

import java.util.Map;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class FreemarkerTest {
	@RequestMapping("/getIndex")
	public String getIndex(Map<String,String> map){
		map.put("name", "张三");
		return "index";
	}
}

plus:

Freemarker配置

新建application.properties文件

########################################################
###FREEMARKER (FreeMarkerAutoConfiguration)
########################################################
spring.freemarker.allow-request-override=false
spring.freemarker.cache=true
spring.freemarker.check-template-location=true
spring.freemarker.charset=UTF-8
spring.freemarker.content-type=text/html
spring.freemarker.expose-request-attributes=false
spring.freemarker.expose-session-attributes=false
spring.freemarker.expose-spring-macro-helpers=false
#spring.freemarker.prefix=
#spring.freemarker.request-context-attribute=
#spring.freemarker.settings.*=
spring.freemarker.suffix=.ftl
spring.freemarker.template-loader-path=classpath:/templates/
#comma-separated list
#spring.freemarker.view-names= # whitelist of view names that can be resolved

4.2、使用JSP渲染Web视图

注意：springboot中使用jsp在创建maven工程时候打包方式为war

1、pom文件引入以下依赖

<parent>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-parent</artifactId>
		<version>1.3.3.RELEASE</version>
</parent>
	<dependencies>
		<!-- SpringBoot 核心组件 -->
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-web</artifactId>
		</dependency>
                <!-- jsp依赖 -->
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-tomcat</artifactId>
		</dependency>
		<dependency>
			<groupId>org.apache.tomcat.embed</groupId>
			<artifactId>tomcat-embed-jasper</artifactId>
		</dependency>
	</dependencies>

2、在application.properties创建以下配置

spring.mvc.view.prefix=/WEB-INF/jsp/
spring.mvc.view.suffix=.jsp

3、后台代码

@Controller
public class IndexController {
	@RequestMapping("/index")
	public String index() {
		return "index";
	}
}

再次强调：

注意：springboot中使用jsp在创建maven工程时候打包方式为war，否则会找不到页面

第五部分.数据访问

5.1、springboot整合使用JdbcTemplate

1、pom文件引入：

        <parent>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-parent</artifactId>
		<version>1.5.2.RELEASE</version>
	</parent>
	<dependencies>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-jdbc</artifactId>
		</dependency>
		<dependency>
			<groupId>mysql</groupId>
			<artifactId>mysql-connector-java</artifactId>
			<version>5.1.21</version>
		</dependency>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-test</artifactId>
			<scope>test</scope>
		</dependency>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-web</artifactId>
		</dependency>
	</dependencies>

2、设置数据源(application.properties新增配置)

spring.datasource.url=jdbc:mysql://localhost:3306/test
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.jdbc.Driver

3、后端代码

@Service
public class UserServiceImpl implements UserService {
	@Autowired
	private JdbcTemplate jdbcTemplate;
	public void createUser(String name, Integer age) {
		System.out.println("新增用户对象");
		jdbcTemplate.update("insert into users values(null,?,?);", name, age);
	}
}

App.java需要注意@ComponentScan(basePackages = "cn.itcats")

需要扫到service层

注意: spring-boot-starter-parent要在1.5以上

5.2、springboot整合mybatis

1、pom文件引入

	<parent>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-parent</artifactId>
		<version>1.3.2.RELEASE</version>
		<relativePath /> <!-- lookup parent from repository -->
	</parent>
	<dependencies>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter</artifactId>
		</dependency>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-test</artifactId>
			<scope>test</scope>
		</dependency>
		<dependency>
			<groupId>org.mybatis.spring.boot</groupId>
			<artifactId>mybatis-spring-boot-starter</artifactId>
			<version>1.1.1</version>
		</dependency>
		<dependency>
			<groupId>mysql</groupId>
			<artifactId>mysql-connector-java</artifactId>
			<version>5.1.21</version>
		</dependency>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-web</artifactId>
		</dependency>
	</dependencies>

2、引入数据源/src/main/resources/application.properties

spring.datasource.url=jdbc:mysql://localhost:3306/test
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.jdbc.Driver

3、创建cn.itcats.mapper包

Mapper代码：

public interface UserMapper {
	@Select("SELECT * FROM USERS WHERE NAME = #{name}")
	User findByName(@Param("name") String name);
	@Insert("INSERT INTO USERS(NAME, AGE) VALUES(#{name}, #{age})")
	int insert(@Param("name") String name, @Param("age") Integer age);
}

4、修改App.java

@EnableAutoConfiguration
@ComponentScan(basePackages = "cn.itcats")
@MapperScan(basePackages = "cn.itcats.mapper")
public class App {
	public static void main(String[] args) {
		SpringApplication.run(App.class, args);
	}
}

5.3、springboot整合springjpa

1、pom文件引入依赖

        <parent>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-parent</artifactId>
		<version>1.4.2.RELEASE</version>
	</parent>
	<dependencies>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-data-jpa</artifactId>
		</dependency>
		<dependency>
			<groupId>mysql</groupId>
			<artifactId>mysql-connector-java</artifactId>
			<version>5.1.21</version>
		</dependency>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-web</artifactId>
		</dependency>
	</dependencies>

2、创建User实体类

@Entity(name = "users")
public class User {
	@Id
	@GeneratedValue
	private Integer id;
	@Column
	private String name;
	@Column
	private Integer age;
      // ..get/set方法
}

3、创建UserDao并继承JpaRepository

public interface UserDao extends JpaRepository<User, Integer> {}

4、创建IndexJpaController

@RestController
public class IndexJpaController {
	@Autowired
	private UserDao userDao;
	@RequestMapping("/index")
	public String index(Integer id) {
		User findUser = userDao.findOne(id);
		System.out.println(findUser.getName());
		return "success";
	}
}

5、修改App.java

@ComponentScan(basePackages = { "cn.itcats" })
@EnableJpaRepositories(basePackages = "cn.itcats.dao")
@EnableAutoConfiguration
@EntityScan(basePackages = "cn.itcats.entity")
public class App {
	public static void main(String[] args) {
		SpringApplication.run(App.class, args);
	}
}