Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance. Project price only 1 $
You can buy this project and download/modify it how often you want.
package org.kie.services.client.api;
import java.net.MalformedURLException;
import java.net.URISyntaxException;
import java.net.URL;
import org.jboss.resteasy.client.ClientRequest;
import org.jboss.resteasy.client.ClientRequestFactory;
import org.kie.services.client.api.command.RemoteConfiguration;
/**
* This class is meant to help users help interact with the (kie-wb or business-central) REST api by creating
* either {@link ClientRequest} (REST request) instances or {@link ClientRequestFactory} instances to
* create {@link ClientRequest} instances.
*/
public class RestRequestHelper extends RemoteConfiguration {
private ClientRequestFactory requestFactory;
private static int DEFAULT_TIMEOUT = 5;
/**
* Helper methods
*/
private URL addRestToPath(URL origUrl) {
StringBuilder urlString = new StringBuilder(origUrl.toExternalForm());
if (!urlString.toString().endsWith("/")) {
urlString.append("/");
}
urlString.append("rest/");
URL origPlusRestUrl = convertStringToUrl(urlString.toString());
return origPlusRestUrl;
}
private static URL convertStringToUrl(String urlString) {
URL realUrl;
try {
realUrl = new URL(urlString);
} catch (MalformedURLException murle) {
throw new IllegalArgumentException("URL (" + urlString + ") is incorrectly formatted: " + murle.getMessage(), murle);
}
return realUrl;
}
/**
* Creates a {@link RestRequestHelper} instance.
*
* @param serverPortUrl in the format of "http://server:port/"
* @param username The username (registered on the kie-wb or business-central server)
* @param password The password associated with the username.
* @param timeout The timeout used for REST requests.
*/
public RestRequestHelper(URL serverPortUrl, String username, String password, int timeout) {
super();
URL serverPlusRestUrl = addRestToPath(serverPortUrl);
this.requestFactory = createAuthenticatingRequestFactory(serverPlusRestUrl, username, password, timeout);
}
/**
* Creates a {@link RestRequestHelper} instance. A default timeout of 5 seconds is used for REST requests.
*
* @param serverPortUrl in the format of "http://server:port/"
* @param username The username (registered on the kie-wb or business-central server)
* @param password The password associated with the username.
*
*/
public RestRequestHelper(URL serverPortUrl, String username, String password) {
super();
URL serverPlusRestUrl = addRestToPath(serverPortUrl);
this.requestFactory = createAuthenticatingRequestFactory(serverPlusRestUrl, username, password, DEFAULT_TIMEOUT);
}
/**
* Creates a REST request for the given REST operation URL.
*
* For example, if you wanted to create a REST request for the following URL:
* Then you could call this method as follows:
* restRequestHelperInstance.createRestRequest( "runtime/test-deploy/process/org.jbpm:HR:1.0/start" );
*
* @param restOperationUrl The URL of the REST operation, exculding the server/port and "/rest" base.
* @return A {@link ClientRequest} instance that authenticates based on the username/password arguments
* given to the constructor of this {@link RestRequestHelper} instance.
*/
public ClientRequest createRestRequest(String restOperationUrl) {
if (restOperationUrl.startsWith("/")) {
restOperationUrl = restOperationUrl.substring(1);
}
return this.requestFactory.createRelativeRequest(restOperationUrl);
}
/**
* This method creates a {@link ClientRequestFactory} instance that can be used to create {@link ClientRequest} instances
* that will authenticate against a kie-wb or business-central server using the given username and password.
*
* The {@link ClientRequestFactory} instance can then be used like this to create {@link ClientRequest} REST request instances:
*
*
* @param restBaseUrl The base URL of the rest server, which will have this format: "http://server[:port]/rest".
* @param username The username to use when authenticating.
* @param password The password to use when authenticating.
* @param timeout The timeout to use for the REST request.
* @return A {@link ClientRequestFactory} in order to create REST request ( {@link ClientRequest} ) instances
* to interact with the REST api.
*/
public static ClientRequestFactory createRestRequestFactory(String restBaseUrlString, String username, String password, int timeout) {
URL url = convertStringToUrl(restBaseUrlString);
return createAuthenticatingRequestFactory(url, username, password, timeout);
}
/**
* See {@link RestRequestHelper#createRestRequestFactory(String, String, String, int)}. This method uses a default timeout of
* 5 seconds, whereas the referred method allows users to pass the value for the timeout.
*
* @param restBaseUrlString The base URL of the rest server, which will have this format: "http://server[:port]/rest".
* @param username The username to use when authenticating.
* @param password The password to use when authenticating.
* @return A {@link ClientRequestFactory} in order to create REST request ( {@link ClientRequest} ) instances
* to interact with the REST api.
*/
public static ClientRequestFactory createRestRequestFactory(String restBaseUrlString, String username, String password) {
URL url = convertStringToUrl(restBaseUrlString);
return createAuthenticatingRequestFactory(url, username, password, DEFAULT_TIMEOUT);
}
/**
* See {@link RestRequestHelper#createRestRequestFactory(String, String, String, int)}. This method uses a default timeout of
* 5 seconds, whereas the referred method allows users to pass the value for the timeout.
*
* @param restBaseUrl The base URL of the rest server, which will have this format: "http://server[:port]/rest".
* @param username The username to use when authenticating.
* @param password The password to use when authenticating.
* @return A {@link ClientRequestFactory} in order to create REST request ( {@link ClientRequest} ) instances
* to interact with the REST api.
*/
public static ClientRequestFactory createRestRequestFactory(URL restBaseUrl, String username, String password) {
return createAuthenticatingRequestFactory(restBaseUrl, username, password, DEFAULT_TIMEOUT);
}
}
