Spring Boot 入门教程学习 （按照spring boot官方文档和自己理解整理）

1. 创建Spring Boot maven项目
   1.   1. 在spring 官网中创建项目到本地

     具体过程： 访问 https://start.spring.io/    地址 创建spring boot maven项目 

  首先选择maven project  java 之后 填写 group id Artifactid  完成之后， 　点击 generate Project 生成本地项目。 

1. 2.eclipse IDE中导入刚才创建到本地的项目 

   

    具体过程: 在project explorer空白处右键，点击import  选择 Existing Maven Project 点击next 选择在spring boot中创建的本地化的项目，导入进入。基于pom.xml文件会自动将依赖jar包下载到本地的仓库中。具体如何在project 创建本地maven仓库，请自行百度解决。

   导入后，项目目录结构为：

 

其中，

• src/main/java 程序开发以及主程序入口

• src/main/resources 配置文件

• src/test/java 测试程序

另外，spingboot建议的目录结果如下：

root package结构：com.example.myproject

 

com

  +- example

    +- myproject

      +- Application.java

      |

      +- domain

      |  +- Customer.java

      |  +- CustomerRepository.java

      |

      +- service

      |  +- CustomerService.java

      |

      +- controller

      |  +- CustomerController.java

      |

 

1. Application.java 建议放到根目录下面,主要用于做一些框架配置

2. domain目录主要用于实体（Entity）与数据访问层（Repository）

3. service 层主要是业务类代码

4. controller 负责页面访问控制

1.3.引入web模块 运行spring程序

1、pom.xml中添加支持web的模块：

<dependency>

        <groupId>org.springframework.boot</groupId>

        <artifactId>spring-boot-starter-web</artifactId>

 </dependency>

 

pom.xml文件中默认有两个模块：

spring-boot-starter ：核心模块，包括自动配置支持、日志和YAML；

spring-boot-starter-test ：测试模块，包括JUnit、Hamcrest、Mockito。

编写controller内容：

@RestController

public class HelloWorldController {

    @RequestMapping("/hello")

    public String index() {

        return "Hello World";

    }

}

 

@RestController 的意思就是controller里面的方法都以json格式输出，不用再写什么jackjson配置的了！

3、启动主程序，打开浏览器访问http://localhost:8080/hello，就可以看到效果了，有木有很简单！

简单看一下主程序的代码：

一个主程序java执行的代码： SpringApplication.run(Application.class,args);

一个控制层的控制器代码：

@RestController
public class HelloWorldController {
	@RequestMapping("/hello")
    public String index() {
        return "Hello World";
    }
}

简单的用spring mvc 的requestMapper（“/hello");  以及返回值 helloWorld 

---

1. Spring boot 的web综合开发

• web中的json开发

在以前的spring 开发的时候需要我们提供json接口的时候需要做那些配置呢？

• 添加 jackjson 等相关jar包

• 配置spring controller扫描

• 对接的方法添加@ResponseBody

就这样我们会经常由于配置错误，导致406错误等等，spring boot如何做呢，只需要类添加 @RestController 即可，默认类中的方法都会以json的格式返回。

    @RestController

    public class HelloWorldController {

        @RequestMapping("/getUser")

        public User getUser() {

            User user=new User();

            user.setUserName("小明");

            user.setPassWord("xxxx");

            return user;

        }

    }

 如果我们需要使用页面开发只要使用 @Controller ，下面会结合模板来说明。

运行一下 结果自然出来了；

 

•  自定义Filter开发

 

我们常常在项目中会使用filters用于录调用日志、排除有XSS威胁的字符、执行权限验证等等。Spring Boot自动添加了OrderedCharacterEncodingFilter和HiddenHttpMethodFilter，并且我们可以自定义Filter。

两个步骤：

1. 实现Filter接口，实现Filter方法 与传统的Filter 的实现过程一样  实现Filter 过滤器 重写 init（） destroy() doFilter(request,response,chainFilter);  

2. 添加@Configurationz 注解，将自定义Filter加入过滤链

其实是写一个类 使用@Configuration  注解

  获取RemoteIpFIlter 对象   将自定义FIlter 在FilterRegistrationBean中注册 

具体实现代码如下：

package spring.demo.filter;

import java.io.IOException;

import javax.servlet.Filter;
import javax.servlet.FilterChain;
import javax.servlet.FilterConfig;
import javax.servlet.ServletException;
import javax.servlet.ServletRequest;
import javax.servlet.ServletResponse;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
public class MyFilter implements Filter{

	@Override
	public void destroy() {
		// TODO Auto-generated method stub
		System.out.println("过滤器的销毁");
	}

	@Override
	public void doFilter(ServletRequest arg0, ServletResponse arg1, FilterChain filterChain)
			throws IOException, ServletException {
		// TODO Auto-generated method stub
		
	    HttpServletRequest request = (HttpServletRequest) arg0;
	    HttpServletResponse response = (HttpServletResponse)arg1;
        System.out.println("this is MyFilter,url :"+request.getRequestURI());
        filterChain.doFilter(request, response);
		
		
	}

	@Override
	public void init(FilterConfig arg0) throws ServletException {
		// TODO Auto-generated method stub
		System.out.println("过滤器的初始化");
	}

}

    

package spring.demo.filter;

import org.apache.catalina.filters.RemoteIpFilter;
import org.springframework.boot.web.servlet.FilterRegistrationBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class WebConfiguration {
	@Bean
	public RemoteIpFilter remoteIpFilter() {
        return new RemoteIpFilter();
    }
	@Bean
	 public FilterRegistrationBean testFilterRegistration() {
	        FilterRegistrationBean registration = new FilterRegistrationBean();
	        registration.setFilter(new MyFilter());
	        registration.addUrlPatterns("/*");
	        //registration.addInitParameter("paramName", "paramValue");
	        registration.setName("MyFilter");
	        registration.setOrder(1);
	        return registration;
	    }
}

• 自定义Property

  在web开发过程中，我经常需要自定义一些配置文件，如何使用？

自定义配置类

spring boot使用application.properties默认了很多配置。但需要自己添加一些配置的时候，我们应该怎么做呢。

若继续在application.properties中添加

如：

1.     wisely2.name=wyf2  

2.     wisely2.gender=male2  

定义配置类：

1.     @ConfigurationProperties(prefix = "wisely2")  

2.     public class Wisely2Settings {  

3.         private String name;  

4.         private String gender;  

5.         public String getName() {  

6.             return name;  

7.         }  

8.         public void setName(String name) {  

9.             this.name = name;  

10.       }  

11.       public String getGender() {  

12.           return gender;  

13.       }  

14.       public void setGender(String gender) {  

15.           this.gender = gender;  

16.       }  

18.   } 

 

若新用新的配置文件

如我新建一个wisely.properties

1.     wisely.name=wangyunfei  

2.     wisely.gender=male  

 

需定义如下配置类

1.     @ConfigurationProperties(prefix = "wisely",locations = "classpath:config/wisely.properties")  

2.     public class WiselySettings {  

3.         private String name;  

4.         private String gender;  

5.         public String getName() {  

6.             return name;  

7.         }  

8.         public void setName(String name) {  

9.             this.name = name;  

10.       }  

11.       public String getGender() {  

12.           return gender;  

13.       }  

14.       public void setGender(String gender) {  

15.           this.gender = gender;  

16.       }  

17.     

18.   }  

 

最后注意在spring Boot入口类加上@EnableConfigurationProperties

1.     @SpringBootApplication  

2.     @EnableConfigurationProperties({WiselySettings.class,Wisely2Settings.class})  

3.     public class DemoApplication {  

4.       

5.         public static void main(String[] args) {  

6.             SpringApplication.run(DemoApplication.class, args);  

7.         }  

8.     }  

 

使用定义的properties

1.     @Controller  

2.     public class TestController {  

3.         @Autowired  

4.         WiselySettings wiselySettings;  

5.         @Autowired  

6.         Wisely2Settings wisely2Settings;  

7.       

8.         @RequestMapping("/test")  

9.         public @ResponseBody String test(){  

10.           System.out.println(wiselySettings.getGender()+"---"+wiselySettings.getName());  

11.           System.out.println(wisely2Settings.getGender()+"==="+wisely2Settings.getGender());  

12.           return "ok";  

13.       }   

14.   }  

 

   

    @Component

    public class NeoProperties {

        @Value("${com.neo.title}")

        private String title;

        @Value("${com.neo.description}")

        private String description;

     

        //省略getter settet方法

     

    }

 LOG的配置 

    logging.path=/user/local/log

    logging.level.com.favorites=DEBUG

    logging.level.org.springframework.web=INFO

    logging.level.org.hibernate=ERROR

 

path为本机的log地址，logging.level 后面可以根据包路径配置不同资源的log级别。

一般日志有四种输出级别 debug -> info -> error -> fatel 

开发环境一般设置的是debug  上线环境 一般设置为info

 

• 数据库操作

在这里我重点讲述mysql、spring data jpa的使用，其中mysql 就不用说了大家很熟悉，jpa是利用Hibernate生成各种自动化的sql，如果只是简单的增删改查，基本上不用手写了，spring内部已经帮大家封装实现了。

下面简单介绍一下如何在spring boot中使用。

 步骤

  1.添加相关jar包

    <dependency>

        <groupId>org.springframework.boot</groupId>

        <artifactId>spring-boot-starter-data-jpa</artifactId>

    </dependency>

     <dependency>

        <groupId>mysql</groupId>

        <artifactId>mysql-connector-java</artifactId>

    </dependency>

 2.添加相关的配置信息  

    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

     

    spring.jpa.properties.hibernate.hbm2ddl.auto=update

    spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL5InnoDBDialect

    spring.jpa.show-sql= true

 

其实这个hibernate.hbm2ddl.auto参数的作用主要用于：自动创建|更新|验证数据库表结构,有四个值：

1. create： 每次加载hibernate时都会删除上一次的生成的表，然后根据你的model类再重新来生成新表，哪怕两次没有任何改变也要这样执行，这就是导致数据库表数据丢失的一个重要原因。

2. create-drop ：每次加载hibernate时根据model类生成表，但是sessionFactory一关闭,表就自动删除。

3. update：最常用的属性，第一次加载hibernate时根据model类会自动建立起表的结构（前提是先建立好数据库），以后加载hibernate时根据 model类自动更新表结构，即使表结构改变了但表中的行仍然存在不会删除以前的行。要注意的是当部署到服务器后，表结构是不会被马上建立起来的，是要等 应用第一次运行起来后才会。

4. validate ：每次加载hibernate时，验证创建数据库表结构，只会和数据库中的表进行比较，不会创建新表，但是会插入新值。

dialect 主要是指定生成表名的存储引擎为InneoDB show-sql 是否打印出自动生产的SQL，方便调试的时候查看

3.添加实体类和DAO操作层

    @Entity

    public class User implements Serializable {

     

        private static final long serialVersionUID = 1L;

        @Id

        @GeneratedValue

        private Long id;

        @Column(nullable = false, unique = true)

        private String userName;

        @Column(nullable = false)

        private String passWord;

        @Column(nullable = false, unique = true)

        private String email;

        @Column(nullable = true, unique = true)

        private String nickName;

        @Column(nullable = false)

        private String regTime;

     

        //省略getter settet方法、构造方法

     

    }

dao只要继承JpaRepository类就可以，几乎可以不用写方法，还有一个特别有尿性的功能非常赞，就是可以根据方法名来自动的生产SQL，比如findByUserName 会自动生产一个以 userName 为参数的查询方法，比如 findAlll 自动会查询表里面的所有数据，比如自动分页等等。

Entity中不映射成列的字段得加@Transient 注解，不加注解也会映射成列。

    public interface UserRepository extends JpaRepository<User, Long> {

        User findByUserName(String userName);

        User findByUserNameOrEmail(String username, String email);

4.测试代码

    @RunWith(SpringJUnit4ClassRunner.class)

    @SpringApplicationConfiguration(Application.class)

    public class UserRepositoryTests {

     

        @Autowired

        private UserRepository userRepository;

     

        @Test

        public void test() throws Exception {

            Date date = new Date();

            DateFormat dateFormat = DateFormat.getDateTimeInstance(DateFormat.LONG, DateFormat.LONG);        

            String formattedDate = dateFormat.format(date);

             

            userRepository.save(new User("aa1", "aa@126.com", "aa", "aa123456",formattedDate));

            userRepository.save(new User("bb2", "bb@126.com", "bb", "bb123456",formattedDate));

            userRepository.save(new User("cc3", "cc@126.com", "cc", "cc123456",formattedDate));

     

            Assert.assertEquals(9, userRepository.findAll().size());

            Assert.assertEquals("bb", userRepository.findByUserNameOrEmail("bb", "cc@126.com").getNickName());

            userRepository.delete(userRepository.findByUserName("aa1"));

        }

     

    }

 

当让 spring data jpa 还有很多功能，比如封装好的分页，可以自己定义SQL，主从分离等等，这里就不详细讲了。

5.thymeleaf模板5.

Spring boot 推荐使用来代替jsp,thymeleaf模板到底是什么来头呢，让spring大哥来推荐，下面我们来聊聊。

Thymeleaf是一款用于渲染XML/XHTML/HTML5内容的模板引擎。类似JSP，Velocity，FreeMaker等，它也可以轻易的与Spring MVC等Web框架进行集成作为Web应用的模板引擎。与其它模板引擎相比，Thymeleaf最大的特点是能够直接在浏览器中打开并正确显示模板页面，而不需要启动整个Web应用。

好了，你们说了我们已经习惯使用了什么 velocity,FreMaker，beetle之类的模版，那么到底好在哪里呢？ 比一比吧 Thymeleaf是与众不同的，因为它使用了自然的模板技术。这意味着Thymeleaf的模板语法并不会破坏文档的结构，模板依旧是有效的XML文档。模板还可以用作工作原型，Thymeleaf会在运行期替换掉静态值。Velocity与FreeMarker则是连续的文本处理器。 下面的代码示例分别使用Velocity、FreeMarker与Thymeleaf打印出一条消息：

Velocity: <p>$message</p>

FreeMarker: <p>${message}</p>

Thymeleaf: <p th:text="${message}">Hello World!</p>

 

** 注意，由于Thymeleaf使用了XML DOM解析器，因此它并不适合于处理大规模的XML文件。**

URL

 

URL在Web应用模板中占据着十分重要的地位，需要特别注意的是Thymeleaf对于URL的处理是通过语法@{…}来处理的。Thymeleaf支持绝对路径URL：

 

<a th:href="@{http://www.thymeleaf.org}">Thymeleaf</a>

 

条件求值

 

<a th:href="@{/login}" th:unless=${session.user != null}>Login</a>

 

for循环

 

<tr th:each="prod : ${prods}">

<td th:text="${prod.name}">Onions</td>

<td th:text="${prod.price}">2.41</td>

<td th:text="${prod.inStock}? #{true} : #{false}">yes</td>

</tr>

 

就列出这几个吧

6.页面即原型

在Web开发过程中一个绕不开的话题就是前端工程师与后端工程师的写作，在传统Java Web开发过程中，前端工程师和后端工程师一样，也需要安装一套完整的开发环境，然后各类Java IDE中修改模板、静态资源文件，启动/重启/重新加载应用服务器，刷新页面查看最终效果。

但实际上前端工程师的职责更多应该关注于页面本身而非后端，使用JSP，Velocity等传统的Java模板引擎很难做到这一点，因为它们必须在应用服务器中渲染完成后才能在浏览器中看到结果，而Thymeleaf从根本上颠覆了这一过程，通过属性进行模板渲染不会引入任何新的浏览器不能识别的标签，例如JSP中的，不会在Tag内部写表达式。整个页面直接作为HTML文件用浏览器打开，几乎就可以看到最终的效果，这大大解放了前端工程师的生产力，它们的最终交付物就是纯的HTML/CSS/JavaScript文件。

7.Gradle 构建工具

spring 项目建议使用Gradle进行构建项目，相比maven来讲 Gradle更简洁，而且gradle更时候大型复杂项目的构建。gradle吸收了maven和ant的特点而来，不过目前maven仍然是Java界的主流，大家可以先了解了解。

一个使用gradle配置的项目。

    buildscript {

        repositories {

            maven { url "http://repo.spring.io/libs-snapshot" }

            mavenLocal()

        }

        dependencies {

            classpath("org.springframework.boot:spring-boot-gradle-plugin:1.3.6.RELEASE")

        }

    }

     

    apply plugin: 'java'  //添加 Java 插件, 表明这是一个 Java 项目

    apply plugin: 'spring-boot' //添加 Spring-boot支持

    apply plugin: 'war'  //添加 War 插件, 可以导出 War 包

    apply plugin: 'eclipse' //添加 Eclipse 插件, 添加 Eclipse IDE 支持, Intellij Idea 为 "idea"

     

    war {

        baseName = 'favorites'

        version =  '0.1.0'

    }

     

    sourceCompatibility = 1.7  //最低兼容版本 JDK1.7

    targetCompatibility = 1.7  //目标兼容版本 JDK1.7

     

    repositories {     //  Maven 仓库

        mavenLocal()        //使用本地仓库

        mavenCentral()      //使用中央仓库

        maven { url "http://repo.spring.io/libs-snapshot" } //使用远程仓库

    }

      

    dependencies {   // 各种 依赖的jar包

        compile("org.springframework.boot:spring-boot-starter-web:1.3.6.RELEASE")

        compile("org.springframework.boot:spring-boot-starter-thymeleaf:1.3.6.RELEASE")

        compile("org.springframework.boot:spring-boot-starter-data-jpa:1.3.6.RELEASE")

        compile group: 'mysql', name: 'mysql-connector-java', version: '5.1.6'

        compile group: 'org.apache.commons', name: 'commons-lang3', version: '3.4'

        compile("org.springframework.boot:spring-boot-devtools:1.3.6.RELEASE")

        compile("org.springframework.boot:spring-boot-starter-test:1.3.6.RELEASE")

        compile 'org.webjars.bower:bootstrap:3.3.6'

        compile 'org.webjars.bower:jquery:2.2.4'

        compile("org.webjars:vue:1.0.24")

        compile 'org.webjars.bower:vue-resource:0.7.0'

     

    }

     

    bootRun {

        addResources = true

    }

8.WebJars

WebJars是一个很神奇的东西，可以让大家以jar包的形式来使用前端的各种框架、组件。

什么是WebJars

什么是WebJars？WebJars是将客户端（浏览器）资源（JavaScript，Css等）打成jar包文件，以对资源进行统一依赖管理。WebJars的jar包部署在Maven中央仓库上。

为什么使用

我们在开发Java web项目的时候会使用像Maven，Gradle等构建工具以实现对jar包版本依赖管理，以及项目的自动化管理，但是对于JavaScript，Css等前端资源包，我们只能采用拷贝到webapp下的方式，这样做就无法对这些资源进行依赖管理。那么WebJars就提供给我们这些前端资源的jar包形势，我们就可以进行依赖管理。

如何使用

1、 WebJars主官网 查找对于的组件，比如Vuejs：

    <dependency>

        <groupId>org.webjars.bower</groupId>

        <artifactId>vue</artifactId>

        <version>1.0.21</version>

    </dependency>

2、页面引入

<link th:href="@{/webjars/bootstrap/3.3.6/dist/css/bootstrap.css}" rel="stylesheet"></link>

就可以正常使用了！

示例代码：

https://github.com/ityouknow/spring-boot-examples

• 新一代Java模板引擎Thymeleaf

  http://www.tianmaying.com/tutorial/using-thymeleaf

• Spring Boot参考指南-中文版

  https://qbgbook.gitbooks.io/spring-boot-reference-guide-zh/content/