{"id":24866066,"url":"https://github.com/dsc-cmt/spring-easy-strategy","last_synced_at":"2025-05-12T06:17:26.610Z","repository":{"id":39820917,"uuid":"199790515","full_name":"dsc-cmt/spring-easy-strategy","owner":"dsc-cmt","description":"a useful framework for use strategy design pattern in spring easily","archived":false,"fork":false,"pushed_at":"2024-11-24T09:53:17.000Z","size":179,"stargazers_count":36,"open_issues_count":14,"forks_count":14,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-12T06:16:49.529Z","etag":null,"topics":["design-patterns","spring","strategy","strategy-pattern"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dsc-cmt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-07-31T06:08:12.000Z","updated_at":"2023-12-08T03:23:45.000Z","dependencies_parsed_at":"2024-11-19T07:02:04.093Z","dependency_job_id":null,"html_url":"https://github.com/dsc-cmt/spring-easy-strategy","commit_stats":null,"previous_names":["shengchaojie/spring-strategy-extend"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsc-cmt%2Fspring-easy-strategy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsc-cmt%2Fspring-easy-strategy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsc-cmt%2Fspring-easy-strategy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsc-cmt%2Fspring-easy-strategy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dsc-cmt","download_url":"https://codeload.github.com/dsc-cmt/spring-easy-strategy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253685240,"owners_count":21947309,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["design-patterns","spring","strategy","strategy-pattern"],"created_at":"2025-02-01T00:46:59.673Z","updated_at":"2025-05-12T06:17:26.549Z","avatar_url":"https://github.com/dsc-cmt.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://travis-ci.com/dsc-cmt/spring-easy-strategy.svg?branch=master)](https://travis-ci.com/dsc-cmt/spring-easy-strategy)\n\u003e 运行环境需要java8\n\n## 介绍\nspring-easy-strategy 是一个在spring环境下方便进行策略模式开发的工具类。\n在业务开发使用策略模式中，发现策略的注册以及获取逻辑是一个重复的功能，所以设计该工具类方便开发。  \n主要原理是利用spring的FactoryBean针对每个接口T策略生成一个StrategyManger\\\u003cT\u003e Bean。  \n\n## 策略模式？\n策略模式绝对是我们写业务代码中用到最多的设计模式之一。  \n举个简单的例子  \n比如现在我们针对不同的商品类型，有不同的计算价格方式  \n在不使用设计模式的情况下，肯定存在以下代码\n```\nif(type='水果'){\n    //计算价格\n}else if(type='蔬菜'){\n    //另一种计算价格模式\n}else{\n    ...\n}\n```\n在使用策略模式后，我们的代码变成这样\n```\nstrategy = strategyManger.get('水果');\nprice = strategy.calculate(...)\n```\n有什么好处？\n\n1. 减少if/else，让我们的逻辑更加内聚\n2. 符合开闭原则，新增逻辑时，主流程代码不需要改动，只要增加新的策略即可\n\n## 引入\n```\n\u003c!-- https://mvnrepository.com/artifact/io.github.dsc-cmt/spring-easy-strategy --\u003e\n\u003cdependency\u003e\n    \u003cgroupId\u003eio.github.dsc-cmt\u003c/groupId\u003e\n    \u003cartifactId\u003espring-easy-strategy\u003c/artifactId\u003e\n    \u003cversion\u003e1.4.0\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n## 如何使用\n### 基础使用\n在这个框架中，每个接口的策略实现都会存在一个identify对应，该identifyCode通过注解以及自定义逻辑生成\n\n#### 0. 你的策略接口\n```java\npublic interface PlatformStrategy {\n\n    String hello();\n}\n```\n\n#### 1. 实现自定义注解标记策略实现类\n\n\u003e 如果只有一个属性，直接使用自带的`@StrategyIdentifier`注解即可\n\n自定义注解是策略和标识符的桥梁\n```java\n@Target({ElementType.TYPE})\n@Retention(RetentionPolicy.RUNTIME)\n@Component\npublic @interface Platform {\n\n    PlatformEnum value();\n}\n\npublic enum PlatformEnum {\n    ALI, TENCENT, BAI_DU\n}\n```\n\n\u003e 注意@Component元注解\n\n将该注解注解到策略实现类上去，完成策略实现类与标识符的绑定\n\n```java\n@Platform(PlatformEnum.ALI)\npublic class AliStrategy implements PlatformStrategy {\n    @Override\n    public String hello() {\n        return \"阿里巴巴\";\n    }\n}\n```\n\n#### 2. 配置StrategyContainerFactoryBean\n\nStrategyContainerFactoryBean配置有三个  \n\n|参数|作用|\n|---|---|\n|strategyClass\\\u003cT\\\u003e | 策略类  |\n|strategyAnnotationClass\\\u003cV\\\u003e|  策略实现类标记注解类（作用是完成策略实现类与标识符的绑定）  |\n|identifyGetter\\\u003cR\\\u003e | 从注解提取identify的逻辑（\\\u003cR\\\u003e一般为枚举，也可以定义为String）\u003cbr /\u003e我们使用会通过\\\u003cR\\\u003e来获取对应策略 |\n\n```java\n@Bean\npublic StrategyContainerFactoryBean\u003cPlatformStrategy, Platform, PlatformEnum\u003e platformStrategyManager() {\n   StrategyContainerFactoryBean\u003cPlatformStrategy, Platform, PlatformEnum\u003e factoryBean = new StrategyContainerFactoryBean\u003c\u003e();\n        factoryBean.setStrategyClass(PlatformStrategy.class);//策略接口\n        factoryBean.setStrategyAnnotationClass(Platform.class);//策略实现类标记注解\n        factoryBean.setIdentifyGetter(Platform::value);// 策略实现类标记注解到标识符的转换逻辑\n        return factoryBean;\n    }\n```\n\n\u003e 目前来看不支持xml配置，因为有函数入参，都sb时代了，谁还xml\n\n由下面的注入可以发现，Spring忽略了泛型，因此在StrategyContainerFactoryBean增加了一个build方法，简化配置\n```java\n@Bean\npublic StrategyContainerFactoryBean\u003cPlatformStrategy, Platform, PlatformEnum\u003e platformStrategyManager() {\n    return StrategyContainerFactoryBean.build(\n            PlatformStrategy.class,\n            Platform.class,\n            Platform::value);\n}\n```\n\n#### 3. 注入StrategyContainer\n\nkey为identify\\\u003cR\\\u003e,value为strategyClass\\\u003cT\\\u003e 策略类\n\n```java\n/**\n * 需要注意，spring容器注入会把泛型丢掉，所以必须通过beanname注入\n * 或者@bean的方法名和下面的属性名platformStrategyManager保持一致\n */\n@Resource(name = \"platformStrategyManager\")\nprivate StrategyContainer\u003cPlatformEnum, PlatformStrategy\u003e platformStrategyContainer;\n```\n\n#### 4. 使用\n```java\nPlatformStrategy platformStrategy = platformStrategyContainer.getStrategy(PlatformEnum.ALI);\nplatformStrategy.hello()\n```\n\n\u003e 这边getStrategy的入参需要和自定义注解生成的identify相同\n\u003e 如果对于一个策略接口，有相同的identify产生，在FactoryBean初始化的时候会报错\n\n### 进阶功能\n\n#### 0. 减免配置(SpringBootStarter)\n考虑到现在使用方式上的繁琐以及使用策略模式大部分的场景都为简单场景(一个策略标识符对应一个策略实现)，因此针对SpringBoot开发了Starter\n\n使用这个Starter存在一个约束，**策略注解必须使用内置的@StrategyIdentifier**，如果你的策略模式比较复杂，只能自己去配置\n\n使用方式很简单，引入starter包\n\n```\n\u003cdependency\u003e\n    \u003cgroupId\u003eio.github.dsc-cmt\u003c/groupId\u003e\n    \u003cartifactId\u003espring-easy-strategy-starter\u003c/artifactId\u003e\n    \u003cversion\u003e1.4.0\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n配置策略接口以及对应实现后，注入Container即可\n\n```\n@EasyStrategy\nStrategyContainer\u003cStrategyI\u003e strategyContainerSample;\n```\n\n\n#### 1. 多个属性匹配策略\n\n使用String作为identify，使用时将多个属性通过一定规则拼接成String来匹配策略\n\n```java\n//0.定义策略接口\npublic interface HelloStrategy {\n    String hello();\n}\n\n//1.定义标记注解注解\n@Target({ElementType.TYPE})\n@Retention(RetentionPolicy.RUNTIME)\n@Component\npublic @interface People {\n    String district();\n    GenderEnum gender();\n}\n//2.将该注解注解到策略实现类上去，完成策略实现类与标识符的绑定\n@People(district = \"chinese\", gender = GenderEnum.FEMALE)\npublic class ChineseGirlHelloStrategy implements HelloStrategy {\n    @Override\n    public String hello() {\n        return \"你好\";\n    }\n}\n//3.注册配置StrategyContainerFactoryBean\n@Bean\npublic StrategyContainerFactoryBean helloStrategyContainer(){\n    return StrategyContainerFactoryBean.build(\n      HelloStrategy.class,\n      People.class,\n      a -\u003e Joiner.on(\",\").join(a.district(),a.gender().name()));\n}\n//4.在调用类中注入StrategyContainer\n@Resource(name = \"helloStrategyContainer\")\nprivate StrategyContainer\u003cString, HelloStrategy\u003e helloStrategyContainer;\n//5.使用\nHelloStrategy helloStrategy = helloStrategyContainer.getStrategy(Joiner.on(\",\").join(\"chinese\", GenderEnum.FEMALE.name()));\nhelloStrategy.hello()\n```\n\n#### 2. 手动绑定策略\n\nStrategyContainer接口提供一个register方法用于手动绑定identifyCode和策略\n```java\nhelloStrategyContainer.register(Joiner.on(\",\").join(\"american\", GenderEnum.FEMALE.name()),()-\u003e{\n    return \"hello\";\n});\n```\n\n#### 3. 单策略支持多注解  \n在业务开发中，很多场景下，对于多个identifyCode我们的策略是相同。  \n在原有自定义注解的基础上进行改造，比如原有注解如下\n\n```java\n@Target({ElementType.TYPE})\n@Retention(RetentionPolicy.RUNTIME)\n@Component\npublic @interface One {\n\n    String test();\n\n}\n```\n我们新增一个容器注解，为了支持在同一类上标注多个相同注解\n```java\n@Target({ElementType.TYPE})\n@Retention(RetentionPolicy.RUNTIME)\n@Component\npublic @interface Many {\n\n    One[] value();\n}\n```\n修改原有注解为\n```java\n@Target({ElementType.TYPE})\n@Retention(RetentionPolicy.RUNTIME)\n@Repeatable(Many.class)\n@Component\npublic @interface One {\n\n    String test();\n\n}\n```\n这是java8提供的语法糖，在做如上配置后，你就能在一个策略类标注多个相同注解了  \n\n框架自带的StrategyIdentifier已支持多注解模式\n\n\n#### 4. 默认策略  \n新增了一个`@DefaultStrategy`注解，策略类标注该注解后，如果通过identifyCode找不到策略实现，会执行默认策略逻辑。\n\n\u003e 注意: 一个接口默认策略只能有一个，不然会报错  \n\n#### 5. 支持多策略模式\n某些业务场景下，针对一个identifyCode可能需要多个策略执行，比如我们的校验逻辑，针对一个业务方，可能会触发多个。  \n因此实现了MultiStrategyContainerFactoryBean类，基本使用和StrategyContainerFactoryBean类似。\n也正是因为通过identifyCode可以获取到多个策略了，针对这种模式，新增了排序功能，可以使用spring的Order注解来指定顺序。\n\n使用方式如下  \n策略配置\n```java\n@StrategyIdentifier(identifyCode = \"1\")\n@StrategyIdentifier(identifyCode = \"1\")\n@StrategyIdentifier(identifyCode = \"3\")\n@Order(4)\npublic class AValidation implements Validation{\n    @Override\n    public void validate() {\n        System.out.println(\"AAAAAA\");\n    }\n}\n\n@StrategyIdentifier(identifyCode = \"1\")\n@StrategyIdentifier(identifyCode = \"3\")\n@Order(3)\npublic class BValidation implements Validation{\n    @Override\n    public void validate() {\n        System.out.println(\"BBBBBBB\");\n    }\n}\n```\n框架配置\n```java\n@Bean\npublic MultiStrategyContainerFactoryBean\u003cValidation, StrategyIdentifier\u003e validation(){\n    return MultiStrategyContainerFactoryBean.build(Validation.class,StrategyIdentifier.class,a -\u003e a.identifyCode());\n}\n```\n注入\n```java\n@Resource(name = \"validation\")\nprivate MultiStrategyContainer\u003cValidation\u003e validationMultiStrategyContainer;\n```\n使用\n```java\nList\u003cValidation\u003e strategies = validationMultiStrategyContainer.getStrategies(\"1\");\n```\n\n## 更新\n\n- 2021-01-11  \n    增加starter\n  \n- 2020-03-30  \n    策略标识符identifyCode使用泛型替换\n\n- 2019-09-19  \n    支持多策略模式\n    \n- 2019-09-10  \n    支持单策略多注解  \n    支持默认注解\n    \n- 2019-09-06   \n    解决策略类生成Aop代理时获取不到策略的问题,增加Aop相关测试用例\n    \n- 2019-08-12   \n    修改类名StrategyManager为StrategyContainer\n\n\n\u003e 完整使用案例示例见test用例\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdsc-cmt%2Fspring-easy-strategy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdsc-cmt%2Fspring-easy-strategy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdsc-cmt%2Fspring-easy-strategy/lists"}