Dew Common的理念是简化Java开发中最常用的操作,同时尽可能少地引入第三方包,做到通用、易用、精简。
-
Json与Java对象互转,支持泛型
-
Java Bean操作,Bean复制、反射获取/设置注解、字段、方法等
-
Java Class扫描操作,根据注解或名称过滤
-
Shell脚本操作,Shell内容获取、成功捕获及进度报告等
-
安全(加解密、信息摘要等)操作,Base64、MD5/BCrypt/AES/SHA等对称算法和RSA等非对称算法
-
Http操作,包含Get/Post/Put/Delete/Head/Options操作
-
金额操作,金额转大写操作
-
通用拦截器栈,前/后置、错误处理等
-
定时器操作,定时和周期性任务
-
常用文件操作,根据不同情况获取文件内容
-
常用字段操作,各类字段验证、身份证提取、UUID创建等
-
常用时间处理,常规时间格式化模板
-
主流文件MIME整理,MIME分类
-
响应处理及分页模型
Note
|
文档地址: http://gudaoxuri.github.io/dew-common/ |
<parent>
<groupId>com.ecfront.dew</groupId>
<artifactId>common</artifactId>
<version>1.4.3</version>
</parent>
// 将Json字符串转成JsonNode
JsonNode json = $.json.toJson("{'name':'gudaoxuri'}");
// 获取json中的值
String name = json.get("name").asText();
// 将Json转成Java对象
JavaModel java = $.json.toObject(json,JavaModel.class);
// 将Json字符串转成Java对象
java = $.json.toObject("{'name':'gudaoxuri','date':'2016-07-12 12:00:00'}", JavaModel.class);
// 将Json字符串转成List对象
List<JavaModel> javas = $.json.toList("[{'name':'gudaoxuri','date':'2016-07-12 12:00:00'}]", JavaModel.class);
// 将Java对象转成JsonNode
json = $.json.toJson(java);
// 将List对象转成JsonNode
json = $.json.toJson(javas);
// 将JsonNode转成Json字符串
String str = $.json.toJsonString(json);
// 将Java对象转成Json字符串
str = $.json.toJsonString(java);
// 将List对象转成Json字符串
str = $.json.toJsonString(javas);
static class JavaModel{
private String name;
@JsonFormat(shape=JsonFormat.Shape.STRING, pattern="yyyy-MM-dd HH:mm:ss")
private Date date;
... get/set
}
Tip
|
更多示例见`JsonHelperTest.java` |
// Bean Copy
User ori = new User();
ori.setName("gudaoxuri");
User dist = new User();
$.bean.copyProperties(ori, dist);
// 获取Class的注解信息(此处为IdxController类的RPC注解)
TestAnnotation.RPC rpc = $.bean.getClassAnnotation(IdxController.class, TestAnnotation.RPC.class);
// 获取Class的字段信息(此处为IdxController类)
Map<String, $.bean.FieldInfo> fieldsInfo = $.bean.findFieldsInfo(IdxController.class, null, null, null, null);
// 获取Class的方法信息(此处为IdxController类)
List<$.bean.MethodInfo> methodsInfo = $.bean.findMethodsInfo(IdxController.class, null, null, null, null);
// 获取字段对应的Get/Set方法(此处为User类)
Map<String, Method[]> rel = $.bean.parseRelFieldAndMethod(User.class, null, null, null, null);
User user = new User();
user.setName("gudaoxuri");
// 根据字段的Get方法获取对应的值
Map<String, Object> values = $.bean.findValuesByRel(user, $.bean.parseRelFieldAndMethod(User.class, null, null, null, null));
// 获取对象所有字段的值
values = $.bean.findValues(user, null, null, null, null);
// 根据字段名称获取对应的值(需要有标准的Get方法)
Object value = $.bean.getValue(user, "name");
// 根据字段名称设置值(需要有标准的Set方法)
$.bean.setValue(user, "name", "gudaoxuri");
Tip
|
更多示例见`BeanHelperTest.java` |
Note
|
还有一个`$.bean(boolean useCache)`方法,用于指定是否启用缓存,启用后会缓存获取过的字段和方法列表,默认启用。 |
// 扫描获取指定包下符合条件的class类(此处要求包含Deprecated注解)
Set<Class<?>> resultInFile = $.clazz.scan("com.ecfront.$.common.test", new HashSet<Class<? extends Annotation>>(){{add(Deprecated.class);}},null);
// 扫描获取指定包下符合条件的class类(此处要求包含Before\\w*类名)
Set<Class<?>> resultInJar = $.clazz.scan("org.junit",null, new HashSet<String>(){{add("Before\\w*");}});
Tip
|
更多示例见`ClassScanHelperTest.java` |
Important
|
此操作每次返回新实例! |
$.shell().execute(
"/opt/test.sh", // sh文件路径,包含参数
"test1", // 任务ID
"done!", // 成功标识,只要捕捉到此标识就视为成功,为null时不会调用ReportHandler的success方法,执行结束后会调用ReportHandler的fail方法
"step", // 进度标识,只要捕捉到此标识就更新进度,格式为 <progressFlag>空格<progress>,如: progress 40,为null时不会调用ReportHandler的progress方法
false, // 是否返回结果(输出内容),为true时会返回结果到ReportHandler的complete方法中,结果暂存于内存中,对输出内容过多的脚本需要考虑占用内存的大小
new ReportHandler() { // 任务报告实例
@Override
public void success(String taskId) { // 成功,在执行到successFlag时调用
}
@Override
public void fail(String taskId, String message) { // 失败,在执行完成且successFlag不存在或发生错误时调用
}
@Override
public void progress(String taskId, int progress) { // 进度回调,在执行到progressFlag且格式正确时调用
}
@Override
public void complete(String taskId, String result) { // 完成,无法是否成功,在执行完成时调用
}
}
);
Tip
|
更多示例见`ShellHelperTest.java` |
// 字符串 转 Base64
String base64 = $.security.encodeStringToBase64("gudaoxuri", "UTF-8");
// 数组 转 Base64
base64 = $.security.encodeBytesToBase64("gudaoxuri".getBytes());
// Base64 转 字符串
String str = $.security.decodeBase64ToString(base64, "UTF-8");
// Base64 转 字符串
byte[] bytes = $.security.decodeBase64ToBytes(base64);
// 摘要(此处使用SHA-256算法,支持如bcrypt SHA-X等算法)
String digestContent = $.security.digest.digest("gudaoxuri", "SHA-256");
// 验证(对于bcrypt之类默认使用随机slat的加密算法必须使用此方法验证)
$.security.digest.validate("gudaoxuri", digestContent, "SHA-256");
// 对称加密(此处使用AES算法,需要提供密码)
String encryptContent = $.security.symmetric.encrypt("gudaoxuri", "pwd", "AES");
// 对称解密(此处使用AES算法,需要提供密码), BadPaddingException 异常表示密码错误
$.security.symmetric.decrypt(encryptContent, "pwd", "AES");
// 非对称加密 - 生成公钥和私钥
Map<String, String> keys = $.security.asymmetric.generateKeys("RSA", 1024);
String publicStr = "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC47dAhLLB3xhDWccgEheqTbRimAhluN/ixNyYU/MvExN/bwytthiWViRV2H1sGrGr5JyH3qQSFa57jInbXD6lGN24aw2TfiejLWGkj0hMEXEtj4Bf9OuQhHUmy8unLygOuBlIhtfPLp9cSLBgVVHbt33buNTkL7fvdE2U9B3JVyQIDAQAB";
// 非对称加密 - 获取公钥文件
PublicKey publicKey = $.security.asymmetric.getPublicKey(publicStr, "RSA");
String privateStr = "MIICdwIBADANBgkqhkiG9w0BAQEFAASCAmEwggJdAgEAAoGBALjt0CEssHfGENZxyASF6pNtGKYCGW43+LE3JhT8y8TE39vDK22GJZWJFXYfWwasavknIfepBIVrnuMidtcPqUY3bhrDZN+J6MtYaSPSEwRcS2PgF/065CEdSbLy6cvKA64GUiG188un1xIsGBVUdu3fdu41OQvt+90TZT0HclXJAgMBAAECgYEAjXFndVhHCPU3P637PGppBqW06pREeybYUkNKH1dTS4cBaYcXmke2S290OMq2xp3tm++wbUqbKKkt97AOkWNrJfq8Ecpdw9s3c7yQGWaPuwiX38Cgtq6r0utjT20YgR6etGpqafoBt93RZpEm0eEzFPUnS7qYc86HprL0RJ0/i7kCQQDaOmvO82cYIK1ESkA0GdDVQoz2A1V8HvEWOsccRGqlWuasLUccyBnx1G/LDZUxcPOraDyxI8sdl7VbweLR0H9LAkEA2O/rWXwnSYKqdpt+OhpUBHNnMs3IMvRzefJ1zObnIMyYR3KXtpQ/fL4gEquNwJgFIaPJVg5/3zHISEw3e8XOuwJAIDrGl07tZ+vTiyVoLAmwBP8KMH83jdhIBN9zbqJQGdG+Bam+Oer3ofac+CEuapni8uq3I/ZEVj+EomOVKyWe1wJAATztROd2ee7q9h5RDBfWXughsKKH//JxLkL59R9kNkW0oMPApeQWsKmNGU4tUuoLLXP31CvlAusPz4nPzz8DvQJBAJXpICPNJw84fONzS0raRqlFoZMMI0cqeGtPIiCHKaRHyzQv/FFu2KxUcCrod8PngaBFRselzrwZILmXHqrHc1M=";
// 非对称加密 - 获取私钥文件
PrivateKey privateKey = $.security.asymmetric.getPrivateKey(privateStr, "RSA");
String d = "Scala是一门多范式的编程语言,一种类似java的编程语言[1] ,设计初衷是实现可伸缩的语言[2] 、并集成面向对象编程和函数式编程的各种特性。Scala是一门多范式的编程语言,一种类似java的编程语言[1] ,设计初衷是实现可伸缩的语言[2] 、并集成面向对象编程和函数式编程的各种特性。Scala是一门多范式的编程语言,一种类似java的编程语言[1] ,设计初衷是实现可伸缩的语言[2] 、并集成面向对象编程和函数式编程的各种特性。";
// 非对称加密 - 公钥加密/私钥解密
byte[] encryptByPub = $.security.asymmetric.encrypt(d.getBytes("UTF-8"), publicKey, 1024, "RSA");
String result = new String($.security.asymmetric.decrypt(encryptByPub, privateKey, 1024, "RSA"), "UTF-8");
// 非对称加密 - 私钥加密/公钥解密
byte[] encryptByPriv = $.security.asymmetric.encrypt(d.getBytes("UTF-8"), privateKey, 1024, "RSA");
byte[] decryptByPub = $.security.asymmetric.decrypt(encryptByPriv, publicKey, 1024, "RSA");
$.security.asymmetric.verify(publicKey, decryptByPub,
$.security.asymmetric.sign(privateKey, d.getBytes("UTF-8"), "SHA1withRSA"),
"SHA1withRSA");
Tip
|
更多示例见`SecurityHelperTest.java` |
// get
String result = $.http.get("https://httpbin.org/get");
// get 带 head
result = $.http.get("https://httpbin.org/get", new HashMap<String, String>() {{
put("Customer-A", "AAA");
put("Accept", "json");
}});
// get 包含 head、Content-Type、编码、超时等信息
result = $.http.get("https://httpbin.org/get", new HashMap<String, String>() {{
put("Customer-A", "AAA");
put("Accept", "json");
}}, "application/json; charset=utf-8", "utf-8", 5000, 5000);
// delete
result = $.http.delete("https://httpbin.org/delete");
Assert.assertEquals("httpbin.org", $.json.toJson(result).get("headers").get("Host").asText());
// post - data
result = $.http.post("https://httpbin.org/post", "some data");
// post - form
result = $.http.post("https://httpbin.org/post", new HashMap<String, Object>() {{
put("a", "1");
}}, "application/x-www-form-urlencoded");
// post - file
result = $.http.post("https://httpbin.org/post", new File(this.getClass().getResource("/").getPath() + "conf1.json"));
// put - data
result = $.http.put("https://httpbin.org/put", "some data");
// put - form
result = $.http.put("https://httpbin.org/put", new HashMap<String, Object>() {{
put("a", "1");
}}, "application/x-www-form-urlencoded");
// put - file
result = $.http.put("https://httpbin.org/put", new File(this.getClass().getResource("/").getPath() + "conf1.json"));
// put 返回带 head的内容,同样还有getWithHead、postWithHead、deleteWtihHead
HttpHelper.WrapHead responseWrap = $.http.putWithHead("https://httpbin.org/put", new File(this.getClass().getResource("/").getPath() + "conf1.json"));
// head
Map<String, String> head = $.http.head("https://httpbin.org/get");
// options
head = $.http.options("https://httpbin.org/get");
Tip
|
更多示例见`HttpHelperTest.java` |
Note
|
GET POST PUT DELETE 都带 Wrap`方法,返回包含扩展信息的数据,比如 `getWrap
|
Note
|
还有一个`$.http(int maxTotal, int maxPerRoute, int defaultConnectTimeoutMS, int defaultSocketTimeoutMS, boolean retryAble)方法,用于指定`整个连接池最大连接数`及`每个路由(域)的默认最大连接 ,$.http`是 $.http(200,20)`的语法糖。
|
// 没有注册拦截器的情况
Resp<DewInterceptContext<Obj, Obj>> resp =
$.interceptor.process("none", new Obj("1"), new HashMap<>(), context -> {
try {
// 业务逻辑,只做简单将input对象copy到output对象
context.setOutput($.bean.copyProperties(context.getInput(), Obj.class));
return Resp.success(context);
} catch (InvocationTargetException | IllegalAccessException | InstantiationException e) {
e.printStackTrace();
return Resp.serverError("");
}
});
Assert.assertTrue(resp.ok());
Assert.assertEquals("1", resp.getBody().getOutput().getF());
// 注册了一个拦截器A
$.interceptor.register("test", new InterceptorA());
resp = $.interceptor.process("test", new Obj("1"), new HashMap<>(), context -> {
... 同上,只做简单将input对象copy到output对象
});
Assert.assertTrue(resp.ok());
Assert.assertEquals("2", resp.getBody().getInput().getF());
Assert.assertEquals("3", resp.getBody().getOutput().getF());
// 注册了另一个拦截器B,假设B执行会报错
$.interceptor.register("test", new InterceptorB());
resp = $.interceptor.process("test", new Obj("11"), new HashMap<>(), context -> {
... 同上,只做简单将input对象copy到output对象
});
Assert.assertTrue(!resp.ok());
Tip
|
更多示例见`InterceptorTest.java` |
// 延迟任务
$.timer.timer(1, () -> // Do Something);
// 周期性任务,参数 fixedRate 为true时表示每periodSec执行,为false表示fixedDelay,表示在当前任务执行完成后过periodSec再执行
String taskId = $.timer.periodic(1, true, () -> // Do Something);
// 取消周期性任务
$.timer.cancel(taskId);
Tip
|
更多示例见`TimerHelperTest.java` |
// 根据classpath读取文件所有内容(jar包外路径优先),另外readAllByPath、readAllByFile、readAllByPathName等衍生方法
String conf=$.file.readAllByClassPath("conf1.json","UTF-8");
Tip
|
更多示例见`FileHelperTest.java` |
// 转换成中文大写:壹仟贰佰叁拾肆亿伍仟陆佰柒拾捌万玖仟零壹拾贰元叁角肆分
$.amount.convert("1234,5678,9012.34");
Tip
|
更多示例见`AmountHelperTest.java` |
// 验证邮箱格式是否合法
$.field.validateEmail("[email protected]");
// 验证手机号格式是否合法
$.field.validateMobile("18657120000");
// 是否是汉字
$.field.isChinese("孤岛旭日");
// 验证身份证是否合法
$.field.validateIdNumber("330102199901015759");
// 根据身份编号获取年龄
$.field.getAgeByIdCard("330102199901015759");
// 根据身份编号获取生日
$.field.getBirthByIdCard("330102199901015759");
// 根据身份编号获取生日年
$.field.getYearByIdCard("330102199901015759");
// 根据身份编号获取生日月
$.field.getMonthByIdCard("330102199901015759");
// 根据身份编号获取生日天
$.field.getDateByIdCard("330102199901015759");
// 根据身份编号获取性别
$.field.getGenderByIdCard("330102199901015759");
// 根据身份编号获取户籍省份
$.field.getProvinceByIdCard("330102199901015759");
Tip
|
更多示例见`FieldHelperTest.java` |
Note
|
响应模型,用于统一请求响应处理,模型由三个属性组成: . code:响应编码,同HTTP状态码,200表示成功 . message:错误描述,当code不为200时用于描述错误信息 . body:返回的实际对象 |
/**
* 返回是否成功
*/
public boolean ok();
/**
* 返回成功
*
* @param body 实际对象
*/
public static <E> Resp<E> success(E body);
/**
* 返回未找到资源的错误,如数据记录不存在
*
* @param message 错误描述
*/
public static <E> Resp<E> notFound(String message);
/**
* 返回资源冲突的错误,如密码错误
*
* @param message 错误描述
*/
public static <E> Resp<E> conflict(String message);
/**
* 返回资源被锁定的错误,如当前用户被禁用
*
* @param message 错误描述
*/
public static <E> Resp<E> locked(String message);
/**
* 返回请求格式的错误,如json不合法
*
* @param message 错误描述
*/
public static <E> Resp<E> unsupportedMediaType(String message);
/**
* 返回请求参数的错误,如缺少参数
*
* @param message 错误描述
*/
public static <E> Resp<E> badRequest(String message);
/**
* 返回请求拒绝的错误
*
* @param message 错误描述
*/
public static <E> Resp<E> forbidden(String message);
/**
* 返回未认证的错误,如资源没有权限访问
*
* @param message 错误描述
*/
public static <E> Resp<E> unAuthorized(String message);
/**
* 返回服务器的错误,如捕捉到执行异常
*
* @param message 错误描述
*/
public static <E> Resp<E> serverError(String message);
/**
* 返回方法未实现的错误
*
* @param message 错误描述
*/
public static <E> Resp<E> notImplemented(String message);
/**
* 返回服务不可用的错误
*
* @param message 错误描述
*/
public static <E> Resp<E> serverUnavailable(String message);
/**
* 返回未知错误
*
* @param message 错误描述
*/
public static <E> Resp<E> unknown(String message);
/**
* 返回自定义错误
*
* @param message 错误描述
*/
public static <E> Resp<E> customFail(String code, String message);
/**
* 错误转换,解决java泛型继承问题
*
* @param resp 原响应对象
* @return 转换后的响应对象
*/
public static Resp<Void> error(Resp<?> resp);
/**
* 响应body转换,将body类型A转换成类型B
*
* @param resp 源响应
* @param bodyClazz 目标body类型
* @return 目标响应
*/
public static <E> Resp<E> generic(Resp resp, Class<E> bodyClazz);
/**
* 响应body转换(列表),将body类型A转换成类型B
*
* @param resp 源响应
* @param bodyClazz 目标body类型
* @return 目标响应
*/
public static <E> Resp<List<E>> genericList(Resp resp, Class<E> bodyClazz);
/**
* 响应body转换(Set),将body类型A转换成类型B
*
* @param resp 源响应
* @param bodyClazz 目标body类型
* @return 目标响应
*/
public static <E> Resp<Set<E>> genericSet(String resp, Class<E> bodyClazz);
/**
* 响应body转换(分页),将body类型A转换成类型B
*
* @param resp 源响应
* @param bodyClazz 目标body类型
* @return 目标响应
*/
public static <E> Resp<PageDTO<E>> genericPage(Resp resp, Class<E> bodyClazz);
Note
|
响应模型,用于统一请求响应处理,模型由三个属性组成: . code:响应编码,同HTTP状态码,200表示成功 . message:错误描述,当code不为200时用于描述错误信息 . body:返回的实际对象 |
/**
* 当前页,从1开始
*/
private long pageNumber;
/**
* 每页记录数
*/
private long pageSize;
/**
* 总页数
*/
private long pageTotal;
/**
* 总记录数
*/
private long recordTotal;
/**
* 实际对象
*/
private List<E> objects;
如果不需要某些功能可以在maven中排除以减少包体积
<!--$.json dependency begin-->
<exclusion>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
</exclusion>
<!--$.json dependency end-->
<!--$.bean dependency begin-->
<exclusion>
<groupId>commons-beanutils</groupId>
<artifactId>commons-beanutils</artifactId>
</exclusion>
<!--$.bean dependency end-->
<!--$.security dependency begin-->
<exclusion>
<groupId>org.mindrot</groupId>
<artifactId>jbcrypt</artifactId>
</exclusion>
<!--$.security dependency end-->
<!--$.http dependency begin-->
<exclusion>
<groupId>org.apache.httpcomponents</groupId>
<artifactId>httpclient</artifactId>
</exclusion>
<exclusion>
<groupId>org.apache.httpcomponents</groupId>
<artifactId>httpmime</artifactId>
</exclusion>
<exclusion>
<groupId>org.jooq</groupId>
<artifactId>joox</artifactId>
</exclusion>
<!--$.http dependency end-->