Reimplement OAuth2 library - Step 1

Src/GoogleApis/Apis/Requests/Parameters/ParameterUtils.cs

 /*
 Copyright 2013 Google Inc
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
 You may obtain a copy of the License at
 
 http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software
@@ skipping 14 matching lines @@
 namespace Google.Apis.Requests.Parameters
 {
 /// <summary>
 /// Utility class for iterating on <seealso cref="RequestParameterAttribute"
/> properties in a request object.
 /// </summary>
 public static class ParameterUtils
 {
 /// <summary>
 /// Creates a <seealso cref="System.Net.Http.FormUrlEncodedContent"/> wi
th all the specified parameters in·
 /// input request. It uses reflection to iterate over all properties wit
h
 /// <seealso cref="Google.Apis.Util.RequestParameterAttribute"/> attribu
te.

[class, 2013/09/16 23:47:29]

<param> missing

[peleyal, 2013/09/17 15:53:40]

Done.

 /// </summary>
+/// <param name="request">
+/// A request object which contains properties with·
+/// <seealso cref="Google.Apis.Util.RequestParameterAttribute"/> attribu
te. Those properties will be serialized
+/// to the returned <seealso cref="System.Net.Http.FormUrlEncodedContent
"/>.
+/// </param>
+/// <returns>
+/// A <seealso cref="System.Net.Http.FormUrlEncodedContent"/> which cont
ains the all the given object required·
+/// values
+/// </returns>
 public static FormUrlEncodedContent CreateFormUrlEncodedContent(object r
equest)
 {
 IList<KeyValuePair<string, string>> list = new List<KeyValuePair<str
ing, string>>();
 IterateParameters(request, (type, name, value) =>
 {
 list.Add(new KeyValuePair<string, string>(name, value.ToStri
ng()));
 });
 return new FormUrlEncodedContent(list);
 }
 
 /// <summary>

[class, 2013/09/16 23:47:29]

<param missing>

[peleyal, 2013/09/17 15:53:40]

Done.

 /// Creates a parameter dictionary by using reflection to iterate over a
ll properties with
 /// <seealso cref="Google.Apis.Util.RequestParameterAttribute"/> attribu
te.
 /// </summary>
+/// <param name="request">
+/// A request object which contains properties with·
+/// <seealso cref="Google.Apis.Util.RequestParameterAttribute"/> attribu
te. Those properties will be set
+/// in the output dictionary
+/// </param>
 public static IDictionary<string, object> CreateParameterDictionary(obje
ct request)
 {
 var dict = new Dictionary<string, object>();
 IterateParameters(request, (type, name, value) =>
 {
 dict.Add(name, value);
 });
 return dict;
 }
 
 /// <summary>
- /// Creates a parameter dictionary by using reflection to iterate over a
 ll properties with

[class, 2013/09/16 23:47:29]

<param> missing

[peleyal, 2013/09/17 15:53:40]

Done.

+ /// Sets query parameters in the given builder with all all properties w
 ith the
 /// <seealso cref="Google.Apis.Util.RequestParameterAttribute"/> attribu
te.
 /// </summary>
+/// <param name="builder">The request builder</param>
+/// <param name="request">
+/// A request object which contains properties with·
+/// <seealso cref="Google.Apis.Util.RequestParameterAttribute"/> attribu
te. Those properties will be set in the·
+/// given request builder object
+/// </param>
 public static void InitParameters(RequestBuilder builder, object request
)
 {
 IterateParameters(request, (type, name, value) =>
 {
 builder.AddParameter(type, name, value.ToString());
 });
 }
 
 /// <summary>
- /// Iterates over all <seealso cref="RequestParameterAttribute"/> proper
 ties in the request object and invoke 

[class, 2013/09/16 23:47:29]

Iterates over all <seealso cref="RequestParameterAttribute"/> properties in the
request object and **invokes**

[peleyal, 2013/09/17 15:53:40]

Done.

+ /// Iterates over all <seealso cref="RequestParameterAttribute"/> proper
 ties in the request object and invokes
 /// the specified action for each of them.
 /// </summary>
 /// <param name="request">A request object</param>
- /// <param name="action">An action to invoke which gets the parameter ty
 pe, name and it value</param>

[class, 2013/09/16 23:47:29]

Fix plural and add period at end of action param
<param name="action">An action to invoke which gets the parameter type, name and
°°its** value.</param>

[peleyal, 2013/09/17 15:53:40]

Done.

+ /// <param name="action">An action to invoke which gets the parameter ty
 pe, name and its value</param>
 private static void IterateParameters(object request, Action<RequestPara
meterType, string, object> action)
 {
- // use reflection to build the parameter dictionary.

[class, 2013/09/16 23:47:29]

Capitalize use

[peleyal, 2013/09/17 15:53:40]

Done.

+ // Use reflection to build the parameter dictionary.
 foreach (PropertyInfo property in request.GetType().GetProperties(Bi
ndingFlags.Instance |
 BindingFlags.Public))
 {
- // retrieve the RequestParameterAttribute

[class, 2013/09/16 23:47:29]

Capitalize Retrieve and add . at end of comment

[peleyal, 2013/09/17 15:53:40]

Done.

+ // Retrieve the RequestParameterAttribute.
 RequestParameterAttribute attribute =
 property.GetCustomAttributes(typeof(RequestParameterAttribut
e), false).FirstOrDefault() as
 RequestParameterAttribute;
 if (attribute == null)
 {
 continue;
 }
 
- // get the name of this parameter from the attribute, if it does
 n't exist take a lower-case variant of·

[class, 2013/09/16 23:47:29]

Add period and capitol to comment

[peleyal, 2013/09/17 15:53:40]

Done.

- // property name
+ // Get the name of this parameter from the attribute, if it does
 n't exist take a lower-case variant of·
+ // property name.
 string name = attribute.Name ?? property.Name.ToLower();
 
 var propertyType = property.PropertyType;
 var value = property.GetValue(request, null);
 
- // call action with the type name and value

[class, 2013/09/16 23:47:29]

Add period / cap to comment

[peleyal, 2013/09/17 15:53:40]

Done.

+ // Call action with the type name and value.
 if (propertyType.IsValueType || value != null)
 {
 action(attribute.Type, name, value);
 }
 }
 }
 }
 }