release v2.4.4

allurx · Sep 17, 2021 · b74756a · b74756a
1 parent 60f954e
commit b74756a
Show file tree

Hide file tree

Showing 2 changed files with 59 additions and 28 deletions.
diff --git a/README.md b/README.md
@@ -1,5 +1,7 @@
 # desensitization
+
 基于Java反射api、零依赖、简单易用、支持各种复杂数据结构的数据脱敏库，包含但不限于以下类型的数据脱敏：
+
 * **邮箱**
 * **手机号码**
 * **中文名称**
@@ -9,23 +11,33 @@
 * **统一社会信用代码**
 * **任意`CharSequence`类型的值**
 * **级联脱敏**
+
 # 用法
+
 ## jdk版本
+
 大于等于1.8
+
 ## maven依赖
+
 ```xml
+
 <dependency>
-  <groupId>red.zyc</groupId>
-  <artifactId>desensitization</artifactId>
-  <version>2.4.3</version>
+    <groupId>red.zyc</groupId>
+    <artifactId>desensitization</artifactId>
+    <version>2.4.4</version>
 </dependency>
 ```
+
 ## 例子
+
 ### 对象域值脱敏
+
 下面是一个Child类，其中包含了一些敏感域以及一些嵌套的敏感域
+
 ```java
 public class Child {
-    
+
     @ChineseNameSensitive
     private String name = "李富贵";
 
@@ -49,58 +61,77 @@ public class Child {
 
     @CascadeSensitive
     private Father father = new Father();
-
-    private @PasswordSensitive String[] passwords = {"123456", "1234567", "12345678"};
+
+    private @PasswordSensitive
+    String[] passwords = {"123456", "1234567", "12345678"};
 
     private List<@CascadeSensitive Parent> parents1 = Stream.of(new Father(), new Mother()).collect(Collectors.toList());
 
     private List<@EmailSensitive String> emails1 = Stream.of("123456@qq.com", "1234567@qq.com", "1234568@qq.com").collect(Collectors.toList());
-    
+
     private Map<@ChineseNameSensitive String, @EmailSensitive String> emails2 = Stream.of("张三", "李四", "小明").collect(Collectors.toMap(s -> s, s -> "123456@qq.com"));
 
 }
 ```
-只需要在敏感数据字段上标记相应类型的敏感注解，例如`@ChineseNameSensitive`、`@EmailSensitive`等注解，如果你的数据字段是需要级联脱敏的对象，你只需要在该字段上标注`@CascadeSensitive`注解，最后调用以下方法即可擦除对象中的所有敏感信息然后返回一个新的Child对象。
+
+只需要在敏感数据字段上标记相应类型的敏感注解，例如`@ChineseNameSensitive`、`@EmailSensitive`等注解，如果你的数据字段是需要级联脱敏的对象，你只需要在该字段上标注`@CascadeSensitive`
+注解，最后调用以下方法即可擦除对象中的所有敏感信息然后返回一个新的Child对象。
+
 ```java
-Child child = Sensitive.desensitize(new Child());
+Child child=Sensitive.desensitize(new Child());
 ```
+
 ### 值脱敏
+
 可能你的敏感信息是一个字符串类型的值或者是一个`Collection`、`Array`、`Map`之类的值，同样擦除它们的敏感信息也很简单：
+
 ```java
 static void desensitize(){
 
-    // String
-    System.out.printf("字符串脱敏: %s%n", Sensitive.desensitize("123456@qq.com", new TypeToken<@EmailSensitive String>() {
-    }));
+        // String
+        System.out.printf("字符串脱敏: %s%n",Sensitive.desensitize("123456@qq.com",new TypeToken<@EmailSensitive String>(){
+        }));
 
-    // Collection
-    System.out.printf("集合脱敏: %s%n", Sensitive.desensitize(Stream.of("123456@qq.com", "1234567@qq.com", "1234568@qq.com").collect(Collectors.toList()),
-            new TypeToken<List<@EmailSensitive String>>() {
-            }));
+        // Collection
+        System.out.printf("集合脱敏: %s%n",Sensitive.desensitize(Stream.of("123456@qq.com","1234567@qq.com","1234568@qq.com").collect(Collectors.toList()),
+        new TypeToken<List<@EmailSensitive String>>(){
+        }));
 
-    // Array
-    System.out.printf("数组脱敏: %s%n", Arrays.toString(Sensitive.desensitize(new String[]{"123456@qq.com", "1234567@qq.com", "12345678@qq.com"},
-            new TypeToken<@EmailSensitive String[]>() {
-            })));
+        // Array
+        System.out.printf("数组脱敏: %s%n",Arrays.toString(Sensitive.desensitize(new String[]{"123456@qq.com","1234567@qq.com","12345678@qq.com"},
+        new TypeToken<@EmailSensitive String[]>(){
+        })));
 
-    // Map
-    System.out.printf("Map脱敏: %s%n", Sensitive.desensitize(Stream.of("张三", "李四", "小明").collect(Collectors.toMap(s -> s, s -> "123456@qq.com")),
-            new TypeToken<Map<@ChineseNameSensitive String, @EmailSensitive String>>() {
-            }));
-}
+        // Map
+        System.out.printf("Map脱敏: %s%n",Sensitive.desensitize(Stream.of("张三","李四","小明").collect(Collectors.toMap(s->s,s->"123456@qq.com")),
+        new TypeToken<Map<@ChineseNameSensitive String, @EmailSensitive String>>(){
+        }));
+        }
 ```
+
 在上面的例子中通过`TypeToken`构造需要脱敏对象的类型以便我们能够准确的捕获被脱敏对象的实际类型和相应的敏感注解。
-**这里有一个很重要的地方需要我们格外的关注：由于jdk在解析注解时的bug导致无法正确的获取嵌套类上的注解，TypeToken必须在静态方法、静态代码块中初始化或者作为静态变量初始化，不能在实例方法、实例代码块中初始化同时也不能作为成员变量初始化，这样运行时才能正确的获取脱敏对象上的注解。**
+**
+这里有一个很重要的地方需要我们格外的关注：由于jdk在解析注解时的bug导致无法正确的获取嵌套类上的注解，TypeToken必须在静态方法、静态代码块中初始化或者作为静态变量初始化，不能在实例方法、实例代码块中初始化同时也不能作为成员变量初始化，这样运行时才能正确的获取脱敏对象上的注解。**
 有关这个bug的详情可以参考这个链接[jdk解析注解的bug](http://stackoverflow.com/questions/39952812/why-annotation-on-generic-type-argument-is-not-visible-for-nested-type)
+
 # 例子
+
 1. [一个需要脱敏的复杂对象](https://github.com/Allurx/desensitization/blob/master/src/test/java/red/zyc/desensitization/model/Child.java)
 2. [测试用例](https://github.com/Allurx/desensitization/blob/master/src/test/java/red/zyc/desensitization/DesensitizationTest.java)
+
 # 原理
+
 desensitization库是基于Java1.8新增的AnnotatedType这种新的类型体系来解析各种复杂数据结构中的脱敏注解，然后通过责任链这种设计模式完成数据脱敏处理的，要想完全理解其背后的实现原理需要对Java的Type体系和AnnotatedType体系有较为深刻的理解，可以参考以下几篇文章了解Java中的类型体系以及注解体系。
+
 * [Java Type](https://www.zyc.red/Java/Reflection/Type)
 * [Java AnnotatedType](https://www.zyc.red/Java/Reflection/AnnotatedType)
 * [Java AnnotatedElement](https://www.zyc.red/Java/Reflection/AnnotatedElement)
+
 # 扩展
-如果你的应用是基于spring-boot搭建的，并且你不想在代码中每次都手动调用脱敏方法对数据进行脱敏处理，那么[desensitization-spring-boot](https://github.com/Allurx/desensitization-spring-boot) 这个starter可能会对你有很大的帮助，详细的信息可以查看该工程介绍。
+
+如果你的应用是基于spring-boot搭建的，并且你不想在代码中每次都手动调用脱敏方法对数据进行脱敏处理，那么[desensitization-spring-boot](https://github.com/Allurx/desensitization-spring-boot)
+这个starter可能会对你有很大的帮助，详细的信息可以查看该工程介绍。
+
 # License
+
 [Apache License 2.0](https://github.com/Allurx/desensitization/blob/master/LICENSE.txt)
diff --git a/pom.xml b/pom.xml
@@ -5,7 +5,7 @@
     <modelVersion>4.0.0</modelVersion>
     <groupId>red.zyc</groupId>
     <artifactId>desensitization</artifactId>
-    <version>2.4.3</version>
+    <version>2.4.4</version>
     <name>desensitization</name>
     <url>https://github.com/Allurx/desensitization</url>
     <description>Sensitive information erasure framework</description>