any.h 3.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990
  1. // Protocol Buffers - Google's data interchange format
  2. // Copyright 2008 Google Inc. All rights reserved.
  3. // https://developers.google.com/protocol-buffers/
  4. //
  5. // Redistribution and use in source and binary forms, with or without
  6. // modification, are permitted provided that the following conditions are
  7. // met:
  8. //
  9. // * Redistributions of source code must retain the above copyright
  10. // notice, this list of conditions and the following disclaimer.
  11. // * Redistributions in binary form must reproduce the above
  12. // copyright notice, this list of conditions and the following disclaimer
  13. // in the documentation and/or other materials provided with the
  14. // distribution.
  15. // * Neither the name of Google Inc. nor the names of its
  16. // contributors may be used to endorse or promote products derived from
  17. // this software without specific prior written permission.
  18. //
  19. // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  20. // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  21. // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  22. // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  23. // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  24. // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  25. // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  26. // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  27. // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  28. // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  29. // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  30. #ifndef GOOGLE_PROTOBUF_ANY_H__
  31. #define GOOGLE_PROTOBUF_ANY_H__
  32. #include <string>
  33. #include <google/protobuf/stubs/common.h>
  34. #include <google/protobuf/descriptor.h>
  35. #include <google/protobuf/message.h>
  36. #include <google/protobuf/arenastring.h>
  37. namespace google {
  38. namespace protobuf {
  39. namespace internal {
  40. // Helper class used to implement google::protobuf::Any.
  41. class LIBPROTOBUF_EXPORT AnyMetadata {
  42. typedef ArenaStringPtr UrlType;
  43. typedef ArenaStringPtr ValueType;
  44. public:
  45. // AnyMetadata does not take ownership of "type_url" and "value".
  46. AnyMetadata(UrlType* type_url, ValueType* value);
  47. void PackFrom(const Message& message);
  48. bool UnpackTo(Message* message) const;
  49. template<typename T>
  50. bool Is() const {
  51. return InternalIs(T::default_instance().GetDescriptor());
  52. }
  53. private:
  54. bool InternalIs(const Descriptor* message) const;
  55. UrlType* type_url_;
  56. ValueType* value_;
  57. GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(AnyMetadata);
  58. };
  59. extern const char kAnyFullTypeName[]; // "google.protobuf.Any".
  60. extern const char kTypeGoogleApisComPrefix[]; // "type.googleapis.com/".
  61. // Get the proto type name from Any::type_url value. For example, passing
  62. // "type.googleapis.com/rpc.QueryOrigin" will return "rpc.QueryOrigin" in
  63. // *full_type_name. Returns false if type_url does not start with
  64. // "type.googleapis.com".
  65. bool ParseAnyTypeUrl(const string& type_url, string* full_type_name);
  66. // See if message is of type google.protobuf.Any, if so, return the descriptors
  67. // for "type_url" and "value" fields.
  68. bool GetAnyFieldDescriptors(const Message& message,
  69. const FieldDescriptor** type_url_field,
  70. const FieldDescriptor** value_field);
  71. } // namespace internal
  72. } // namespace protobuf
  73. } // namespace google
  74. #endif // GOOGLE_PROTOBUF_ANY_H__