/* * Copyright (c) Meta Platforms, Inc. and affiliates. * * 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 THRIFT_PROTOCOL_TBINARYPROTOCOL_H_ #define THRIFT_PROTOCOL_TBINARYPROTOCOL_H_ 1 #include #include #include #include namespace apache { namespace thrift { namespace protocol { /** * The default binary protocol for thrift. Writes all data in a very basic * binary format, essentially just spitting out the raw bytes. * */ template class TBinaryProtocolT : public TVirtualProtocol> { public: static const int32_t VERSION_MASK = 0xffff0000; static const int32_t VERSION_1 = 0x80010000; // VERSION_2 (0x80020000) is taken by TDenseProtocol. explicit TBinaryProtocolT(const std::shared_ptr& trans) : TVirtualProtocol>(trans), trans_(trans.get()), string_limit_(0), container_limit_(0), strict_read_(false), strict_write_(true) {} TBinaryProtocolT( const std::shared_ptr& trans, int32_t string_limit, int32_t container_limit, bool strict_read, bool strict_write) : TVirtualProtocol>(trans), trans_(trans.get()), string_limit_(string_limit), container_limit_(container_limit), strict_read_(strict_read), strict_write_(strict_write) {} /** * Construct a TBinaryProtocolT using a raw pointer to the transport. * * The caller is responsible for ensuring that the transport remains valid * for the lifetime of the protocol. */ explicit TBinaryProtocolT(Transport_* trans) : TVirtualProtocol>(trans), trans_(trans), string_limit_(0), container_limit_(0), strict_read_(false), strict_write_(true) {} void setStringSizeLimit(int32_t string_limit) { string_limit_ = string_limit; } void setContainerSizeLimit(int32_t container_limit) { container_limit_ = container_limit; } int32_t getStringSizeLimit() { return string_limit_; } int32_t getContainerSizeLimit() { return container_limit_; } void setStrict(bool strict_read, bool strict_write) { strict_read_ = strict_read; strict_write_ = strict_write; } /** * Writing functions. */ /*ol*/ uint32_t writeMessageBegin( const std::string& name, const TMessageType messageType, const int32_t seqid); /*ol*/ uint32_t writeMessageEnd(); inline uint32_t writeStructBegin(const char* name); inline uint32_t writeStructEnd(); inline uint32_t writeFieldBegin( const char* name, const TType fieldType, const int16_t fieldId); inline uint32_t writeFieldEnd(); inline uint32_t writeFieldStop(); inline uint32_t writeMapBegin( const TType keyType, const TType valType, const uint32_t size); inline uint32_t writeMapEnd(); inline uint32_t writeListBegin(const TType elemType, const uint32_t size); inline uint32_t writeListEnd(); inline uint32_t writeSetBegin(const TType elemType, const uint32_t size); inline uint32_t writeSetEnd(); inline uint32_t writeBool(const bool value); inline uint32_t writeByte(const int8_t byte); inline uint32_t writeI16(const int16_t i16); inline uint32_t writeI32(const int32_t i32); inline uint32_t writeI64(const int64_t i64); inline uint32_t writeDouble(const double dub); inline uint32_t writeFloat(const float flt); template inline uint32_t writeString(const StrType& str); inline uint32_t writeBinary(const std::string& str); /** * Reading functions */ /*ol*/ uint32_t readMessageBegin( std::string& name, TMessageType& messageType, int32_t& seqid); /*ol*/ uint32_t readMessageEnd(); inline uint32_t readStructBegin(std::string& name); inline uint32_t readStructEnd(); inline uint32_t readFieldBegin( std::string& name, TType& fieldType, int16_t& fieldId); inline uint32_t readFieldEnd(); inline uint32_t readMapBegin( TType& keyType, TType& valType, uint32_t& size, bool& sizeUnknown); inline uint32_t readMapEnd(); inline uint32_t readListBegin( TType& elemType, uint32_t& size, bool& SizeUnknown); inline uint32_t readListEnd(); inline uint32_t readSetBegin( TType& elemType, uint32_t& size, bool& sizeUnknown); inline uint32_t readSetEnd(); inline uint32_t readBool(bool& value); // Provide the default readBool() implementation for std::vector using TVirtualProtocol>::readBool; inline uint32_t readByte(int8_t& byte); inline uint32_t readI16(int16_t& i16); inline uint32_t readI32(int32_t& i32); inline uint32_t readI64(int64_t& i64); inline uint32_t readDouble(double& dub); inline uint32_t readFloat(float& flt); template inline uint32_t readString(StrType& str); inline uint32_t readBinary(std::string& str); protected: template uint32_t readStringBody(StrType& str, int32_t sz); Transport_* trans_; int32_t string_limit_; int32_t container_limit_; // Enforce presence of version identifier bool strict_read_; bool strict_write_; }; typedef TBinaryProtocolT TBinaryProtocol; class TBinaryProtocolFactoryBase : public TProtocolFactory {}; /** * Constructs binary protocol handlers */ template class TBinaryProtocolFactoryT : public TBinaryProtocolFactoryBase { public: TBinaryProtocolFactoryT() : string_limit_(0), container_limit_(0), strict_read_(false), strict_write_(true) {} TBinaryProtocolFactoryT( int32_t string_limit, int32_t container_limit, bool strict_read, bool strict_write) : string_limit_(string_limit), container_limit_(container_limit), strict_read_(strict_read), strict_write_(strict_write) {} ~TBinaryProtocolFactoryT() override {} void setStringSizeLimit(int32_t string_limit) { string_limit_ = string_limit; } void setContainerSizeLimit(int32_t container_limit) { container_limit_ = container_limit; } void setStrict(bool strict_read, bool strict_write) { strict_read_ = strict_read; strict_write_ = strict_write; } std::shared_ptr getProtocol( std::shared_ptr trans) override { std::shared_ptr specific_trans = std::dynamic_pointer_cast(trans); TProtocol* prot; if (specific_trans) { prot = new TBinaryProtocolT( specific_trans, string_limit_, container_limit_, strict_read_, strict_write_); } else { prot = new TBinaryProtocol( trans, string_limit_, container_limit_, strict_read_, strict_write_); } return std::shared_ptr(prot); } private: int32_t string_limit_; int32_t container_limit_; bool strict_read_; bool strict_write_; }; typedef TBinaryProtocolFactoryT TBinaryProtocolFactory; } // namespace protocol } // namespace thrift } // namespace apache #include #endif // #ifndef THRIFT_PROTOCOL_TBINARYPROTOCOL_H_