From 9abb73069cf09a7cd8f16636de79e51ba3daeb87 Mon Sep 17 00:00:00 2001 From: Sebastian Harko Date: Fri, 24 Mar 2017 15:26:50 +0100 Subject: [PATCH] Serialization Docs: better intro (#22624) --- akka-docs/rst/java/serialization.rst | 6 ++---- akka-docs/rst/scala/serialization.rst | 6 ++---- 2 files changed, 4 insertions(+), 8 deletions(-) diff --git a/akka-docs/rst/java/serialization.rst b/akka-docs/rst/java/serialization.rst index 1f8d64a409..3f61e212ce 100644 --- a/akka-docs/rst/java/serialization.rst +++ b/akka-docs/rst/java/serialization.rst @@ -5,11 +5,9 @@ Serialization ##################### -Akka has a built-in Extension for serialization, -and it is both possible to use the built-in serializers and to write your own. +The messages that Akka actors send to each other are JVM objects (e.g. instances of Scala case classes). Message passing between actors that live on the same JVM is straightforward. It is simply done via reference passing. However, messages that have to escape the JVM to reach an actor running on a different host have to undergo some form of serialization (i.e. the objects have to be converted to and from byte arrays). -The serialization mechanism is both used by Akka internally to serialize messages, -and available for ad-hoc serialization of whatever you might need it for. +Akka itself uses Protocol Buffers to serialize internal messages (i.e. cluster gossip messages). However, the serialization mechanism in Akka allows you to write custom serializers and to define which serializer to use for what. Usage ===== diff --git a/akka-docs/rst/scala/serialization.rst b/akka-docs/rst/scala/serialization.rst index cd9e15f293..718560635a 100644 --- a/akka-docs/rst/scala/serialization.rst +++ b/akka-docs/rst/scala/serialization.rst @@ -4,11 +4,9 @@ Serialization ############# -Akka has a built-in Extension for serialization, -and it is both possible to use the built-in serializers and to write your own. +The messages that Akka actors send to each other are JVM objects (e.g. instances of Scala case classes). Message passing between actors that live on the same JVM is straightforward. It is simply done via reference passing. However, messages that have to escape the JVM to reach an actor running on a different host have to undergo some form of serialization (i.e. the objects have to be converted to and from byte arrays). -The serialization mechanism is both used by Akka internally to serialize messages, -and available for ad-hoc serialization of whatever you might need it for. +Akka itself uses Protocol Buffers to serialize internal messages (i.e. cluster gossip messages). However, the serialization mechanism in Akka allows you to write custom serializers and to define which serializer to use for what. Usage =====