Add UnpackMessagePackObject(byte[])

Author: yfakariya

CHANGES.txt

@@ -712,6 +712,7 @@ Release 1.0.0-beta1 T.B.D.
 
   NEW FEATURES
   * .NET Standard 2.0 which supports serializer source code generation on .NET Core. Note that serializer assembly generation is not supported.
+  * MessagePackSerializer.UnpackMessagePackObject(byte[]) utility method.
 
   BUG FIXES
   * Fix ByteArrayPacker throws IndexOutOfBoundException when the buffer remaining bytes is equal to packed scalar size. #252

src/MsgPack/Serialization/MessagePackSerializer.Factories.cs

@@ -1,4 +1,4 @@
-#region -- License Terms --
+#region -- License Terms --
 //
 // MessagePack for CLI
 //
@@ -666,6 +666,25 @@ public static MessagePackObject UnpackMessagePackObject( Stream stream )
 			return _singleTonMpoDeserializer.Unpack( stream );
 		}
 
+		/// <summary>
+		///		Directly deserialize specified MessagePack byte array as <see cref="MessagePackObject"/> tree.
+		/// </summary>
+		/// <param name="buffer">The stream which contains deserializing data.</param>
+		/// <returns>A <see cref="MessagePackObject"/> which is root of the deserialized MessagePack object tree.</returns>
+		/// <exception cref="ArgumentNullException">
+		///		<paramref name="buffer"/> is <c>null</c>.
+		/// </exception>
+		/// <remarks>
+		///		This method is convinient wrapper for <see cref="MessagePackSerializer.Get{T}(SerializationContext)"/> for <see cref="MessagePackObject"/>.
+		///		<note>
+		///			You cannot override this method behavior because this method uses private <see cref="SerializationContext"/> instead of default context which is able to be accessed via <see cref="SerializationContext.Default"/>.
+		///		</note>
+		/// </remarks>
+		public static MessagePackObject UnpackMessagePackObject( byte[] buffer )
+		{
+			return _singleTonMpoDeserializer.UnpackSingleObject( buffer );
+		}
+
 		/// <summary>
 		///		Try to prepare specified type for some AOT(Ahead-Of-Time) compilation environment.
 		///		If the type will be used in collection or dictionary, use <see cref="PrepareCollectionType{TElement}"/> and/or <see cref="PrepareDictionaryType{TKey,TValue}"/> instead.