com.github.houbb:chinese-poetry-tangs

唐诗模块

License

License

GroupId

GroupId

com.github.houbb
ArtifactId

ArtifactId

chinese-poetry-tangs
Last Version

Last Version

0.0.4
Release Date

Release Date

Type

Type

jar
Description

Description

唐诗模块

Download chinese-poetry-tangs

How to add to project

<!-- https://jarcasting.com/artifacts/com.github.houbb/chinese-poetry-tangs/ -->
<dependency>
    <groupId>com.github.houbb</groupId>
    <artifactId>chinese-poetry-tangs</artifactId>
    <version>0.0.4</version>
</dependency>
// https://jarcasting.com/artifacts/com.github.houbb/chinese-poetry-tangs/
implementation 'com.github.houbb:chinese-poetry-tangs:0.0.4'
// https://jarcasting.com/artifacts/com.github.houbb/chinese-poetry-tangs/
implementation ("com.github.houbb:chinese-poetry-tangs:0.0.4")
'com.github.houbb:chinese-poetry-tangs:jar:0.0.4'
<dependency org="com.github.houbb" name="chinese-poetry-tangs" rev="0.0.4">
  <artifact name="chinese-poetry-tangs" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.github.houbb', module='chinese-poetry-tangs', version='0.0.4')
)
libraryDependencies += "com.github.houbb" % "chinese-poetry-tangs" % "0.0.4"
[com.github.houbb/chinese-poetry-tangs "0.0.4"]

Dependencies

compile (2)

Group / Artifact Type Version
com.github.houbb : chinese-poetry-common jar 0.0.4
com.github.houbb : heaven jar 0.1.86

test (2)

Group / Artifact Type Version
com.github.houbb : keyword jar 0.0.3
junit : junit jar 4.12

Project Modules

There are no modules declared in this project.

checksum

基于 java 注解生成加签验签 checksum。

Maven Central

创作缘由

原来的代码中,checksum 的生成是用的工具类方法。

后来发现如下的问题:

  1. 有些字段太大,不想参与验签,但是无法方便的调整。

  2. 不同系统的 checksum 字段不同,只好把工具方法 copy 过去,改来改去。

感觉这样有很大的弊端,完全失去了灵活性。

特性

  • 基于注解的 checksum 加签验签,灵活方便

  • Fluent 流式语法

  • 支持用户策略自定义

  • 高性能,和手动设置相差无几

  • 轻量级框架,jar 包只有 19kb

更新记录

更新记录

快速开始

环境要求

jdk7+

maven 3.x+

引入

<plugin>
    <groupId>com.github.houbb</groupId>
    <artifactId>checksum</artifactId>
    <version>0.0.3</version>
</plugin>

定义待加签的示例对象

  • User.java
public class User {

    @CheckField
    private String name;

    @CheckField
    private String password;

    private String address;

    @Checksum
    private String checksum;

    //Getter & Setter
    //toString()
}

核心注解

@CheckField 表示参与加签的字段信息

@Checksum 表示加签结果存放的字段,该字段类型需要为 String 类型。

后期将会添加一个 String 与不同类型的转换实现,拓展应用场景。

调用测试

User user = User.buildUser();
final String checksum = ChecksumBs
                .newInstance(user)
                .checksum();

Assert.assertEquals(user.buildChecksum(), checksum);

该方法会把 User 对象中指定 @CheckField 的字段全部进行处理, 通过指定排序后进行拼接,然后结合指定加密策略构建最后的验签结果。

ChecksumBs 引导类

用来创建加签的相关配置及实现。

构建引导类

ChecksumBs.newInstance(object) 可以新建一个引导类实例。

调用核心方法

方法 返回值 备注
checksum() String 返回加签的结果
fill() 将上面 checksum 的结果设置到 @Checksum 标识的字段中

自定义策略

  • 字段排序策略

  • 加密策略

这两个策略暂时未作开放,后期将逐步开放功能。

性能

背景

每次我们说到反射第一反应是方便,第二反应就是性能。

有时候往往因为关心性能,而选择手动一次次的复制,黏贴。

性能

详情见 BenchmarkTest.java

benchmark

本次进行 100w 次测试验证,耗时如下。

手动处理耗时:2505ms

注解处理耗时:2927ms

Versions

Version
0.0.4