开箱即用(out-of-box)的Redis序列号生成器,不用再写任何代码,你值得拥有

先看整体效果


把简单的东西“傻瓜化”是软件开发追求的目标之一。请看下图:


左边是在 application.yml 里配置了3个生成器,右边可以直接注入到代码中使用,注意,不用写任何代码。这酸爽。

下面请看效果:

上面是3个生成器生成的第一个序号。哎吆,还不错哦。

 

慢慢学会分析


序列号大家都非常熟悉,无非就是一个初始值、步长,有时还有最大值。这只是最基本的信息,还可以按需添加其他的。

很容易抽象出一个接口,如下代码:

/** * 序列号生成器 * @author lixinjie * @since 2019-04-04 */public interface SnGenerator {  /**名称,根据实际情况使用*/  String getName();  /**注册到容器中的bean名称*/  String getBeanName();  /**初始值*/  long getInitNum();  /**步长*/  long getStep();  /**获取下一个序列号*/  long nextNum();  /**最大值*/  long getMaxNum();}

剩下的就是下面这三个问题了:

  • 接口有了之后,自然就是基于Redis的实现了,这是遇到第一个问题。

  • 还需要根据配置动态向容器中注册bean定义,这是第二个问题。

  • 自然需要从配置文件中读出这些配置信息,供上一步使用,这是第三个问题。


 

再来学会实现


接口实现时主要用到Redis的INCRBY命令,这是个原子命令。即使你有多个节点,每个节点有多个线程同时来调用,也是OK的。

而且key不存在时,首次调用时还会将key设置为0。这样带来的好处就是,程序不用考虑key是否存在,直接调用自增就可以了。

唯一不爽的就是key只会被设置为0,如果初始值不是从0开始的,就真有些不爽,最简单的办法就是在程序中把初始值作为偏移量叠加上去。

当然还有另一个办法,就是主动设置key的初始值。因为存在并发,自然要使用SETNX命令。这样已经完全OK,但还是会有人在心理上觉得不安全。那就在应用启动阶段执行该命令,此时肯定不会有调用的。请看下面源码:

/** * 基于Redis的实现 * @author lixinjie * @since 2019-04-04 */public class RedisSnGenerator implements SnGenerator {
  @Autowired  private StringRedisTemplate stringRedisTemplate;  private String name;  private String beanName;  private long initNum;  private long step;  private long maxNum;  public RedisSnGenerator(String name, String beanName, long initNum, long step, long maxNum) {    this.name = name;    this.beanName = beanName;    this.initNum = initNum;    this.step = step;    this.maxNum = maxNum;  }  @PostConstruct  public void init() {    if (!stringRedisTemplate.hasKey(getName())) {      stringRedisTemplate.opsForValue().setIfAbsent(getName(), String.valueOf(getInitNum()));    }  }
  @Override  public String getName() {    return name;  }
  public String getBeanName() {    return beanName;  }
  @Override  public long getInitNum() {    return initNum;  }
  @Override  public long getStep() {    return step;  }
  @Override  public long nextNum() {    return stringRedisTemplate.opsForValue().increment(getName(), getStep());  }
  @Override  public long getMaxNum() {    return maxNum;  }
}


要动态注册bean定义,Spring框架提供了专用接口,BeanDefinitionRegistryPostProcessor:

public interface BeanDefinitionRegistryPostProcessor extends BeanFactoryPostProcessor {
  /**   * @param registry the bean definition registry used by the application context   * @throws org.springframework.beans.BeansException in case of errors   */  void postProcessBeanDefinitionRegistry(BeanDefinitionRegistry registry) throws BeansException;
}

它是一个bean工厂后处理器,应用启动时框架会自动检测并应用该类型的实现类。

要使用配置文件中的内容,Spring框架提供了专门的接口,EnvironmentAware:

public interface EnvironmentAware extends Aware {
  /**   * Set the {@code Environment} that this component runs in.   */  void setEnvironment(Environment environment);
}

它是一个Aware接口,应用启动时框架会自动检测该类型的接口并把你需要的给你set进去。

这块源码有点多,我们就只看两部分吧。下面是从配置文件中读出配置信息的:

  private SnGeneInfo[] parseSnGeneInfos() {    String prefix = "sngenerator";    String[] generators = environment.getProperty(prefix + ".generators", String[].class);    SnGeneInfo[] infos = new SnGeneInfo[generators.length];    for (int i = 0; i < generators.length; i++) {      infos[i] = buildSnGeneInfo(prefix, generators[i]);    }    return infos;  }  private SnGeneInfo buildSnGeneInfo(String prefix, String generator) {    return new SnGeneInfo(        prefix + ":" + generator,        environment.getProperty(prefix + "." + generator + ".bean-name"),        environment.getProperty(prefix + "." + generator + ".init-num", long.class),        environment.getProperty(prefix + "." + generator + ".step", long.class),        environment.getProperty(prefix + "." + generator + ".max-num", long.class)      );  }


下面是注册bean定义的:

  @Override  public void postProcessBeanDefinitionRegistry(BeanDefinitionRegistry registry) throws BeansException {    SnGeneInfo[] geneInfos = parseSnGeneInfos();    System.out.println(logInfo(geneInfos));    for (SnGeneInfo geneInfo : geneInfos) {      BeanDefinitionBuilder bdb = BeanDefinitionBuilder.genericBeanDefinition(RedisSnGenerator.class);      bdb.addConstructorArgValue(geneInfo.getKeyName());      bdb.addConstructorArgValue(geneInfo.getBeanName());      bdb.addConstructorArgValue(geneInfo.getInitNum());      bdb.addConstructorArgValue(geneInfo.getStep());      bdb.addConstructorArgValue(geneInfo.getMaxNum());      registry.registerBeanDefinition(geneInfo.getBeanName(), bdb.getBeanDefinition());    }  }

需要很多序列的话?


如果需要非常多的序列生成器的话,上面的方法不可取。可以采用“分组”序列生成器,每一组内可以有足够多的序列,且组与组之间互不影响。

下面请看使用方法,还是一样的简单:

下面请看效果:

每一组内部的key,就是上面的f1/f2/f3等,不用配置,程序按需直接传入即可。

此时获取下一个序列号的方法需要带一个参数,就是用来传这个key的。它是基于Redis的哈希(Hash)实现的。

/** * 分组序列号生成器 * @author lixinjie * @since 2019-04-04 */public interface GroupSnGenerator {  /**名称,根据实际情况使用*/  String getName();  /**注册到容器中的bean名称*/  String getBeanName();  /**初始值*/  long getInitNum();  /**步长*/  long getStep();  /**获取下一个序列号*/  long nextNum(String identifier);  /**最大值*/  long getMaxNum();}

此时也会遇到给hashkey设置初始值的问题,肯定和上面不一样,请阅读源码吧。

/** * 基于Redis的实现 * @author lixinjie * @since 2019-04-04 */public class RedisGroupSnGenerator implements GroupSnGenerator {
  private Map<String, Boolean> existHashKeys = new ConcurrentHashMap<>();  @Autowired  private StringRedisTemplate stringRedisTemplate;  private String name;  private String beanName;  private long initNum;  private long step;  private long maxNum;  public RedisGroupSnGenerator(String name, String beanName, long initNum, long step, long maxNum) {    this.name = name;    this.beanName = beanName;    this.initNum = initNum;    this.step = step;    this.maxNum = maxNum;  }  @PostConstruct  public void init() {    if (!stringRedisTemplate.hasKey(getName())) {      stringRedisTemplate.opsForHash().putIfAbsent(getName(), "flag", String.valueOf(getInitNum()));    }  }
  @Override  public String getName() {    return name;  }
  public String getBeanName() {    return beanName;  }
  @Override  public long getInitNum() {    return initNum;  }
  @Override  public long getStep() {    return step;  }
  @Override  public long nextNum(String identifier) {    if (!existHashKeys.containsKey(identifier)) {      stringRedisTemplate.opsForHash().putIfAbsent(getName(), identifier, String.valueOf(getInitNum()));      existHashKeys.putIfAbsent(identifier, Boolean.TRUE);    }    return stringRedisTemplate.opsForHash().increment(getName(), identifier, getStep());  }
  @Override  public long getMaxNum() {    return maxNum;  }
}

源码地址:https://github.com/coding-new-talking/cnt-springboot.git

先看整体效果


把简单的东西“傻瓜化”是软件开发追求的目标之一。请看下图:


左边是在 application.yml 里配置了3个生成器,右边可以直接注入到代码中使用,注意,不用写任何代码。这酸爽。

下面请看效果:

上面是3个生成器生成的第一个序号。哎吆,还不错哦。

 

慢慢学会分析


序列号大家都非常熟悉,无非就是一个初始值、步长,有时还有最大值。这只是最基本的信息,还可以按需添加其他的。

很容易抽象出一个接口,如下代码:

/** * 序列号生成器 * @author lixinjie * @since 2019-04-04 */public interface SnGenerator {  /**名称,根据实际情况使用*/  String getName();  /**注册到容器中的bean名称*/  String getBeanName();  /**初始值*/  long getInitNum();  /**步长*/  long getStep();  /**获取下一个序列号*/  long nextNum();  /**最大值*/  long getMaxNum();}

剩下的就是下面这三个问题了:

  • 接口有了之后,自然就是基于Redis的实现了,这是遇到第一个问题。

  • 还需要根据配置动态向容器中注册bean定义,这是第二个问题。

  • 自然需要从配置文件中读出这些配置信息,供上一步使用,这是第三个问题。


 

再来学会实现


接口实现时主要用到Redis的INCRBY命令,这是个原子命令。即使你有多个节点,每个节点有多个线程同时来调用,也是OK的。

而且key不存在时,首次调用时还会将key设置为0。这样带来的好处就是,程序不用考虑key是否存在,直接调用自增就可以了。

唯一不爽的就是key只会被设置为0,如果初始值不是从0开始的,就真有些不爽,最简单的办法就是在程序中把初始值作为偏移量叠加上去。

当然还有另一个办法,就是主动设置key的初始值。因为存在并发,自然要使用SETNX命令。这样已经完全OK,但还是会有人在心理上觉得不安全。那就在应用启动阶段执行该命令,此时肯定不会有调用的。请看下面源码:

/** * 基于Redis的实现 * @author lixinjie * @since 2019-04-04 */public class RedisSnGenerator implements SnGenerator {
  @Autowired  private StringRedisTemplate stringRedisTemplate;  private String name;  private String beanName;  private long initNum;  private long step;  private long maxNum;  public RedisSnGenerator(String name, String beanName, long initNum, long step, long maxNum) {    this.name = name;    this.beanName = beanName;    this.initNum = initNum;    this.step = step;    this.maxNum = maxNum;  }  @PostConstruct  public void init() {    if (!stringRedisTemplate.hasKey(getName())) {      stringRedisTemplate.opsForValue().setIfAbsent(getName(), String.valueOf(getInitNum()));    }  }
  @Override  public String getName() {    return name;  }
  public String getBeanName() {    return beanName;  }
  @Override  public long getInitNum() {    return initNum;  }
  @Override  public long getStep() {    return step;  }
  @Override  public long nextNum() {    return stringRedisTemplate.opsForValue().increment(getName(), getStep());  }
  @Override  public long getMaxNum() {    return maxNum;  }
}


要动态注册bean定义,Spring框架提供了专用接口,BeanDefinitionRegistryPostProcessor:

public interface BeanDefinitionRegistryPostProcessor extends BeanFactoryPostProcessor {
  /**   * @param registry the bean definition registry used by the application context   * @throws org.springframework.beans.BeansException in case of errors   */  void postProcessBeanDefinitionRegistry(BeanDefinitionRegistry registry) throws BeansException;
}

它是一个bean工厂后处理器,应用启动时框架会自动检测并应用该类型的实现类。

要使用配置文件中的内容,Spring框架提供了专门的接口,EnvironmentAware:

public interface EnvironmentAware extends Aware {
  /**   * Set the {@code Environment} that this component runs in.   */  void setEnvironment(Environment environment);
}

它是一个Aware接口,应用启动时框架会自动检测该类型的接口并把你需要的给你set进去。

这块源码有点多,我们就只看两部分吧。下面是从配置文件中读出配置信息的:

  private SnGeneInfo[] parseSnGeneInfos() {    String prefix = "sngenerator";    String[] generators = environment.getProperty(prefix + ".generators", String[].class);    SnGeneInfo[] infos = new SnGeneInfo[generators.length];    for (int i = 0; i < generators.length; i++) {      infos[i] = buildSnGeneInfo(prefix, generators[i]);    }    return infos;  }  private SnGeneInfo buildSnGeneInfo(String prefix, String generator) {    return new SnGeneInfo(        prefix + ":" + generator,        environment.getProperty(prefix + "." + generator + ".bean-name"),        environment.getProperty(prefix + "." + generator + ".init-num", long.class),        environment.getProperty(prefix + "." + generator + ".step", long.class),        environment.getProperty(prefix + "." + generator + ".max-num", long.class)      );  }


下面是注册bean定义的:

  @Override  public void postProcessBeanDefinitionRegistry(BeanDefinitionRegistry registry) throws BeansException {    SnGeneInfo[] geneInfos = parseSnGeneInfos();    System.out.println(logInfo(geneInfos));    for (SnGeneInfo geneInfo : geneInfos) {      BeanDefinitionBuilder bdb = BeanDefinitionBuilder.genericBeanDefinition(RedisSnGenerator.class);      bdb.addConstructorArgValue(geneInfo.getKeyName());      bdb.addConstructorArgValue(geneInfo.getBeanName());      bdb.addConstructorArgValue(geneInfo.getInitNum());      bdb.addConstructorArgValue(geneInfo.getStep());      bdb.addConstructorArgValue(geneInfo.getMaxNum());      registry.registerBeanDefinition(geneInfo.getBeanName(), bdb.getBeanDefinition());    }  }

需要很多序列的话?


如果需要非常多的序列生成器的话,上面的方法不可取。可以采用“分组”序列生成器,每一组内可以有足够多的序列,且组与组之间互不影响。

下面请看使用方法,还是一样的简单:

下面请看效果:

每一组内部的key,就是上面的f1/f2/f3等,不用配置,程序按需直接传入即可。

此时获取下一个序列号的方法需要带一个参数,就是用来传这个key的。它是基于Redis的哈希(Hash)实现的。

/** * 分组序列号生成器 * @author lixinjie * @since 2019-04-04 */public interface GroupSnGenerator {  /**名称,根据实际情况使用*/  String getName();  /**注册到容器中的bean名称*/  String getBeanName();  /**初始值*/  long getInitNum();  /**步长*/  long getStep();  /**获取下一个序列号*/  long nextNum(String identifier);  /**最大值*/  long getMaxNum();}

此时也会遇到给hashkey设置初始值的问题,肯定和上面不一样,请阅读源码吧。

/** * 基于Redis的实现 * @author lixinjie * @since 2019-04-04 */public class RedisGroupSnGenerator implements GroupSnGenerator {
  private Map<String, Boolean> existHashKeys = new ConcurrentHashMap<>();  @Autowired  private StringRedisTemplate stringRedisTemplate;  private String name;  private String beanName;  private long initNum;  private long step;  private long maxNum;  public RedisGroupSnGenerator(String name, String beanName, long initNum, long step, long maxNum) {    this.name = name;    this.beanName = beanName;    this.initNum = initNum;    this.step = step;    this.maxNum = maxNum;  }  @PostConstruct  public void init() {    if (!stringRedisTemplate.hasKey(getName())) {      stringRedisTemplate.opsForHash().putIfAbsent(getName(), "flag", String.valueOf(getInitNum()));    }  }
  @Override  public String getName() {    return name;  }
  public String getBeanName() {    return beanName;  }
  @Override  public long getInitNum() {    return initNum;  }
  @Override  public long getStep() {    return step;  }
  @Override  public long nextNum(String identifier) {    if (!existHashKeys.containsKey(identifier)) {      stringRedisTemplate.opsForHash().putIfAbsent(getName(), identifier, String.valueOf(getInitNum()));      existHashKeys.putIfAbsent(identifier, Boolean.TRUE);    }    return stringRedisTemplate.opsForHash().increment(getName(), identifier, getStep());  }
  @Override  public long getMaxNum() {    return maxNum;  }
}

源码地址:https://github.com/coding-new-talking/cnt-springboot.git

如果你对编程感兴趣或者想往编程方向发展,可以关注微信公众号【筑梦编程】,大家一起交流讨论!小编也会每天定时更新既有趣又有用的编程知识!
 

猜你喜欢

转载自blog.csdn.net/weixin_44811417/article/details/91414438
今日推荐