Springboot入门

简介

Spring Boot是由Pivotal团队提供的全新框架，其设计目的是用来简化新Spring应用的初始搭建以及开发过程。

1.如何创建springboot项目

创建Spring Initializr项目
选则default
Group：域名倒置 com.公司名.项目
Arifact：文件名
java版本：8
package:删除到项目名
修改pom文件版本：1.5.9.RELEASE
修改test里的内容

2.@SpringBootApplication注解的作用

添加了@SpringBootApplication注解，就是一个主程序类，不要删除
@SpringBootApplication 通过@EnableAutoConfiguration将它所在的父包下的所有文件加入ioc容器中


几个注解的作用：
@Target(ElementType.TYPE) 指定该注解的位置
@Retention(RetentionPolicy.RUNTIME) 注解的生命周期
@Documented 生成文档注解
@Inherited  继承性
@SpringBootConfiguration 此类提供了应用程序配置。与@Configuration 相同 将文件变为xml文件，放入ioc容器中
@EnableAutoConfiguration 
通过@EnableAutoConfiguration将它所在的父包下的所有文件加入ioc容器中

3.Springboot的配置文件

1.application.properties文件

语法：
	server.port=8088
	spring.profiles.active=dev

2.application.yml文件

语法：---注意，冒号后面要加空格
	server:
  		port: 8089
  	
  	两种方式：
    #user:
		#  userName: tom
		#  userAge: 20
    
  	# user: {userName:tom,userAge:20}	
  		
  		
 邮件列子： spring:
  			mail:
    			host: smtp.126.com
    			username: lzyxxxean@126.com
    			password: FSHxxxxxxBJFL

集合：
 users:
  - mark
  - jack
  - marry

数组
users: [zhangsan,lisi,wangwu]	

3.文件的优先级

application.properties文件 默认情况下大于 application.yml文件 ，但是配置是互补的。


# 项目根路径 config 配置文件 > 项目根路径下配置文件 > resource 下config 配置文件 > resouces 下配置文件

# 激活profile配置文件，指定使用的配置文件(dev就是-后面的名称，例如application-dev.properties)
# spring.profiles.active=dev

4.实体如何获取配置文件中自定义的配置信息

方式一

使用注解@ConfigurationProperties(prefix = "employee")，可以批量读取

注意：此注解必须配置@Component使用，实现自动绑定配置参数，支持复杂类型，支持松散绑定
@Component
@ConfigurationProperties(prefix = "employee")

方式二

使用@Value("${属性完整配置}")，单个属性读取

注意： 此种读取方式，不支持复杂类型，语法限制比较多，不支持松散绑定，比如下划线映射驼峰。
 // 姓名
    @Value("${employee.emp_name}")
    private String empName;
    
${} 和#{}使用场景：

${}：用于读取配置文件中配置的属性值，可以设置默认值 @Value("${employee.gender:man}")
#{}：用于获取容器中已有实体的属性值，可以设置固定值

 // 工资
    @Value("#{373.10*30}")
    private Double salary;

  // 昵称
    @Value("#{employee.empName}")
    private String nickName;

方式三

使用注解读取自定义配置文件（不是配置在核心配置文件中的）
	注意：这种用法了解，一般不会单独使用，要用也是配合上面两种方式使用
 	@PropertySource(value = "classpath:employee.properties")

5.config自动配置类

@Configuration // 指定当前类是一个配置类（就类似于之前的spring的xml配置文件）。springboot项目启动时，会自动加载这个类
public class EmployeeConfig {

    /**
     * 创建一个对象，加入ioc容器，容器中对象的id值就是对应的方法名
     */
    @Bean
    public Employee employee(){
        System.out.println("创建一个Employee对象加入到容器中");

        return  new Employee();
    }

6.数据校验@Validated (controller层)

@AssertFalse	
Boolean,boolean	验证注解的元素值是false

@AssertTrue	Boolean,boolean	
验证注解的元素值是true

@NotNull	
任意类型	验证注解的元素值不是null

@Null	
任意类型	验证注解的元素值是null

@Min(value=值)	
BigDecimal，BigInteger, byte,short, int, long，等任何Number或CharSequence（存储的是数字）子类型	验证注解的元素值大于等于@Min指定的value值

@Max（value=值）	
和@Min要求一样	验证注解的元素值小于等于@Max指定的value值

@DecimalMin(value=值)	
和@Min要求一样	验证注解的元素值大于等于@ DecimalMin指定的value值

@DecimalMax(value=值)	
和@Min要求一样	验证注解的元素值小于等于@ DecimalMax指定的value值

@Digits(integer=整数位数, fraction=小数位数)	
和@Min要求一样	验证注解的元素值的整数位数和小数位数上限

@Size(min=下限, max=上限)	
字符串、Collection、Map、数组等	验证注解的元素值的在min和max（包含）指定区间之内，如字符长度、集合大小

@Past	
java.util.Date,java.util.Calendar;Joda Time类库的日期类型	验证注解的元素值（日期类型）比当前时间早

@Future	
与@Past要求一样	验证注解的元素值（日期类型）比当前时间晚

@NotBlank	
CharSequence子类型	验证注解的元素值不为空（不为null、去除首位空格后长度为0），不同于@NotEmpty，@NotBlank只应用于字符串且在比较时会去除字符串的首位空格

@Length(min=下限, max=上限)	
CharSequence子类型	验证注解的元素值长度在min和max区间内

@NotEmpty	
CharSequence子类型、Collection、Map、数组	验证注解的元素值不为null且不为空（字符串长度不为0、集合大小不为0）

@Range(min=最小值, max=最大值)	
BigDecimal,BigInteger,CharSequence, byte, short, int, long等原子类型和包装类型	验证注解的元素值在最小值和最大值之间

@Email
(regexp=正则表达式,flag=标志的模式)	CharSequence子类型（如String）	验证注解的元素值是Email，也可以通过regexp和flag指定自定义的email格式

@Pattern(regexp=正则表达式,flag=标志的模式)	
String，任何CharSequence的子类型	验证注解的元素值与指定的正则表达式匹配

@Valid	
任何非原子类型	指定递归验证关联的对象；如用户对象中有个地址对象属性，如果想在验证用户对象时一起验证地址对象的话，在地址对象上加@Valid注解即可级联验证

4.Springboot使用日志框架

注意：使用springboot 的test，必须要加@RunWith(SpringRunner.class)

1.日志级别

从这节课开始，除非为了方便或者临时调试代码，其他任何时候代码中绝对不可以出现sout
trace
debug
info
warn
error

2.日志的输出规则

自动根据指定的日志级别（及更高级别）进行日志输出，比如：当前日志级别指定为info,输出的日志包括（info warn error级别日志）

3.如何创建日志

1.使用配置文件修改日志

// 创建日志记录对象
    private Logger logger = LoggerFactory.getLogger(getClass());

// 实际开发过程中：trace 级别几乎不用，了解，
    logger.trace("—————— trace级别日志输出 ——————");
// debug和info是用最多，线上一般先开info，出问题定位，再开debug
    logger.debug("—————— debug级别日志输出 ——————");
// 实际开发时，要用info记录关键流程日志,springboot的默认日志级别就是info
    logger.info("—————— info级别日志输出 ——————");
// 正常情况下，warn级别日志不一定代表的是错误，可能是异常流程
    logger.warn("—————— warn级别日志输出 ——————");
// 作为最高级别日志，记录的日志都是系统中产生的异常（空指针，自定义异常）
    logger.error("—————— error级别日志输出 ——————");

# 修改日志级别
 logging.level.com.kgc.sbt=debug
# 指定日志输出文件,如果不写具体路径，默认在当前项目的根路径下，所有的日志都是追加
logging.file=sbt.log

# 指定本地目录生成日志
logging.file=D:\\java\\log\\sbt.log

# 指定日志输出文件目录,如果要生效，不可以和logging.file同时用，默认会自动在指定目录下，使用spring.log作为日志文件。
logging.path=D:\\java\\log\\log1

# 指定日志输出格式
# 控制台 日期，线程号，
 logging.pattern.console=%d{yyyy-MM-dd} [%thread] %-5level %logger{50} - %msg%n

# 生成文件
logging.pattern.file=%d{yyyy-MM-dd HH:mm:ss} *** [%thread] *** %-5level *** %logger{50} *** %msg%n

2.使用logback.xml文件

<?xml version="1.0" encoding="UTF-8"?>
<!--
scan：配置文件发生改变，是否被重新加载，默认值为true。
scanPeriod：设置监测配置文件是否有修改的时间间隔，当scan为true时，此属性生效。默认的时间间隔为1分钟。
debug：是否打印出logback内部日志信息，实时查看logback运行状态。默认值为false。

文件名logback.xml会被logback识别
文件名logback-spring.xml会被spring识别

-->
<configuration scan="true" scanPeriod="60 seconds" debug="false">
    <!-- 日志的根目录，可以自动创建log目录，一般公司都是统一的日志目录，不能乱写 -->
    <!--<property name="LOG_HOME" value="/Users/zhukang/Tempfiles/log" />-->
    <property name="LOG_HOME" value="D:\\java\\log" />
    <!-- 日志文件名称 -->
    <property name="appName" value="kgc-sbt-log"/>
    <!-- 控制台输出 -->
    <appender name="stdout" class="ch.qos.logback.core.ConsoleAppender">
        <!--
        日志输出格式：
			%d{日期时间格式}，
			%thread：线程名，
			%-5level：级别从左显示5个字符宽度
			%logger{60} 表示logger名字最长60个字符，否则按照句点分割。 
			%msg：记录的日志消息，
			%n是换行符
        -->
        <layout class="ch.qos.logback.classic.PatternLayout">
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{60} - %msg%n</pattern>
        </layout>
    </appender>

    <!-- 滚动文件记录，先将日志记录到指定文件，当符合某个条件时，将日志记录到其他文件 -->  
    <appender name="appLogAppender" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <!-- 指定服务器记录日志文件的名称 -->
        <file>${LOG_HOME}/${appName}.log</file>
        <!--
        当发生滚动时，决定 RollingFileAppender 的行为，涉及文件移动和重命名
        TimeBasedRollingPolicy： 最常用的滚动策略，它根据时间来制定滚动策略，既负责滚动也负责出发滚动。
        -->
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!--
            滚动时产生的文件的存放位置及文件名称 %d{yyyy-MM-dd}：按天进行日志滚动 
            %i：当文件大小超过maxFileSize时，按照i进行文件滚动
            -->
            <fileNamePattern>${LOG_HOME}/${appName}-%d{yyyy-MM-dd}-%i.log</fileNamePattern>
            <!-- 
            可选节点，控制保留的归档文件的最大数量，超出数量就删除旧文件。假设设置每天滚动，
            且maxHistory是365，则只保存最近365天的文件，删除之前的旧文件。注意，删除旧文件是，
            那些为了归档而创建的目录也会被删除。
            -->
            <MaxHistory>30</MaxHistory>
            <!-- 
            当日志文件超过maxFileSize指定的大小是，根据上面提到的%i进行日志文件滚动 注意此处配置SizeBasedTriggeringPolicy是无法实现按文件大小进行滚动的，必须配置timeBasedFileNamingAndTriggeringPolicy
            -->
            <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
                <maxFileSize>30MB</maxFileSize>
            </timeBasedFileNamingAndTriggeringPolicy>
        </rollingPolicy>
        <!-- 日志输出格式： -->     
        <layout class="ch.qos.logback.classic.PatternLayout">
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [ %thread ] - [ %-5level ] [ %logger{60} : %line ] - %msg%n</pattern>
        </layout>
    </appender>

    <!-- 
		logger主要用于存放日志对象，也可以定义日志类型、级别
		name：表示匹配的logger类型前缀，也就是包的前半部分
		level：要记录的日志级别，包括 TRACE < DEBUG < INFO < WARN < ERROR
		additivity：作用在于children-logger是否使用 rootLogger配置的appender进行输出，
		  false：表示只用当前logger的appender-ref
          true：表示当前logger的appender-ref和rootLogger的appender-ref都有效
    -->
    <logger name="com.kgc.sbt" level="info" />
    <logger name="org.springframework" level="debug" additivity="false"/>

    <!-- 
    root与logger是父子关系，没有特别定义则默认为root，任何一个类只会和一个logger对应，
    要么是定义的logger，要么是root，判断的关键在于找到这个logger，然后判断这个logger的appender和level。 
    -->
    <root level="debug">
        <appender-ref ref="stdout" />
        <appender-ref ref="appLogAppender" />
    </root>
</configuration> 

使用log
在类上 注解@Slf4j
通过 log.debug("");
	log.info("");
	log.warn("");
	log.error("");