mirror of https://github.com/grpc/grpc.git
The C based gRPC (C++, Python, Ruby, Objective-C, PHP, C#)
https://grpc.io/
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.
63 lines
2.3 KiB
63 lines
2.3 KiB
7 years ago
|
/*
|
||
|
|
*
|
||
|
|
* Copyright 2015 gRPC authors.
|
||
|
|
*
|
||
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||
|
|
* you may not use this file except in compliance with the License.
|
||
|
|
* You may obtain a copy of the License at
|
||
|
|
*
|
||
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||
|
|
*
|
||
|
|
* Unless required by applicable law or agreed to in writing, software
|
||
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
|
|
* See the License for the specific language governing permissions and
|
||
|
|
* limitations under the License.
|
||
|
|
*
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef GRPCPP_IMPL_CODEGEN_SERIALIZATION_TRAITS_H
|
||
|
|
#define GRPCPP_IMPL_CODEGEN_SERIALIZATION_TRAITS_H
|
||
|
|
|
||
|
|
namespace grpc {
|
||
|
|
|
||
|
|
/// Defines how to serialize and deserialize some type.
|
||
|
|
///
|
||
|
|
/// Used for hooking different message serialization API's into GRPC.
|
||
|
|
/// Each SerializationTraits<Message> implementation must provide the
|
||
|
|
/// following functions:
|
||
|
|
/// 1. static Status Serialize(const Message& msg,
|
||
|
|
/// ByteBuffer* buffer,
|
||
|
|
/// bool* own_buffer);
|
||
|
|
/// OR
|
||
|
|
/// static Status Serialize(const Message& msg,
|
||
|
|
/// grpc_byte_buffer** buffer,
|
||
|
|
/// bool* own_buffer);
|
||
|
|
/// The former is preferred; the latter is deprecated
|
||
|
|
///
|
||
|
|
/// 2. static Status Deserialize(ByteBuffer* buffer,
|
||
|
|
/// Message* msg);
|
||
|
|
/// OR
|
||
|
|
/// static Status Deserialize(grpc_byte_buffer* buffer,
|
||
|
|
/// Message* msg);
|
||
|
|
/// The former is preferred; the latter is deprecated
|
||
|
|
///
|
||
|
|
/// Serialize is required to convert message to a ByteBuffer, and
|
||
|
|
/// return that byte buffer through *buffer. *own_buffer should
|
||
|
|
/// be set to true if the caller owns said byte buffer, or false if
|
||
|
|
/// ownership is retained elsewhere.
|
||
|
|
///
|
||
|
|
/// Deserialize is required to convert buffer into the message stored at
|
||
|
|
/// msg. max_receive_message_size is passed in as a bound on the maximum
|
||
|
|
/// number of message bytes Deserialize should accept.
|
||
|
|
///
|
||
|
|
/// Both functions return a Status, allowing them to explain what went
|
||
|
|
/// wrong if required.
|
||
|
|
template <class Message,
|
||
|
|
class UnusedButHereForPartialTemplateSpecialization = void>
|
||
|
|
class SerializationTraits;
|
||
|
|
|
||
|
|
} // namespace grpc
|
||
|
|
|
||
|
|
#endif // GRPCPP_IMPL_CODEGEN_SERIALIZATION_TRAITS_H
|