Solon 框架详解(九)- 渲染控制之定制统一的接口输出
Solon详解系列文章:
Solon详解(一)- 快速入门
Solon详解(二)- Solon的核心
Solon详解(三)- Solon的web开发
Solon详解(四)- Solon的事务传播机制
Solon详解(五)- Solon扩展机制之Solon Plugin
Solon详解(六)- Solon的校验框架使用、定制与扩展
Solon详解(七)- Solon Ioc 的注解对比Spring及JSR330
Solon详解(八)- Solon的缓存框架使用和定制
Solon详解(九)- 渲染控制之定制统一的接口输出
Solon详解(十)- 怎么用 Solon 开发基于 undertow jsp tld 的项目?
下面这个场景是特意为此文设计出来的,有点儿乱。但凡类似的场景。。。Solon 都可以给你一个so easy的支持。
Solon 特性之一:
可让控制器实现 Render,从而接管控制器的渲染动作。
一、定义个接口基类,并实现渲染接口
渲染逻辑如下:
- 如果对象是null,跳过不管
- 如果是String,直接输出
- 如果是ONode,做为Json输出
- 如果是UapiCode,将其转为Result,再序列化为Json输出
- 如果是Throwable,将其转为Result,再序列化为Json输出
- 如果是其它数据,直接序列化为Json输出
代码:
//这个注解可继承,用于支持子类的验证
//
@Valid
public class UapiBase implements Render {@Overridepublic void render(Object obj, Context ctx) throws Throwable {if (obj == null) {return;}if (obj instanceof String) {ctx.output((String) obj);} else {if (obj instanceof ONode) {ctx.outputAsJson(((ONode) obj).toJson());} else {if (obj instanceof UapiCode) {//此处是重点,把一些特别的类型进行标准化转换//UapiCode err = (UapiCode) obj;obj = XResult.failure(err.getCode(), UapiCodes.getDescription(err));}if (obj instanceof Throwable) {//此处是重点,把异常进行标准化转换//Throwable err = (Throwable) obj;obj = XResult.failure(err.getMessage());}ctx.outputAsJson(ONode.stringify(obj));}}}
}
二、接口示例
1. 白名单接口
此接口做个白名单检测。如果成功,则返加符串:OK
@Controller
public class CMD_run_whitelist_check extends UapiBase {//此处的@NotEmpty验证,如果没通过会抛出UapiCode@NotEmpty({"type", "value"})@Mapping("/run/whitelist/check/")public String cmd_exec(Context ctx, String type, String value) throws Exception {String tags = ctx.param("tags", "");if (tags.contains("client")) {if (DbWaterCfgApi.whitelistIgnoreClient()) {return "OK";}}if (DbWaterCfgApi.isWhitelist(tags, type, value)) {return ("OK");} else {return (value + ",not is whitelist!");}}
}
2. 通知推送接口
此接口只能白名单里的IP方可调用。执行后返回:Result
//此处的@Whitelist验证,如果没通过会抛出UapiCode
@Whitelist
@Controller
public class CMD_run_push extends UapiBase {//此处的@NotEmpty验证,如果没通过会抛出UapiCode@NotEmpty({"msg", "target"})@Mapping("/run/push/")public Result cmd_exec(String msg, String target) throws Exception {List<String> list = new ArrayList<String>();for (String str : target.split(",")) {if (str.equals("@alarm")) {List<String> mobiles = DbWaterCfgApi.getAlarmMobiles();list.addAll(mobiles);} else {list.add(str);}}String rest = ProtocolHub.heihei.push(Config.water_service_name, list, msg);if (TextUtils.isEmpty(rest) == false) {return Result.succeed(ONode.load(rest));} else {return Result.failure();}}
}
3. 配置获取接口
此接口返回一组配置,以ONode类型返回
//@Logging是个拦截器,会对请求输入进行记录
@Logging
//此处的@Whitelist验证,如果没通过会抛出UapiCode
@Whitelist
@Controller
public class CMD_cfg_get extends UapiBase {//此处的@NotEmpty验证,如果没通过会抛出UapiCode@NotEmpty("tag")@Mapping("/cfg/get/")public ONode cmd_exec(Context ctx, String tag) throws Throwable {ONode nList = new ONode().asObject();if (TextUtils.isEmpty(tag) == false) {List<ConfigModel> list = DbWaterCfgApi.getConfigByTag(tag);Date def_time = new Date();for (ConfigModel m1 : list) {if (m1.update_fulltime == null) {m1.update_fulltime = def_time;}ONode n = nList.getNew(m1.key);n.set("key", m1.key);n.set("value", m1.value);if (m1.update_fulltime == null) {n.set("lastModified", 0);} else {n.set("lastModified", m1.update_fulltime.getTime());}}}return nList;}
}
此文的渲染控制重点是对抛出来的UapiCode和Throwable,进行有效的控制并以统一的Result形态输出。对外接口开发时,还是效果可期的。当然,也可以用此特性干点别的什么事儿。
附:Solon项目地址
- gitee: https://gitee.com/noear/solon
- github: https://github.com/noear/solon
Solon 框架详解(九)- 渲染控制之定制统一的接口输出相关推荐
- shiro放行_Shiro框架详解 tagline
部分面试资料链接:https://pan.baidu.com/s/1qDb2YoCopCHoQXH15jiLhA 密码:jsam 想获得全部面试必看资料,关注公众号,大家可以在公众号后台回复" ...
- WebDriver自动化测试框架详解
webDriver自动化测试框架详解 一. 简介 WebDriver API相对于Selenium Remote Control API来说,虽然同样是控制浏览器,但它的编程接口更加简洁 WebDri ...
- Android 动画框架详解,第 1 部分
2019独角兽企业重金招聘Python工程师标准>>> Android 平台提供了一套完整的动画框架,使得开发者可以用它来开发各种动画效果,本文将向读者阐述 Android 的动画框 ...
- springboot2整合mysql5_SpringBoot2整合SSM框架详解
SpringBoot2整合SSM框架详解 发布时间:2019-01-15 21:33, 浏览次数:1218 , 标签: SpringBoot SSM <>开发环境 * 开发工具:Eclip ...
- (转) shiro权限框架详解06-shiro与web项目整合(上)
http://blog.csdn.net/facekbook/article/details/54947730 shiro和web项目整合,实现类似真实项目的应用 本文中使用的项目架构是springM ...
- java编译器源码详解_已更新至第8章 | LLVM 编译框架详解
LLVM是什么? 我又不做编译器研究,干嘛要管它? 这是一些朋友想要对LLVM发起的提问,那么今天我们就来看看那款据说很酷炫的编译器--LLVM. LLVM是什么? LLVM是一个自由软件项目,它是一 ...
- iOS中ImageIO框架详解与应用分析
2019独角兽企业重金招聘Python工程师标准>>> iOS中ImageIO框架详解与应用分析 一.引言 ImageIO框架提供了读取与写入图片数据的基本方法,使用它可以直接获取到 ...
- 双目视觉集合框架详解
双目视觉几何框架详解 一.图像坐标:我想和世界坐标谈谈(A) 玉米竭力用轻松具体的描述来讲述双目三维重建中的一些数学问题.希望这样的方式让大家以一个轻松的心态阅读玉米的<计算机视觉学习笔记> ...
- Django REST 框架详解 07 | 三大认证与权限六表
文章目录 一.三大认证 1. 认证组件:校验用户 2. 权限组件:校验用户权限 3. 频率组件:限制视图接口被访问次数 4. 分析源码 二.权限六表 1. RBAC 认证 2. 权限三表 3. 权限五 ...
最新文章
- index.html文件作用,MEAN JS – 主要的html文件(index.html)位于何处
- spring注解配置quartz
- arm中断保护和恢复_浅谈ARM处理器的七种异常处理
- SpringCloud介绍(一)
- C#LeetCode刷题之#11-盛最多水的容器(Container With Most Water)
- 解题:HNOI 2008 玩具装箱
- 应用安全-提权/降权相关整理
- 关于10月16日数据迁移致网友的致歉信
- VBA 根据模板批量生成工作表
- 审计机构不用计算机审计,计算机审计存在哪些风险
- android 号码区号判断,android 将手机号中间隐藏为星号(*)和手机号码判断
- linux系统怎么使用优盘,教你如何使用u盘安装Linux系统
- c语言cout函数,c++中cin与cout 详解
- Javascript是什么,能干什么、JavaScript的发展史、JavaScript的使用、方式一:内部引用、方式二:外部引用、程序设计的基础、数据类型与变量、运算符
- C++环境下部署深度学习模型方案
- 华为云14天鸿蒙设备开发培训Day3:快速入门
- Accenture埃森哲面试
- Python入门教程NO.5 用python写个自动选择加油站的小程序
- middel在c语言中的作用,Middle和medium的区别
- 大数据部门组织架构以及相关团队职能分析