mirror of https://github.com/grpc/grpc.git
ncteisen
7 years ago
parent
1c73e2c53d
commit
cf5b2666e1
24 changed files with 574 additions and 327 deletions
@ -0,0 +1,151 @@ |
||||
/*
|
||||
* |
||||
* 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_PROTO_BUFFER_READER_H |
||||
#define GRPCPP_IMPL_CODEGEN_PROTO_BUFFER_READER_H |
||||
|
||||
#include <type_traits> |
||||
|
||||
#include <grpc/impl/codegen/byte_buffer_reader.h> |
||||
#include <grpc/impl/codegen/grpc_types.h> |
||||
#include <grpc/impl/codegen/slice.h> |
||||
#include <grpcpp/impl/codegen/byte_buffer.h> |
||||
#include <grpcpp/impl/codegen/config_protobuf.h> |
||||
#include <grpcpp/impl/codegen/core_codegen_interface.h> |
||||
#include <grpcpp/impl/codegen/serialization_traits.h> |
||||
#include <grpcpp/impl/codegen/status.h> |
||||
|
||||
/// This header provides an object that reads bytes directly from a
|
||||
/// grpc::ByteBuffer, via the ZeroCopyInputStream interface
|
||||
|
||||
namespace grpc { |
||||
|
||||
extern CoreCodegenInterface* g_core_codegen_interface; |
||||
|
||||
/// This is a specialization of the protobuf class ZeroCopyInputStream
|
||||
/// The principle is to get one chunk of data at a time from the proto layer,
|
||||
/// with options to backup (re-see some bytes) or skip (forward past some bytes)
|
||||
///
|
||||
/// Read more about ZeroCopyInputStream interface here:
|
||||
/// https://developers.google.com/protocol-buffers/docs/reference/cpp/google.protobuf.io.zero_copy_stream#ZeroCopyInputStream
|
||||
class GrpcProtoBufferReader : public ::grpc::protobuf::io::ZeroCopyInputStream { |
||||
public: |
||||
/// Constructs buffer reader from \a buffer. Will set \a status() to non ok
|
||||
/// if \a buffer is invalid (the internal buffer has not been initialized).
|
||||
explicit GrpcProtoBufferReader(ByteBuffer* buffer) |
||||
: byte_count_(0), backup_count_(0), status_() { |
||||
/// Implemented through a grpc_byte_buffer_reader which iterates
|
||||
/// over the slices that make up a byte buffer
|
||||
if (!buffer->Valid() || |
||||
!g_core_codegen_interface->grpc_byte_buffer_reader_init( |
||||
&reader_, buffer->c_buffer())) { |
||||
status_ = Status(StatusCode::INTERNAL, |
||||
"Couldn't initialize byte buffer reader"); |
||||
} |
||||
} |
||||
|
||||
~GrpcProtoBufferReader() { |
||||
if (status_.ok()) { |
||||
g_core_codegen_interface->grpc_byte_buffer_reader_destroy(&reader_); |
||||
} |
||||
} |
||||
|
||||
/// Give the proto library a chunk of data from the stream. The caller
|
||||
/// may safely read from data[0, size - 1].
|
||||
bool Next(const void** data, int* size) override { |
||||
if (!status_.ok()) { |
||||
return false; |
||||
} |
||||
/// If we have backed up previously, we need to return the backed-up slice
|
||||
if (backup_count_ > 0) { |
||||
*data = GRPC_SLICE_START_PTR(slice_) + GRPC_SLICE_LENGTH(slice_) - |
||||
backup_count_; |
||||
GPR_CODEGEN_ASSERT(backup_count_ <= INT_MAX); |
||||
*size = (int)backup_count_; |
||||
backup_count_ = 0; |
||||
return true; |
||||
} |
||||
/// Otherwise get the next slice from the byte buffer reader
|
||||
if (!g_core_codegen_interface->grpc_byte_buffer_reader_next(&reader_, |
||||
&slice_)) { |
||||
return false; |
||||
} |
||||
g_core_codegen_interface->grpc_slice_unref(slice_); |
||||
*data = GRPC_SLICE_START_PTR(slice_); |
||||
// On win x64, int is only 32bit
|
||||
GPR_CODEGEN_ASSERT(GRPC_SLICE_LENGTH(slice_) <= INT_MAX); |
||||
byte_count_ += * size = (int)GRPC_SLICE_LENGTH(slice_); |
||||
return true; |
||||
} |
||||
|
||||
/// Returns the status of the buffer reader.
|
||||
Status status() const { return status_; } |
||||
|
||||
/// The proto library calls this to indicate that we should back up \a count
|
||||
/// bytes that have already been returned by the last call of Next.
|
||||
/// So do the backup and have that ready for a later Next.
|
||||
void BackUp(int count) override { |
||||
GPR_CODEGEN_ASSERT(count <= static_cast<int>(GRPC_SLICE_LENGTH(slice_))); |
||||
backup_count_ = count; |
||||
} |
||||
|
||||
/// The proto library calls this to skip over \a count bytes. Implement this
|
||||
/// using Next and BackUp combined.
|
||||
bool Skip(int count) override { |
||||
const void* data; |
||||
int size; |
||||
while (Next(&data, &size)) { |
||||
if (size >= count) { |
||||
BackUp(size - count); |
||||
return true; |
||||
} |
||||
// size < count;
|
||||
count -= size; |
||||
} |
||||
// error or we have too large count;
|
||||
return false; |
||||
} |
||||
|
||||
/// Returns the total number of bytes read since this object was created.
|
||||
grpc::protobuf::int64 ByteCount() const override { |
||||
return byte_count_ - backup_count_; |
||||
} |
||||
|
||||
// These protected members are needed to support internal optimizations.
|
||||
// they expose internal bits of grpc core that are NOT stable. If you have
|
||||
// a use case needs to use one of these functions, please send an email to
|
||||
// https://groups.google.com/forum/#!forum/grpc-io.
|
||||
protected: |
||||
void set_byte_count(int64_t byte_count) { byte_count_ = byte_count; } |
||||
int64_t backup_count() { return backup_count_; } |
||||
void set_backup_count(int64_t backup_count) { backup_count_ = backup_count; } |
||||
grpc_byte_buffer_reader* reader() { return &reader_; } |
||||
grpc_slice* slice() { return &slice_; } |
||||
|
||||
private: |
||||
int64_t byte_count_; ///< total bytes read since object creation
|
||||
int64_t backup_count_; ///< how far backed up in the stream we are
|
||||
grpc_byte_buffer_reader reader_; ///< internal object to read \a grpc_slice
|
||||
///< from the \a grpc_byte_buffer
|
||||
grpc_slice slice_; ///< current slice passed back to the caller
|
||||
Status status_; ///< status of the entire object
|
||||
}; |
||||
|
||||
} // namespace grpc
|
||||
|
||||
#endif // GRPCPP_IMPL_CODEGEN_PROTO_BUFFER_READER_H
|
||||
@ -0,0 +1,168 @@ |
||||
/*
|
||||
* |
||||
* Copyright 2018 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_PROTO_BUFFER_WRITER_H |
||||
#define GRPCPP_IMPL_CODEGEN_PROTO_BUFFER_WRITER_H |
||||
|
||||
#include <type_traits> |
||||
|
||||
#include <grpc/impl/codegen/grpc_types.h> |
||||
#include <grpc/impl/codegen/slice.h> |
||||
#include <grpcpp/impl/codegen/byte_buffer.h> |
||||
#include <grpcpp/impl/codegen/config_protobuf.h> |
||||
#include <grpcpp/impl/codegen/core_codegen_interface.h> |
||||
#include <grpcpp/impl/codegen/serialization_traits.h> |
||||
#include <grpcpp/impl/codegen/status.h> |
||||
|
||||
/// This header provides an object that writes bytes directly into a
|
||||
/// grpc::ByteBuffer, via the ZeroCopyOutputStream interface
|
||||
|
||||
namespace grpc { |
||||
|
||||
extern CoreCodegenInterface* g_core_codegen_interface; |
||||
|
||||
// Forward declaration for testing use only
|
||||
namespace internal { |
||||
class GrpcProtoBufferWriterPeer; |
||||
} // namespace internal
|
||||
|
||||
const int kGrpcProtoBufferWriterMaxBufferLength = 1024 * 1024; |
||||
|
||||
/// This is a specialization of the protobuf class ZeroCopyOutputStream.
|
||||
/// The principle is to give the proto layer one buffer of bytes at a time
|
||||
/// that it can use to serialize the next portion of the message, with the
|
||||
/// option to "backup" if more buffer is given than required at the last buffer.
|
||||
///
|
||||
/// Read more about ZeroCopyOutputStream interface here:
|
||||
/// https://developers.google.com/protocol-buffers/docs/reference/cpp/google.protobuf.io.zero_copy_stream#ZeroCopyOutputStream
|
||||
class GrpcProtoBufferWriter |
||||
: public ::grpc::protobuf::io::ZeroCopyOutputStream { |
||||
public: |
||||
/// Constructor for this derived class
|
||||
///
|
||||
/// \param[out] byte_buffer A pointer to the grpc::ByteBuffer created
|
||||
/// \param block_size How big are the chunks to allocate at a time
|
||||
/// \param total_size How many total bytes are required for this proto
|
||||
GrpcProtoBufferWriter(ByteBuffer* byte_buffer, int block_size, int total_size) |
||||
: block_size_(block_size), |
||||
total_size_(total_size), |
||||
byte_count_(0), |
||||
have_backup_(false) { |
||||
GPR_CODEGEN_ASSERT(!byte_buffer->Valid()); |
||||
/// Create an empty raw byte buffer and look at its underlying slice buffer
|
||||
grpc_byte_buffer* bp = |
||||
g_core_codegen_interface->grpc_raw_byte_buffer_create(NULL, 0); |
||||
byte_buffer->set_buffer(bp); |
||||
slice_buffer_ = &bp->data.raw.slice_buffer; |
||||
} |
||||
|
||||
~GrpcProtoBufferWriter() { |
||||
if (have_backup_) { |
||||
g_core_codegen_interface->grpc_slice_unref(backup_slice_); |
||||
} |
||||
} |
||||
|
||||
/// Give the proto library the next buffer of bytes and its size. It is
|
||||
/// safe for the caller to write from data[0, size - 1].
|
||||
bool Next(void** data, int* size) override { |
||||
// Protobuf should not ask for more memory than total_size_.
|
||||
GPR_CODEGEN_ASSERT(byte_count_ < total_size_); |
||||
// 1. Use the remaining backup slice if we have one
|
||||
// 2. Otherwise allocate a slice, up to the remaining length needed
|
||||
// or our maximum allocation size
|
||||
// 3. Provide the slice start and size available
|
||||
// 4. Add the slice being returned to the slice buffer
|
||||
size_t remain = total_size_ - byte_count_; |
||||
if (have_backup_) { |
||||
/// If we have a backup slice, we should use it first
|
||||
slice_ = backup_slice_; |
||||
have_backup_ = false; |
||||
if (GRPC_SLICE_LENGTH(slice_) > remain) { |
||||
GRPC_SLICE_SET_LENGTH(slice_, remain); |
||||
} |
||||
} else { |
||||
// When less than a whole block is needed, only allocate that much.
|
||||
// But make sure the allocated slice is not inlined.
|
||||
size_t allocate_length = |
||||
remain > static_cast<size_t>(block_size_) ? block_size_ : remain; |
||||
slice_ = g_core_codegen_interface->grpc_slice_malloc( |
||||
allocate_length > GRPC_SLICE_INLINED_SIZE |
||||
? allocate_length |
||||
: GRPC_SLICE_INLINED_SIZE + 1); |
||||
} |
||||
*data = GRPC_SLICE_START_PTR(slice_); |
||||
// On win x64, int is only 32bit
|
||||
GPR_CODEGEN_ASSERT(GRPC_SLICE_LENGTH(slice_) <= INT_MAX); |
||||
byte_count_ += * size = (int)GRPC_SLICE_LENGTH(slice_); |
||||
g_core_codegen_interface->grpc_slice_buffer_add(slice_buffer_, slice_); |
||||
return true; |
||||
} |
||||
|
||||
/// Backup by \a count bytes because Next returned more bytes than needed
|
||||
/// (only used in the last buffer). \a count must be less than or equal too
|
||||
/// the last buffer returned from next.
|
||||
void BackUp(int count) override { |
||||
/// 1. Remove the partially-used last slice from the slice buffer
|
||||
/// 2. Split it into the needed (if any) and unneeded part
|
||||
/// 3. Add the needed part back to the slice buffer
|
||||
/// 4. Mark that we still have the remaining part (for later use/unref)
|
||||
GPR_CODEGEN_ASSERT(count <= static_cast<int>(GRPC_SLICE_LENGTH(slice_))); |
||||
g_core_codegen_interface->grpc_slice_buffer_pop(slice_buffer_); |
||||
if ((size_t)count == GRPC_SLICE_LENGTH(slice_)) { |
||||
backup_slice_ = slice_; |
||||
} else { |
||||
backup_slice_ = g_core_codegen_interface->grpc_slice_split_tail( |
||||
&slice_, GRPC_SLICE_LENGTH(slice_) - count); |
||||
g_core_codegen_interface->grpc_slice_buffer_add(slice_buffer_, slice_); |
||||
} |
||||
// It's dangerous to keep an inlined grpc_slice as the backup slice, since
|
||||
// on a following Next() call, a reference will be returned to this slice
|
||||
// via GRPC_SLICE_START_PTR, which will not be an address held by
|
||||
// slice_buffer_.
|
||||
have_backup_ = backup_slice_.refcount != NULL; |
||||
byte_count_ -= count; |
||||
} |
||||
|
||||
/// Returns the total number of bytes written since this object was created.
|
||||
grpc::protobuf::int64 ByteCount() const override { return byte_count_; } |
||||
|
||||
// These protected members are needed to support internal optimizations.
|
||||
// they expose internal bits of grpc core that are NOT stable. If you have
|
||||
// a use case needs to use one of these functions, please send an email to
|
||||
// https://groups.google.com/forum/#!forum/grpc-io.
|
||||
protected: |
||||
grpc_slice_buffer* slice_buffer() { return slice_buffer_; } |
||||
void set_byte_count(int64_t byte_count) { byte_count_ = byte_count; } |
||||
|
||||
private: |
||||
// friend for testing purposes only
|
||||
friend class internal::GrpcProtoBufferWriterPeer; |
||||
const int block_size_; ///< size to alloc for each new \a grpc_slice needed
|
||||
const int total_size_; ///< byte size of proto being serialized
|
||||
int64_t byte_count_; ///< bytes written since this object was created
|
||||
grpc_slice_buffer* |
||||
slice_buffer_; ///< internal buffer of slices holding the serialized data
|
||||
bool have_backup_; ///< if we are holding a backup slice or not
|
||||
grpc_slice backup_slice_; ///< holds space we can still write to, if the
|
||||
///< caller has called BackUp
|
||||
grpc_slice slice_; ///< current slice passed back to the caller
|
||||
}; |
||||
|
||||
} // namespace grpc
|
||||
|
||||
#endif // GRPCPP_IMPL_CODEGEN_PROTO_BUFFER_WRITER_H
|
||||
@ -0,0 +1,24 @@ |
||||
/*
|
||||
* |
||||
* Copyright 2018 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_SUPPORT_PROTO_BUFFER_READER_H |
||||
#define GRPCPP_SUPPORT_PROTO_BUFFER_READER_H |
||||
|
||||
#include <grpcpp/impl/codegen/proto_buffer_reader.h> |
||||
|
||||
#endif // GRPCPP_SUPPORT_PROTO_BUFFER_READER_H
|
||||
@ -0,0 +1,24 @@ |
||||
/*
|
||||
* |
||||
* Copyright 2018 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_SUPPORT_PROTO_BUFFER_WRITER_H |
||||
#define GRPCPP_SUPPORT_PROTO_BUFFER_WRITER_H |
||||
|
||||
#include <grpcpp/impl/codegen/proto_buffer_writer.h> |
||||
|
||||
#endif // GRPCPP_SUPPORT_PROTO_BUFFER_WRITER_H
|
||||
@ -1,55 +0,0 @@ |
||||
/*
|
||||
* |
||||
* 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. |
||||
* |
||||
*/ |
||||
|
||||
#include <grpc/slice.h> |
||||
#include <grpcpp/support/slice.h> |
||||
|
||||
namespace grpc { |
||||
|
||||
Slice::Slice() : slice_(grpc_empty_slice()) {} |
||||
|
||||
Slice::~Slice() { grpc_slice_unref(slice_); } |
||||
|
||||
Slice::Slice(grpc_slice slice, AddRef) : slice_(grpc_slice_ref(slice)) {} |
||||
|
||||
Slice::Slice(grpc_slice slice, StealRef) : slice_(slice) {} |
||||
|
||||
Slice::Slice(size_t len) : slice_(grpc_slice_malloc(len)) {} |
||||
|
||||
Slice::Slice(const void* buf, size_t len) |
||||
: slice_( |
||||
grpc_slice_from_copied_buffer(static_cast<const char*>(buf), len)) {} |
||||
|
||||
Slice::Slice(const grpc::string& str) |
||||
: slice_(grpc_slice_from_copied_buffer(str.c_str(), str.length())) {} |
||||
|
||||
Slice::Slice(const void* buf, size_t len, StaticSlice) |
||||
: slice_( |
||||
grpc_slice_from_static_buffer(static_cast<const char*>(buf), len)) {} |
||||
|
||||
Slice::Slice(const Slice& other) : slice_(grpc_slice_ref(other.slice_)) {} |
||||
|
||||
Slice::Slice(void* buf, size_t len, void (*destroy)(void*), void* user_data) |
||||
: slice_(grpc_slice_new_with_user_data(buf, len, destroy, user_data)) {} |
||||
|
||||
Slice::Slice(void* buf, size_t len, void (*destroy)(void*, size_t)) |
||||
: slice_(grpc_slice_new_with_len(buf, len, destroy)) {} |
||||
|
||||
grpc_slice Slice::c_slice() const { return grpc_slice_ref(slice_); } |
||||
|
||||
} // namespace grpc
|
||||
Loading…
Reference in new issue