Class LegacyUnredactedTextFormat


  • public final class LegacyUnredactedTextFormat
    extends java.lang.Object
    The legacy APIs preserve the existing toString() behavior (output TextFormat), which allows us to migrate toString callers that expect TextFormat output off toString. Eventually, we will make toString output DebugFormat, which is randomized and redacts SPII fields (incompatible with TextFormat).
    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static java.lang.String legacyUnredactedMultilineString​(MessageOrBuilder message)
      Like TextFormat.printer().printToString(message), but for legacy purposes.
      static java.lang.String legacyUnredactedMultilineString​(UnknownFieldSet fields)
      Like TextFormat.printer().printToString(fields), but for legacy purposes.
      static java.lang.String legacyUnredactedSingleLineString​(MessageOrBuilder message)
      Like TextFormat.printer().emittingSingleLine(true).printToString(message), but for legacy purposes.
      static java.lang.String legacyUnredactedSingleLineString​(UnknownFieldSet fields)
      Like TextFormat.printer().emittingSingleLine(true).printToString(fields), but for legacy purposes.
      static java.lang.String legacyUnredactedStringValueOf​(java.lang.Object object)
      Return String.valueOf() with the guarantee that any Protobuf Message.toString() invoked under this call always returns TextFormat (except for Message.toString() calls that are also under ProtobufToStringOutput.callWithDebugFormat).
      static java.lang.String legacyUnredactedToString​(java.lang.Object object)
      Return object.toString() with the guarantee that any Protobuf Message.toString() invoked under this call always returns TextFormat (except for Message.toString() calls that are also under ProtobufToStringOutput.callWithDebugFormat).
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Method Detail

      • legacyUnredactedMultilineString

        public static java.lang.String legacyUnredactedMultilineString​(MessageOrBuilder message)
        Like TextFormat.printer().printToString(message), but for legacy purposes.
      • legacyUnredactedMultilineString

        public static java.lang.String legacyUnredactedMultilineString​(UnknownFieldSet fields)
        Like TextFormat.printer().printToString(fields), but for legacy purposes.
      • legacyUnredactedSingleLineString

        public static java.lang.String legacyUnredactedSingleLineString​(MessageOrBuilder message)
        Like TextFormat.printer().emittingSingleLine(true).printToString(message), but for legacy purposes.
      • legacyUnredactedSingleLineString

        public static java.lang.String legacyUnredactedSingleLineString​(UnknownFieldSet fields)
        Like TextFormat.printer().emittingSingleLine(true).printToString(fields), but for legacy purposes.
      • legacyUnredactedToString

        public static java.lang.String legacyUnredactedToString​(java.lang.Object object)
        Return object.toString() with the guarantee that any Protobuf Message.toString() invoked under this call always returns TextFormat (except for Message.toString() calls that are also under ProtobufToStringOutput.callWithDebugFormat). This is particularly useful for toString calls on objects that contain Protobuf messages (e.g collections) and existing code expects toString() on these objects to contain Message.toString() outputs in TextFormat.
      • legacyUnredactedStringValueOf

        public static java.lang.String legacyUnredactedStringValueOf​(java.lang.Object object)
        Return String.valueOf() with the guarantee that any Protobuf Message.toString() invoked under this call always returns TextFormat (except for Message.toString() calls that are also under ProtobufToStringOutput.callWithDebugFormat). This is particularly useful for explicit and implicit String.valueOf() calls on objects that contain Protobuf messages (e.g collections) and may be null, and existing code expects toString() on these objects to contain Message.toString() outputs in TextFormat.