Wikiadmin: Created page with "FORCETOC {{RatingArticle}} {{Languages | Documentation_Style_Guide}} == Objective == The objective of this article it to provide the necessary steps to prepare a Java clas..."

2021-12-15T07:00:04Z

Created page with "__FORCETOC__ {{RatingArticle}} {{Languages | Documentation_Style_Guide}} == Objective == The objective of this article it to provide the necessary steps to prepare a Java clas..."

New page

__FORCETOC__
{{RatingArticle}}
{{Languages | Documentation_Style_Guide}}
== Objective ==
The objective of this article it to provide the necessary steps to prepare a Java class so it is possible to call Openbravo web services from this class.

== Recommended articles ==
Before reading this guide, we recommend that you take some time to get further information about the REST webservice concept:

*[[ERP_2.50:Developers_Guide/Concepts/XML_REST_Web_Services | XML REST web services]]

== Execution Steps ==

=== Background ===

To call an '''Openbravo Webservice''' from a Java class we have to make use of several classes that provide the proper Java API to create a HTTP connection via the webservice's URL and to use classes of the '''java.io package''' that allow to read the data streams. Furthermore we can optionally use some classes that ease processing the results that are returned in XML format in case of the '''XML REST''' type webservices, because they allow to get, parse and validate an XML document[http://www.saxproject.org/].

=== Example Code ===

Openbravo has a '''test''' java class that exemplifies the above. This class is '''"BaseWSTest.java"''' and it is located inside the directory '''''"src-test/org/openbravo/test/webservice"'''''. To make a webservice request we have the '''"createConnection()"''' method which uses the httpURLConnection class to make a request to a webservice by using the specific command parameter and specifying the credentials (username/password).

<source lang="java">protected HttpURLConnection createConnection(String wsPart, String method) throws Exception {
Authenticator.setDefault(new Authenticator() {
@Override
protected PasswordAuthentication getPasswordAuthentication() {
return new PasswordAuthentication(LOGIN, PWD.toCharArray());
}
});
log.debug(method + ": " + getOpenbravoURL() + wsPart);
final URL url = new URL(getOpenbravoURL() + wsPart + "&basicAuthentication=true");
final HttpURLConnection hc = (HttpURLConnection) url.openConnection();
hc.setRequestMethod(method);
hc.setAllowUserInteraction(false);
hc.setDefaultUseCaches(false);
hc.setDoOutput(true);
hc.setDoInput(true);
hc.setInstanceFollowRedirects(true);
hc.setUseCaches(false);
hc.setRequestProperty("Content-Type", "text/xml");
return hc;
}
</source>
Note: this sample code uses basic authentication, see below for more details.

Using this function as our base, we will implement other methods for the other HTTP comamnds:
'''POST, PUT, GET and DELETE'''. Furthermore, this class uses the '''org.xml.sax library''' to parse the XML results that will be returned after our HTTP request, which we refered to before. For example, the '''GET''' request:

<source lang="java">protected String doTestGetRequest(String wsPart, String testContent, int responseCode,boolean validate) {
try {
final HttpURLConnection hc = createConnection(wsPart, "GET");
hc.connect();
final SAXReader sr = new SAXReader();
final InputStream is = hc.getInputStream();
final StringBuilder sb = new StringBuilder();
BufferedReader reader = new BufferedReader(new InputStreamReader(is, "UTF-8"));
String line;
while ((line = reader.readLine()) != null) {
sb.append(line).append("\n");
}
try {
final Document doc = sr.read(new StringReader(sb.toString()));
final String content = XMLUtil.getInstance().toString(doc);
if (testContent != null && content.indexOf(testContent) == -1) {
log.debug(content);
fail();
}
assertEquals(responseCode, hc.getResponseCode());
is.close();
// do not validate the xml schema itself, this results in infinite loops
if (validate) {
validateXML(content);
}
return content;
} catch (Exception e) {
log.debug(sb.toString());
throw e;
}
} catch (final Exception e) {
throw new OBException("Exception when executing ws: " + wsPart, e);
}
}
</source>
Thus we can utilize this class as the base for our development and implement the adaptations that we consider necessary. Using this class, we can implement calls to the webservices of your choice by simply specifying its path, that will be formed with the Openbravo URL ('''getOpenbravoURL()''') plus the webservice part ('''wsPart''').

== Other Aspects ==

=== Login and Security ===

Openbravo general webservices provides the same login and security control as the [[XML_REST_Web_Services#Login_and_Security| XML REST]] webservice.

=== Basic Authentication: two ways to do it ===

The above sample code shows one way of implementing basic authentication:
<source lang="java"> Authenticator.setDefault(new Authenticator() {
@Override
protected PasswordAuthentication getPasswordAuthentication() {
return new PasswordAuthentication(getLogin(), getPassword().toCharArray());
}
});
</source>
This approach will need two requests. The first one will fail with 401, return to the caller/client and then call the getPasswordAuthentication method above for a second request with credentials. As two requests are needed for this authentication it is less useful for high frequency calls. '''To make this type of approach work in Openbravo code it is required to pass in the parameter 'basicAuthentication=true' in the request url.'''

Another approach to set credentials in the request header like this, this only requires one request as Openbravo will directly find the authentication information and will not throw a 401:
<source lang="java">
String userpass = getLogin() + ":" + getPassword();
String basicAuth = "Basic " + new String(new Base64().encode(userpass.getBytes()));
hc.setRequestProperty("Authorization", basicAuth);
</source>

=== High Frequency - stateless ===

Client side code which calls webservices will typically not maintain the session cookie of the server. This means that every webservice request can create a new http session on the receiving server. This is not adviced for high frequency webservices. The implementor of the webservice within the Openbravo system can force the call being stateless. But the caller can also achieve this by passing a parameter. See [[How_to_create_a_new_REST_webservice#Stateless_Webservice_Requests_-_HTTP_Session|here]] for more details.

[[Category:HowTo]]

How To Call An Openbravo Webservice From Java - Revision history

Wikiadmin: Created page with "__FORCETOC__ {{RatingArticle}} {{Languages | Documentation_Style_Guide}} == Objective == The objective of this article it to provide the necessary steps to prepare a Java clas..."

Wikiadmin: Created page with "FORCETOC {{RatingArticle}} {{Languages | Documentation_Style_Guide}} == Objective == The objective of this article it to provide the necessary steps to prepare a Java clas..."