added clarity to BaseB2Response Logging

Synapticloop · Synapticloop · commit a2a88642068f · 2016-03-07T23:09:33.000Z
diff --git a/README.md b/README.md
@@ -226,7 +226,7 @@ And now for the dependency
 <dependency>
 	<groupId>synapticloop</groupId>
 	<artifactId>backblaze-b2-java-api</artifactId>
-	<version>v1.2.6</version>
+	<version>v1.2.7</version>
 	<type>jar</type>
 </dependency>
 ```
@@ -256,19 +256,19 @@ and then include the dependency:
 
 ```
 dependencies {
-	runtime(group: 'synapticloop', name: 'backblaze-b2-java-api', version: 'v1.2.6', ext: 'jar')
+	runtime(group: 'synapticloop', name: 'backblaze-b2-java-api', version: 'v1.2.7', ext: 'jar')
 
-	compile(group: 'synapticloop', name: 'backblaze-b2-java-api', version: 'v1.2.6', ext: 'jar')
+	compile(group: 'synapticloop', name: 'backblaze-b2-java-api', version: 'v1.2.7', ext: 'jar')
 }
 ```
 
 or, more simply for versions of gradle greater than 2.4
 
 ```
 dependencies {
-	runtime 'synapticloop:backblaze-b2-java-api:v1.2.6'
+	runtime 'synapticloop:backblaze-b2-java-api:v1.2.7'
 
-	compile 'synapticloop:backblaze-b2-java-api:v1.2.6'
+	compile 'synapticloop:backblaze-b2-java-api:v1.2.7'
 }
 ```
 
diff --git a/build.gradle b/build.gradle
@@ -13,7 +13,7 @@ group = 'synapticloop'
 archivesBaseName = 'backblaze-b2-java-api'
 description = """A java api for the truly excellent backblaze b2 storage service"""
 
-version = 'v1.2.6'
+version = 'v1.2.7'
 
 sourceCompatibility = 1.7
 targetCompatibility = 1.7
diff --git a/src/main/java/synapticloop/b2/response/B2AuthorizeAccountResponse.java b/src/main/java/synapticloop/b2/response/B2AuthorizeAccountResponse.java
@@ -63,7 +63,7 @@ public B2AuthorizeAccountResponse(String json) throws B2ApiException {
 		this.downloadUrl = this.readString(B2ResponseProperties.KEY_DOWNLOAD_URL);
 		this.minimumPartSize = this.readInt(B2ResponseProperties.KEY_MINIMUM_PART_SIZE);
 
-		this.warnOnMissedKeys(LOGGER);
+		this.warnOnMissedKeys();
 	}
 
 	/**
@@ -105,6 +105,9 @@ public B2AuthorizeAccountResponse(String json) throws B2ApiException {
 	 */
 	public int getMinimumPartSize() {return this.minimumPartSize; }
 
+	@Override
+	protected Logger getLogger() { return LOGGER; }
+
 	@Override
 	public String toString() {
 		StringBuilder stringBuilder = new StringBuilder();
diff --git a/src/main/java/synapticloop/b2/response/B2BucketResponse.java b/src/main/java/synapticloop/b2/response/B2BucketResponse.java
@@ -19,6 +19,7 @@
 import org.json.JSONObject;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
+
 import synapticloop.b2.BucketType;
 import synapticloop.b2.exception.B2ApiException;
 
@@ -45,7 +46,7 @@ public B2BucketResponse(String json) throws B2ApiException {
 		this.bucketName = this.readString(B2ResponseProperties.KEY_BUCKET_NAME);
 		this.bucketType = this.readString(B2ResponseProperties.KEY_BUCKET_TYPE);
 
-		this.warnOnMissedKeys(LOGGER);
+		this.warnOnMissedKeys();
 	}
 
 	/**
@@ -63,7 +64,7 @@ public B2BucketResponse(final JSONObject response) throws B2ApiException {
 		this.bucketName = this.readString(B2ResponseProperties.KEY_BUCKET_NAME);
 		this.bucketType = this.readString(B2ResponseProperties.KEY_BUCKET_TYPE);
 
-		this.warnOnMissedKeys(LOGGER);
+		this.warnOnMissedKeys();
 	}
 
 	/**
@@ -94,6 +95,9 @@ public B2BucketResponse(final JSONObject response) throws B2ApiException {
 	 */
 	public BucketType getBucketType() { return BucketType.valueOf(this.bucketType); }
 
+	@Override
+	protected Logger getLogger() { return LOGGER; }
+
 	@Override
 	public String toString() {
 		final StringBuilder sb = new StringBuilder("B2BucketResponse{");
diff --git a/src/main/java/synapticloop/b2/response/B2DeleteFileVersionResponse.java b/src/main/java/synapticloop/b2/response/B2DeleteFileVersionResponse.java
@@ -57,7 +57,7 @@ public B2DeleteFileVersionResponse(String json) throws B2ApiException {
 		this.fileId = this.readString(B2ResponseProperties.KEY_FILE_ID);
 		this.fileName = this.readString(B2ResponseProperties.KEY_FILE_NAME);
 
-		this.warnOnMissedKeys(LOGGER);
+		this.warnOnMissedKeys();
 	}
 
 	/**
@@ -74,6 +74,9 @@ public B2DeleteFileVersionResponse(String json) throws B2ApiException {
 	 */
 	public String getFileName() { return this.fileName; }
 
+	@Override
+	protected Logger getLogger() { return LOGGER; }
+
 	@Override
 	public String toString() {
 		final StringBuilder sb = new StringBuilder("B2DeleteFileVersionResponse{");
diff --git a/src/main/java/synapticloop/b2/response/B2FileInfoResponse.java b/src/main/java/synapticloop/b2/response/B2FileInfoResponse.java
@@ -78,7 +78,7 @@ public B2FileInfoResponse(final JSONObject response) throws B2ApiException {
 		this.size = this.readInt(B2ResponseProperties.KEY_SIZE);
 		this.uploadTimestamp = this.readLong(B2ResponseProperties.KEY_UPLOAD_TIMESTAMP);
 
-		this.warnOnMissedKeys(LOGGER);
+		this.warnOnMissedKeys();
 	}
 
 	/**
@@ -138,6 +138,9 @@ public B2FileInfoResponse(final JSONObject response) throws B2ApiException {
 	 */
 	public long getUploadTimestamp() { return this.uploadTimestamp; }
 
+	@Override
+	protected Logger getLogger() { return LOGGER; }
+
 	@Override
 	public String toString() {
 		final StringBuilder sb = new StringBuilder("B2FileInfoResponse{");
diff --git a/src/main/java/synapticloop/b2/response/B2FileResponse.java b/src/main/java/synapticloop/b2/response/B2FileResponse.java
@@ -69,7 +69,7 @@ public B2FileResponse(String json) throws B2ApiException {
 			}
 		}
 
-		this.warnOnMissedKeys(LOGGER);
+		this.warnOnMissedKeys();
 	}
 
 	/**
@@ -132,6 +132,9 @@ public B2FileResponse(String json) throws B2ApiException {
 	 */
 	public Map<String, String> getFileInfo() { return this.fileInfo; }
 
+	@Override
+	protected Logger getLogger() { return LOGGER; }
+
 	@Override
 	public String toString() {
 		final StringBuilder sb = new StringBuilder("B2FileResponse{");
diff --git a/src/main/java/synapticloop/b2/response/B2GetUploadUrlResponse.java b/src/main/java/synapticloop/b2/response/B2GetUploadUrlResponse.java
@@ -43,7 +43,7 @@ public B2GetUploadUrlResponse(String json) throws B2ApiException {
 		this.uploadUrl = this.readString(B2ResponseProperties.KEY_UPLOAD_URL);
 		this.authorizationToken = this.readString(B2ResponseProperties.KEY_AUTHORIZATION_TOKEN);
 
-		this.warnOnMissedKeys(LOGGER);
+		this.warnOnMissedKeys();
 	}
 
 	/**
@@ -67,6 +67,9 @@ public B2GetUploadUrlResponse(String json) throws B2ApiException {
 	 */
 	public String getAuthorizationToken() { return this.authorizationToken; }
 
+	@Override
+	protected Logger getLogger() { return LOGGER; }
+
 	@Override
 	public String toString() {
 		final StringBuilder sb = new StringBuilder("B2GetUploadUrlResponse{");
diff --git a/src/main/java/synapticloop/b2/response/B2HideFileResponse.java b/src/main/java/synapticloop/b2/response/B2HideFileResponse.java
@@ -71,7 +71,7 @@ public B2HideFileResponse(String json) throws B2ApiException {
 		this.size = this.readInt(B2ResponseProperties.KEY_SIZE);
 		this.uploadTimestamp = this.readLong(B2ResponseProperties.KEY_UPLOAD_TIMESTAMP);
 
-		this.warnOnMissedKeys(LOGGER);
+		this.warnOnMissedKeys();
 	}
 
 	public String getFileId() { return this.fileId; }
@@ -84,6 +84,9 @@ public B2HideFileResponse(String json) throws B2ApiException {
 
 	public long getUploadTimestamp() { return this.uploadTimestamp; }
 
+	@Override
+	protected Logger getLogger() { return LOGGER; }
+
 	@Override
 	public String toString() {
 		final StringBuilder sb = new StringBuilder("B2HideFileResponse{");
@@ -94,4 +97,5 @@ public String toString() {
 		sb.append('}');
 		return sb.toString();
 	}
+
 }
diff --git a/src/main/java/synapticloop/b2/response/B2ListBucketsResponse.java b/src/main/java/synapticloop/b2/response/B2ListBucketsResponse.java
@@ -47,7 +47,7 @@ public B2ListBucketsResponse(final String json) throws B2ApiException {
 			buckets.add(new B2BucketResponse(optJSONArray.optJSONObject(i)));
 		}
 
-		this.warnOnMissedKeys(LOGGER);
+		this.warnOnMissedKeys();
 	}
 
 	/**
@@ -59,6 +59,9 @@ public List<B2BucketResponse> getBuckets() {
 		return buckets;
 	}
 
+	@Override
+	protected Logger getLogger() { return LOGGER; }
+
 	@Override
 	public String toString() {
 		final StringBuilder sb = new StringBuilder("B2ListBucketsResponse{");
diff --git a/src/main/java/synapticloop/b2/response/B2ListFilesResponse.java b/src/main/java/synapticloop/b2/response/B2ListFilesResponse.java
@@ -54,7 +54,7 @@ public B2ListFilesResponse(String json) throws B2ApiException {
 			files.add(new B2FileInfoResponse(filesArray.optJSONObject(i)));
 		}
 
-		this.warnOnMissedKeys(LOGGER);
+		this.warnOnMissedKeys();
 	}
 
 	/**
@@ -80,6 +80,9 @@ public B2ListFilesResponse(String json) throws B2ApiException {
 	 */
 	public List<B2FileInfoResponse> getFiles() { return this.files; }
 
+	@Override
+	protected Logger getLogger() { return LOGGER; }
+
 	@Override
 	public String toString() {
 		final StringBuilder sb = new StringBuilder("B2ListFilesResponse{");
diff --git a/src/main/java/synapticloop/b2/response/BaseB2Response.java b/src/main/java/synapticloop/b2/response/BaseB2Response.java
@@ -22,13 +22,10 @@
 import org.json.JSONException;
 import org.json.JSONObject;
 import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
 
 import synapticloop.b2.exception.B2ApiException;
 
 public abstract class BaseB2Response {
-	private static final Logger LOGGER = LoggerFactory.getLogger(BaseB2Response.class);
-
 	private final JSONObject response;
 
 	/**
@@ -91,7 +88,7 @@ protected String readString(String key) {
 	protected String readString(JSONObject response, String key) {
 		final Object value = response.remove(key);
 		if (null == value || JSONObject.NULL == value) {
-			LOGGER.warn("No field for key {}", key);
+			getLogger().warn("No field for key {}", key);
 			return null;
 		}
 		return value.toString();
@@ -107,7 +104,7 @@ protected String readString(JSONObject response, String key) {
 	protected int readInt(String key) {
 		final Object value = response.remove(key);
 		if (null == value || JSONObject.NULL == value) {
-			LOGGER.warn("No field for key {}", key);
+			getLogger().warn("No field for key {}", key);
 			return -1;
 		}
 		return value instanceof Number ? ((Number) value).intValue() : Integer.parseInt(value.toString());
@@ -123,7 +120,7 @@ protected int readInt(String key) {
 	protected long readLong(String key) {
 		final Object value = response.remove(key);
 		if (null == value || JSONObject.NULL == value) {
-			LOGGER.warn("No field for key {}", key);
+			getLogger().warn("No field for key {}", key);
 			return -1L;
 		}
 		return value instanceof Number ? ((Number) value).longValue() : Long.parseLong(value.toString());
@@ -151,7 +148,7 @@ protected JSONObject readObject(String key) {
 	protected JSONObject readObject(JSONObject response, String key) {
 		final Object value = response.remove(key);
 		if (null == value || JSONObject.NULL == value) {
-			LOGGER.warn("No field for key {}", key);
+			getLogger().warn("No field for key {}", key);
 			return null;
 		}
 		return value instanceof JSONObject ? (JSONObject) value : null;
@@ -167,7 +164,7 @@ protected JSONObject readObject(JSONObject response, String key) {
 	protected JSONArray readObjects(String key) {
 		final Object value = response.remove(key);
 		if (null == value || JSONObject.NULL == value) {
-			LOGGER.warn("No field for key {}", key);
+			getLogger().warn("No field for key {}", key);
 			return null;
 		}
 		return value instanceof JSONArray ? (JSONArray) value : null;
@@ -192,13 +189,20 @@ protected JSONArray readObjects(String key) {
 	 * @param LOGGER     The logger to use
 	 */
 	@SuppressWarnings("rawtypes")
-	protected void warnOnMissedKeys(Logger LOGGER) {
-		if (LOGGER.isWarnEnabled()) {
+	protected void warnOnMissedKeys() {
+		if (getLogger().isWarnEnabled()) {
 			Iterator keys = response.keys();
 			while (keys.hasNext()) {
 				String key = (String) keys.next();
-				LOGGER.warn("Found an unexpected key of '{}' in JSON that is not mapped to a field.", key);
+				getLogger().warn("Found an unexpected key of '{}' in JSON that is not mapped to a field.", key);
 			}
 		}
 	}
+
+	/**
+	 * Get the logger to use for Logging from the base class
+	 * 
+	 * @return The logger to use
+	 */
+	protected abstract Logger getLogger();
 }

Original file line number	Diff line number	Diff line change
`@@ -69,7 +69,7 @@ public B2FileResponse(String json) throws B2ApiException {`
`69`	`69`	`}`
`70`	`70`	`}`
`71`	`71`
`72`		`- this.warnOnMissedKeys(LOGGER);`
	`72`	`+ this.warnOnMissedKeys();`
`73`	`73`	`}`
`74`	`74`
`75`	`75`	`/**`
`@@ -132,6 +132,9 @@ public B2FileResponse(String json) throws B2ApiException {`
`132`	`132`	`*/`
`133`	`133`	`public Map<String, String> getFileInfo() { return this.fileInfo; }`
`134`	`134`
	`135`	`+ @Override`
	`136`	`+ protected Logger getLogger() { return LOGGER; }`
	`137`	`+`
`135`	`138`	`@Override`
`136`	`139`	`public String toString() {`
`137`	`140`	`final StringBuilder sb = new StringBuilder("B2FileResponse{");`
Original file line number	Diff line number	Diff line change
`@@ -71,7 +71,7 @@ public B2HideFileResponse(String json) throws B2ApiException {`
`71`	`71`	`this.size = this.readInt(B2ResponseProperties.KEY_SIZE);`
`72`	`72`	`this.uploadTimestamp = this.readLong(B2ResponseProperties.KEY_UPLOAD_TIMESTAMP);`
`73`	`73`
`74`		`- this.warnOnMissedKeys(LOGGER);`
	`74`	`+ this.warnOnMissedKeys();`
`75`	`75`	`}`
`76`	`76`
`77`	`77`	`public String getFileId() { return this.fileId; }`
`@@ -84,6 +84,9 @@ public B2HideFileResponse(String json) throws B2ApiException {`
`84`	`84`
`85`	`85`	`public long getUploadTimestamp() { return this.uploadTimestamp; }`
`86`	`86`
	`87`	`+ @Override`
	`88`	`+ protected Logger getLogger() { return LOGGER; }`
	`89`	`+`
`87`	`90`	`@Override`
`88`	`91`	`public String toString() {`
`89`	`92`	`final StringBuilder sb = new StringBuilder("B2HideFileResponse{");`
`@@ -94,4 +97,5 @@ public String toString() {`
`94`	`97`	`sb.append('}');`
`95`	`98`	`return sb.toString();`
`96`	`99`	`}`
	`100`	`+`
`97`	`101`	`}`
Original file line number	Diff line number	Diff line change
`@@ -47,7 +47,7 @@ public B2ListBucketsResponse(final String json) throws B2ApiException {`
`47`	`47`	`buckets.add(new B2BucketResponse(optJSONArray.optJSONObject(i)));`
`48`	`48`	`}`
`49`	`49`
`50`		`- this.warnOnMissedKeys(LOGGER);`
	`50`	`+ this.warnOnMissedKeys();`
`51`	`51`	`}`
`52`	`52`
`53`	`53`	`/**`
`@@ -59,6 +59,9 @@ public List<B2BucketResponse> getBuckets() {`
`59`	`59`	`return buckets;`
`60`	`60`	`}`
`61`	`61`
	`62`	`+ @Override`
	`63`	`+ protected Logger getLogger() { return LOGGER; }`
	`64`	`+`
`62`	`65`	`@Override`
`63`	`66`	`public String toString() {`
`64`	`67`	`final StringBuilder sb = new StringBuilder("B2ListBucketsResponse{");`