func-spring-boot-starter 匿名函数托管
func-spring-boot-starter 匿名函数托管
GitHub项目路径:
https://github.com/yiurhub/func-spring-boot-starterGitee项目路径:
https://gitee.com/yiur/func-spring-boot-starter使用注意事项
推荐版本:
- spring-boot-starter
2.6.x
设计原理
匿名函数特性
匿名函数链接配置
Yaml
func-link: # 默认代理模式 singleton: true # 默认开启lambda模式 lambda: true # 默认的callback回调函数类 call-back: org.func.spring.boot.component.callback.SimpleFuncCallback # logger 配置 logger: # 默认false 不输出日志 enable-log: false # 默认输出日志信息 ${取当前匿名函数的公开信息} message: "call method --> ${methodName}(${parameterSource})" # 日志执行日志格式化 date-format: "yyyy-MM-dd HH:mm:ss" # 输出日志的文件名 file-name: "simple"JavaConfig
添加类注解@EnableFuncLambda
需要注入FuncLinkFactory工厂类，生产默认FuncLink链接类
添加链接的方法为setObject(key, Object)链式编程泛型约束Lambda
key: {Spring Bean Name}????{功能链接 | 插件}
object: ${功能链接类| 插件类}
FuncLink推荐Lambda操作
详细内容请看项目:
https://gitee.com/yiur/func-spring-boot-starter/tree/main/func-web-simple@Configuration @EnableFuncLambda("com.simple.web.lambda") public class FuncLinkConfig { @Autowired public FuncLinkFactory funcLinkFactory; @Bean public FuncLink funcLink() { return funcLinkFactory.build() .<FuncLogger>setObject("logger:log", (set, log) -> "logger => ${methodName}\r\n"); } }严格类型托管
开发推荐严格类型托管，有代码提示，开发效率更高，在Web项目中，可以托管整个Servcie层
配合Mybaits，Redis等框架一起使用
1、定义接口
用于SpringBoot自动注入funcLink代理的HttpLink类
public interface HttpLink { Object link(); }2、代理类代理接口方法
@FuncBean(link = "funcLink Bean Name")
添加类注解@FuncBean声明这是一个匿名函数代理类
添加方法注解@FuncLambda声明这是一个代理方法
如果有参数请加上参数注解@FuncParameter("参数名")
@Component @FuncBean public class FuncLinkHosting implements HttpLink { @Override @FuncLambda(classFile = HttpLink.class) public Map<String, String> link() { Map<String, String> map = new HashMap<>(10); map.put("GitHub", "https://github.com/yiurhub"); map.put("Gitee", "https://gitee.com/yiur"); map.put("博客", "https://www.cnblogs.com/yiur-bgy"); return map; } }松散类型托管
开发使用不推荐，后续2.x估计废用，可读性不高
1、定义接口
添加类注解@Component，用于SpringBoot自动注入funcLink代理的HttpLink类，SpringBoot插件提升
@Component public interface HttpLink { Object link(); }2、代理类代理接口方法
@FuncBean(link = "funcLink Bean Name")
松散类型托管需要注意的事项:
- 代理方法返回值与接口不一样，接口返回值必须得是Object
添加类注解@FuncBean声明这是一个匿名函数代理类
添加方法注解@FuncLambda声明这是一个代理方法
如果有参数请加上参数注解@FuncParameter("参数名")
@FuncBean public class FuncLinkHosting { @FuncLambda(classFile = HttpLink.class) public Map<String, String> link() { Map<String, String> map = new HashMap<>(10); map.put("GitHub", "https://github.com/yiurhub"); map.put("Gitee", "https://gitee.com/yiur"); map.put("博客", "https://www.cnblogs.com/yiur-bgy"); return map; } }@FuncLogger
添加方法注解@FuncLogger开启方法执行完后的输出日志，优先级比配置文件高
@FuncLogger参数
name: 生成的日志文件名，默认为func-link
suffix: 生成的日志文件后缀名，默认为log
path: 生成的日志文件存放绝对路径路径，默认当前项目下的log文件夹下
@FuncBean public class FuncLinkHosting implements HttpLink { @Override @FuncLogger @FuncLambda(classFile = HttpLink.class) public Map<String, String> link() { Map<String, String> map = new HashMap<>(10); map.put("GitHub", "https://github.com/yiurhub"); map.put("Gitee", "https://gitee.com/yiur"); map.put("博客", "https://www.cnblogs.com/yiur-bgy"); return map; } }FuncLink 返回message
应用
Logger 日志功能链接，根据执行方法绑定的Bean或者ref，执行此功能
在绑定的方法中执行完后，则会输出日志，获取执行的方法信息
链接
FuncLogger
功能链接为:"${Bean Name}:log"
代码
@Configuration @EnableFuncLambda("com.simple.web.lambda") public class FuncLinkConfig { @Autowired public FuncLinkFactory funcLinkFactory; @Bean public FuncLink funcLink() { return funcLinkFactory.build() .<FuncLogger>setObject("httpLink:log", (set, log) -> "logger => ${methodName}\r\n"); } }@FuncCallback 注解实现
添加方法注解@FuncCallback绑定方法执行后的回调函数
成功执行回调:then(T result)
失败执行回调:error(Throwable e)
public class DefaultCallback implements FuncCallback { @Override public Object then(Object data) { return data; } @Override public Object error(Throwable error) { return error.getMessage(); } }@FuncBean public class FuncLinkHosting implements HttpLink { @Override @FuncCallback(DefaultCallback.class) @FuncLambda(classFile = HttpLink.class) public Map<String, String> link() { Map<String, String> map = new HashMap<>(10); map.put("GitHub", "https://github.com/yiurhub"); map.put("Gitee", "https://gitee.com/yiur"); map.put("博客", "https://www.cnblogs.com/yiur-bgy"); return map; } }FuncLink Callback 实现
应用
Callback 方法执行完回调功能链接，根据执行方法绑定的Bean或者ref，执行此功能
在Web项目Service层中返回方法执行的结果，能做到服务熔断操作
链接
FuncCallback<T, R>约束参数值和返回值，执行优先级: 1
功能链接为:"${Bean Name}:callback"
FuncCallbackThen<T, R>约束参数值和返回值，执行优先级: 2
功能链接为:"${Bean Name}:callback-then"
FuncCallbackError<R>约束返回值，执行优先级: 2
功能链接为:"${Bean Name}:callback-error"
代码
@Configuration @EnableFuncLambda("com.simple.web.lambda") public class FuncLinkConfig { @Autowired public FuncLinkFactory funcLinkFactory; @Bean("simple") public FuncLink funcLink() { return funcLinkFactory.build() // httpLink .<FuncCallback<Map<String, String>, Object>>setObject("httpLink:callback", new FuncCallback<Map<String, String>, Object>() { @Override public Object then(Map<String, String> result) { return result; } @Override public Object error(Throwable throwable) { return throwable; } }) .<FuncCallbackThen<Map<String, String>, Object>>setObject("httpLink:callback-then", result -> result) .<FuncCallbackError<Object>>setObject("httpLink:callback-error", throwable -> throwable); } }FuncLink Life 实现
应用
Life 方法执行前后回调功能链接，根据执行方法绑定的Bean或者ref，执行此功能
方法执行前会先执行start方法，用来检查参数
方法执行后会执行end方法，用来检查返回值
链接
FuncLife<T, R>约束参数值和返回值，执行优先级: 1
功能链接为:"${Bean Name}:life"
FuncLifeStart约束参数值和返回值，执行优先级: 2
功能链接为:"${Bean Name}:life-start"
FuncLifeEnd<T, R>约束返回值，执行优先级: 2
功能链接为:"${Bean Name}:life-end"
代码
@Configuration @EnableFuncLambda("com.simple.web.lambda") public class FuncLinkConfig { @Autowired public FuncLinkFactory funcLinkFactory; @Bean("simple") public FuncLink funcLink() { return funcLinkFactory.build() // httpLink .<FuncLife<Object, Object>>setObject("httpLink:life", new FuncLife<Object, Object>() { @Override public Map<String, Object> start(Map<String, Object> args) { return args; } @Override public Object end(Object result) { return result; } }) .<FuncLifeStart>setObject("httpLink:life-start", args -> args) .<FuncLifeEnd<Object, Object>>setObject("httpLink:life-end", result -> result); } }1.1.3.RELEASE 更新
func-spring-boot-starter-1.1.2.RELEASE 依赖
<!--func--> <dependency> <groupId>io.github.yiurhub</groupId> <artifactId>func-spring-boot-starter</artifactId> <version>1.1.3.RELEASE</version> </dependency>添加匿名函数链接自定义实现功能
AbstractFuncLifePlugin
public class SimpleLifePlugin extends AbstractFuncLifePlugin { public SimpleLifePlugin() { } public SimpleLifePlugin(String beanName, String[] refs, FuncLink funcLink, FuncCallbackPlugin funcCallbackPlugin) { super(beanName, refs, funcLink, funcCallbackPlugin); } }AbstractFuncCallbackPlugin
public class SimpleCallbackPlugin extends AbstractFuncCallbackPlugin { public SimpleCallbackPlugin() { } public SimpleCallbackPlugin(String beanName, String[] refs, FuncLink funcLink, FuncProperties funcProperties, FuncLoggerPlugin funcLoggerPlugin) { super(beanName, refs, funcLink, funcProperties, funcLoggerPlugin); } }AbstractFuncLoggerPlugin
public class SimpleLoggerPlugin extends AbstractFuncLoggerPlugin { public SimpleLoggerPlugin() { } public SimpleLoggerPlugin(String beanName, String[] refs, FuncLink funcLink, FuncProperties funcProperties) { super(beanName, refs, funcLink, funcProperties); } }FuncLink 使用
@Configuration @EnableFuncLambda("com.simple.web.lambda") public class FuncLinkConfig { @Autowired public FuncLinkFactory funcLinkFactory; @Bean("simple") public FuncLink funcLink() { return funcLinkFactory.build() // httpLink .setObject("httpLink:FuncLifePlugin", SimpleLifePlugin.class) .setObject("httpLink:FuncCallbackPlugin", SimpleCallbackPlugin.class) .setObject("httpLink:FuncLoggerPlugin", SimpleLoggerPlugin.class) } }API更改
注解更改
@FuncConfiguration 改为@FuncBean
@EnableLog 改为@FuncLogger
CallbackClass 改为@FuncCallback
上一个：控制Python浮点数输出位数