Updated documentation on arrays on RequestParams, replaced for with foreach, better debugging of file arrays in toString(), android-async-http#862

Author: smarek

library/src/main/java/com/loopj/android/http/RequestParams.java

@@ -68,10 +68,10 @@
  * List<String> list = new ArrayList<String>(); // Ordered collection
  * list.add("Java");
  * list.add("C");
- * params.put("languages", list); // url params: "languages[]=Java&languages[]=C"
+ * params.put("languages", list); // url params: "languages[0]=Java&languages[1]=C"
  *
  * String[] colors = { "blue", "yellow" }; // Ordered collection
- * params.put("colors", colors); // url params: "colors[]=blue&colors[]=yellow"
+ * params.put("colors", colors); // url params: "colors[0]=blue&colors[1]=yellow"
  *
  * File[] files = { new File("pic.jpg"), new File("pic1.jpg") }; // Ordered collection
  * params.put("files", files); // url params: "files[]=pic.jpg&files[]=pic1.jpg"
@@ -228,11 +228,11 @@ public void put(String key, File files[], String contentType, String customFileN
 
         if (key != null) {
             List<FileWrapper> fileWrappers = new ArrayList<FileWrapper>();
-            for (int i = 0; i < files.length; i++) {
-                if (files[i] == null || !files[i].exists()) {
+            for (File file : files) {
+                if (file == null || !file.exists()) {
                     throw new FileNotFoundException();
                 }
-                fileWrappers.add(new FileWrapper(files[i], contentType, customFileName));
+                fileWrappers.add(new FileWrapper(file, contentType, customFileName));
             }
             fileArrayParams.put(key, fileWrappers);
         }
@@ -460,7 +460,7 @@ public String toString() {
 
             result.append(entry.getKey());
             result.append("=");
-            result.append("FILE");
+            result.append("FILES(SIZE=").append(entry.getValue().size()).append(")");
         }
 
         List<BasicNameValuePair> params = getParamsList(null, urlParamsWithObjects);