• (四)Spring Boot官网文档学习



    原文地址:https://docs.spring.io/spring-boot/docs/2.1.3.RELEASE/reference/htmlsingle/#using-boot-structuring-your-code



    关于默认包的问题

    java 中,如果我们把一个 java 类,不放到特定包里面,则默认放到 默认包 里面,在使用 Spring Boot 的时候,要避免这样做,因为这样做,会导致使用 @ComponentScan, @EntityScan, or @SpringBootApplication 注解出现一些问题;


    加载启动类

    Spring Boot 建议我们将,启动类,放在所有类之上,根包下面,因为启动类上面的 @SpringBootApplication 注解,有个隐式的扫描包的动作,它会扫描他所在包下面的所以包,这样就省去我们使用 @ComponentScan 注解进行手动扫描了;

    官网建议我们包格式如下:

    com
     +- example
         +- myapplication
             +- Application.java
             |
             +- customer
             |   +- Customer.java
             |   +- CustomerController.java
             |   +- CustomerService.java
             |   +- CustomerRepository.java
             |
             +- order
                 +- Order.java
                 +- OrderController.java
                 +- OrderService.java
                 +- OrderRepository.java
    

    可以看到启动类 Application.java 在所有类的上面;

    如果不想使用 @SpringBootApplication 可以使用 @EnableAutoConfiguration and @ComponentScan 两个注解替换,完成一样的效果;

    @EnableAutoConfiguration
    @ComponentScan(value = "hello")
    // @SpringBootApplication
    public class Application {
    
        public static void main(String[] args) {
            SpringApplication.run(Application.class, args);
        }
    }
    
    

    配置

    • 基于 java

      Spring Boot 里面,推荐使用基于 java 类的配置,而不去使用基于 xml 的配置,杜绝任何 xml 文件的产生;

      官网建议的做法是:创建一个单例的 java 类,使用 @Configuration 标识为配置类,该类里面进行各种配置,因为 Spring Boot 支持基于 java 的配置 ;

      但是不需要将所有的配置,都放在一个 java 里面,可以使用 @Import 注解导入其他配置类,或者使用 @ComponentScan 注解,扫描所有的类,这样也就自动的导入了配置类;

    • 导入 xml 文件

      如果项目必须使用到 xml 文件,官方依然建议先创建一个配置类,进行其他配置,然后使用注解 @ImportResource 导入 xml 文件的配置 ;

    • 自动配置(Auto-configuration

      Spring Boot 会自动配置依赖,根据你在 pom 文件里面配置的依赖,你只需要将注解 @EnableAutoConfiguration或@SpringBootApplication 配置到任何一个配置类上,即可获得 Auto-configuration 的功能 ;

      自动配置是非侵入性的;比如你添加了数据源的依赖,则自动配置,会在你没有配置数据源实例的时候,进行自动配置,一旦你自己配置了,则自动配置将取消之前的配置;

      还可以禁止某些配置的自动配置,在配置上使用注解 @EnableAutoConfiguration

      import org.springframework.boot.autoconfigure.*;
      import org.springframework.boot.autoconfigure.jdbc.*;
      import org.springframework.context.annotation.*;
      
      @Configuration
      @EnableAutoConfiguration(exclude={DataSourceAutoConfiguration.class})
      public class MyConfiguration {
      }
      

      如果要禁止的类不在类路径下面,则使用 excludeName 值为类的全限定名来替换掉 exclude


    Bean管理和依赖注入

    官方建议使用 @ComponentScan 扫描 beans,然后使用 @Autowired 进行属性的注入 ;

    如果我们按照上面我说的 加载启动类 那样做。则我们可以直接使用不带参数的@ComponentScan 所有应用程序组件(@ Component,@ Service,@ Repository,@ Controller等),注册 Beans ;

    就像下面这样,直接使用 @Service 创建一个 service 层 的 bean ,而不用带任何参数:

    package com.example.service;
    
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.stereotype.Service;
    
    @Service
    public class DatabaseAccountService implements AccountService {
    
    	private final RiskAssessor riskAssessor;
    
    	@Autowired
    	public DatabaseAccountService(RiskAssessor riskAssessor) {
    		this.riskAssessor = riskAssessor;
    	}
    
    	// ...
    
    }
    

    如果 bean 只有一个构造器,则 @Autowired 可以被省略:

    @Service
    public class DatabaseAccountService implements AccountService {
    
    	private final RiskAssessor riskAssessor;
    
    	public DatabaseAccountService(RiskAssessor riskAssessor) {
    		this.riskAssessor = riskAssessor;
    	}
    
    	// ...
    
    }
    

    @SpringBootApplication

    一个 @SpringBootApplication 相当于下面三个注解:

    1. @EnableAutoConfiguration 根据依赖项自动配置项目
    2. @ComponentScan 可以扫描本身所在包及其子包
    3. @Configuration 配置类

    Developer Tools

    开发者工具;Spring Boot 还提供了一额外的工具包,提供一些开发时可能需要的功能,可以添加到 Maven 依赖里面:

    <dependencies>
    	<dependency>
    		<groupId>org.springframework.boot</groupId>
    		<artifactId>spring-boot-devtools</artifactId>
    		<optional>true</optional>
    	</dependency>
    </dependencies>
    

    上述配置中的 optional 置为 true ,使得开发者工具,仅仅在开发环境中可以使用,也就是打成 jar 包的时候,将自动的被禁用;


    关于 Developer Tools 的一些细节

    1. 缓存问题

      Sping Boot 支持一些库使用缓存功能;比如:模板引擎,会缓存已经编译过的模板,以避免重复解析模板文件;SpringMvc 提供静态资源的时候,可以设置 Http 缓存头 ;

      但是缓存功能,可能会导致新的页面无法里面被访问,因此,spring-boot-devtools 工具包,默认禁用缓存选项;

      缓存配置(包括下面的配置),通常在 application.properties 文件里面配置,spring-boot-devtools 不需要手动去设置这些属性,只会自适应application.properties 等配置文件的配置 ;

    2. 日志级别

      还可以打印出 Web 请求的详细信息,只需要将 spring.http.log-request-details 置为 true,否则默认是不打印详细信息的;

    3. 自动重启

      使用了工具包以后,将会监测类路径上的文件,一旦有文件发生改变,则自动重启项目,以及时得到修改反馈,在 IDEA 中,更改完资源以后,需要 build 一下,以更新类路径下文件,触发自动重启 ;

      当决定类路径上的条目是否应该在更改时触发重新启动时,DevTools会自动忽略名为spring-boot,spring-boot-devtools,spring-boot-autoconfigure,spring-boot-actuator和spring-boot-starter的项目。

    4. 排除资源

      一些资源改动,我们整个项目重启,比如只是改变了模板元素这些,我们更希望的是,仅仅重新加载我们改动的,其他的不要重新加载 ;

      默认情况下 /META-INF/maven,/META-INF/resources,/resources,/static,/public,或 /templates 下面的资源改动,不会引起重启,只会引起局部重新加载;

      如果要自定义这些排除项,这样默认的排除项就没了:

      spring.devtools.restart.exclude=static/**,public/**
      

      如果想保留默认的排除项,再继续添加新的排除项,使用:

      spring.devtools.restart.additional-exclude=static/**,public/**
      
    5. 其他触发重启路径

      使用注解 spring.devtools.restart.additional-paths 配置;

    6. 禁用重启

      如果想禁用重启,则配置 spring.devtools.restart.enabledfalse ,但是这样做,还是会初始化重新启动的类加载器,只是不会监视文件更改;

      在某些情况下,需要完全禁用,让它得不到加载,因为某些库不能与重新加载的类加载器一起使用,这时候需要这样做:

      public static void main(String[] args) {
      	System.setProperty("spring.devtools.restart.enabled", "false");
      	SpringApplication.run(MyApp.class, args);
      }
      
    7. 使用触发器文件

      仅针对特定文件的修改,才触发重启;使用 spring.devtools.restart.trigger-file 配置下特定文件的路径地址 ;

      实现了序列化接口对象的改动,不会触发重启 ;


  • 相关阅读:
    acdream 1017: Fast Transportation 网络流层次图
    centos5的kernel source
    Linux内核源代码的阅读及相关工具介绍(转)
    gcc生成静态库和动态库(转)
    写一篇大家一看就会的教程《JNI初步》(转)
    jni.h
    5分钟学用Lucene
    (VC2005) picture 控件显示16*16的Icon
    (VC/MFC)通过结构体传递参数给线程
    (VC2005)MFC中添加控件的成员变量.
  • 原文地址:https://www.cnblogs.com/young-youth/p/11665589.html
Copyright © 2020-2023  润新知