springboot:归纳整合,框架整体应用以及插件推荐

在前两天,Damon也是将springboot大概的状况给大家介绍了不少,今天Damon就跟大家说说springboot框架的一些整合,以及一些实用的插件介绍,希望大家喜欢。(最近由于实训比较累【现在才10已经很目涩了】,所以每日推荐也是比较慢,希望大家原谅。)

Spring Boot 集成druid

  • druid有很多个配置选项,使用Spring Boot 的配置文件可以方便的配置druid。

  • 在application.yml配置文件中写上:

  •   spring:
          datasource:
              name: test
              url: jdbc:mysql://192.168.16.137:3306/test
              username: root
              password:
              # 使用druid数据源
              type: com.alibaba.druid.pool.DruidDataSource
              driver-class-name: com.mysql.jdbc.Driver
              filters: stat
              maxActive: 20
              initialSize: 1
              maxWait: 60000
              minIdle: 1
              timeBetweenEvictionRunsMillis: 60000
              minEvictableIdleTimeMillis: 300000
              validationQuery: select 'x'
              testWhileIdle: true
              testOnBorrow: false
              testOnReturn: false
              poolPreparedStatements: true
              maxOpenPreparedStatements: 20
    
  • 这里通过type: com.alibaba.druid.pool.DruidDataSource配置即可!

Spring Boot 集成MyBatis

  • Spring Boot 集成MyBatis有两种方式,一种简单的方式就是使用MyBatis官方提供的:
    mybatis-spring-boot-starter
  • 另外一种方式就是仍然用类似mybatis-spring的配置方式,这种方式需要自己写一些代码,但是可以很方便的控制MyBatis的各项配置。

mybatis-spring-boot-starter方式

  • 在pom.xml中添加依赖:

    
      org.mybatis.spring.boot
      mybatis-spring-boot-starter
      1.0.0
    

  • mybatis-spring-boot-starter依赖树如下:

  • 其中mybatis使用的3.3.0版本,可以通过:

  • 3.3.0属性修改默认版本。
  • mybatis-spring使用版本1.2.3,可以通过:
  • 1.2.3修改默认版本。
  • 在application.yml中增加配置:

  • mybatis:
    mapperLocations: classpath:mapper/*.xml
    typeAliasesPackage: tk.mapper.model

  • 除了上面常见的两项配置,还有:

  • mybatis.config:mybatis-config.xml配置文件的路径
  • mybatis.typeHandlersPackage:扫描typeHandlers的包
  • mybatis.checkConfigLocation:检查配置文件是否存在
  • mybatis.executorType:设置执行模式(SIMPLE, REUSE, BATCH),默认为SIMPLE

mybatis-spring方式

  • 这种方式和平常的用法比较接近。需要添加mybatis依赖和mybatis-spring依赖。

  • 然后创建一个MyBatisConfig配置类:

      /**
       * MyBatis基础配置
       *
       * @author liuzh
       * @since 2015-12-19 10:11
       */
      @Configuration
      @EnableTransactionManagement
      public class MyBatisConfig implements TransactionManagementConfigurer {
          @Autowired
          DataSource dataSource;
      
          @Bean(name = "sqlSessionFactory")
          public SqlSessionFactory sqlSessionFactoryBean() {
              SqlSessionFactoryBean bean = new SqlSessionFactoryBean();
              bean.setDataSource(dataSource);
              bean.setTypeAliasesPackage("tk.mybatis.springboot.model");
      
              //分页插件
              PageHelper pageHelper = new PageHelper();
              Properties properties = new Properties();
              properties.setProperty("reasonable", "true");
              properties.setProperty("supportMethodsArguments", "true");
              properties.setProperty("returnPageInfo", "check");
              properties.setProperty("params", "count=countSql");
              pageHelper.setProperties(properties);
    
          //添加插件
          bean.setPlugins(new Interceptor[]{pageHelper});
    
          //添加XML目录
          ResourcePatternResolver resolver = new PathMatchingResourcePatternResolver();
          try {
              bean.setMapperLocations(resolver.getResources("classpath:mapper/*.xml"));
              return bean.getObject();
          } catch (Exception e) {
              e.printStackTrace();
              throw new RuntimeException(e);
          }
      }
      @Bean
      public SqlSessionTemplate sqlSessionTemplate(SqlSessionFactory sqlSessionFactory) {
          return new SqlSessionTemplate(sqlSessionFactory);
      }
    
      @Bean
      @Override
      public PlatformTransactionManager annotationDrivenTransactionManager() {
          return new DataSourceTransactionManager(dataSource);
      }
    

    }

  • 上面代码创建了一个SqlSessionFactory和一个SqlSessionTemplate,为了支持注解事务,增加了@EnableTransactionManagement注解,并且反回了一个PlatformTransactionManagerBean。

  • 另外应该注意到这个配置中没有MapperScannerConfigurer,如果我们想要扫描MyBatis的Mapper接口,我们就需要配置这个类,这个配置我们需要单独放到一个类中。

      /**
       * MyBatis扫描接口
       * 
       * @author liuzh
       * @since 2015-12-19 14:46
       */
      @Configuration
      //注意,由于MapperScannerConfigurer执行的比较早,所以必须有下面的注解
      @AutoConfigureAfter(MyBatisConfig.class)
      public class MyBatisMapperScannerConfig {
          @Bean
          public MapperScannerConfigurer mapperScannerConfigurer() {
              MapperScannerConfigurer mapperScannerConfigurer = new MapperScannerConfigurer();
              mapperScannerConfigurer.setSqlSessionFactoryBeanName("sqlSessionFactory");
              mapperScannerConfigurer.setBasePackage("tk.mybatis.springboot.mapper");
              //配置通用mappers
      Properties properties = new Properties();
              properties.setProperty("mappers", "tk.mybatis.springboot.util.MyMapper");
              properties.setProperty("notEmpty", "false");
              properties.setProperty("IDENTITY", "MYSQL");
              //这里使用的通用Mapper的MapperScannerConfigurer,所有有下面这个方法
              mapperScannerConfigurer.setProperties(properties);
      
              return mapperScannerConfigurer;
          }
      }
    
  • 这个配置一定要注意@AutoConfigureAfter(MyBatisConfig.class),必须有这个配置,否则会有异常。原因就是这个类执行的比较早,由于sqlSessionFactory还不存在,后续执行出错。做好上面配置以后就可以使用MyBatis了。

关于分页插件和通用Mapper集成

  • 分页插件作为插件的例子在上面代码中有。
  • 通用Mapper配置实际就是配置MapperScannerConfigurer的时候使用- tk.mybatis.spring.mapper.MapperScannerConfigurer即可,配置属性使用Properties。

Spring Boot集成MyBatis的基础项目

  • 项目地址:https://github.com/wudongqiang/MyBatis-Spring-Boot
  • 分页插件和通用Mapper的相关信息可以通过上面地址找到。

Spring Boot 静态资源处理

  • Spring Boot 默认的处理方式就已经足够了,默认情况下Spring Boot 使用WebMvcAutoConfiguration中配置的各种属性。

  • 建议使用Spring Boot 默认处理方式,需要自己配置的地方可以通过配置文件修改。

  • 但是如果你想完全控制Spring MVC,你可以在@Configuration注解的配置类上增加@EnableWebMvc,增加该注解以后WebMvcAutoConfiguration中配置就不会生效,你需要自己来配置需要的每一项。这种情况下的配置方法建议参考WebMvcAutoConfiguration类。
    -本文以下内容针对Spring Boot 默认的处理方式,部分配置通过在application.yml配置文件中设置。
    -.spring boot默认加载文件的路径是

      /META-INF/resources/ 
      /resources/ 
      /static/ 
      /public/
      private static final String[] CLASSPATH_RESOURCE_LOCATIONS = {  
              "classpath:/META-INF/resources/", "classpath:/resources/",  
              "classpath:/static/", "classpath:/public/" };  
    
  • 所有本地的静态资源都配置在了classpath下面了, 而非在webapp下了

配置资源映射

  • Spring Boot 默认配置的/映射到/static(或/public ,/resources,/META-INF/resources),/webjars/会映射到
  • classpath:/META-INF/resources/webjars/。
  • 注意:上面的/static等目录都是在classpath:下面。

  • 如果你想增加如/mystatic/**映射到classpath:/mystatic/,你可以让你的配置类继承WebMvcConfigurerAdapter,然后重写如下方法:

       @Override
      public void addResourceHandlers(ResourceHandlerRegistry registry) {
          registry.addResourceHandler("/mystatic/**")
                  .addResourceLocations("classpath:/mystatic/");
      }
    
  • 这种方式会在默认的基础上增加/mystatic/**映射到classpath:/mystatic/,不会影响默认的方式,可以同时使用。
  • 静态资源映射还有一个配置选项,为了简单这里用.properties方式书写:
    spring.mvc.static-path-pattern=/** # Path pattern used for static resources.
    这个配置会影响默认的/,例如修改为/static/后,只能映射如/static/js/sample.js这样的请求(修改前是/js/sample.js)。这个配置只能写一个值,不像大多数可以配置多个用逗号隔开的。

使用注意

  • 例如有如下目录结构:

      └─resources
          │  application.yml
          │
          ├─static
          │  ├─css
          │  │      index.css
          │  │
          │  └─js
          │          index.js
          │
          └─templates
                  index.ftl
    
  • 在index.ftl中该如何引用上面的静态资源呢?

  • 如下写法:


  • 注意:默认配置的/**映射到/static(或/public ,/resources,/META-INF/resources)

  • 当请求/css/index.css的时候,Spring MVC 会在/static/目录下面找到。

  • 如果配置为/static/css/index.css,那么上面配置的几个目录下面都没有/static目录,因此会找不到资源文件!

  • 所以写静态资源位置的时候,不要带上映射的目录名(如/static/,/public/,/resources/,/META-INF/resources/)!

使用WebJars

  • WebJars:http://www.webjars.org/

  • 例如使用jquery,添加依赖:


    org.webjars
    jquery
    1.11.3

  • 然后可以如下使用:

  • 你可能注意到href中的1.11.3版本号了,如果仅仅这么使用,那么当我们切换版本号的时候还要手动修改href,怪麻烦的,我们可以用如下方式解决。

  • 先在pom.xml中添加依赖:


    org.webjars
    webjars-locator

  • 增加一个WebJarController:

      @Controller
      public class WebJarController {
          private final WebJarAssetLocator assetLocator = new WebJarAssetLocator();
      
          @ResponseBody
          @RequestMapping("/webjarslocator/{webjar}/**")
          public ResponseEntity locateWebjarAsset(@PathVariable String webjar, HttpServletRequest request) {
              try {
                  String mvcPrefix = "/webjarslocator/" + webjar + "/";
                  String mvcPath = 
      (String) request.getAttribute(HandlerMapping.PATH_WITHIN_HANDLER_MAPPING_ATTRIBUTE);
                  String fullPath = 
      assetLocator.getFullPath(webjar, mvcPath.substring(mvcPrefix.length()));
                  return new ResponseEntity(new ClassPathResource(fullPath), HttpStatus.OK);
              } catch (Exception e) {
                  return new ResponseEntity<>(HttpStatus.NOT_FOUND);
              }
          }
      }
    
  • 然后使用的时候按照如下方式:

    type="text/javascript" src="/webjarslocator/jquery/jquery.js">

  • 注意:这里不需要在写版本号了,但是注意写url的时候,只是在原来url基础上去掉了版本号,其他的都不能少!

静态资源版本管理

  • Spring MVC 提供了静态资源版本映射的功能。

  • 用途:当我们资源内容发生变化时,由于浏览器缓存,用户本地的静态资源还是旧的资源,为了防止这种情况导致的问题,我们可能会手动在请求url的时候加个版本号或者其他方式。

  • 版本号如:

    type="text/javascript" src="/js/sample.js?v=1.0.1">

  • Spring MVC 提供的功能可以很容易的帮助我们解决类似问题。

  • Spring MVC 有两种解决方式。

  • 注意:下面的配置方式针对freemarker模板方式,其他的配置方式可以参考。

资源名-md5 方式


  • Spring 会自动读取资源md5,然后添加到index.css的名字后面,因此当资源内容发生变化的时候,文件名发生变化,就会更新本地资源。
  • 配置方式:
  • 在application.properties中做如下配置:

  • spring.resources.chain.strategy.content.enabled=true
    spring.resources.chain.strategy.content.paths=/**

  • 这样配置后,所有/**请求的静态资源都会被处理为上面例子的样子。

  • 到这儿还没完,我们在写资源url的时候还要特殊处理。

  • 首先增加如下配置:

  • @ControllerAdvice
    public class ControllerConfig {
    @Autowired
    ResourceUrlProvider resourceUrlProvider;
    @ModelAttribute("urls")
    public ResourceUrlProvider urls() {
    return this.resourceUrlProvider;
    }
    }

  • 然后在页面写的时候用下面的写法:

  • 使用urls.getForLookupPath('/css/index.css')来得到处理后的资源名。

版本号 方式

  • 在application.properties中做如下配置:

  • spring.resources.chain.strategy.fixed.enabled=true
    spring.resources.chain.strategy.fixed.paths=/js/,/v1.0.0/
    spring.resources.chain.strategy.fixed.version=v1.0.0

  • 这里配置需要特别注意,将version的值配置在paths中。

  • 在页面写的时候,写法如下:

    type="text/javascript" src="${urls.getForLookupPath('/js/index.js')}">

  • 注意,这里仍然使用了urls.getForLookupPath,urls配置方式见上一种方式。
    在请求的实际页面中,会显示为:

    type="text/javascript" src="/v1.0.0/js/index.js">

  • 可以看到这里的地址是/v1.0.0/js/index.js。

静态资源版本管理 处理过程

  • 在Freemarker模板首先会调用urls.getForLookupPath方法,返回一个/v1.0.0/js/index.js或/css/index-2b371326aa93ce4b611853a309b69b29.css。
  • 这时页面上的内容就是处理后的资源地址。这之后浏览器发起请求。
  • 这里分开说。
第一种md5方式
  • 请求/css/index-2b371326aa93ce4b611853a309b69b29.css,我们md5配置的paths=/**,所以Spring MVC 会尝试url中是否包含-,如果包含会去掉后面这部分,然后去映射的目录(如/static/)查找/css/index.css文件,如果能找到就返回。
第二种版本方式
  • 请求/v1.0.0/js/index.js。
  • 如果我们paths中没有配置/v1.0.0,那么上面这个请求地址就不会按版本方式来处理,因此会找不到上面的资源。
  • 如果配置了/v1.0.0,Spring 就会将/v1.0.0去掉再去找/js/index.js,最终会在/static/下面找到。

总结:

作为一个新生程序猿,Damon希望能够与大家一同进步。文章或者描述有所不足的地方,希望大家多多提出来,一同进步。

Damon会继续发掘一些有用的咨询,知识以及新工具,与大家一同分享,谢谢!

过去文章都上传到github,有兴趣的小伙伴可以Star下:https://github.com/xxxyyh/Front-end-knowledge.git

你可能感兴趣的:(springboot:归纳整合,框架整体应用以及插件推荐)