public class StringUtf8Coder extends AtomicCoder<String>
Coder that encodes Strings in UTF-8 encoding.
If in a nested context, prefixes the string with an integer length field,
encoded via a VarIntCoder.Coder.Context, Coder.NonDeterministicException| Modifier and Type | Method and Description |
|---|---|
boolean |
consistentWithEquals()
|
String |
decode(InputStream inStream,
Coder.Context context)
Decodes a value of type
T from the given input stream in
the given context. |
void |
encode(String value,
OutputStream outStream,
Coder.Context context)
Encodes the given value of type
T onto the given output stream
in the given context. |
protected long |
getEncodedElementByteSize(String value,
Coder.Context context)
Returns the size in bytes of the encoded value using this coder.
|
static StringUtf8Coder |
of() |
getCoderArguments, getInstanceComponentsverifyDeterministicasCloudObject, equals, getAllowedEncodings, getComponents, getEncodingId, hashCode, isRegisterByteSizeObserverCheap, registerByteSizeObserver, structuralValue, toString, verifyDeterministic, verifyDeterministicpublic static StringUtf8Coder of()
public void encode(String value, OutputStream outStream, Coder.Context context) throws IOException
CoderT onto the given output stream
in the given context.IOException - if writing to the OutputStream fails
for some reasonCoderException - if the value could not be encoded for some reasonpublic String decode(InputStream inStream, Coder.Context context) throws IOException
CoderT from the given input stream in
the given context. Returns the decoded value.IOException - if reading from the InputStream fails
for some reasonCoderException - if the value could not be decoded for some reasonpublic boolean consistentWithEquals()
true if this Coder is injective with respect to Object.equals(java.lang.Object).
Whenever the encoded bytes of two values are equal, then the original values are equal
according to Objects.equals(). Note that this is well-defined for null.
This condition is most notably false for arrays. More generally, this condition is false
whenever equals() compares object identity, rather than performing a
semantic/structural comparison.
consistentWithEquals in interface Coder<String>consistentWithEquals in class StandardCoder<String>true. This coder is injective.protected long getEncodedElementByteSize(String value, Coder.Context context) throws Exception
getEncodedElementByteSize in class StandardCoder<String>Exception