Added Serialization.DeserializeActorRef method (#7237)

Designed to give us a more aligned API for end-users that need to serialize and deserialize `IActorRef`s in their own user-defined messages.

src/contrib/cluster/Akka.Cluster.Sharding/Serialization/ClusterShardingMessageSerializer.cs

@@ -699,7 +699,7 @@ private static string ShardIdMessageFromBinary(byte[] bytes)
 
         private IActorRef ResolveActorRef(string path)
         {
-            return system.Provider.ResolveActorRef(path);
+            return system.Serialization.DeserializeActorRef(path);
         }
     }
 }

src/core/Akka.API.Tests/verify/CoreAPISpec.ApproveCore.DotNet.verified.txt

@@ -5228,6 +5228,7 @@ namespace Akka.Serialization
         public void AddSerializer(string name, Akka.Serialization.Serializer serializer) { }
         public object Deserialize(byte[] bytes, int serializerId, System.Type type) { }
         public object Deserialize(byte[] bytes, int serializerId, string manifest) { }
+        public Akka.Actor.IActorRef DeserializeActorRef(string path) { }
         public Akka.Serialization.Serializer FindSerializerFor(object obj, string defaultSerializerName = null) { }
         public Akka.Serialization.Serializer FindSerializerForType(System.Type objectType, string defaultSerializerName = null) { }
         public static Akka.Serialization.Information GetCurrentTransportInformation() { }

src/core/Akka.API.Tests/verify/CoreAPISpec.ApproveCore.Net.verified.txt

@@ -5218,6 +5218,7 @@ namespace Akka.Serialization
         public void AddSerializer(string name, Akka.Serialization.Serializer serializer) { }
         public object Deserialize(byte[] bytes, int serializerId, System.Type type) { }
         public object Deserialize(byte[] bytes, int serializerId, string manifest) { }
+        public Akka.Actor.IActorRef DeserializeActorRef(string path) { }
         public Akka.Serialization.Serializer FindSerializerFor(object obj, string defaultSerializerName = null) { }
         public Akka.Serialization.Serializer FindSerializerForType(System.Type objectType, string defaultSerializerName = null) { }
         public static Akka.Serialization.Information GetCurrentTransportInformation() { }

src/core/Akka/Serialization/Serialization.cs

@@ -574,6 +574,17 @@ public Serializer FindSerializerForType(Type objectType, string defaultSerialize
             AddSerializationMap(type, serializer);
             return serializer;
         }
+
+        /// <summary>
+        /// Deserializes an <see cref="IActorRef"/> from its string representation.
+        /// </summary>
+        /// <param name="path">The serialized path of the actor represented as a string.</param>
+        /// <returns>The <see cref="IActorRef"/>. If no such actor exists, it will be (equivalent to) a dead letter reference.</returns>
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public IActorRef DeserializeActorRef(string path)
+        {
+            return System.Provider.ResolveActorRef(path);
+        }
 
         /// <summary>
         /// The serialized path of an actorRef, based on the current transport serialization information.
@@ -589,7 +600,7 @@ public Serializer FindSerializerForType(Type objectType, string defaultSerialize
         public static string SerializedActorPath(IActorRef actorRef)
         {
             if (Equals(actorRef, ActorRefs.NoSender))
-                return String.Empty;
+                return string.Empty;
 
             var path = actorRef.Path;
             ExtendedActorSystem originalSystem = null;