Renaming and documenting the new HttpHeaders configuration item (ACRA#76

).

src/main/java/org/acra/ACRAConfiguration.java

@@ -15,13 +15,6 @@
  */
 package org.acra;
 
-import org.acra.annotation.ReportsCrashes;
-import org.acra.sender.HttpSender.Method;
-import org.acra.sender.HttpSender.Type;
-
-import java.lang.annotation.Annotation;
-import java.util.Map;
-
 import static org.acra.ACRAConstants.DEFAULT_APPLICATION_LOGFILE;
 import static org.acra.ACRAConstants.DEFAULT_APPLICATION_LOGFILE_LINES;
 import static org.acra.ACRAConstants.DEFAULT_CONNECTION_TIMEOUT;
@@ -44,6 +37,14 @@
 import static org.acra.ACRAConstants.DEFAULT_STRING_VALUE;
 import static org.acra.ACRAConstants.NULL_VALUE;
 
+import java.lang.annotation.Annotation;
+import java.util.Map;
+
+import org.acra.annotation.ReportsCrashes;
+import org.acra.sender.HttpSender;
+import org.acra.sender.HttpSender.Method;
+import org.acra.sender.HttpSender.Type;
+
 /**
  * This class is to be used if you need to apply dynamic settings. This is
  * needed for example when using ACRA in an Android Library Project since ADT
@@ -101,16 +102,30 @@ public class ACRAConfiguration implements ReportsCrashes {
     private Boolean mDisableSSLCertValidation = null;
     private Method mHttpMethod = null;
     private Type mReportType = null;
-    private Map<String,String> mHeaders;
+    private Map<String, String> mHttpHeaders;
 
-    public void setHeaders(Map<String,String> headers) {
-        this.mHeaders = headers;
+    /**
+     * Set custom HTTP headers to be sent by the provided {@link HttpSender}.
+     * This should be used also by third party senders.
+     * 
+     * @param headers
+     *            A map associating HTTP header names to their values.
+     */
+    public void setHttpHeaders(Map<String, String> headers) {
+        this.mHttpHeaders = headers;
     }
 
-    public Map<String,String> getHeaders() {
-        return mHeaders;
+    /**
+     * Retrieve HTTP headers defined by the application developer. These should
+     * be added to requests sent by any third-party sender (over HTTP of
+     * course).
+     * 
+     * @return A map associating http header names to their values.
+     */
+    public Map<String, String> getHttpHeaders() {
+        return mHttpHeaders;
     }
-    
+
     /**
      * @param additionalDropboxTags
      *            the additionalDropboxTags to set

src/main/java/org/acra/sender/HttpSender.java

@@ -195,7 +195,7 @@ public void send(CrashReportData report) throws ReportSenderException {
             request.setMaxNrRetries(ACRA.getConfig().maxNumberOfRequestRetries());
             request.setLogin(login);
             request.setPassword(password);
-            request.setHeaders(ACRA.getConfig().getHeaders());
+            request.setHeaders(ACRA.getConfig().getHttpHeaders());
 
             String reportAsString = "";