org.jetlinks.core.message.codec.context

接口 CodecContext

public interface CodecContext

编解码上下文,用于在设备侧无法使用Message.getMessageId()来进行请求响应关联时 通过在协议包中使用此接口来进行处理.

例如:

  //类成员变量
  CodecContext context = CodecContext.newContext();

  public Publisher<DeviceMessage> decode(MessageDecodeContext ctx){
      //1.解码

      //2.设备返回的消息ID
      String deviceMsgId =.....;

      //3.去除缓存的消息并创建回复
      ReadPropertyMessageReply reply = context.<ReadPropertyMessage>removeDownstream(deviceMsgId)
                 .map(ReadPropertyMessage::newReply)
                  .orElseThrow(()->new NullPointerException("找不到下行指令"))
                  .success(Collections.singletonMap("test","1"));

      return Mono.just(reply);
  }

  public Publisher<EncodedMessage> encode(MessageEncodeContext ctx){
       //1.编码

       //2.设备支持消息ID
       String deviceMsgId =....;

       Message msg = ctx.getMessage();
       if(msg instanceof ReadPropertyMessage){
          ReadPropertyMessage readMsg = (ReadPropertyMessage)msg;
          context.cacheDownstream(deviceMsgId, readMsg, Duration.ofMinutes(1));

          //编码要发给设备的指令
          return encodeReadProperty(readMsg);
       }
     }

 

从以下版本开始:

1.1.1

作者:

zhouhao

方法概要

限定符和类型	方法和说明
default void	cacheDownstream(Object key, RepayableDeviceMessage<? extends DeviceMessageReply> message) 缓存下行消息,默认30秒超时
void	cacheDownstream(Object key, RepayableDeviceMessage<? extends DeviceMessageReply> message, java.time.Duration ttl) 缓存下行消息
<T extends RepayableDeviceMessage<? extends DeviceMessageReply>> Optional<T>	getDownstream(Object key, boolean remove) 根据key获取下行消息,可通过下行消息来构造消息回复
static CodecContext	newContext()
default <T extends RepayableDeviceMessage<? extends DeviceMessageReply>> Optional<T>	removeDownstream(Object key) 根据key获取并删除下行消息,可通过下行消息来构造消息回复

方法详细资料

newContext

static CodecContext newContext()

cacheDownstream

void cacheDownstream(Object key,
                     RepayableDeviceMessage<? extends DeviceMessageReply> message,
                     java.time.Duration ttl)

缓存下行消息

参数:

key - key

message - 下行消息

ttl - 有效期

cacheDownstream

default void cacheDownstream(Object key,
                             RepayableDeviceMessage<? extends DeviceMessageReply> message)

缓存下行消息,默认30秒超时

参数:

key - key

message - 下行消息

getDownstream

<T extends RepayableDeviceMessage<? extends DeviceMessageReply>> Optional<T> getDownstream(Object key,
                                                                                           boolean remove)

根据key获取下行消息,可通过下行消息来构造消息回复

类型参数:

T - 下行消息类型

参数:

key - key

remove - 自动删除

返回:

下行消息

另请参阅:

RepayableDeviceMessage.newReply()

removeDownstream

default <T extends RepayableDeviceMessage<? extends DeviceMessageReply>> Optional<T> removeDownstream(Object key)

根据key获取并删除下行消息,可通过下行消息来构造消息回复

类型参数:

T - 下行消息类型

参数:

key - key

返回:

下行消息

另请参阅:

RepayableDeviceMessage.newReply()