This post is based on using Jive SBS 4.5 series.
The documentation for using REST on Jive SBS is found in the below document. One of the problems with this document is that I cannot just give you a URL. You have to go to the document and in the search type REST.
Search on REST.
Select Core Services.
You will see many services listed including the documentation for these services.
Multiple Method Types
There are four common method types that can be used with REST. GET, POST, PUT, and DELETE. All four methods can be done programmatically. The GET method can often be done by simply dropping a URL in a browser; however, get requests on password protected resources require authentication. POST and PUT usually add an XML based data stream associated with it. DELETE does not have an XML based data stream and is similar to GET requests except that they require authentication.
The best way to do these rest calls is programmatically. In java, we use the apache HttpClient classes to do this. These are the classes:
org.apache.commons.httpclient.methods.GetMethod;
org.apache.commons.httpclient.methods.PostMethod;
org.apache.commons.httpclient.methods.PutMethod;
org.apache.commons.httpclient.methods.DeleteMethod;
Making REST Calls
Lets now go into the Jive Documentation. If you go into User Service, look for web services that are specified as GET calls. Here is an example.
https://myjiveinstance.com/rpc/rest/userService/usersByID/2007
With this call, you will get back basic user information for the user with userid 2007.
https://myjiveinstance.com/rpc/rest/blogService/blogCount
This will give the number of blog posts.
Sample Code
I am including a sample java code that can be used for making rest calls. This sample can be modified in more than one way. While I am calling this java code, I run it as a groovy script. There are a few things to note about this code.
1. Method should be GetMethod, PostMethod, PutMethod, or DeleteMethod depending on the REST call to be used. Reference the jive documentation to know which to use.
2. The authentication credentials need to be a jive user with permissions to the requested resource. You can post for other users if the authenticated user has administrative access or ample permissions to perform the task.
Here is the script as a Post example used for creating blog posts:
// cd C:\development\tfs\jive\jive-sbs\Main\Source\Applications\WebServiceClients\src\com\quest\groovy\restclients
//groovy -classpath c:\groovy\jars\commons-httpclient-3.0.1.jar;c:\groovy\jars\commons-codec.jar RestClientPost.groovy
package com.quest.groovy.restclients
import java.io.IOException;
import java.net.MalformedURLException;
import java.net.URL;
import org.apache.commons.httpclient.Credentials;
import org.apache.commons.httpclient.HttpClient;
import org.apache.commons.httpclient.HttpException;
import org.apache.commons.httpclient.UsernamePasswordCredentials;
import org.apache.commons.httpclient.auth.AuthScope;
import org.apache.commons.httpclient.methods.PostMethod;
import org.apache.commons.httpclient.methods.StringRequestEntity;
URL requestURL
String restContext = "https://myjiveinstance.com/rpc/rest/blogService/blogPosts";
String userName = "admin";
String password = "admin";
String payloadTemplate ="<createBlogPost>" +
"<subject>Rest Created Post</subject>" +
"<body>Test post. Please disregard.</body>" +
"<blogID>3012</blogID>" +
"<userID>2006</userID>" +
"</createBlogPost>";
HttpClient client = new HttpClient();
try {
System.out.println(restContext);
requestURL = new URL(restContext);
Credentials defaultcreds = new UsernamePasswordCredentials(
userName, password);
client.getParams().setAuthenticationPreemptive(true);
client.getState().setCredentials(AuthScope.ANY, defaultcreds);
} catch (MalformedURLException e) {
System.out.println("Couldn't set up the HTTP connection with the community. ");
e.printStackTrace();
}
try {
PostMethod method = new PostMethod(restContext);
StringRequestEntity requestPayload = new StringRequestEntity(
payloadTemplate, "text/html", null);
method.setRequestEntity(requestPayload);
method.setDoAuthentication(true);
// The response code is useful for debugging.
int response = client.executeMethod(method);
System.out.println(response);
InputStream responseStream = method.getResponseBodyAsStream();
BufferedReader br = new BufferedReader(new InputStreamReader(responseStream));
String line;
while ((line = br.readLine()) != null) {
System.out.println(line);
}
br.close();
} catch (HttpException e) {
System.out.println("Error connecting to the instance. "
+ e.getCause().getLocalizedMessage());
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
}
Here is a Dot Net sample someone else wrote.
using System.Net;
using System.IO;
String payloadTemplate = "<" + tbxJivePut_Method.Text + ">" +
"<community_id>" + spaceID + "</community_id>" +
"</" + tbxJivePut_Method.Text + ">";
String restContext = "https://jiveinstance.com/rpc/rest/";
String userID = "2007";
WebRequest request = HttpWebRequest.Create(restContext + payloadTemplate);
request.Headers.Add("source","packettrap");
request.Headers[HttpRequestHeader.Authorization] = "Basic " + Convert.ToBase64String(Encoding.UTF8.GetBytes(userName + ":" + password));
request.Method = "DELETE";
WebResponse response = request.GetResponse();
Stream dataStream = response.GetResponseStream();
StreamReader reader = new StreamReader(dataStream);
string responseFromServer = reader.ReadToEnd();
// Response.Write("Response: <br><xmp>" + responseFromServer + "</xmp>");
tbxJiveDelete_Result.Text = tbxJiveDelete_Result.Text + responseFromServer;
}
catch (Exception ex)
{
//Response.Write(ex.Message);
tbxJiveDelete_Result.Text = "";
tbxJiveDelete_Result.Text = tbxJiveDelete_Result.Text + ex.Message;
}
Hope this gets you started and good luck!!!
Categories: Programming.