org.labkey.remoteapi.PostCommand Maven / Gradle / Ivy
Show all versions of labkey-client-api Show documentation
/*
* Copyright (c) 2008-2014 LabKey Corporation
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.labkey.remoteapi;
import org.apache.hc.client5.http.classic.methods.HttpPost;
import org.apache.hc.client5.http.classic.methods.HttpUriRequest;
import org.apache.hc.core5.http.ContentType;
import org.apache.hc.core5.http.io.entity.StringEntity;
import org.json.JSONObject;
import java.net.URI;
/**
* Base class for all commands that needs to post data to the server,
* rather than providing parameters in the query string.
*
* Client code will not typically use this class directly, but will
* instead use one of the classes that extend this class (e.g.,
* {@link org.labkey.remoteapi.query.UpdateRowsCommand}).
*
* However, if future versions of the LabKey Server expose new HTTP APIs requiring a POST
* that are not yet supported with a specialized class in this library,
* the developer may still invoke these APIs by creating an instance of the
* PostCommand object directly, providing the controller and action name for
* the new API. The post body may then be supplied by overriding the
* {@link #getJsonObject()} method, returning the JSON object to post.
*/
public class PostCommand extends Command
{
private JSONObject _jsonObject = null;
/**
* Constructs a new PostCommand given a controller and action name.
* @param controllerName The controller name.
* @param actionName The action name.
*/
public PostCommand(String controllerName, String actionName)
{
super(controllerName, actionName);
}
public PostCommand(PostCommand source)
{
super(source);
if (null != source.getJsonObject())
{
// Convert to String and back is the easiest way to get a deep copy
_jsonObject = new JSONObject(source.getJsonObject().toString());
}
}
/**
* Returns the JSON object to post, or null if the JSON object
* has not yet been set. Override this method to provide the
* JSON object dynamically.
* @return The JSON object to post.
*/
public JSONObject getJsonObject()
{
return _jsonObject;
}
/**
* Sets the JSON object to post.
* @param jsonObject The JSON object to post
*/
public void setJsonObject(JSONObject jsonObject)
{
_jsonObject = jsonObject;
}
/**
* Overrides {@link Command#createRequest(URI)} to create an
* {@link HttpPost} object.
*
* Override this method if your post command sends something other
* than JSON in the post body. In your override, create the PostMethod
* and set the RequestEntity appropriately.
* @return The PostMethod object.
*/
@Override
protected HttpUriRequest createRequest(URI uri)
{
HttpPost request = new HttpPost(uri);
//set the post body based on the supplied JSON object
JSONObject json = getJsonObject();
if (null != json)
{
if (!json.has(CommonParameters.apiVersion.name()) && getRequiredVersion() > 0)
json.put(CommonParameters.apiVersion.name(), getRequiredVersion());
request.setEntity(new StringEntity(json.toString(), ContentType.APPLICATION_JSON));
}
return request;
}
}