Feature upsert

src/main/java/com/force/api/ApiResponse.java

@@ -0,0 +1,33 @@
+package com.force.api;
+
+public class ApiResponse {
+
+	private String id;
+	private ApiError[] errors;
+	private boolean success;
+
+	public String getId() {
+		return id;
+	}
+
+	public void setId(String id) {
+		this.id = id;
+	}
+
+	public ApiError[] getErrors() {
+		return errors;
+	}
+
+	public void setErrors(ApiError[] errors) {
+		this.errors = errors;
+	}
+
+	public boolean isSuccess() {
+		return success;
+	}
+
+	public void setSuccess(boolean success) {
+		this.success = success;
+	}
+
+}

src/main/java/com/force/api/CreateResponse.java

@@ -1,27 +1,5 @@
 package com.force.api;
 
-public class CreateResponse {
-	String id;
-	ApiError[] errors;
-	boolean success;
-	public String getId() {
-		return id;
-	}
-	public void setId(String id) {
-		this.id = id;
-	}
-	public ApiError[] getErrors() {
-		return errors;
-	}
-	public void setErrors(ApiError[] errors) {
-		this.errors = errors;
-	}
-	public boolean isSuccess() {
-		return success;
-	}
-	public void setSuccess(boolean success) {
-		this.success = success;
-	}
+public class CreateResponse extends ApiResponse {
 
-
 }

src/main/java/com/force/api/ForceApi.java

@@ -279,6 +279,44 @@ public CreateOrUpdateResult createOrUpdateSObject(String type, String externalId
 		}
 	}
 
+	public UpsertResult upsertSObject(String type, String externalIdField, String externalIdValue, Object sObject) {
+		try {
+			String method = externalIdValue != null ? "?_HttpMethod=PATCH" : "";
+			String idValue = externalIdValue != null ? "/" + URLEncoder.encode(externalIdValue, "UTF-8") : "";
+			HttpResponse res =
+					apiRequest(new HttpRequest()
+							.url(uriBase() + "/sobjects/" + type + "/" + externalIdField + idValue + method)
+							.method("POST")
+							.header("Accept", "application/json")
+							.header("Content-Type", "application/json")
+							.content(jsonMapper.writeValueAsBytes(sObject))
+					);
+			if (res.getResponseCode() == 201) {
+				UpsertResult upsertResult = jsonMapper.readValue(res.getStream(), UpsertResult.class);
+				upsertResult.setStatus(UpsertStatus.INSERTED);
+				return upsertResult;
+			} else if (res.getResponseCode() == 204) {
+				UpsertResult upsertResult = new UpsertResult();
+				if ("Id".equals(externalIdField)) {
+					upsertResult.setId(externalIdValue);
+				}
+				upsertResult.setStatus(UpsertStatus.UPDATED);
+				return upsertResult;
+			} else {
+				logger.debug("Code: {}", res.getResponseCode());
+				logger.debug("Message: {}", res.getString());
+				throw new RuntimeException();
+			}
+
+		} catch (JsonGenerationException e) {
+			throw new ResourceException(e);
+		} catch (JsonMappingException e) {
+			throw new ResourceException(e);
+		} catch (IOException e) {
+			throw new ResourceException(e);
+		}
+	}
+
 	public <T> QueryResult<T> query(String query, Class<T> clazz) {
         try {
             return queryAny(uriBase() + "/query/?q=" + URLEncoder.encode(query, "UTF-8"), clazz);
@@ -416,11 +454,11 @@ public DescribeSObject describeSObject(String sobject) {
 			throw new ResourceException(e);
 		}
 	}
-	
+
 	private final String uriBase() {
 		return(session.getApiEndpoint()+"/services/data/"+config.getApiVersionString());
 	}
-	
+
 	private final HttpResponse apiRequest(HttpRequest req) {
 		req.setAuthorization("Bearer "+session.getAccessToken());
 		req.setRequestTimeout(this.config.getRequestTimeout());
@@ -454,17 +492,17 @@ private final HttpResponse apiRequest(HttpRequest req) {
 			return res;
 		}
 	}
-	
+
 	/**
 	 * Normalizes the JSON response in case it contains responses from
 	 * relationship queries. For e.g.
 	 *
 	 * <code>
 	 * Query:
 	 *   select Id,Name,(select Id,Email,FirstName from Contacts) from Account
-	 *   
+	 *
 	 * Json Response Returned:
-	 * 
+	 *
 	 * {
 	 *	  "totalSize" : 1,
 	 *	  "done" : true,
@@ -491,9 +529,9 @@ private final HttpResponse apiRequest(HttpRequest req) {
 	 *	  } ]
 	 *	}
 	 * </code>
-	 * 
+	 *
 	 * Will get normalized to:
-	 * 
+	 *
 	 * <code>
 	 * {
 	 *	  "totalSize" : 1,
@@ -515,12 +553,12 @@ private final HttpResponse apiRequest(HttpRequest req) {
 	 *	        "FirstName" : "John"
 	 *	    } ]
 	 *	  } ]
-	 *	} 
+	 *	}
 	 * </code
-	 * 
+	 *
 	 * This allows Jackson to deserialize the response into it's corresponding Object representation
-	 * 
-	 * @param node 
+	 *
+	 * @param node
 	 * @return
 	 */
 	private final JsonNode normalizeCompositeResponse(JsonNode node){
@@ -531,14 +569,14 @@ private final JsonNode normalizeCompositeResponse(JsonNode node){
 			currNode = elements.next();
 
 			newNode.set(currNode.getKey(),
-						(		currNode.getValue().isObject() && 
+						(		currNode.getValue().isObject() &&
 								currNode.getValue().get("records")!=null
 						)?
 								currNode.getValue().get("records"):
 									currNode.getValue()
 					);
 		}
 		return newNode;
-		
+
 	}
 }

src/main/java/com/force/api/UpsertResult.java

@@ -0,0 +1,15 @@
+package com.force.api;
+
+
+public class UpsertResult extends ApiResponse {
+
+    private UpsertStatus status;
+
+    public UpsertStatus getStatus() {
+        return status;
+    }
+
+    public void setStatus(UpsertStatus status) {
+        this.status = status;
+    }
+}

src/main/java/com/force/api/UpsertStatus.java

@@ -0,0 +1,8 @@
+package com.force.api;
+
+public enum UpsertStatus {
+
+    INSERTED,
+    UPDATED
+
+}