springboot下载插件 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版本，可以通过：
• <mybatis.version>3.3.0</mybatis.version>属性修改默认版本。
• mybatis-spring使用版本1.2.3，可以通过：
• <mybatis-spring.version>1.2.3</mybatis-spring.version>修改默认版本。
• 在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，添加依赖：
• 然后可以如下使用：
• 注意：这里不需要在写版本号了，但是注意写url的时候，只是在原来url基础上去掉了版本号，其他的都不能少！

静态资源版本管理

• Spring MVC 提供了静态资源版本映射的功能。
• 用途：当我们资源内容发生变化时，由于浏览器缓存，用户本地的静态资源还是旧的资源，为了防止这种情况导致的问题，我们可能会手动在请求url的时候加个版本号或者其他方式。
• 版本号如：
• Spring MVC 提供的功能可以很容易的帮助我们解决类似问题。
• Spring MVC 有两种解决方式。
• 注意：下面的配置方式针对freemarker模板方式，其他的配置方式可以参考。

资源名-md5 方式

<link rel="stylesheet" type="text/css" href="/css/index-2b371326aa93ce4b611853a309b69b29.css">

• 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配置方式见上一种方式。
  在请求的实际页面中，会显示为：
• 可以看到这里的地址是/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会继续发掘一些有用的咨询，知识以及新工具，与大家一同分享，谢谢！