Merge pull request #573 from davidgrupp/master

Added clearer comments for RestRequest.AddBody and additional RestRequest.AddJsonBody and RestRequest.AddXmlBody

Author: hallem

RestSharp.Tests/NamespacedXmlTests.cs

@@ -1,4 +1,4 @@
-#region Licensed
+#region Licensed
 //   Copyright 2010 John Sheehan
 //
 //   Licensed under the Apache License, Version 2.0 (the "License");

RestSharp.sln

@@ -1,4 +1,4 @@
-
+
 Microsoft Visual Studio Solution File, Format Version 12.00
 # Visual Studio 2013
 VisualStudioVersion = 12.0.30723.0

RestSharp/IRestRequest.cs

@@ -160,7 +160,8 @@ public interface IRestRequest
 #endif
 
 		/// <summary>
-		/// Serializes obj to format specified by RequestFormat, but passes xmlNamespace if using the default XmlSerializer
+		/// Serializes obj to format specified by RequestFormat, but passes xmlNamespace if using the default XmlSerializer.
+		/// The default format is XML. Change RequestFormat if you wish to use a different serialization format.
 		/// </summary>
 		/// <param name="obj">The object to serialize</param>
 		/// <param name="xmlNamespace">The XML namespace to use when serializing</param>
@@ -169,11 +170,35 @@ public interface IRestRequest
 
 		/// <summary>
 		/// Serializes obj to data format specified by RequestFormat and adds it to the request body.
+		/// The default format is XML. Change RequestFormat if you wish to use a different serialization format.
 		/// </summary>
 		/// <param name="obj">The object to serialize</param>
 		/// <returns>This request</returns>
 		IRestRequest AddBody (object obj);
 
+		/// <summary>
+		/// Serializes obj to JSON format and adds it to the request body.
+		/// </summary>
+		/// <param name="obj">The object to serialize</param>
+		/// <returns>This request</returns>
+		IRestRequest AddJsonBody(object obj);
+
+		/// <summary>
+		/// Serializes obj to XML format and adds it to the request body.
+		/// </summary>
+		/// <param name="obj">The object to serialize</param>
+		/// <returns>This request</returns>
+		IRestRequest AddXmlBody(object obj);
+
+		/// <summary>
+		/// Serializes obj to format specified by RequestFormat, but passes xmlNamespace if using the default XmlSerializer
+		/// Serializes obj to XML format and passes xmlNamespace then adds it to the request body.
+		/// </summary>
+		/// <param name="obj">The object to serialize</param>
+		/// <param name="xmlNamespace">The XML namespace to use when serializing</param>
+		/// <returns>This request</returns>
+		IRestRequest AddXmlBody(object obj, string xmlNamespace);
+
 		/// <summary>
 		/// Calls AddParameter() for all public, readable properties specified in the includedProperties list
 		/// </summary>

RestSharp/RestRequest.cs

@@ -207,7 +207,8 @@ private IRestRequest AddFile (FileParameter file)
 		}
 
 		/// <summary>
-		/// Serializes obj to format specified by RequestFormat, but passes xmlNamespace if using the default XmlSerializer
+		/// Serializes obj to format specified by RequestFormat, but passes xmlNamespace if using the default XmlSerializer.
+		/// The default format is XML. Change RequestFormat if you wish to use a different serialization format.
 		/// </summary>
 		/// <param name="obj">The object to serialize</param>
 		/// <param name="xmlNamespace">The XML namespace to use when serializing</param>
@@ -244,6 +245,7 @@ public IRestRequest AddBody (object obj, string xmlNamespace)
 
 		/// <summary>
 		/// Serializes obj to data format specified by RequestFormat and adds it to the request body.
+		/// The default format is XML. Change RequestFormat if you wish to use a different serialization format.
 		/// </summary>
 		/// <param name="obj">The object to serialize</param>
 		/// <returns>This request</returns>
@@ -252,6 +254,42 @@ public IRestRequest AddBody (object obj)
 			return AddBody(obj, "");
 		}
 
+		/// <summary>
+		/// Serializes obj to JSON format and adds it to the request body.
+		/// </summary>
+		/// <param name="obj">The object to serialize</param>
+		/// <returns>This request</returns>
+		public IRestRequest AddJsonBody(object obj)
+		{
+			RequestFormat = DataFormat.Json;
+			return AddBody(obj, "");
+		}
+
+		/// <summary>
+		/// Serializes obj to XML format and adds it to the request body.
+		/// </summary>
+		/// <param name="obj">The object to serialize</param>
+		/// <returns>This request</returns>
+		public IRestRequest AddXmlBody(object obj)
+		{
+			RequestFormat = DataFormat.Xml;
+			return AddBody(obj, "");
+		}
+
+		/// <summary>
+		/// Serializes obj to format specified by RequestFormat, but passes xmlNamespace if using the default XmlSerializer
+		/// Serializes obj to XML format and passes xmlNamespace then adds it to the request body.
+		/// </summary>
+		/// <param name="obj">The object to serialize</param>
+		/// <param name="xmlNamespace">The XML namespace to use when serializing</param>
+		/// <returns>This request</returns>
+		public IRestRequest AddXmlBody(object obj, string xmlNamespace)
+		{
+			RequestFormat = DataFormat.Xml;
+			return AddBody(obj, xmlNamespace);
+		}
+
+		
 		/// <summary>
 		/// Calls AddParameter() for all public, readable properties specified in the includedProperties list
 		/// </summary>