#neon #serialization #deserialize #convert #value #object #handle-js-value

neon-serde

轻松将对象序列化以便与 neon 一起使用

8 个版本 (4 个破坏性更新)

使用旧的 Rust 2015

0.4.0 2020 年 5 月 11 日
0.3.0 2019 年 10 月 3 日
0.2.0 2019 年 8 月 29 日
0.1.1 2018 年 11 月 5 日
0.0.1 2017 年 9 月 18 日

#1681 in 编码

每月下载量:31

MIT 许可证

73KB
1K SLoC

Rust 1K SLoC // 0.0% comments JavaScript 189 SLoC Shell 27 SLoC // 0.1% comments

Neon-serde

Build Status

此软件包是一个工具,用于轻松地在以下值之间转换:

A Handle<JsValue>neon 软件包和任何实现 serde::{Serialize, Deserialize}

版本支持

neon-serde 在 node 8 10 12 上进行了测试

用法

neon_serde::from_value

Handle<js::JsValue> 转换为实现 serde::Deserialize 的类型

neon_serde::to_value

将实现 serde::Serialize 的值转换为 Handle<JsValue>

导出宏示例

export! 宏允许您快速定义自动转换其参数的函数


#[macro_use]
extern crate neon;
#[macro_use]
extern crate neon_serde;
#[macro_use]
extern crate serde_derive;
extern crate serde_bytes;

#[derive(Deserialize)]
struct User {
    name: String,
    age: u16,
}

export! {

    /// Say hello based on a persons name
    fn say_hello(name: String) -> String {
        format!("Hello, {}!", name)
    }

    /// Say how old someone is
    fn greet(user: User) -> String {
        format!("{} is {} years old", user.name, user.age)
    }

    /// Say how old someone is, if they exist
    fn maybe_say_hello(user: Option<User>) -> Option<String> {
        user.map(greet)
    }

    /// Sorts the bytes in a string
    /// use `serde_bytes::ByteBuf` to return a `Buffer` in node
    /// a `Vec<u8>` will be an array
    fn sort_utf8_bytes(str: String) -> serde_bytes::ByteBuf {
        let mut bytes = str.into_bytes();
        bytes.sort();
        serde_bytes::ByteBuf::from(bytes)
    }

    /// using `serde_bytes::ByteBuf` will make passing an array
    /// of numbers an error
    ///
    /// note: `-> ()` is NOT optional
    fn expect_buffer_only(_buff: serde_bytes::ByteBuf) -> () {
        // code
    }

    /// using `Vec<u8>` not accept a buffer
    fn expect_array(_buff: Vec<u8>) -> () {
        // code
    }

    /// calculate fibonacci recursively
    fn fibonacci(n: i32) -> i32 {
        match n {
            1 | 2 => 1,
            n => fibonacci(n - 1) + fibonacci(n - 2)
        }
    }
}

直接使用示例

extern crate neon_serde;
extern crate neon;
#[macro_use]
extern crate serde_derive;

use neon::prelude::*;

#[derive(Serialize, Debug, Deserialize)]
struct AnObject {
    a: u32,
    b: Vec<f64>,
    c: String,
}

fn deserialize_something(mut cx: FunctionContext) -> JsResult<JsValue> {
    let arg0 = cx.argument::<JsValue>(0)?;

    let arg0_value :AnObject = neon_serde::from_value(&mut cx, arg0)?;
    println!("{:?}", arg0_value);

    Ok(JsUndefined::new().upcast())
}

fn serialize_something(mut cx: FunctionContext) -> JsResult<JsValue> {
    let value = AnObject {
        a: 1,
        b: vec![2f64, 3f64, 4f64],
        c: "a string".into()
    };

    let js_value = neon_serde::to_value(&mut cx, &value)?;
    Ok(js_value)
}

限制

数据所有权

所有 Deserialize 值必须拥有其所有数据(它们必须具有 serde::DeserializeOwned 特性)

依赖关系

~3.5–5MB
~104K SLoC