cn.felord.callback

Class AbstractCallbackCrypto<EVENT>

java.lang.Object

cn.felord.callback.AbstractCallbackCrypto<EVENT>

Type Parameters:

EVENT - 解析后的事件明文

public abstract class AbstractCallbackCrypto<EVENT>
extends Object

回调解密超类

Field Summary

Fields

Modifier and Type	Field and Description
private static String	BASE_
private static String	BOM
private CallbackAsyncConsumer<EVENT>	callbackAsyncConsumer
private static String	MSG
private static Random	RANDOM
private XmlReader	xmlReader

Constructor Summary

Constructors

Constructor and Description
AbstractCallbackCrypto(XmlReader xmlReader, CallbackAsyncConsumer<EVENT> callbackAsyncConsumer) 构造函数

Method Summary

Modifier and Type	Method and Description
<T> T	accept(EVENT eventBody, T response) Accept t.
private CallbackDecrypted	decrypt(byte[] aesKey, String text) 对密文进行解密.
CallbackDecrypted	decrypt(CallbackSettings callbackSettings, String msgSignature, String timeStamp, String nonce, String encrypt) 解密验签，用于解密XML BODY以及校验回调URL真实性
String	encrypt(String receiveid, byte[] aesKey, String randomStr, String text) 对明文进行加密.
String	encryptJsonMsg(CallbackSettings callbackSettings, String replyMsg, String timeStamp, String nonce) 将企业微信回复用户的消息加密打包.
String	encryptXmlMsg(CallbackSettings callbackSettings, String replyMsg, String timeStamp, String nonce) Encrypt xml msg string.
(package private) byte[]	getNetworkBytesOrder(int sourceNumber) 生成4个字节的网络字节序
(package private) String	randomStr() 随机生成16位字符串
<T extends XmlEntity> T	readXml(String xmlBody, Class<T> clazz) Read xml t.
(package private) int	recoverNetworkBytesOrder(byte[] orderBytes) 还原4个字节的网络字节序

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

BOM

private static final String BOM

See Also:

Constant Field Values

BASE_

private static final String BASE_

See Also:

Constant Field Values

MSG

private static final String MSG

See Also:

Constant Field Values

RANDOM

private static final Random RANDOM

xmlReader

private final XmlReader xmlReader

callbackAsyncConsumer

private final CallbackAsyncConsumer<EVENT> callbackAsyncConsumer

Constructor Detail

AbstractCallbackCrypto

public AbstractCallbackCrypto(XmlReader xmlReader,
                              CallbackAsyncConsumer<EVENT> callbackAsyncConsumer)

构造函数

Parameters:

xmlReader - the xml reader

callbackAsyncConsumer - the callback consumer

Method Detail

encrypt

public String encrypt(String receiveid,
                      byte[] aesKey,
                      String randomStr,
                      String text)
               throws IllegalArgumentException

对明文进行加密.

Parameters:

receiveid - the receiveid

aesKey - the aes key

randomStr - the random str

text - 需要加密的明文

Returns:

加密后base64编码的字符串 string

Throws:

IllegalArgumentException - aes加密失败

decrypt

private CallbackDecrypted decrypt(byte[] aesKey,
                                  String text)
                           throws IllegalArgumentException

对密文进行解密.

Parameters:

aesKey - the aes key

text - 需要解密的密文

Returns:

解密得到的明文 string

Throws:

IllegalArgumentException - aes解密失败

encryptJsonMsg

public String encryptJsonMsg(CallbackSettings callbackSettings,
                             String replyMsg,
                             String timeStamp,
                             String nonce)

将企业微信回复用户的消息加密打包.

1. 对要发送的消息进行AES-CBC加密
2. 生成安全签名
3. 将消息密文和安全签名打包成json格式

Parameters:

callbackSettings - the callback settings

replyMsg - 企业微信待回复用户的消息，json格式的字符串

timeStamp - 时间戳，可以自己生成，也可以用URL参数的timestamp

nonce - 随机串，可以自己生成，也可以用URL参数的nonce

Returns:

加密后的可以直接回复用户的密文 ，包括msg_signature, timestamp, nonce, encrypt的json格式的字符串

encryptXmlMsg

public String encryptXmlMsg(CallbackSettings callbackSettings,
                            String replyMsg,
                            String timeStamp,
                            String nonce)

Encrypt xml msg string.

Parameters:

callbackSettings - the callback settings

replyMsg - the reply msg

timeStamp - the time stamp

nonce - the nonce

Returns:

the string

accept

public <T> T accept(EVENT eventBody,
                    T response)

Accept t.

Type Parameters:

T - the type parameter

Parameters:

eventBody - the event body

response - the response

Returns:

the t

decrypt

public CallbackDecrypted decrypt(CallbackSettings callbackSettings,
                                 String msgSignature,
                                 String timeStamp,
                                 String nonce,
                                 String encrypt)

解密验签，用于解密XML BODY以及校验回调URL真实性

Parameters:

callbackSettings - the callback settings

msgSignature - the msg signature

timeStamp - the time stamp

nonce - the nonce

encrypt - the encrypt

Returns:

the callback decrypted

readXml

public <T extends XmlEntity> T readXml(String xmlBody,
                                       Class<T> clazz)

Read xml t.

Type Parameters:

T - the type parameter

Parameters:

xmlBody - the xml body

clazz - the clazz

Returns:

the t

getNetworkBytesOrder

byte[] getNetworkBytesOrder(int sourceNumber)

生成4个字节的网络字节序

Parameters:

sourceNumber - the source number

Returns:

the byte [ ]

recoverNetworkBytesOrder

int recoverNetworkBytesOrder(byte[] orderBytes)

还原4个字节的网络字节序

Parameters:

orderBytes - the order bytes

Returns:

the int

randomStr

String randomStr()

随机生成16位字符串

Returns:

the random str