Protocol Buffers - Google's data interchange format (grpc依赖)
https://developers.google.com/protocol-buffers/
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
744 lines
26 KiB
744 lines
26 KiB
// Protocol Buffers - Google's data interchange format |
|
// Copyright 2023 Google LLC. All rights reserved. |
|
// |
|
// Use of this source code is governed by a BSD-style |
|
// license that can be found in the LICENSE file or at |
|
// https://developers.google.com/open-source/licenses/bsd |
|
|
|
//! UPB FFI wrapper code for use by Rust Protobuf. |
|
|
|
use crate::__internal::{Enum, Private, PtrAndLen, RawArena, RawMap, RawMessage, RawRepeatedField}; |
|
use crate::{ |
|
Map, MapView, Mut, ProtoStr, Proxied, ProxiedInMapValue, ProxiedInRepeated, Repeated, |
|
RepeatedMut, RepeatedView, SettableValue, View, ViewProxy, |
|
}; |
|
use core::fmt::Debug; |
|
use paste::paste; |
|
use std::alloc; |
|
use std::alloc::Layout; |
|
use std::cell::UnsafeCell; |
|
use std::ffi::c_int; |
|
use std::fmt; |
|
use std::marker::PhantomData; |
|
use std::mem::{size_of, MaybeUninit}; |
|
use std::ops::Deref; |
|
use std::ptr::{self, NonNull}; |
|
use std::slice; |
|
use std::sync::{Once, OnceLock}; |
|
|
|
/// See `upb/port/def.inc`. |
|
const UPB_MALLOC_ALIGN: usize = 8; |
|
|
|
/// A wrapper over a `upb_Arena`. |
|
/// |
|
/// This is not a safe wrapper per se, because the allocation functions still |
|
/// have sharp edges (see their safety docs for more info). |
|
/// |
|
/// This is an owning type and will automatically free the arena when |
|
/// dropped. |
|
/// |
|
/// Note that this type is neither `Sync` nor `Send`. |
|
#[derive(Debug)] |
|
pub struct Arena { |
|
// Safety invariant: this must always be a valid arena |
|
raw: RawArena, |
|
_not_sync: PhantomData<UnsafeCell<()>>, |
|
} |
|
|
|
extern "C" { |
|
// `Option<NonNull<T: Sized>>` is ABI-compatible with `*mut T` |
|
fn upb_Arena_New() -> Option<RawArena>; |
|
fn upb_Arena_Free(arena: RawArena); |
|
fn upb_Arena_Malloc(arena: RawArena, size: usize) -> *mut u8; |
|
fn upb_Arena_Realloc(arena: RawArena, ptr: *mut u8, old: usize, new: usize) -> *mut u8; |
|
} |
|
|
|
impl Arena { |
|
/// Allocates a fresh arena. |
|
#[inline] |
|
pub fn new() -> Self { |
|
#[inline(never)] |
|
#[cold] |
|
fn arena_new_failed() -> ! { |
|
panic!("Could not create a new UPB arena"); |
|
} |
|
|
|
// SAFETY: |
|
// - `upb_Arena_New` is assumed to be implemented correctly and always sound to |
|
// call; if it returned a non-null pointer, it is a valid arena. |
|
unsafe { |
|
let Some(raw) = upb_Arena_New() else { arena_new_failed() }; |
|
Self { raw, _not_sync: PhantomData } |
|
} |
|
} |
|
|
|
/// Returns the raw, UPB-managed pointer to the arena. |
|
#[inline] |
|
pub fn raw(&self) -> RawArena { |
|
self.raw |
|
} |
|
|
|
/// Allocates some memory on the arena. |
|
/// |
|
/// # Safety |
|
/// |
|
/// - `layout`'s alignment must be less than `UPB_MALLOC_ALIGN`. |
|
#[inline] |
|
pub unsafe fn alloc(&self, layout: Layout) -> &mut [MaybeUninit<u8>] { |
|
debug_assert!(layout.align() <= UPB_MALLOC_ALIGN); |
|
// SAFETY: `self.raw` is a valid UPB arena |
|
let ptr = unsafe { upb_Arena_Malloc(self.raw, layout.size()) }; |
|
if ptr.is_null() { |
|
alloc::handle_alloc_error(layout); |
|
} |
|
|
|
// SAFETY: |
|
// - `upb_Arena_Malloc` promises that if the return pointer is non-null, it is |
|
// dereferencable for `size` bytes and has an alignment of `UPB_MALLOC_ALIGN` |
|
// until the arena is destroyed. |
|
// - `[MaybeUninit<u8>]` has no alignment requirement, and `ptr` is aligned to a |
|
// `UPB_MALLOC_ALIGN` boundary. |
|
unsafe { slice::from_raw_parts_mut(ptr.cast(), layout.size()) } |
|
} |
|
|
|
/// Resizes some memory on the arena. |
|
/// |
|
/// # Safety |
|
/// |
|
/// - `ptr` must be the data pointer returned by a previous call to `alloc` |
|
/// or `resize` on `self`. |
|
/// - After calling this function, `ptr` is no longer dereferencable - it is |
|
/// zapped. |
|
/// - `old` must be the layout `ptr` was allocated with via `alloc` or |
|
/// `realloc`. |
|
/// - `new`'s alignment must be less than `UPB_MALLOC_ALIGN`. |
|
#[inline] |
|
pub unsafe fn resize(&self, ptr: *mut u8, old: Layout, new: Layout) -> &mut [MaybeUninit<u8>] { |
|
debug_assert!(new.align() <= UPB_MALLOC_ALIGN); |
|
// SAFETY: |
|
// - `self.raw` is a valid UPB arena |
|
// - `ptr` was allocated by a previous call to `alloc` or `realloc` as promised |
|
// by the caller. |
|
let ptr = unsafe { upb_Arena_Realloc(self.raw, ptr, old.size(), new.size()) }; |
|
if ptr.is_null() { |
|
alloc::handle_alloc_error(new); |
|
} |
|
|
|
// SAFETY: |
|
// - `upb_Arena_Realloc` promises that if the return pointer is non-null, it is |
|
// dereferencable for the new `size` in bytes until the arena is destroyed. |
|
// - `[MaybeUninit<u8>]` has no alignment requirement, and `ptr` is aligned to a |
|
// `UPB_MALLOC_ALIGN` boundary. |
|
unsafe { slice::from_raw_parts_mut(ptr.cast(), new.size()) } |
|
} |
|
} |
|
|
|
impl Drop for Arena { |
|
#[inline] |
|
fn drop(&mut self) { |
|
unsafe { |
|
upb_Arena_Free(self.raw); |
|
} |
|
} |
|
} |
|
|
|
static mut INTERNAL_PTR: Option<RawMessage> = None; |
|
static INIT: Once = Once::new(); |
|
|
|
// TODO:(b/304577017) |
|
const ALIGN: usize = 32; |
|
const UPB_SCRATCH_SPACE_BYTES: usize = 64_000; |
|
|
|
/// Holds a zero-initialized block of memory for use by upb. |
|
/// By default, if a message is not set in cpp, a default message is created. |
|
/// upb departs from this and returns a null ptr. However, since contiguous |
|
/// chunks of memory filled with zeroes are legit messages from upb's point of |
|
/// view, we can allocate a large block and refer to that when dealing |
|
/// with readonly access. |
|
pub struct ScratchSpace; |
|
impl ScratchSpace { |
|
pub fn zeroed_block(_private: Private) -> RawMessage { |
|
unsafe { |
|
INIT.call_once(|| { |
|
let layout = |
|
std::alloc::Layout::from_size_align(UPB_SCRATCH_SPACE_BYTES, ALIGN).unwrap(); |
|
let Some(ptr) = |
|
crate::__internal::RawMessage::new(std::alloc::alloc_zeroed(layout).cast()) |
|
else { |
|
std::alloc::handle_alloc_error(layout) |
|
}; |
|
INTERNAL_PTR = Some(ptr) |
|
}); |
|
INTERNAL_PTR.unwrap() |
|
} |
|
} |
|
} |
|
|
|
/// Serialized Protobuf wire format data. |
|
/// |
|
/// It's typically produced by `<Message>::serialize()`. |
|
pub struct SerializedData { |
|
data: NonNull<u8>, |
|
len: usize, |
|
|
|
// The arena that owns `data`. |
|
_arena: Arena, |
|
} |
|
|
|
impl SerializedData { |
|
/// Construct `SerializedData` from raw pointers and its owning arena. |
|
/// |
|
/// # Safety |
|
/// - `arena` must be have allocated `data` |
|
/// - `data` must be readable for `len` bytes and not mutate while this |
|
/// struct exists |
|
pub unsafe fn from_raw_parts(arena: Arena, data: NonNull<u8>, len: usize) -> Self { |
|
SerializedData { _arena: arena, data, len } |
|
} |
|
|
|
/// Gets a raw slice pointer. |
|
pub fn as_ptr(&self) -> *const [u8] { |
|
ptr::slice_from_raw_parts(self.data.as_ptr(), self.len) |
|
} |
|
} |
|
|
|
impl Deref for SerializedData { |
|
type Target = [u8]; |
|
fn deref(&self) -> &Self::Target { |
|
// SAFETY: `data` is valid for `len` bytes as promised by |
|
// the caller of `SerializedData::from_raw_parts`. |
|
unsafe { slice::from_raw_parts(self.data.as_ptr(), self.len) } |
|
} |
|
} |
|
|
|
impl fmt::Debug for SerializedData { |
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { |
|
fmt::Debug::fmt(self.deref(), f) |
|
} |
|
} |
|
|
|
impl SettableValue<[u8]> for SerializedData { |
|
fn set_on<'msg>(self, _private: Private, mut mutator: Mut<'msg, [u8]>) |
|
where |
|
[u8]: 'msg, |
|
{ |
|
mutator.set(self.as_ref()) |
|
} |
|
} |
|
|
|
// TODO: Investigate replacing this with direct access to UPB bits. |
|
pub type BytesPresentMutData<'msg> = crate::vtable::RawVTableOptionalMutatorData<'msg, [u8]>; |
|
pub type BytesAbsentMutData<'msg> = crate::vtable::RawVTableOptionalMutatorData<'msg, [u8]>; |
|
pub type InnerBytesMut<'msg> = crate::vtable::RawVTableMutator<'msg, [u8]>; |
|
pub type InnerPrimitiveMut<'msg, T> = crate::vtable::RawVTableMutator<'msg, T>; |
|
|
|
/// The raw contents of every generated message. |
|
#[derive(Debug)] |
|
pub struct MessageInner { |
|
pub msg: RawMessage, |
|
pub arena: Arena, |
|
} |
|
|
|
/// Mutators that point to their original message use this to do so. |
|
/// |
|
/// Since UPB expects runtimes to manage their own arenas, this needs to have |
|
/// access to an `Arena`. |
|
/// |
|
/// This has two possible designs: |
|
/// - Store two pointers here, `RawMessage` and `&'msg Arena`. This doesn't |
|
/// place any restriction on the layout of generated messages and their |
|
/// mutators. This makes a vtable-based mutator three pointers, which can no |
|
/// longer be returned in registers on most platforms. |
|
/// - Store one pointer here, `&'msg MessageInner`, where `MessageInner` stores |
|
/// a `RawMessage` and an `Arena`. This would require all generated messages |
|
/// to store `MessageInner`, and since their mutators need to be able to |
|
/// generate `BytesMut`, would also require `BytesMut` to store a `&'msg |
|
/// MessageInner` since they can't store an owned `Arena`. |
|
/// |
|
/// Note: even though this type is `Copy`, it should only be copied by |
|
/// protobuf internals that can maintain mutation invariants: |
|
/// |
|
/// - No concurrent mutation for any two fields in a message: this means |
|
/// mutators cannot be `Send` but are `Sync`. |
|
/// - If there are multiple accessible `Mut` to a single message at a time, they |
|
/// must be different fields, and not be in the same oneof. As such, a `Mut` |
|
/// cannot be `Clone` but *can* reborrow itself with `.as_mut()`, which |
|
/// converts `&'b mut Mut<'a, T>` to `Mut<'b, T>`. |
|
#[derive(Clone, Copy, Debug)] |
|
pub struct MutatorMessageRef<'msg> { |
|
msg: RawMessage, |
|
arena: &'msg Arena, |
|
} |
|
|
|
impl<'msg> MutatorMessageRef<'msg> { |
|
#[doc(hidden)] |
|
#[allow(clippy::needless_pass_by_ref_mut)] // Sound construction requires mutable access. |
|
pub fn new(_private: Private, msg: &'msg mut MessageInner) -> Self { |
|
MutatorMessageRef { msg: msg.msg, arena: &msg.arena } |
|
} |
|
|
|
pub fn from_parent( |
|
_private: Private, |
|
parent_msg: &'msg mut MessageInner, |
|
message_field_ptr: RawMessage, |
|
) -> Self { |
|
MutatorMessageRef { msg: message_field_ptr, arena: &parent_msg.arena } |
|
} |
|
|
|
pub fn msg(&self) -> RawMessage { |
|
self.msg |
|
} |
|
|
|
pub fn raw_arena(&self, _private: Private) -> RawArena { |
|
self.arena.raw() |
|
} |
|
} |
|
|
|
pub fn copy_bytes_in_arena_if_needed_by_runtime<'msg>( |
|
msg_ref: MutatorMessageRef<'msg>, |
|
val: &'msg [u8], |
|
) -> &'msg [u8] { |
|
// SAFETY: the alignment of `[u8]` is less than `UPB_MALLOC_ALIGN`. |
|
let new_alloc = unsafe { msg_ref.arena.alloc(Layout::for_value(val)) }; |
|
debug_assert_eq!(new_alloc.len(), val.len()); |
|
|
|
let start: *mut u8 = new_alloc.as_mut_ptr().cast(); |
|
// SAFETY: |
|
// - `new_alloc` is writeable for `val.len()` bytes. |
|
// - After the copy, `new_alloc` is initialized for `val.len()` bytes. |
|
unsafe { |
|
val.as_ptr().copy_to_nonoverlapping(start, val.len()); |
|
&*(new_alloc as *mut _ as *mut [u8]) |
|
} |
|
} |
|
|
|
/// Opaque struct containing a upb_MiniTable. |
|
/// |
|
/// This wrapper is a workaround until stabilization of [`extern type`]. |
|
/// TODO: convert to extern type once stabilized. |
|
/// [`extern type`]: https://github.com/rust-lang/rust/issues/43467 |
|
#[repr(C)] |
|
pub struct OpaqueMiniTable { |
|
// TODO: consider importing a minitable struct declared in |
|
// google3/third_party/upb/bits. |
|
_data: [u8; 0], |
|
_marker: std::marker::PhantomData<(*mut u8, ::std::marker::PhantomPinned)>, |
|
} |
|
|
|
extern "C" { |
|
pub fn upb_Message_DeepCopy( |
|
dst: RawMessage, |
|
src: RawMessage, |
|
mini_table: *const OpaqueMiniTable, |
|
arena: RawArena, |
|
); |
|
} |
|
|
|
/// The raw type-erased pointer version of `RepeatedMut`. |
|
/// |
|
/// Contains a `upb_Array*` as well as `RawArena`, most likely that of the |
|
/// containing message. upb requires a `RawArena` to perform mutations on |
|
/// a repeated field. |
|
/// |
|
/// An owned `Repeated` stores a `InnerRepeatedMut<'static>` and manages the |
|
/// contained `RawArena`. |
|
#[derive(Clone, Copy, Debug)] |
|
pub struct InnerRepeatedMut<'msg> { |
|
pub(crate) raw: RawRepeatedField, |
|
// Storing a `RawArena` instead of `&Arena` allows this to be used for |
|
// both `RepeatedMut<T>` and `Repeated<T>`. |
|
arena: RawArena, |
|
_phantom: PhantomData<&'msg Arena>, |
|
} |
|
|
|
impl<'msg> InnerRepeatedMut<'msg> { |
|
#[doc(hidden)] |
|
#[allow(clippy::needless_pass_by_ref_mut)] // Sound construction requires mutable access. |
|
pub fn new(_private: Private, raw: RawRepeatedField, arena: &'msg Arena) -> Self { |
|
InnerRepeatedMut { raw, arena: arena.raw(), _phantom: PhantomData } |
|
} |
|
} |
|
|
|
// Transcribed from google3/third_party/upb/upb/message/value.h |
|
#[repr(C)] |
|
#[derive(Clone, Copy)] |
|
pub union upb_MessageValue { |
|
bool_val: bool, |
|
float_val: std::ffi::c_float, |
|
double_val: std::ffi::c_double, |
|
uint32_val: u32, |
|
int32_val: i32, |
|
uint64_val: u64, |
|
int64_val: i64, |
|
array_val: *const std::ffi::c_void, |
|
map_val: *const std::ffi::c_void, |
|
msg_val: *const std::ffi::c_void, |
|
str_val: PtrAndLen, |
|
} |
|
|
|
// Transcribed from google3/third_party/upb/upb/base/descriptor_constants.h |
|
#[repr(C)] |
|
#[allow(dead_code)] |
|
pub enum UpbCType { |
|
Bool = 1, |
|
Float = 2, |
|
Int32 = 3, |
|
UInt32 = 4, |
|
Enum = 5, |
|
Message = 6, |
|
Double = 7, |
|
Int64 = 8, |
|
UInt64 = 9, |
|
String = 10, |
|
Bytes = 11, |
|
} |
|
|
|
extern "C" { |
|
fn upb_Array_New(a: RawArena, r#type: std::ffi::c_int) -> RawRepeatedField; |
|
fn upb_Array_Size(arr: RawRepeatedField) -> usize; |
|
fn upb_Array_Set(arr: RawRepeatedField, i: usize, val: upb_MessageValue); |
|
fn upb_Array_Get(arr: RawRepeatedField, i: usize) -> upb_MessageValue; |
|
fn upb_Array_Append(arr: RawRepeatedField, val: upb_MessageValue, arena: RawArena); |
|
fn upb_Array_Resize(arr: RawRepeatedField, size: usize, arena: RawArena) -> bool; |
|
fn upb_Array_MutableDataPtr(arr: RawRepeatedField) -> *mut std::ffi::c_void; |
|
fn upb_Array_DataPtr(arr: RawRepeatedField) -> *const std::ffi::c_void; |
|
} |
|
|
|
macro_rules! impl_repeated_primitives { |
|
($(($t:ty, $ufield:ident, $upb_tag:expr)),* $(,)?) => { |
|
$( |
|
unsafe impl ProxiedInRepeated for $t { |
|
#[allow(dead_code)] |
|
fn repeated_new(_: Private) -> Repeated<$t> { |
|
let arena = Arena::new(); |
|
let raw_arena = arena.raw(); |
|
std::mem::forget(arena); |
|
unsafe { |
|
Repeated::from_inner(InnerRepeatedMut { |
|
raw: upb_Array_New(raw_arena, $upb_tag as c_int), |
|
arena: raw_arena, |
|
_phantom: PhantomData, |
|
}) |
|
} |
|
} |
|
#[allow(dead_code)] |
|
unsafe fn repeated_free(_: Private, f: &mut Repeated<$t>) { |
|
// Freeing the array itself is handled by `Arena::Drop` |
|
// SAFETY: |
|
// - `f.raw_arena()` is a live `upb_Arena*` as |
|
// - This function is only called once for `f` |
|
unsafe { |
|
upb_Arena_Free(f.inner().arena); |
|
} |
|
} |
|
fn repeated_len(f: View<Repeated<$t>>) -> usize { |
|
unsafe { upb_Array_Size(f.as_raw(Private)) } |
|
} |
|
fn repeated_push(mut f: Mut<Repeated<$t>>, v: View<$t>) { |
|
unsafe { |
|
upb_Array_Append( |
|
f.as_raw(Private), |
|
upb_MessageValue { $ufield: v }, |
|
f.raw_arena(Private)) |
|
} |
|
} |
|
fn repeated_clear(mut f: Mut<Repeated<$t>>) { |
|
unsafe { upb_Array_Resize(f.as_raw(Private), 0, f.raw_arena(Private)); } |
|
} |
|
unsafe fn repeated_get_unchecked(f: View<Repeated<$t>>, i: usize) -> View<$t> { |
|
unsafe { upb_Array_Get(f.as_raw(Private), i).$ufield } |
|
} |
|
unsafe fn repeated_set_unchecked(mut f: Mut<Repeated<$t>>, i: usize, v: View<$t>) { |
|
unsafe { upb_Array_Set(f.as_raw(Private), i, upb_MessageValue { $ufield: v.into() }) } |
|
} |
|
fn repeated_copy_from(src: View<Repeated<$t>>, mut dest: Mut<Repeated<$t>>) { |
|
// SAFETY: |
|
// - `upb_Array_Resize` is unsafe but assumed to be always sound to call. |
|
// - `copy_nonoverlapping` is unsafe but here we guarantee that both pointers |
|
// are valid, the pointers are `#[repr(u8)]`, and the size is correct. |
|
unsafe { |
|
if (!upb_Array_Resize(dest.as_raw(Private), src.len(), dest.inner.arena)) { |
|
panic!("upb_Array_Resize failed."); |
|
} |
|
ptr::copy_nonoverlapping( |
|
upb_Array_DataPtr(src.as_raw(Private)).cast::<u8>(), |
|
upb_Array_MutableDataPtr(dest.as_raw(Private)).cast::<u8>(), |
|
size_of::<$t>() * src.len()); |
|
} |
|
} |
|
} |
|
)* |
|
} |
|
} |
|
|
|
impl<'msg, T: ?Sized> RepeatedMut<'msg, T> { |
|
// Returns a `RawArena` which is live for at least `'msg` |
|
#[doc(hidden)] |
|
pub fn raw_arena(&self, _private: Private) -> RawArena { |
|
self.inner.arena |
|
} |
|
} |
|
|
|
impl_repeated_primitives!( |
|
(bool, bool_val, UpbCType::Bool), |
|
(f32, float_val, UpbCType::Float), |
|
(f64, double_val, UpbCType::Double), |
|
(i32, int32_val, UpbCType::Int32), |
|
(u32, uint32_val, UpbCType::UInt32), |
|
(i64, int64_val, UpbCType::Int64), |
|
(u64, uint64_val, UpbCType::UInt64), |
|
); |
|
|
|
/// Cast a `RepeatedView<SomeEnum>` to `RepeatedView<i32>`. |
|
pub fn cast_enum_repeated_view<E: Enum + ProxiedInRepeated>( |
|
private: Private, |
|
repeated: RepeatedView<E>, |
|
) -> RepeatedView<i32> { |
|
// SAFETY: Reading an enum array as an i32 array is sound. |
|
unsafe { RepeatedView::from_raw(private, repeated.as_raw(Private)) } |
|
} |
|
|
|
/// Cast a `RepeatedMut<SomeEnum>` to `RepeatedMut<i32>`. |
|
/// |
|
/// Writing an unknown value is sound because all enums |
|
/// are representationally open. |
|
pub fn cast_enum_repeated_mut<E: Enum + ProxiedInRepeated>( |
|
private: Private, |
|
repeated: RepeatedMut<E>, |
|
) -> RepeatedMut<i32> { |
|
// SAFETY: |
|
// - Reading an enum array as an i32 array is sound. |
|
// - No shared mutation is possible through the output. |
|
unsafe { |
|
let InnerRepeatedMut { arena, raw, .. } = repeated.into_inner(); |
|
RepeatedMut::from_inner(private, InnerRepeatedMut { arena, raw, _phantom: PhantomData }) |
|
} |
|
} |
|
|
|
/// Returns a static empty RepeatedView. |
|
pub fn empty_array<T: ?Sized + ProxiedInRepeated>() -> RepeatedView<'static, T> { |
|
// TODO: Consider creating a static empty array in C. |
|
|
|
// Use `i32` for a shared empty repeated for all repeated types in the program. |
|
static EMPTY_REPEATED_VIEW: OnceLock<RepeatedView<'static, i32>> = OnceLock::new(); |
|
|
|
// SAFETY: |
|
// - Because the repeated is never mutated, the repeated type is unused and |
|
// therefore valid for `T`. |
|
// - The view is leaked for `'static`. |
|
unsafe { |
|
RepeatedView::from_raw( |
|
Private, |
|
EMPTY_REPEATED_VIEW |
|
.get_or_init(|| Box::leak(Box::new(Repeated::new())).as_mut().into_view()) |
|
.as_raw(Private), |
|
) |
|
} |
|
} |
|
|
|
/// Returns a static empty MapView. |
|
pub fn empty_map<K, V>() -> MapView<'static, K, V> |
|
where |
|
K: Proxied + ?Sized, |
|
V: ProxiedInMapValue<K> + ?Sized, |
|
{ |
|
// TODO: Consider creating a static empty map in C. |
|
|
|
// Use `i32` for a shared empty map for all map types. |
|
static EMPTY_MAP_VIEW: OnceLock<MapView<'static, i32, i32>> = OnceLock::new(); |
|
|
|
// SAFETY: |
|
// - Because the map is never mutated, the map type is unused and therefore |
|
// valid for `T`. |
|
// - The view is leaked for `'static`. |
|
unsafe { |
|
MapView::from_raw( |
|
Private, |
|
EMPTY_MAP_VIEW |
|
.get_or_init(|| Box::leak(Box::new(Map::new())).as_mut().into_view()) |
|
.as_raw(Private), |
|
) |
|
} |
|
} |
|
|
|
#[derive(Clone, Copy, Debug)] |
|
pub struct InnerMapMut<'msg> { |
|
pub(crate) raw: RawMap, |
|
raw_arena: RawArena, |
|
_phantom: PhantomData<&'msg Arena>, |
|
} |
|
|
|
impl<'msg> InnerMapMut<'msg> { |
|
pub fn new(_private: Private, raw: RawMap, raw_arena: RawArena) -> Self { |
|
InnerMapMut { raw, raw_arena, _phantom: PhantomData } |
|
} |
|
} |
|
|
|
macro_rules! impl_ProxiedInMapValue_for_non_generated_value_types { |
|
($key_t:ty, $key_msg_val:expr, $key_upb_tag:expr, for $($t:ty, $msg_val:expr, $from_msg_val:expr, $upb_tag:expr, $zero_val:literal;)*) => { |
|
$( |
|
impl ProxiedInMapValue<$key_t> for $t { |
|
fn map_new(_private: Private) -> Map<$key_t, Self> { |
|
let arena = Arena::new(); |
|
let raw_arena = arena.raw(); |
|
std::mem::forget(arena); |
|
|
|
unsafe { |
|
Map::from_inner( |
|
Private, |
|
InnerMapMut { |
|
raw: upb_Map_New(raw_arena, $key_upb_tag, $upb_tag), |
|
raw_arena, |
|
_phantom: PhantomData |
|
} |
|
) |
|
} |
|
} |
|
|
|
unsafe fn map_free(_private: Private, map: &mut Map<$key_t, Self>) { |
|
// SAFETY: |
|
// - `map.inner.raw_arena` is a live `upb_Arena*` |
|
// - This function is only called once for `map` in `Drop`. |
|
unsafe { |
|
upb_Arena_Free(map.inner.raw_arena); |
|
} |
|
} |
|
|
|
fn map_clear(map: Mut<'_, Map<$key_t, Self>>) { |
|
unsafe { |
|
upb_Map_Clear(map.inner.raw); |
|
} |
|
} |
|
|
|
fn map_len(map: View<'_, Map<$key_t, Self>>) -> usize { |
|
unsafe { |
|
upb_Map_Size(map.raw) |
|
} |
|
} |
|
|
|
fn map_insert(map: Mut<'_, Map<$key_t, Self>>, key: View<'_, $key_t>, value: View<'_, Self>) -> bool { |
|
unsafe { |
|
upb_Map_Set( |
|
map.inner.raw, |
|
$key_msg_val(key), |
|
$msg_val(value), |
|
map.inner.raw_arena |
|
) |
|
} |
|
} |
|
|
|
fn map_get<'a>(map: View<'a, Map<$key_t, Self>>, key: View<'_, $key_t>) -> Option<View<'a, Self>> { |
|
let mut val = $msg_val($zero_val); |
|
let found = unsafe { |
|
upb_Map_Get(map.raw, ($key_msg_val)(key), &mut val) |
|
}; |
|
if !found { |
|
return None; |
|
} |
|
Some($from_msg_val(val)) |
|
} |
|
|
|
fn map_remove(map: Mut<'_, Map<$key_t, Self>>, key: View<'_, $key_t>) -> bool { |
|
let mut val = $msg_val($zero_val); |
|
unsafe { |
|
upb_Map_Delete(map.inner.raw, $key_msg_val(key), &mut val) |
|
} |
|
} |
|
} |
|
)* |
|
} |
|
} |
|
|
|
macro_rules! scalar_to_msg { |
|
($ufield:ident) => { |
|
|val| upb_MessageValue { $ufield: val } |
|
}; |
|
} |
|
|
|
macro_rules! scalar_from_msg { |
|
($ufield:ident) => { |
|
|msg: upb_MessageValue| unsafe { msg.$ufield } |
|
}; |
|
} |
|
|
|
fn str_to_msg<'msg>(val: impl Into<&'msg ProtoStr>) -> upb_MessageValue { |
|
upb_MessageValue { str_val: val.into().as_bytes().into() } |
|
} |
|
|
|
fn msg_to_str<'msg>(msg: upb_MessageValue) -> &'msg ProtoStr { |
|
unsafe { ProtoStr::from_utf8_unchecked(msg.str_val.as_ref()) } |
|
} |
|
|
|
macro_rules! impl_ProxiedInMapValue_for_key_types { |
|
($($t:ty, $t_sized:ty, $key_msg_val:expr, $upb_tag:expr;)*) => { |
|
paste! { |
|
$( |
|
impl_ProxiedInMapValue_for_non_generated_value_types!($t, $key_msg_val, $upb_tag, for |
|
f32, scalar_to_msg!(float_val), scalar_from_msg!(float_val), UpbCType::Float, 0f32; |
|
f64, scalar_to_msg!(double_val), scalar_from_msg!(double_val), UpbCType::Double, 0f64; |
|
i32, scalar_to_msg!(int32_val), scalar_from_msg!(int32_val), UpbCType::Int32, 0i32; |
|
u32, scalar_to_msg!(uint32_val), scalar_from_msg!(uint32_val), UpbCType::UInt32, 0u32; |
|
i64, scalar_to_msg!(int64_val), scalar_from_msg!(int64_val), UpbCType::Int64, 0i64; |
|
u64, scalar_to_msg!(uint64_val), scalar_from_msg!(uint64_val), UpbCType::UInt64, 0u64; |
|
bool, scalar_to_msg!(bool_val), scalar_from_msg!(bool_val), UpbCType::Bool, false; |
|
ProtoStr, str_to_msg, msg_to_str, UpbCType::String, ""; |
|
); |
|
)* |
|
} |
|
} |
|
} |
|
|
|
impl_ProxiedInMapValue_for_key_types!( |
|
i32, i32, scalar_to_msg!(int32_val), UpbCType::Int32; |
|
u32, u32, scalar_to_msg!(uint32_val), UpbCType::UInt32; |
|
i64, i64, scalar_to_msg!(int64_val), UpbCType::Int64; |
|
u64, u64, scalar_to_msg!(uint64_val), UpbCType::UInt64; |
|
bool, bool, scalar_to_msg!(bool_val), UpbCType::Bool; |
|
ProtoStr, &ProtoStr, |val: &ProtoStr| upb_MessageValue { str_val: val.as_bytes().into() }, UpbCType::String; |
|
); |
|
|
|
extern "C" { |
|
fn upb_Map_New(arena: RawArena, key_type: UpbCType, value_type: UpbCType) -> RawMap; |
|
fn upb_Map_Size(map: RawMap) -> usize; |
|
fn upb_Map_Set( |
|
map: RawMap, |
|
key: upb_MessageValue, |
|
value: upb_MessageValue, |
|
arena: RawArena, |
|
) -> bool; |
|
fn upb_Map_Get(map: RawMap, key: upb_MessageValue, value: *mut upb_MessageValue) -> bool; |
|
fn upb_Map_Delete( |
|
map: RawMap, |
|
key: upb_MessageValue, |
|
removed_value: *mut upb_MessageValue, |
|
) -> bool; |
|
fn upb_Map_Clear(map: RawMap); |
|
} |
|
|
|
#[cfg(test)] |
|
mod tests { |
|
use super::*; |
|
use googletest::prelude::*; |
|
|
|
#[test] |
|
fn test_arena_new_and_free() { |
|
let arena = Arena::new(); |
|
drop(arena); |
|
} |
|
|
|
#[test] |
|
fn test_serialized_data_roundtrip() { |
|
let arena = Arena::new(); |
|
let original_data = b"Hello world"; |
|
let len = original_data.len(); |
|
|
|
let serialized_data = unsafe { |
|
SerializedData::from_raw_parts( |
|
arena, |
|
NonNull::new(original_data as *const _ as *mut _).unwrap(), |
|
len, |
|
) |
|
}; |
|
assert_that!(&*serialized_data, eq(b"Hello world")); |
|
} |
|
}
|
|
|