msg_chain

QQ机器人消息接收，解析trait和自动实现宏

提供解析QQBot MessageChain的工具

• 使用举例

{
    "type": "Image",
    "imageId": "{01E9451B-70ED-EAE3-B37C-101F1EEBF5B5}.mirai",  //群图片格式
    //"imageId": "/f8f1ab55-bf8e-4236-b55e-955848d7069f"      //好友图片格式
    "url": "https://xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "path": null,
    "base64": null
}

对应的结构体为

#[derive(MessageChain, LoadFormMap)]
struct Image{
    imageId:Option<String>,
    url:Option<String>,
    path:Option<String>,
    base64:Option<String>,
}

然后，将Image和其他实现了MessageChain和LoadFormMap一起通过msg_loader_generate! 注册,构造函数message_chain_loader

///构造函数 message_chain_loader 用于生成MessageChain
msg_loader_generate!(Image,Plain,At,AtAll);

在获取数据后，通过message_chain_loader获取当前MessageChain对象无匹配对象返回 None, 可以通过 into_target转换为特定对象转换不可行会返回 None

let map : HashMap<String, ChainMeta> = map_generate!(
            Image=>
            [
                imageId: "{01E9451B-70ED-EAE3-B37C-101F1EEBF5B5}.mirai"
                url: None,
            ]
        );
let res : Box<dyn MessageChain> = message_chain_loader(&map).unwrap();
//可以转换为指定类型
let res : Image = res.into_target::<Image>().unwrap();

然后就可以快乐使用了

• 为了方便快捷得构造 HashMap 提供了相关宏map_generate!帮助构造,以下为使用方法

    //以下将会构造出
    //{
    //  "type" : ChainMeta::Str("AtAll")
    //  "id" : Chain::Num(Number::N(1141451919_u64))
    //}
    let map1 : HashMap<String, ChainMeta> = map_generate![
        "type":"AtAll",
        "id":1141451919_u64
        ];

    //以下将会构造出
    //{
    //  "type" : ChainMeta::Str("Image"),
    //  "imageId" : ChainMeta::Str("{01E9451B-70ED-EAE3-B37C-101F1EEBF5B5}.mirai"),
    //  "url" : ChainMeta::Null
    //}
    let map2: HashMap<String, ChainMeta> = map_generate!(
            Image=>
            [
                imageId: "{01E9451B-70ED-EAE3-B37C-101F1EEBF5B5}.mirai",
                url: Option::<String>::None
            ]
        );
    
    let t = Image{
            imageId:Some("{01E9451B-70ED-EAE3-B37C-101F1EEBF5B5}.mirai".to_string()),
            url:None,
            path:None,
            base64:None
        };
    //以下将会构造出
    //{
    //  "type" : ChainMeta::Str("Image"),
    //  "imageId" : ChainMeta::Str("{01E9451B-70ED-EAE3-B37C-101F1EEBF5B5}.mirai"),
    //  "url" : ChainMeta::Null
    //  "path" : ChainMeta::Null
    //  "base64" : ChainMeta::Null
    //}
    let map3: HashMap<String, ChainMeta> = map_generate!( &t );

• MessageChain自动实现
  • 类型为 namedStruct 或者 Unit
  • 内部变量全部都实现了IntoChainMeta 和 FromChainMeta
  • 为了方便处理，所有实现了MessageChain都会实现Serialize

enums

• ChainMeta

#[derive(Debug, PartialEq, Clone)]
pub enum ChainMeta {
    Null,
    Str(String),
    Bool(bool),
    Num(Number),
    SubChains(Vec<ChainMeta>),
    Map(HashMap<&'static str, ChainMeta>),
    MapOwn(HashMap<String, ChainMeta>),
}

• Number

#[derive(Debug, PartialEq, Clone)]
pub enum Number {
    N(u64),
    T(i64),
    Float(f64),
}

tarits

• IntoChainMeta 将自身转换为ChainMeta对象

pub trait IntoChainMeta {
    fn into_chain(&self) -> ChainMeta;
}

• FromChainMeta 将ChainMeta转换为自身对象

pub trait FromChainMeta: Sized {
    fn from_chain(chain: Option<&ChainMeta>) -> Option<Self>;
}

• MessageChain

pub trait MessageChain {
    fn get_type(&self) -> &'static str;
    fn get(&self, key: &str) -> Option<ChainMeta>;
    fn all_keys(&self) -> Vec<&'static str>;
    fn get_all(&self) -> Vec<(&'static str, ChainMeta)> {
        self.all_keys()
            .iter()
            .map(|f| (*f, self.get(f).unwrap()))
            .collect()
    }
}

• LoadFormMap

pub trait LoadFormMap: Sized + MessageChain {
    fn load_from_map(map: &HashMap<String, ChainMeta>) -> Option<Self>;
    fn can_match(map: &HashMap<String, ChainMeta>) -> bool;
    fn type_eq(ty: &str) -> bool;
}