Jeff Douglas - Technology, Coding and Bears... OH MY! » Innovation

Salesforce REST API Demo from Cloudstock

Jeff Douglas — Fri, 17 Dec 2010 17:18:16 +0000

This is the demo that I put together for the Cloudstock Hackathon and I tried to throw in as many partner services as possible. I finally ended up with five so it was dubbed the “Kitchen Sink” demo. I thought some people may find it useful as it shows how to use the Force.com REST API in conjunction with OAuth2 using the Spring MVC framework. Pat Patterson put together a great Getting Started with the Force.com REST API article but my app is slightly different and IMHO easier, since it uses the Spring Framework.

The app is a external-facing recruiting site that advertises the open Appirio positions. Please remember that this is a demo and I put most of the code into a couple of controllers to make it easier to show. The code can definitely be refactored in certain places.

Here’s how the app uses the partner services:

Partner	How Used?
	Store pdf job descriptions on Box for download by applicants.
	Use Force.com as the datastore for open jobs. Access to Force.com using OAuth2 and the REST API.
	Send a job to a friend via SMS.
	Application built using Spring STS, Spring Roo and Spring MVC. The application runs locally on tc Server.
	Store metrics for jobs on MongoHQ.

Here’s a video of the application so you can see it in action plus some explanation of the Spring code. The controller code for the OAuth functionality and interacting with the Job records is following the jump.

It may be easier to watch this at Youtube with a larger picture. Just double-click the video.

www.youtube.com/watch?v=TFNJaHYEK3U

OAuthController

package com.appirio.jobs.web;
 
import java.io.IOException;
import java.io.UnsupportedEncodingException;
import java.net.URLEncoder;
 
import org.apache.commons.httpclient.HttpClient;
import org.apache.commons.httpclient.methods.PostMethod;
import org.json.JSONException;
import org.json.JSONObject;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.context.request.RequestAttributes;
import org.springframework.web.context.request.WebRequest;
 
/**
 * @author Jeff Douglas (jeff@appirio.com)
 */
@RequestMapping("/oauth/**")
@Controller
public class OAuthController {
 
  private static final String ACCESS_TOKEN = "ACCESS_TOKEN";
  private static final String INSTANCE_URL = "INSTANCE_URL";
 
  private String clientId = null;
  private String clientSecret = null;
  private String redirectUri = null;
  private String environment = null;
  private String authUrl = null;
  private String tokenUrl = null;
  private String accessToken = null;
 
  private void init() {
 
      redirectUri = "https://127.0.0.1:8443/AppirioCareers/oauth/_callback";
      environment = "https://na5.salesforce.com";
      // client id and secret from Force.com Remote Access
      clientId = "YOUR-CLIENT-ID";
      clientSecret = "YOUR-CLIENT-SECRET";
 
        try {
      authUrl = environment + "/services/oauth2/authorize?response_type=code&client_id=" 
        + clientId + "&redirect_uri=" + URLEncoder.encode(redirectUri, "UTF-8");
    } catch (UnsupportedEncodingException e1) {
      // TODO Auto-generated catch block
      e1.printStackTrace();
    }
 
        tokenUrl = environment + "/services/oauth2/token";
 
  }
 
  /* Start the OAuth process if no session with the access token is found. 
   * If a session exists, the redirect the user to the /job/list page. */
  @RequestMapping(value = "/oauth/start", method = RequestMethod.GET)
  public String startOauth(WebRequest req) {
 
    init();
    // check for an access token in the servlet session
    accessToken = (String) req.getAttribute(ACCESS_TOKEN, RequestAttributes.SCOPE_SESSION);
 
    if (accessToken != null) {
      System.out.println("Session found!! Access token: "+accessToken);
      return "forward:/job/list";
    } else {
      System.out.println("No session... need to auth.");        
      return "redirect:" + authUrl;
    }
 
  }
 
  /* OAuth callback from Force.com after authrozing the application.  */
  @RequestMapping(value = "/oauth/_callback", method = RequestMethod.GET)
  public String endOauth(WebRequest req) {
 
    init();
    String accessToken = null;
    String instanceUrl = null;
    String code = req.getParameter("code");
    HttpClient http = new HttpClient();
    PostMethod post = new PostMethod(tokenUrl);
    post.addParameter("client_secret", clientSecret);
    post.addParameter("redirect_uri", redirectUri);
    post.addParameter("grant_type", "authorization_code");
    post.addParameter("code", code);
    post.addParameter("client_id", clientId);
 
    try {
      JSONObject json = null;
      http.executeMethod(post);
      String respBody = post.getResponseBodyAsString();
      System.out.println("post response: " + respBody);
      try {
        json = new JSONObject(respBody);
        accessToken = json.getString("access_token");
        instanceUrl = json.getString("instance_url");
      } catch (JSONException e) {
        e.printStackTrace();
      }
      System.out.println("found access token: "+accessToken);
      System.out.println("found instance url: "+instanceUrl);
    } catch (IOException e) {
      // TODO Auto-generated catch block
      e.printStackTrace();
    } finally {
      post.releaseConnection();
    }
 
    System.out.println("Setting Access token: "+accessToken);
    System.out.println("Setting Instance Url: "+instanceUrl);
 
    /* Set the token and url to the session so other servlets can access it. */
    req.setAttribute(ACCESS_TOKEN, accessToken, RequestAttributes.SCOPE_SESSION);
    req.setAttribute(INSTANCE_URL, instanceUrl, RequestAttributes.SCOPE_SESSION);
 
    return "forward:/job/list";
  }
 
  @RequestMapping
  public String index() {
    return "oauth/index";
  }
}

JobController

package com.appirio.jobs.web;
 
import java.io.IOException;
import java.net.UnknownHostException;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.Map;
 
import org.apache.commons.httpclient.HttpClient;
import org.apache.commons.httpclient.HttpException;
import org.apache.commons.httpclient.NameValuePair;
import org.apache.commons.httpclient.methods.GetMethod; 
import org.json.JSONArray;
import org.json.JSONException;
import org.json.JSONObject;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.ModelAttribute;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.context.request.RequestAttributes;
import org.springframework.web.context.request.WebRequest;
import org.springframework.web.servlet.ModelAndView;
 
import com.appirio.jobs.domain.Job;
import com.appirio.jobs.domain.SmsMessage;
import com.mongodb.BasicDBObject;
import com.mongodb.DB;
import com.mongodb.DBCollection;
import com.mongodb.DBCursor;
import com.mongodb.Mongo;
import com.mongodb.MongoException;
import com.twilio.sdk.TwilioRestClient;
import com.twilio.sdk.TwilioRestException;
import com.twilio.sdk.TwilioRestResponse;
 
/**
 * @author Jeff Douglas (jeff@appirio.com)
 */
 
@RequestMapping("/job/**")
@Controller
public class JobController {
 
  private static final String ACCESS_TOKEN = "ACCESS_TOKEN";
  private static final String INSTANCE_URL = "INSTANCE_URL";
  private static Mongo m;
  private static DB db;
  private static DBCollection coll;
  private static DBCursor cur;
  private ArrayList jobs = new ArrayList();
 
 
    @RequestMapping(value="/job/list", method=RequestMethod.GET)
    public ModelAndView list(WebRequest req) {
 
      // if the job collection is empty then fetch jobs from Force.com
      if (jobs.isEmpty()) {
 
        // fetch the access token and url from the servlet session
        String accessToken = (String) req.getAttribute(ACCESS_TOKEN, RequestAttributes.SCOPE_SESSION);
        String instanceUrl = (String) req.getAttribute(INSTANCE_URL, RequestAttributes.SCOPE_SESSION);
 
        System.out.println("Access token: "+accessToken);
        System.out.println("Instance Url: "+instanceUrl);
 
        jobs = new ArrayList();
      HttpClient httpclient = new HttpClient();
          GetMethod gm = new GetMethod(instanceUrl + "/services/data/v20.0/query");
          //set the token in the header
          gm.setRequestHeader("Authorization", "OAuth "+accessToken);
          //set the SOQL as a query param
          NameValuePair[] params = new NameValuePair[1];
          //no need to url encode here...it will cause your query to fail
          params[0] = new NameValuePair("q","Select Id, Name, Job_Title__c, Location__c, " +
              "Duties__c, Skills__c, Salary__c, Box_Url__c from Job__c Order by Job_Title__c");
          gm.setQueryString(params);
 
          String respBody = "";
 
          try {
        httpclient.executeMethod(gm);
        respBody = gm.getResponseBodyAsString();
            System.out.println("response body: " + respBody);
      } catch (HttpException e1) {
        // TODO Auto-generated catch block
        e1.printStackTrace();
      } catch (IOException e2) {
        // TODO Auto-generated catch block
        e2.printStackTrace();
      } finally {
              gm.releaseConnection();
          }
 
          try {
              JSONObject json = new JSONObject(respBody);                
              JSONArray results = json.getJSONArray("records");
 
             for(int i = 0; i < results.length(); i++) {
               // add the json payload to a Job object
               Job job = new Job(results.getJSONObject(i).getString("Id"), 
            results.getJSONObject(i).getString("Name"),
            results.getJSONObject(i).getString("Job_Title__c"),
            results.getJSONObject(i).getString("Location__c"),
            results.getJSONObject(i).getString("Duties__c"),
            results.getJSONObject(i).getString("Skills__c"),
            results.getJSONObject(i).getString("Salary__c"),
            results.getJSONObject(i).getString("Box_Url__c"));
 
               // add the job to the collection
               jobs.add(job);
             }
 
 
          } catch (JSONException e) {
              e.printStackTrace();
          }
 
          System.out.println("jobs found: "+jobs.size());
 
      }
 
      ModelAndView mav = new ModelAndView("job/list");
      mav.addObject("jobs", jobs);
      return mav;
    }
 
    @RequestMapping(value="/job/{id}/display", method=RequestMethod.GET)
    public ModelAndView display(@PathVariable String id, Model model) {
      Job job = getJobById(id);
      incrementCount(job.getName(),"views");
      ModelAndView mav = new ModelAndView("job/display");
      mav.addObject(getJobById(id));
      return mav;
    }
 
    @RequestMapping(value="/job/{id}/sms", method=RequestMethod.GET)
    public ModelAndView message(@PathVariable String id, Model model) {
      ModelAndView mav = new ModelAndView("job/sms"); 
      SmsMessage sms = new SmsMessage();
      sms.setPhone("9412274843");
      sms.setMessage("Check out this AWESOME job with Appirio!");
      mav.addObject("smsMessage", sms);
      mav.addObject(getJobById(id));
      return mav;
    }
 
    @RequestMapping(value="/job/{id}/print", method=RequestMethod.GET)
    public String print(@PathVariable String id, Model model) {
      Job job = getJobById(id);
      incrementCount(job.getName(),"downloads");
      System.out.println(job.getBoxUrl());
      return "redirect:"+job.getBoxUrl();
    }
 
    @RequestMapping(value = "/job/{id}/smsSend", method = RequestMethod.POST)
    public ModelAndView smsSubmit(@PathVariable String id, @ModelAttribute SmsMessage sms, Model model) {
 
      Job job = getJobById(id);
      sendSms(job, sms.getPhone(), sms.getMessage());
      incrementCount(job.getName(),"messages");
 
      ModelAndView mav = new ModelAndView("job/smsConfirm"); 
      mav.addObject("phone", sms.getPhone());
      mav.addObject("message", sms.getMessage());
      mav.addObject(job);
      return mav;
 
    }
 
  private void incrementCount(String name, String type) {
 
    try {
      m = new Mongo("flame.mongohq.com", 27065);
      db = m.getDB("AppirioCareers");
      char[] password = { '4','+','r','E','o','x','x','x','x','x'};
      boolean auth = db.authenticate("jeffdonthemic", password);
      System.out.println("Mongo auth?: "+auth);
      coll = db.getCollection("jobs");  
    }
    catch (UnknownHostException ex) {
      ex.printStackTrace();
    }
    catch (MongoException ex) {
      ex.printStackTrace();
    }
 
    cur = coll.find(new BasicDBObject("name", name));  
    while (cur.hasNext()) {
      BasicDBObject doc = (BasicDBObject)cur.next();
      if (type.equals("views"))
        doc.put("views", (Integer)doc.get("views")+1);
      else if (type.equals("messages"))
        doc.put("messages", (Integer)doc.get("messages")+1);
      else
        doc.put("downloads", (Integer)doc.get("downloads")+1);
      coll.update( new BasicDBObject("name", name), doc );
    }
 
  }
 
    private void sendSms(Job job, String phone, String message) {
 
        String AccountSid = "YOUR-ACCOUNT-ID";
        String AuthToken = "YOUR-AUTH-TOKEN";
        String ApiVersion = "2010-04-01";
 
        TwilioRestClient client = new TwilioRestClient(AccountSid, AuthToken, null);
 
        String msg = "\n"+message+"\n"+job.getJobTitle()+"\nhttp://appirio.com/careers";
 
        System.out.println("size: "+msg.length());
 
        //build map of post parameters 
        Map params = new HashMap();
        params.put("From", "14155992671");
        params.put("To", phone);
        params.put("Body", msg);
        TwilioRestResponse response;
        try {
            response = client.request("/"+ApiVersion+"/Accounts/"+AccountSid+"/SMS/Messages", "POST", params);
 
            if(response.isError())
                System.out.println("Error making outgoing call: "+response.getHttpStatus()+"\n"+response.getResponseText());
            else {
                System.out.println(response.getResponseText());
 
            }
        } catch (TwilioRestException e) {
            e.printStackTrace();
        }
 
    }
 
    private Job getJobById(String id) {
      Job job = null;
      for (Job j : jobs) {
        if (j.getId().equals(id)) {
          job = j;
          break;
        }
      }
      return job;
    }
 
    @RequestMapping
    public String index() {
        return "job/index";
    }
 
}

My VMforce and Facebook Demos Today at Dreamforce

Jeff Douglas — Wed, 08 Dec 2010 15:28:40 +0000

If you are at Dreamforce today here are the sessions that I am speaking in. I’m really excited to be part of both of them as the topics (VMforce and the new Facebook toolkit) are really cool.

Leveraging Public Social Networks – West 2005 @ 12:15

We’ll be showing off the new Facebook toolkit and building a few applications.

VMforce: The Trusted Enterprise Platform as a Service - Force.com Theater @ 1:45

I’ll be demoing an app built using Spring STS, Spring Roo and Spring MVC connecting to the Force.com Database using JPA and running on the VMforce servers. I’ll show you the code, pick it apart and talk about best practices.

Google Short Links

Jeff Douglas — Sun, 20 Sep 2009 12:07:23 +0000

I found this tip on my buddy Kyle Roche’s blog this morning. It’s such a great service that I had to repost it (aka rip it off).

Google has released an awesome new Labs feature called Google Short Links that allows you to easily create descriptive shortcuts to web URLs. The service (powered by App Engine!!) integrates with your Google Apps Control Panel and also the Firefox 3 “awesome bar”.

For example, I created a short link to the book that Kyle and I are writing on Java App Engine: http://links.jeffdouglas.com/book

You can have both public and private shortlinks. So you might create the following short links:

http://work.jeffdouglas.com
http://family.jeffdouglas.com

Then you could make a bookmarklet to your private Flickr photos (http://family.jeffdouglas.com/myphotos) that only you can access. You might make a series of work related bookmarklets (e.g., http://work.jeffdouglas.com/myproducts, http://work.jeffdouglas.com/linkedin) that you can give out to the general public and leave scattered around the interwebs.

You can sign up for the service here.

Chromium – Chrome for Mac

Jeff Douglas — Thu, 16 Jul 2009 13:23:09 +0000

I started running Chromium (the Chrome browser for Mac) yesterday and it’s pretty nifty. It’s fast and functions alot like the Windows version. The only issue I’ve run into so far is its lack of support for Flash.

For more info you can checkout the Chromium blog or download the latest build. TechCrunch also has a pretty good article with a number of screenshots.

Skimmer – Streamline your social networks

Jeff Douglas — Tue, 24 Mar 2009 11:59:08 +0000

Skimmer was just released today and I’m impressed. It’s a really slick and visually appealing Air application that makes updating multiple social networks a breeze.

“Skimmer℠ is an Adobe AIR desktop application designed to streamline, beautify, and enhance the experience of participating in your most frequently used social networking activities. It improves upon day-to-day interaction with multiple social networks, removing distractions and providing a rich content experience from Facebook, Twitter, Flickr, Blogger and YouTube. Skimmer’s spare, modern aesthetic sets it apart, creating a welcome, handsome social networking hub on your desktop that is particularly suited to multimedia content.”

Wow!

Jeff Douglas — Thu, 18 Dec 2008 16:13:19 +0000

A picture tells a thousand words. Wages, healthcare and legacy costs are killing the Big Three.

2008 CIO 100 Award

Jeff Douglas — Thu, 21 Aug 2008 10:26:04 +0000

Now in its 21st year, the CIO 100 Award is known worldwide as the most prestigious honor in the IT user community and is awarded to 100 companies and their CIOs for leadership in business, technology and innovation. For the third consecutive year, we have been honored by CIO Magazine with the coveted distinction . This year we were recognized for applications developed to support operations and management of its biomedical technologies training and educational programs.

See our Press Release and our Profile at CIO Magazine.

Five Steps to Managing Innovation

Jeff Douglas — Sun, 12 Aug 2007 12:58:20 +0000

CIO Magazine has a really good article on inspiring and managing the innovation process.

An Official Measure of Innovation

Jeff Douglas — Fri, 20 Apr 2007 13:52:13 +0000

BusinessWeek has an interesting analysis of a two page document produced by the US Department of Commerce on a series of innovation measurements it might use to drive public economic and innovation policy.

The main thrust of the document seems to be how can the U.S.?and U.S. business?remain competitive? The Commerce department is looking for comments on this initiative as there are many nebulous concepts that they are looking for feedback on.

It was really interesting to see how they defined innovation: “The design, invention, development, and/or implementation of new or altered products, services, processes, systems, organizational structures, or business models for the purpose of creating new value for customers and financial returns for the firm.” This statement shows that they are looking beyond simpe new product development towards a more systematic view of innovation.

Forgetting, Borrowing & Learning

Jeff Douglas — Fri, 13 Apr 2007 13:54:05 +0000

There is an interesting article in BusinessWeek with an interview of Dr. Vijay Govindarajan. Dr. Govindarajan is currently a Professor at Dartmouth’s Tuck School and a is world authority on strategic innovation. It was recently announced that he would become the Dean of the John H. Sykes College of Business at the University of Tampa. I am currently enrolled in the Masters of Technology and Innovation Management at UT.

The article is essentially a high level overview of my TIM 730 class, “Leading Innovators”. The article focuses on how mature businesses can compete, innovate and spin off high growth companies to compete against nimble startups. The article (and the course itself) focuses on a number of case studies such as The New York Times Interactive, OnStar, Microsoft .NET, The Fate of the Vasa and Hasbro Interactive. It attempts to point out how companies can use assets like brands, customer relationships, expertise, manufacturing capacity, etc to compete against and even beat these startups.

The major focus of the article is that when established companies form a new business unit or organization, these new entities must:

Forget the parent company’s success formula
Borrow the parent’s resources
Learn how to succeed in a new environment

Dr. Govindarajan states that the difference between innovation and strategic innovation is:

“An innovation is strategic when there is a substantial change to one or more of the fundamental questions that define a business: Who are the customers, what value do we provide, and by what processes, and through what areas of expertise do we provide that value?”