Package com.fasterxml.jackson.core.io

Class SerializedString

  • All Implemented Interfaces:
    SerializableString, Serializable
    public class SerializedString
extends Object
implements SerializableString, Serializable
    String token that can lazily serialize String contained and then reuse that serialization later on. This is similar to JDBC prepared statements, for example, in that instances should only be created when they are used more than use; prime candidates are various serializers.

    Class is final for performance reasons and since this is not designed to be extensible or customizable (customizations would occur in calling code)

    See Also:
    Serialized Form

    • Constructor Detail

      • SerializedString

        public SerializedString​(String v)

    • Method Detail

      • charLength

        public final int charLength()
        Returns length of the String as characters
        Specified by:
        charLength in interface SerializableString

      • asQuotedChars

        public final char[] asQuotedChars()
        Accessor for accessing value that has been quoted (escaped) using JSON quoting rules (using backslash-prefixed codes) into a char array.
        Specified by:
        asQuotedChars in interface SerializableString

      • asQuotedUTF8

        public final byte[] asQuotedUTF8()
        Accessor for accessing value that has been quoted (escaped) using JSON quoting rules (using backslash-prefixed codes), and encoded using UTF-8 encoding into a byte array.
        Specified by:
        asQuotedUTF8 in interface SerializableString

      • asUnquotedUTF8

        public final byte[] asUnquotedUTF8()
        Accessor for accessing value as is (without JSON quoting (ecaping)) encoded as UTF-8 byte array.
        Specified by:
        asUnquotedUTF8 in interface SerializableString

      • appendQuoted

        public int appendQuoted​(char[] buffer,
                        int offset)
        Description copied from interface: SerializableString
        Method that will append quoted characters of this String into given buffer. Functionally equivalent to: 
          char[] ch = str.asQuotedChars();
  System.arraycopy(ch, 0, buffer, offset, ch.length);
  return ch.length;
        Specified by:
        appendQuoted in interface SerializableString
        Returns:
        Number of characters appended, if successful, otherwise -1

      • appendQuotedUTF8

        public int appendQuotedUTF8​(byte[] buffer,
                            int offset)
        Description copied from interface: SerializableString
        Method that will append quoted UTF-8 bytes of this String into given buffer, if there is enough room; if not, returns -1. Functionally equivalent to: 
          byte[] bytes = str.asQuotedUTF8();
  System.arraycopy(bytes, 0, buffer, offset, bytes.length);
  return bytes.length;
        Specified by:
        appendQuotedUTF8 in interface SerializableString
        Returns:
        Number of bytes appended, if successful, otherwise -1

      • appendUnquoted

        public int appendUnquoted​(char[] buffer,
                          int offset)
        Description copied from interface: SerializableString
        Method that will append unquoted characters of this String into given buffer. Functionally equivalent to: 
          char[] ch = str.getValue().toCharArray();
  System.arraycopy(bytes, 0, buffer, offset, ch.length);
  return ch.length;
        Specified by:
        appendUnquoted in interface SerializableString
        Returns:
        Number of characters appended, if successful, otherwise -1

      • appendUnquotedUTF8

        public int appendUnquotedUTF8​(byte[] buffer,
                              int offset)
        Description copied from interface: SerializableString
        Method that will append unquoted ('raw') UTF-8 bytes of this String into given buffer. Functionally equivalent to: 
          byte[] bytes = str.asUnquotedUTF8();
  System.arraycopy(bytes, 0, buffer, offset, bytes.length);
  return bytes.length;
        Specified by:
        appendUnquotedUTF8 in interface SerializableString
        Returns:
        Number of bytes appended, if successful, otherwise -1

      • hashCode

        public final int hashCode()
        Overrides:
        hashCode in class Object