Uploading files to Oracle Document Cloud Service using SOA

This blog provides a quick tip for implementing file upload into Oracle Document Cloud Service (DOCS) using java in Oracle SOA and Oracle SOA Cloud Service(SOACS)

The DOCS upload REST service requires POSTing of multipart form, a feature that is currently unavailable in the REST cloud adapter. This POST request to upload a file contains 2 body parts. The first being a json payload and the second containing the actual file content.

The request format looks as shown here in the Oracle Documents Cloud Service REST API Reference.

Content-Type: multipart/form-data; boundary=---1234567890

-----1234567890
Content-Disposition: form-data; name="parameters"
Content-Type: application/json
{
"parentID":"FB4CD874EF94CD2CC1B60B72T0000000000100000001"
}
-----1234567890
Content-Disposition: form-data; name="primaryFile"; filename="example.txt"
Content-Type: text/plain
 
<File Content>
-----1234567890--

The section below shows a java embedded block of code that can be used within a BPEL process to achieve the file upload. This can be used in Oracle SOA and SOACS – BPEL composites. A valid DOCS endpoint, credentials for authorization, and a GUID of the folder location for the file upload are required to execute this REST call.
In this sample, a pdf document file is being uploaded into DOCS. The media type should be appropriately changed for other content formats.
Also, It is recommended to access the authorization credentials from a credential store when developing for production deployments. This section is only intended as a demo.

com.sun.jersey.api.client.Client client = com.sun.jersey.api.client.Client.create(); 
com.sun.jersey.api.client.WebResource webResource = client.resource("https://xxxx-yyyy.documents.zome.oraclecloud.com/documents/api/1.1/files/data"); 
com.sun.jersey.api.client.filter.HTTPBasicAuthFilter basicAuth = new com.sun.jersey.api.client.filter.HTTPBasicAuthFilter("username", "password"); 
client.addFilter(basicAuth);
;
com.sun.jersey.multipart.FormDataMultiPart multiform = new com.sun.jersey.multipart.FormDataMultiPart(); 
String DocCSFolderID = "{'parentID' : 'F1B2DDE55E4606D2B4718FDE2C1A41A800FD957B38C9'}";
com.sun.jersey.multipart.FormDataBodyPart formPart = new com.sun.jersey.multipart.FormDataBodyPart("parameters", DocCSFolderID, javax.ws.rs.core.MediaType.APPLICATION_JSON_TYPE);
com.sun.jersey.multipart.file.FileDataBodyPart filePart = new com.sun.jersey.multipart.file.FileDataBodyPart("primaryFile", new java.io.File("C:\\temp\\SampleDoc.pdf") , javax.ws.rs.core.MediaType.APPLICATION_OCTET_STREAM_TYPE);
multiform.bodyPart(formPart);
multiform.bodyPart(filePart); 

String response = webResource.type(javax.ws.rs.core.MediaType.MULTIPART_FORM_DATA_TYPE).accept(javax.ws.rs.core.MediaType.APPLICATION_JSON_TYPE).post(String.class, multiform);

Note that the REST cloud adapter can be used to interact with DOCS for most of the REST API defined here. The above exception is only for file upload and few other operations which require multipart forms. The REST cloud adapter is being enhanced to add multipart/form-data support in the near future.
Once that is available, the file upload into Oracle Document Cloud Service can also be achieved using the adapter within Oracle Integration Cloud Service (ICS), Oracle SOA, and SOACS.

All content listed on this page is the property of Oracle Corp. Redistribution not allowed without written permission