Spring Boot开发之流水无情(二)

时间:2023-12-22 22:36:08

http://my.oschina.net/u/1027043/blog/406558

Spring Boot开发之流水无情(二)

上篇散仙写了一个很简单的入门级的Spring Boot的例子,没啥技术含量,不过,其实学任何东西只要找到第一个突破口,接下来的事情就好办了,人最怕什么? 我想莫过于干一件事情,没有下手的地方了,而当你一旦找到了这感觉,就可以很喜悦的顺藤摸瓜般的探索你强烈想探索求知的某种事物了,这种冥冥之中玄而又玄的感觉是什么?回想一下:

(1) 当你把第一个某种编程语言的Hello World的例子,成功的运行在一个IDE中 
(2) 当你第一次从老家出发到达了某个你从未涉足过的地方 
(3) 当你成功的完成了第一次网购

一切的不相关的事物之间的,其实都有类似的学习历程,正是所谓的触类旁通,万法归宗!

关于Spring Boot这块,其实里面涉及的内容非常多也非常灵活,散仙的项目中用到的模块也只是冰山一角,不可能完全覆盖所有有关的模块,完全是为了项目而用技术,不是为了技术而诞生了这个项目,所以这次记录的心得,完全是项目有关的,而不是Spring Boot一个学习教程,这一点,希望各位看官明白,如果想专攻学习Spring Boot,推荐点击官网更详细的教程 
一个项目是由多种不同层面的技术组成的,所以散仙不会只写有关Spring Boot方面的,虽然Spring Boot是主线。大多数情况下,都会集成多种不同的技术,只有各自发挥自己擅长的优势,才能组合出最优的架构。

好了,多说了点废话,下面看下本篇记录Spring Boot的几个知识点:

(一)一个Maven+Spring Boot项目基本的包结构形式 
(二)一个简单的在Spring Boot项目集成安全控制 
(二)如何在Spring Boot中记录log日志 
(四)Spring Boot中几个常用注解介绍

ok下面开始正题:

(一)先看下,官网给出的一个简单的包结构组成:

Java代码   Spring Boot开发之流水无情(二)
  1. com
  2. +- example
  3. +- myproject
  4. +- Application.java
  5. |
  6. +- domain
  7. |   +- Customer.java
  8. |   +- CustomerRepository.java
  9. |
  10. +- service
  11. |   +- CustomerService.java
  12. |
  13. +- web
  14. +- CustomerController.java

然后,看下散仙实际工作中的项目结构:

Spring Boot开发之流水无情(二)

需要注意的地方如下: 
1,在src/main/java包下的第一层结构中,是必须放一个含有main方法的主启动的类,而且只能有一个main方法,如果再出现其他的main方法,在使用maven编译打包时,会报编译错误,当然在src/test/java包下,可以出现多个,但建议最好使用Junit进行单元测试.

这个main方法启动,就会启动内嵌的tomcat或jetty容器,然后加载所有需要加载的或扫描的类或资源文件。上篇博客中,散仙为了测试方便,是直接在当前的Conroller中,启动了一个测试服务,这样做适合单独调试,如果是生产环境下的启动方法,则是散仙前面所讲的,在java包的根目录下建立一个main方法类,负责启动所有的资源。

在本例中,散仙的main代码如下:

Java代码   Spring Boot开发之流水无情(二)
  1. package com.dhgate.rate;
  2. import org.springframework.boot.SpringApplication;
  3. import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
  4. import org.springframework.context.annotation.ComponentScan;
  5. import org.springframework.context.annotation.Configuration;
  6. @Configuration//配置控制
  7. @EnableAutoConfiguration//启用自动配置
  8. @ComponentScan//组件扫描
  9. public class ApplicationMain {
  10. public static void main(String[] args) throws Exception {
  11. //启动Spring Boot项目的唯一入口
  12. SpringApplication.run(ApplicationMain.class, args);
  13. }
  14. }

2,在src/main/resource目录下面,是放置一些配置文件,或模板支持的文件,如JSP,Velocity,Freemaker等,这里面比较常用或重要的一个文件,就是Spring Boot的集中式配置文件application.properties这个文件了,这里面给其他大部分的组件,提供了一个可集中管理和配置的中心,包括安全控制,redis,solr,mangodb的连接信息,以及数据库连接池,容器端口号,jmx,java mail,动态模板等。此外这个目录下默认是可以访问静态资源的,比如我们的css,js,或者第三方的一些引用文件等。

(二)关于在Spring Boot的配置简单的安全访问控制,这一点非常容器,我们只需要做如下二步,即可。 
1,在pom文件中,引入spring-boot-starter-security的maven依赖。

Xml代码   Spring Boot开发之流水无情(二)
  1. <dependency>
  2. <groupId>org.springframework.boot</groupId>
  3. <artifactId>spring-boot-starter-security</artifactId>
  4. </dependency>

2,在application.properties中,配置访问的用户名和密码

Java代码   Spring Boot开发之流水无情(二)
  1. #用户名 密码配置
  2. security.user.name=admin
  3. security.user.password=test

再次,访问链接时,会出现以下,拦截页面,就代表配置成功:

Spring Boot开发之流水无情(二)

当然这只是,一个初级的配置,更复杂的配置,可以分不用角色,在控制范围上,能够拦截到方法级别的权限控制。

(三)日志的重要性,不言而喻,Spring Boot支持大部分的log配置,其中包括: 
(1)java util logging 
(2)log4j 
(3)log4j2 
(4)logbak 
默认的情况下spring boot会选择logback作为日志记录的载体,当然要想它正常的工作,需要依赖 Commons Logging, Java Util Logging, Log4J 或 SLF4J,相信大部分同学都是选择使用log4j.properties作为我们的日志配置和管理,但是散仙在Spring Boot中一直没有测试集成成功,所以就放弃使用log4j.properties作为日志载体,而是选择了Spring Boot推荐的logbak作为日志的配置文件,用过之后感觉也不错。

使用步骤:

1,将logbak.xml拷贝至resource目录下的根目录,然后在logbak.xml中,配置相关的log生成规则,log级别,以及日志路径,log的字符编码集,这个非常重要,因为刚开始用这个log记录程序运行的信息时,发现它不支持中文log,后来经查名,需要配置相关的log编码才可以正确记录对应的信息。一个通用的配置如下:

Xml代码   Spring Boot开发之流水无情(二)
  1. <!-- Logback configuration. See http://logback.qos.ch/manual/index.html -->
  2. <configuration scan="true" scanPeriod="10 seconds">
  3. <!-- Simple file output -->
  4. <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
  5. <!-- encoder defaults to ch.qos.logback.classic.encoder.PatternLayoutEncoder -->
  6. <encoder>
  7. <pattern>
  8. [ %-5level] [%date{yyyy-MM-dd HH:mm:ss}] %logger{96} [%line] - %msg%n
  9. </pattern>
  10. <charset>UTF-8</charset> <!-- 此处设置字符集 -->
  11. </encoder>
  12. <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
  13. <!-- rollover daily 配置日志所生成的目录以及生成文件名的规则 -->
  14. <fileNamePattern>logs/mylog-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
  15. <timeBasedFileNamingAndTriggeringPolicy
  16. class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
  17. <!-- or whenever the file size reaches 64 MB -->
  18. <maxFileSize>64 MB</maxFileSize>
  19. </timeBasedFileNamingAndTriggeringPolicy>
  20. </rollingPolicy>
  21. <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
  22. <level>DEBUG</level>
  23. </filter>
  24. <!-- Safely log to the same file from multiple JVMs. Degrades performance! -->
  25. <prudent>true</prudent>
  26. </appender>
  27. <!-- Console output -->
  28. <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
  29. <!-- encoder defaults to ch.qos.logback.classic.encoder.PatternLayoutEncoder -->
  30. <encoder>
  31. <pattern>
  32. [ %-5level] [%date{yyyy-MM-dd HH:mm:ss}] %logger{96} [%line] - %msg%n
  33. </pattern>
  34. <charset>GBK</charset> <!-- 此处设置字符集 -->
  35. </encoder>
  36. <!-- Only log level WARN and above -->
  37. <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
  38. <level>WARN</level>
  39. </filter>
  40. </appender>
  41. <!-- Enable FILE and STDOUT appenders for all log messages.
  42. By default, only log at level INFO and above. -->
  43. <root level="INFO">
  44. <appender-ref ref="FILE" />
  45. <appender-ref ref="STDOUT" />
  46. </root>
  47. <!-- For loggers in the these namespaces, log at all levels. -->
  48. <logger name="pedestal" level="ALL" />
  49. <logger name="hammock-cafe" level="ALL" />
  50. <logger name="user" level="ALL" />
  51. </configuration>

2,在application.properties中,指定log文件的加载路径,已经配置通用的log日志级别:

Java代码   Spring Boot开发之流水无情(二)
  1. #指定log的配置文件,以及记录Spring Boot的log级别
  2. logging.config=logback.xml
  3. logging.level.org.springframework.web: INFO

(四)介绍下Spring Boot中几个常用的注解,其中大部分都是来自Spring MVC的注解,这些注解使用的频率一般都在90%之上。

(1)@RestController和@Controller指定一个类,作为控制器的注解 
(2)@RequestMapping方法级别的映射注解,这一个用过Spring MVC的小伙伴相信都很熟悉 
(3)@EnableAutoConfiguration和@SpringBootApplication是类级别的注解,根据maven依赖的jar来自动猜测完成正确的spring的对应配置,只要引入了spring-boot-starter-web的依赖,默认会自动配置Spring MVC和tomcat容器 
(4)@Configuration类级别的注解,一般这个注解,我们用来标识main方法所在的类 
(5)@ComponentScan类级别的注解,自动扫描加载所有的Spring组件包括Bean注入,一般用在main方法所在的类上 
(6)@ImportResource类级别注解,当我们必须使用一个xml的配置时,使用@ImportResource和@Configuration来标识这个文件资源的类。 
(7)@Autowired注解,一般结合@ComponentScan注解,来自动注入一个Service或Dao级别的Bean 
(8)@Component类级别注解,用来标识一个组件,比如我自定了一个filter,则需要此注解标识之后,Spring Boot才会正确识别。

ok,本篇的讲解,就到此结束,这些都是项目工程的基础知识,了解这些,有助于我们快速的上手一个Spring Boot应用。

下篇博客的内容会写: 
(1)如何在Spring Boot项目中集成Spring Loaded框架,来完成模块热加载和代码动态编译,有了这个东西,我们开发的效率会更加高效,大部分情况下我们改了一个类或方法的代码之后,都不需要重启应用,因为Spring Loaded会定时重新编译并加载代码。

(2)如何在Spring Boot项目中集成Velocity,Spring Boot支持多种模板引擎,包括 
1,FreeMarker 
2,Groovy 
3,Thymeleaf 
4,Velocity 
5,JSP (Spring Boot官方不推荐) 
我们可以根据熟悉程度来选择自己喜欢的引擎。