Package org.apache.pekko.serialization

Class AsyncSerializerWithStringManifest

java.lang.Object

org.apache.pekko.serialization.SerializerWithStringManifest

org.apache.pekko.serialization.AsyncSerializerWithStringManifest

All Implemented Interfaces:

AsyncSerializer, Serializer

Direct Known Subclasses:

AsyncSerializerWithStringManifestCS

public abstract class AsyncSerializerWithStringManifest
extends SerializerWithStringManifest
implements AsyncSerializer

Scala API: Async serializer with string manifest that delegates synchronous calls to the asynchronous calls and blocks.

Constructor Summary

Constructors

Constructor	Description
AsyncSerializerWithStringManifest(ExtendedActorSystem system)

Method Summary

Modifier and Type	Method	Description
final Object	fromBinary(byte[] bytes, String manifest)	Produces an object from an array of bytes, with an optional type-hint.
final byte[]	toBinary(Object o)	Serializes the given object into an Array of Byte.

Methods inherited from class org.apache.pekko.serialization.SerializerWithStringManifest

fromBinary, identifier, includeManifest, manifest

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.apache.pekko.serialization.AsyncSerializer

fromBinaryAsync, toBinaryAsync

Methods inherited from interface org.apache.pekko.serialization.Serializer

fromBinary, fromBinary

Constructor Details

AsyncSerializerWithStringManifest

public AsyncSerializerWithStringManifest(ExtendedActorSystem system)

Method Details

fromBinary

public final Object fromBinary(byte[] bytes,
 String manifest)

Description copied from class: SerializerWithStringManifest

Produces an object from an array of bytes, with an optional type-hint.

It's recommended to throw java.io.NotSerializableException in fromBinary if the manifest is unknown. This makes it possible to introduce new message types and send them to nodes that don't know about them. This is typically needed when performing rolling upgrades, i.e. running a cluster with mixed versions for while. NotSerializableException is treated as a transient problem in the TCP based remoting layer. The problem will be logged and message is dropped. Other exceptions will tear down the TCP connection because it can be an indication of corrupt bytes from the underlying transport.

Specified by:

fromBinary in class SerializerWithStringManifest

toBinary

public final byte[] toBinary(Object o)

Description copied from class: SerializerWithStringManifest

Serializes the given object into an Array of Byte.

Note that the array must not be mutated by the serializer after it has been returned.

Specified by:

toBinary in interface Serializer

Specified by:

toBinary in class SerializerWithStringManifest