Most WebCenter services are available over REST access. In this example app we will try to connect to our development Spaces instance and get the list of spaces for the user.
The REST API supports two kind of different authentication, depending where you use the Java code. If you are creating a taskflow to be deployed on same domain of the spaces node, you should use "OIT" auth, this kind of auth does not need the user password on each request to the server.
Instead, if your code is outside of the weblogic domain, you must send (user + password) on each request.
This sample app have a boolean flag to enable "development-mode" that means connection from outside of weblogic domain (for example my local JDeveloper).
Keep in mind that on each request you should have the URL access to your REST API, to generate that URL you need before the userToken.
//Get the client connnection
RESTUtils rest = new RESTUtils();
rest.setDevelopmentMode(true);
//Get weblogic user token
String userToken = rest.getUserToken();
//Creation of endpoint URL
RESTUtils rest = new RESTUtils();
rest.setDevelopmentMode(true);
//Get weblogic user token
String userToken = rest.getUserToken();
//Creation of endpoint URL
//Sample URL: http://owc:8888/rest/api/spaces?utoken=FMgUQjBKZ96NGgwGdlZrX-WJACJ4_w**
URL endpoint = new URL(RESOURCE_INDEX + UTOKEN + userToken);
//Establishing connection
HttpURLConnection connection = rest.getConnection(endpoint);
URL endpoint = new URL(RESOURCE_INDEX + UTOKEN + userToken);
//Establishing connection
HttpURLConnection connection = rest.getConnection(endpoint);
This is the sample output of the app after executing the class WCSpaces.java
5-sep-2012 10:34:33 webcenter.rest.RESTUtils getUserToken
INFO: Obtaining user token
25-sep-2012 10:34:33 webcenter.rest.RESTUtils getConnection
INFO: We are connecting in development mode
25-sep-2012 10:34:33 webcenter.rest.RESTUtils getConnection
INFO: Auth sent:Basic d2VibG9naWM6T3JhY2xlMTFn
25-sep-2012 10:34:33 webcenter.rest.RESTUtils getConnection
INFO: Finished development connection to http://owc:8888/rest/api/resourceIndex
25-sep-2012 10:34:33 webcenter.rest.RESTUtils getUserToken
INFO: Obtained token:FMgUQjBKZ96NGgwGdlZrX-WJACJ4_w**
25-sep-2012 10:34:33 webcenter.rest.RESTUtils getConnection
INFO: We are connecting in development mode
25-sep-2012 10:34:33 webcenter.rest.RESTUtils getConnection
INFO: Auth sent:Basic d2VibG9naWM6T3JhY2xlMTFn
25-sep-2012 10:34:33 webcenter.rest.RESTUtils getConnection
INFO: Finished development connection to http://owc:8888/rest/api/spaces?utoken=FMgUQjBKZ96NGgwGdlZrX-WJACJ4_w**
25-sep-2012 10:34:33 webcenter.rest.WCSpaces getSpaces
INFO: Space displayName:blog
25-sep-2012 10:34:33 webcenter.rest.WCSpaces getSpaces
INFO: Space displayName:test
Process exited with exit code 0.
As you see, both "displayName" of the spaces are obtained.
Here is the sample app for download.
And finally the Oracle Documentation about REST
