server_fn 0.8.7

RPC for any web framework.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

use crate::{
    codec::{Patch, Post, Put},
    ContentType, Decodes, Encodes, Format, FormatType,
};
use bytes::Bytes;
use rkyv::{
    api::high::{HighDeserializer, HighSerializer, HighValidator},
    bytecheck::CheckBytes,
    rancor,
    ser::allocator::ArenaHandle,
    util::AlignedVec,
    Archive, Deserialize, Serialize,
};

type RkyvSerializer<'a> =
    HighSerializer<AlignedVec, ArenaHandle<'a>, rancor::Error>;
type RkyvDeserializer = HighDeserializer<rancor::Error>;
type RkyvValidator<'a> = HighValidator<'a, rancor::Error>;

/// Pass arguments and receive responses using `rkyv` in a `POST` request.
pub struct RkyvEncoding;

impl ContentType for RkyvEncoding {
    const CONTENT_TYPE: &'static str = "application/rkyv";
}

impl FormatType for RkyvEncoding {
    const FORMAT_TYPE: Format = Format::Binary;
}

impl<T> Encodes<T> for RkyvEncoding
where
    T: Archive + for<'a> Serialize<RkyvSerializer<'a>>,
    T::Archived: Deserialize<T, RkyvDeserializer>
        + for<'a> CheckBytes<RkyvValidator<'a>>,
{
    type Error = rancor::Error;

    fn encode(value: &T) -> Result<Bytes, Self::Error> {
        let encoded = rkyv::to_bytes::<rancor::Error>(value)?;
        Ok(Bytes::copy_from_slice(encoded.as_ref()))
    }
}

impl<T> Decodes<T> for RkyvEncoding
where
    T: Archive + for<'a> Serialize<RkyvSerializer<'a>>,
    T::Archived: Deserialize<T, RkyvDeserializer>
        + for<'a> CheckBytes<RkyvValidator<'a>>,
{
    type Error = rancor::Error;

    fn decode(bytes: Bytes) -> Result<T, Self::Error> {
        let mut aligned = AlignedVec::<1024>::new();
        aligned.extend_from_slice(bytes.as_ref());
        rkyv::from_bytes::<T, rancor::Error>(aligned.as_ref())
    }
}

/// Pass arguments and receive responses as `rkyv` in a `POST` request.
pub type Rkyv = Post<RkyvEncoding>;

/// Pass arguments and receive responses as `rkyv` in a `PATCH` request.
/// **Note**: Browser support for `PATCH` requests without JS/WASM may be poor.
/// Consider using a `POST` request if functionality without JS/WASM is required.
pub type PatchRkyv = Patch<RkyvEncoding>;

/// Pass arguments and receive responses as `rkyv` in a `PUT` request.
/// **Note**: Browser support for `PUT` requests without JS/WASM may be poor.
/// Consider using a `POST` request if functionality without JS/WASM is required.
pub type PutRkyv = Put<RkyvEncoding>;