// Copyright (c) 2006- Facebook // Distributed under the Thrift Software License // // See accompanying file LICENSE or visit the Thrift site at: // http://developers.facebook.com/thrift/ #ifndef _THRIFT_PROTOCOL_TVIRTUALPROTOCOL_H_ #define _THRIFT_PROTOCOL_TVIRTUALPROTOCOL_H_ 1 #include "thrift/lib/cpp/protocol/TProtocol.h" namespace apache { namespace thrift { namespace protocol { /** * Helper class that provides default implementations of TProtocol methods. * * This class provides default implementations of the non-virtual TProtocol * methods. It exists primarily so TVirtualProtocol can derive from it. It * prevents TVirtualProtocol methods from causing infinite recursion if the * non-virtual methods are not overridden by the TVirtualProtocol subclass. * * You probably don't want to use this class directly. Use TVirtualProtocol * instead. */ class TProtocolDefaults : public TProtocol { public: void setVersion(const int8_t version) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support setVersion (yet)"); } uint32_t readMessageBegin(std::string& name, TMessageType& messageType, int32_t& seqid) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support reading (yet)."); } uint32_t readMessageEnd() { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support reading (yet)."); } uint32_t readStructBegin(std::string& name) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support reading (yet)."); } uint32_t readStructEnd() { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support reading (yet)."); } uint32_t readFieldBegin(std::string& name, TType& fieldType, int16_t& fieldId) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support reading (yet)."); } uint32_t readFieldEnd() { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support reading (yet)."); } uint32_t readMapBegin(TType& keyType, TType& valType, uint32_t& size) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support reading (yet)."); } uint32_t readMapEnd() { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support reading (yet)."); } uint32_t readListBegin(TType& elemType, uint32_t& size) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support reading (yet)."); } uint32_t readListEnd() { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support reading (yet)."); } uint32_t readSetBegin(TType& elemType, uint32_t& size) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support reading (yet)."); } uint32_t readSetEnd() { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support reading (yet)."); } uint32_t readBool(bool& value) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support reading (yet)."); } uint32_t readBool(std::vector::reference value) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support reading (yet)."); } uint32_t readByte(int8_t& byte) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support reading (yet)."); } uint32_t readI16(int16_t& i16) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support reading (yet)."); } uint32_t readI32(int32_t& i32) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support reading (yet)."); } uint32_t readI64(int64_t& i64) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support reading (yet)."); } uint32_t readDouble(double& dub) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support reading (yet)."); } uint32_t readString(std::string& str) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support reading (yet)."); } uint32_t readBinary(std::string& str) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support reading (yet)."); } uint32_t writeMessageBegin(const std::string& name, const TMessageType messageType, const int32_t seqid) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support writing (yet)."); } uint32_t writeMessageEnd() { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support writing (yet)."); } uint32_t writeStructBegin(const char* name) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support writing (yet)."); } uint32_t writeStructEnd() { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support writing (yet)."); } uint32_t writeFieldBegin(const char* name, const TType fieldType, const int16_t fieldId) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support writing (yet)."); } uint32_t writeFieldEnd() { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support writing (yet)."); } uint32_t writeFieldStop() { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support writing (yet)."); } uint32_t writeMapBegin(const TType keyType, const TType valType, const uint32_t size) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support writing (yet)."); } uint32_t writeMapEnd() { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support writing (yet)."); } uint32_t writeListBegin(const TType elemType, const uint32_t size) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support writing (yet)."); } uint32_t writeListEnd() { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support writing (yet)."); } uint32_t writeSetBegin(const TType elemType, const uint32_t size) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support writing (yet)."); } uint32_t writeSetEnd() { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support writing (yet)."); } uint32_t writeBool(const bool value) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support writing (yet)."); } uint32_t writeByte(const int8_t byte) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support writing (yet)."); } uint32_t writeI16(const int16_t i16) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support writing (yet)."); } uint32_t writeI32(const int32_t i32) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support writing (yet)."); } uint32_t writeI64(const int64_t i64) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support writing (yet)."); } uint32_t writeDouble(const double dub) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support writing (yet)."); } uint32_t writeString(const std::string& str) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support writing (yet)."); } uint32_t writeBinary(const std::string& str) { throw TProtocolException(TProtocolException::NOT_IMPLEMENTED, "this protocol does not support writing (yet)."); } uint32_t skip(TType type) { return ::apache::thrift::protocol::skip(*this, type); } protected: TProtocolDefaults(const boost::shared_ptr& ptrans) : TProtocol(ptrans) {} TProtocolDefaults(transport::TTransport* ptrans) : TProtocol(ptrans) {} }; /** * Concrete TProtocol classes should inherit from TVirtualProtocol * so they don't have to manually override virtual methods. * * @author David Reiss */ template class TVirtualProtocol : public Super_ { public: virtual void setVersion_virt(const int8_t version) { return static_cast(this)->setVersion(version); } /** * Writing functions. */ virtual uint32_t writeMessageBegin_virt(const std::string& name, const TMessageType messageType, const int32_t seqid) { return static_cast(this)->writeMessageBegin(name, messageType, seqid); } virtual uint32_t writeMessageEnd_virt() { return static_cast(this)->writeMessageEnd(); } virtual uint32_t writeStructBegin_virt(const char* name) { return static_cast(this)->writeStructBegin(name); } virtual uint32_t writeStructEnd_virt() { return static_cast(this)->writeStructEnd(); } virtual uint32_t writeFieldBegin_virt(const char* name, const TType fieldType, const int16_t fieldId) { return static_cast(this)->writeFieldBegin(name, fieldType, fieldId); } virtual uint32_t writeFieldEnd_virt() { return static_cast(this)->writeFieldEnd(); } virtual uint32_t writeFieldStop_virt() { return static_cast(this)->writeFieldStop(); } virtual uint32_t writeMapBegin_virt(const TType keyType, const TType valType, const uint32_t size) { return static_cast(this)->writeMapBegin(keyType, valType, size); } virtual uint32_t writeMapEnd_virt() { return static_cast(this)->writeMapEnd(); } virtual uint32_t writeListBegin_virt(const TType elemType, const uint32_t size) { return static_cast(this)->writeListBegin(elemType, size); } virtual uint32_t writeListEnd_virt() { return static_cast(this)->writeListEnd(); } virtual uint32_t writeSetBegin_virt(const TType elemType, const uint32_t size) { return static_cast(this)->writeSetBegin(elemType, size); } virtual uint32_t writeSetEnd_virt() { return static_cast(this)->writeSetEnd(); } virtual uint32_t writeBool_virt(const bool value) { return static_cast(this)->writeBool(value); } virtual uint32_t writeByte_virt(const int8_t byte) { return static_cast(this)->writeByte(byte); } virtual uint32_t writeI16_virt(const int16_t i16) { return static_cast(this)->writeI16(i16); } virtual uint32_t writeI32_virt(const int32_t i32) { return static_cast(this)->writeI32(i32); } virtual uint32_t writeI64_virt(const int64_t i64) { return static_cast(this)->writeI64(i64); } virtual uint32_t writeDouble_virt(const double dub) { return static_cast(this)->writeDouble(dub); } virtual uint32_t writeString_virt(const std::string& str) { return static_cast(this)->writeString(str); } virtual uint32_t writeBinary_virt(const std::string& str) { return static_cast(this)->writeBinary(str); } /** * Reading functions */ virtual uint32_t readMessageBegin_virt(std::string& name, TMessageType& messageType, int32_t& seqid) { return static_cast(this)->readMessageBegin(name, messageType, seqid); } virtual uint32_t readMessageEnd_virt() { return static_cast(this)->readMessageEnd(); } virtual uint32_t readStructBegin_virt(std::string& name) { return static_cast(this)->readStructBegin(name); } virtual uint32_t readStructEnd_virt() { return static_cast(this)->readStructEnd(); } virtual uint32_t readFieldBegin_virt(std::string& name, TType& fieldType, int16_t& fieldId) { return static_cast(this)->readFieldBegin(name, fieldType, fieldId); } virtual uint32_t readFieldEnd_virt() { return static_cast(this)->readFieldEnd(); } virtual uint32_t readMapBegin_virt(TType& keyType, TType& valType, uint32_t& size) { return static_cast(this)->readMapBegin(keyType, valType, size); } virtual uint32_t readMapEnd_virt() { return static_cast(this)->readMapEnd(); } virtual uint32_t readListBegin_virt(TType& elemType, uint32_t& size) { return static_cast(this)->readListBegin(elemType, size); } virtual uint32_t readListEnd_virt() { return static_cast(this)->readListEnd(); } virtual uint32_t readSetBegin_virt(TType& elemType, uint32_t& size) { return static_cast(this)->readSetBegin(elemType, size); } virtual uint32_t readSetEnd_virt() { return static_cast(this)->readSetEnd(); } virtual uint32_t readBool_virt(bool& value) { return static_cast(this)->readBool(value); } virtual uint32_t readBool_virt(std::vector::reference value) { return static_cast(this)->readBool(value); } virtual uint32_t readByte_virt(int8_t& byte) { return static_cast(this)->readByte(byte); } virtual uint32_t readI16_virt(int16_t& i16) { return static_cast(this)->readI16(i16); } virtual uint32_t readI32_virt(int32_t& i32) { return static_cast(this)->readI32(i32); } virtual uint32_t readI64_virt(int64_t& i64) { return static_cast(this)->readI64(i64); } virtual uint32_t readDouble_virt(double& dub) { return static_cast(this)->readDouble(dub); } virtual uint32_t readString_virt(std::string& str) { return static_cast(this)->readString(str); } virtual uint32_t readBinary_virt(std::string& str) { return static_cast(this)->readBinary(str); } virtual uint32_t skip_virt(TType type) { return static_cast(this)->skip(type); } /* * Provide a default skip() implementation that uses non-virtual read * methods. * * Note: subclasses that use TVirtualProtocol to derive from another protocol * implementation (i.e., not TProtocolDefaults) should beware that this may * override any non-default skip() implementation provided by the parent * transport class. They may need to explicitly redefine skip() to call the * correct parent implementation, if desired. */ uint32_t skip(TType type) { Protocol_* const prot = static_cast(this); return ::apache::thrift::protocol::skip(*prot, type); } /* * Provide a default readBool() implementation for use with * std::vector, that behaves the same as reading into a normal bool. * * Subclasses can override this if desired, but there normally shouldn't * be a need to. */ uint32_t readBool(std::vector::reference value) { bool b = false; uint32_t ret = static_cast(this)->readBool(b); value = b; return ret; } using Super_::readBool; // so we don't hide readBool(bool&) protected: TVirtualProtocol(const boost::shared_ptr& ptrans) : Super_(ptrans) {} TVirtualProtocol(transport::TTransport* ptrans) : Super_(ptrans) {} }; }}} // apache::thrift::protocol #endif // #define _THRIFT_PROTOCOL_TVIRTUALPROTOCOL_H_ 1