ServiceCall.java [src/java/utils] Revision: default Date:
/*
* $Id$
*
* This file is part of the Cloud Services Integration Platform (CSIP),
* a Model-as-a-Service framework, API, and application suite.
*
* 2012-2017, OMSLab, Colorado State University.
*
* OMSLab licenses this file to you under the MIT license.
* See the LICENSE file in the project root for more information.
*/
package utils;
import csip.ServiceException;
import org.codehaus.jettison.json.JSONArray;
import org.codehaus.jettison.json.JSONException;
import org.codehaus.jettison.json.JSONObject;
/**
*
* @author <a href="mailto:shaun.case@colostate.edu">Shaun Case</a>
*/
abstract public class ServiceCall extends csip.Client {
protected JSONObject request;
protected JSONObject results = null;
protected JSONObject requestMetainfoObject = null;
protected JSONObject resultMetaInfoObject = null;
protected JSONArray callResultSection = null;
protected String metaError = "";
protected String URI;
protected String errorPrefix="";
public ServiceCall(String URI) {
super();
this.URI = URI;
}
public void call() throws ServiceException {
try {
execPost();
} catch (ServiceException ex) {
throw new ServiceException((errorPrefix.isEmpty() ? "" : (errorPrefix + ": ")) + ex.getMessage(), ex);
}
}
protected void parseResults() throws ServiceException {
// Error checking has already been done on these results.
// If we get to this function, no further error
// checking is necessary, except to look at the "results" array in the output, if desired.
if (null == callResultSection) {
throw new ServiceException((errorPrefix.isEmpty() ? "" : (errorPrefix + ": ")) + "Cannot find results in the call to " + this.URI + " .");
}
}
abstract protected void createRequest() throws ServiceException;
public String getMetaError() {
return metaError;
}
public JSONObject getRequest() {
return request;
}
public JSONObject getResults() {
return results;
}
public JSONObject getReturnMetainfo() {
return resultMetaInfoObject;
}
public JSONArray getResultSection() {
return callResultSection;
}
public void setRequest(String request) throws JSONException, ServiceException {
if ((null != request) && (!request.isEmpty())) {
this.request = new JSONObject(request);
} else {
throw new ServiceException((errorPrefix.isEmpty() ? "" : (errorPrefix + ": ")) + "Attempt to set request data with empty string.");
}
}
public void setRequest(JSONObject request) throws ServiceException {
if ((null != request) && (request.length() > 0)) {
this.request = request;
} else {
throw new ServiceException((errorPrefix.isEmpty() ? "" : (errorPrefix + ": ")) + "Attempt to set request data with empty JSONObject.");
}
}
public void setURI(String URI) throws ServiceException {
if ((null != URI) && (!URI.isEmpty())) {
this.URI = URI;
} else {
throw new ServiceException((errorPrefix.isEmpty() ? "" : (errorPrefix + ": ")) + "Attempt to set URI with empty string.");
}
}
private void checkErrors() throws ServiceException {
try {
if ((null == results) || (results.length() <= 0)) {
throw new ServiceException((errorPrefix.isEmpty() ? "" : (errorPrefix + ": ")) + "No data was returned from " + URI + " for this request. ");
}
resultMetaInfoObject = results.getJSONObject("metainfo");
metaError = resultMetaInfoObject.optString("error", "");
if ((null != metaError) && (!metaError.isEmpty())) {
throw new ServiceException((errorPrefix.isEmpty() ? "" : (errorPrefix + ": ")) + "Service Call failed with error: " + metaError);
}
callResultSection = this.results.optJSONArray("result");
} catch (JSONException ex) {
throw new ServiceException((errorPrefix.isEmpty() ? "" : (errorPrefix + ": ")) + "Missing metainfo in return data. ", ex);
}
}
protected void throwServiceCallException(String message) throws ServiceException {
throw new ServiceException((errorPrefix.isEmpty() ? "" : (errorPrefix + ": ")) + message);
}
protected void throwServiceCallException(String message, Exception ex) throws ServiceException {
throw new ServiceException((errorPrefix.isEmpty() ? "" : (errorPrefix + ": ")) + message + ex.getMessage(), ex);
}
protected final void execPost() throws ServiceException {
createRequest();
try {
results = super.doPOST(URI, request);
} catch (Exception ex) {
throw new ServiceException((errorPrefix.isEmpty() ? "" : (errorPrefix + ": ")) + "Error making a connection to that location: " + URI + ". " + ex.getMessage(), ex);
}
checkErrors();
parseResults();
}
}