├── .gitignore ├── Procfile ├── README.md ├── app.json ├── build.gradle ├── gradle └── wrapper │ ├── gradle-wrapper.jar │ └── gradle-wrapper.properties ├── gradlew ├── gradlew.bat ├── settings.gradle └── src └── main ├── java └── com │ └── example │ ├── Force.java │ └── SpringSalesforceApplication.java └── resources ├── application.properties └── static └── index.html /.gitignore: -------------------------------------------------------------------------------- 1 | /.gradle/ 2 | /.idea/ 3 | /build/ 4 | /application.properties 5 | -------------------------------------------------------------------------------- /Procfile: -------------------------------------------------------------------------------- 1 | web: java -Dserver.port=$PORT -jar build/libs/hello-spring-salesforce.jar 2 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | Hello Spring Salesforce 2 | ======================= 3 | 4 | This is a simple Spring Boot application that connects to Salesforce via the REST APIs. 5 | 6 | 7 | Run on Heroku: 8 | 9 | 1. Deploy this app on Heroku: [![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy) 10 | 1. [Create a new Connected App on Salesforce](https://login.salesforce.com/app/mgmt/forceconnectedapps/forceAppEdit.apexp) 11 | 1. Fill in the `Connected App Name`, `API Name`, and `Contact Email` fields 12 | 1. Select `Enable OAuth Settings` and enter the following `Callback URLs`: 13 | 14 | https://YOUR_HEROKU_APP_NAME.herokuapp.com/login 15 | http://localhost:8080/login 16 | 17 | 1. Select `Full access (full)` from the list of OAuth Scopes and click `Add` 18 | 1. Click `Save` and them `Continue` to complete the creation of the new Connected App 19 | 1. Manage the settings for your Heroku app (via the [Heroku Dashboard](https://dashboard.heroku.com)) and add `SECURITY_OAUTH2_CLIENT_CLIENT_ID` and `SECURITY_OAUTH2_CLIENT_CLIENT_SECRET`config vars using the values from the newly created Connected App 20 | 1. Wait about 10 minutes until the OAuth app creation is completed 21 | 1. Check out your your new app 22 | 23 | 24 | Run Locally: 25 | 26 | 1. If you haven't already done so, create a Salesforce Connected App following the instructions above 27 | 1. Create a file in the root project directory named `application.properties` that contains: 28 | 29 | security.oauth2.client.client-id = YOUR_CONNECTED_APP_CLIENT_ID 30 | security.oauth2.client.client-secret = YOUR_CONNECTED_APP_CLIENT_SECRET 31 | 32 | Note: Make sure you do not put this file in SCM! 33 | 34 | 1. Start the local server via Gradle: 35 | 36 | Mac & Linux: 37 | 38 | ./gradlew dev 39 | 40 | Windows: 41 | 42 | gradlew dev 43 | 44 | 1. Check out the app: [http://localhost:8080](http://localhost:8080) 45 | -------------------------------------------------------------------------------- /app.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "Hello Spring Salesforce", 3 | "description": "Sample app that uses Spring and the Salesforce REST APIs", 4 | "repository": "https://github.com/jamesward/hello-spring-salesforce", 5 | "logo": "http://g00glen00b.be/wp-content/uploads/2012/08/spring-boot-logo.png", 6 | "keywords": ["java", "spring", "spring boot", "salesforce"], 7 | "env": { 8 | "SECURITY_OAUTH2_CLIENT_CLIENT_ID": { 9 | "description": "The Salesforce Connected App's Client ID (Note: You might not have this yet.)", 10 | "required": false 11 | }, 12 | "SECURITY_OAUTH2_CLIENT_CLIENT_SECRET": { 13 | "description": "The Salesforce Connected App's Client Secret (Note: You might not have this yet.)", 14 | "required": false 15 | } 16 | } 17 | } 18 | -------------------------------------------------------------------------------- /build.gradle: -------------------------------------------------------------------------------- 1 | buildscript { 2 | repositories { 3 | mavenLocal() 4 | mavenCentral() 5 | maven { 6 | url 'https://plugins.gradle.org/m2/' 7 | } 8 | } 9 | dependencies { 10 | classpath 'org.springframework.boot:spring-boot-gradle-plugin:1.4.2.RELEASE' 11 | classpath 'gradle.plugin.com.jamesward:atom-gradle-plugin:0.0.1' 12 | } 13 | } 14 | 15 | apply plugin: 'java' 16 | apply plugin: 'org.springframework.boot' 17 | //apply plugin: 'com.jamesward.atomgradleplugin' 18 | 19 | repositories { 20 | mavenLocal() 21 | mavenCentral() 22 | } 23 | 24 | dependencies { 25 | compile 'org.springframework.boot:spring-boot-starter-web:1.4.2.RELEASE' 26 | compile 'org.springframework.boot:spring-boot-devtools:1.4.2.RELEASE' 27 | compile 'org.springframework.boot:spring-boot-starter-security:1.4.2.RELEASE' 28 | compile 'org.springframework.security.oauth:spring-security-oauth2:2.0.12.RELEASE' 29 | compile 'org.webjars:salesforce-lightning-design-system:2.1.4' 30 | compile 'org.webjars:jquery:3.1.1' 31 | } 32 | 33 | allprojects { 34 | sourceCompatibility = 1.8 35 | targetCompatibility = 1.8 36 | } 37 | 38 | /* 39 | atom { 40 | filesToOpen = ['README.md'] 41 | packages = ['heroku-tools'] 42 | } 43 | */ 44 | 45 | import org.gradle.internal.os.OperatingSystem 46 | 47 | task devClasses(type: Exec) { 48 | if (OperatingSystem.current().isWindows()) 49 | commandLine 'gradlew', '-t', 'classes' 50 | else 51 | commandLine './gradlew', '-t', 'classes' 52 | } 53 | 54 | task devBootRun(type: Exec) { 55 | if (OperatingSystem.current().isWindows()) 56 | commandLine 'gradlew', 'bootRun' 57 | else 58 | commandLine './gradlew', 'bootRun' //, '--debug-jvm' 59 | } 60 | 61 | import java.util.concurrent.* 62 | 63 | task dev() << { 64 | def devClassesFuture = Executors.newSingleThreadExecutor().submit({ devClasses.execute() } as Callable) 65 | def devBootRunFuture = Executors.newSingleThreadExecutor().submit({ devBootRun.execute() } as Callable) 66 | devClassesFuture?.get() 67 | devBootRunFuture?.get() 68 | } 69 | 70 | /* 71 | task devWithAtom { 72 | dependsOn tasks.atom 73 | } 74 | */ 75 | 76 | task stage { 77 | dependsOn build 78 | } 79 | 80 | //defaultTasks 'devWithAtom' 81 | -------------------------------------------------------------------------------- /gradle/wrapper/gradle-wrapper.jar: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/jamesward/hello-spring-salesforce/79aaf9b462e37a5a24b1069c8a1d07562098cf63/gradle/wrapper/gradle-wrapper.jar -------------------------------------------------------------------------------- /gradle/wrapper/gradle-wrapper.properties: -------------------------------------------------------------------------------- 1 | #Tue Nov 08 13:56:21 MST 2016 2 | distributionBase=GRADLE_USER_HOME 3 | distributionPath=wrapper/dists 4 | zipStoreBase=GRADLE_USER_HOME 5 | zipStorePath=wrapper/dists 6 | distributionUrl=https\://services.gradle.org/distributions/gradle-3.1-bin.zip 7 | -------------------------------------------------------------------------------- /gradlew: -------------------------------------------------------------------------------- 1 | #!/usr/bin/env bash 2 | 3 | ############################################################################## 4 | ## 5 | ## Gradle start up script for UN*X 6 | ## 7 | ############################################################################## 8 | 9 | # Attempt to set APP_HOME 10 | # Resolve links: $0 may be a link 11 | PRG="$0" 12 | # Need this for relative symlinks. 13 | while [ -h "$PRG" ] ; do 14 | ls=`ls -ld "$PRG"` 15 | link=`expr "$ls" : '.*-> \(.*\)$'` 16 | if expr "$link" : '/.*' > /dev/null; then 17 | PRG="$link" 18 | else 19 | PRG=`dirname "$PRG"`"/$link" 20 | fi 21 | done 22 | SAVED="`pwd`" 23 | cd "`dirname \"$PRG\"`/" >/dev/null 24 | APP_HOME="`pwd -P`" 25 | cd "$SAVED" >/dev/null 26 | 27 | APP_NAME="Gradle" 28 | APP_BASE_NAME=`basename "$0"` 29 | 30 | # Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. 31 | DEFAULT_JVM_OPTS="" 32 | 33 | # Use the maximum available, or set MAX_FD != -1 to use that value. 34 | MAX_FD="maximum" 35 | 36 | warn ( ) { 37 | echo "$*" 38 | } 39 | 40 | die ( ) { 41 | echo 42 | echo "$*" 43 | echo 44 | exit 1 45 | } 46 | 47 | # OS specific support (must be 'true' or 'false'). 48 | cygwin=false 49 | msys=false 50 | darwin=false 51 | nonstop=false 52 | case "`uname`" in 53 | CYGWIN* ) 54 | cygwin=true 55 | ;; 56 | Darwin* ) 57 | darwin=true 58 | ;; 59 | MINGW* ) 60 | msys=true 61 | ;; 62 | NONSTOP* ) 63 | nonstop=true 64 | ;; 65 | esac 66 | 67 | CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar 68 | 69 | # Determine the Java command to use to start the JVM. 70 | if [ -n "$JAVA_HOME" ] ; then 71 | if [ -x "$JAVA_HOME/jre/sh/java" ] ; then 72 | # IBM's JDK on AIX uses strange locations for the executables 73 | JAVACMD="$JAVA_HOME/jre/sh/java" 74 | else 75 | JAVACMD="$JAVA_HOME/bin/java" 76 | fi 77 | if [ ! -x "$JAVACMD" ] ; then 78 | die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME 79 | 80 | Please set the JAVA_HOME variable in your environment to match the 81 | location of your Java installation." 82 | fi 83 | else 84 | JAVACMD="java" 85 | which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 86 | 87 | Please set the JAVA_HOME variable in your environment to match the 88 | location of your Java installation." 89 | fi 90 | 91 | # Increase the maximum file descriptors if we can. 92 | if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then 93 | MAX_FD_LIMIT=`ulimit -H -n` 94 | if [ $? -eq 0 ] ; then 95 | if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then 96 | MAX_FD="$MAX_FD_LIMIT" 97 | fi 98 | ulimit -n $MAX_FD 99 | if [ $? -ne 0 ] ; then 100 | warn "Could not set maximum file descriptor limit: $MAX_FD" 101 | fi 102 | else 103 | warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT" 104 | fi 105 | fi 106 | 107 | # For Darwin, add options to specify how the application appears in the dock 108 | if $darwin; then 109 | GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\"" 110 | fi 111 | 112 | # For Cygwin, switch paths to Windows format before running java 113 | if $cygwin ; then 114 | APP_HOME=`cygpath --path --mixed "$APP_HOME"` 115 | CLASSPATH=`cygpath --path --mixed "$CLASSPATH"` 116 | JAVACMD=`cygpath --unix "$JAVACMD"` 117 | 118 | # We build the pattern for arguments to be converted via cygpath 119 | ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null` 120 | SEP="" 121 | for dir in $ROOTDIRSRAW ; do 122 | ROOTDIRS="$ROOTDIRS$SEP$dir" 123 | SEP="|" 124 | done 125 | OURCYGPATTERN="(^($ROOTDIRS))" 126 | # Add a user-defined pattern to the cygpath arguments 127 | if [ "$GRADLE_CYGPATTERN" != "" ] ; then 128 | OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)" 129 | fi 130 | # Now convert the arguments - kludge to limit ourselves to /bin/sh 131 | i=0 132 | for arg in "$@" ; do 133 | CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -` 134 | CHECK2=`echo "$arg"|egrep -c "^-"` ### Determine if an option 135 | 136 | if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then ### Added a condition 137 | eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"` 138 | else 139 | eval `echo args$i`="\"$arg\"" 140 | fi 141 | i=$((i+1)) 142 | done 143 | case $i in 144 | (0) set -- ;; 145 | (1) set -- "$args0" ;; 146 | (2) set -- "$args0" "$args1" ;; 147 | (3) set -- "$args0" "$args1" "$args2" ;; 148 | (4) set -- "$args0" "$args1" "$args2" "$args3" ;; 149 | (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;; 150 | (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;; 151 | (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;; 152 | (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;; 153 | (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;; 154 | esac 155 | fi 156 | 157 | # Split up the JVM_OPTS And GRADLE_OPTS values into an array, following the shell quoting and substitution rules 158 | function splitJvmOpts() { 159 | JVM_OPTS=("$@") 160 | } 161 | eval splitJvmOpts $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS 162 | JVM_OPTS[${#JVM_OPTS[*]}]="-Dorg.gradle.appname=$APP_BASE_NAME" 163 | 164 | # by default we should be in the correct project dir, but when run from Finder on Mac, the cwd is wrong 165 | if [[ "$(uname)" == "Darwin" ]] && [[ "$HOME" == "$PWD" ]]; then 166 | cd "$(dirname "$0")" 167 | fi 168 | 169 | exec "$JAVACMD" "${JVM_OPTS[@]}" -classpath "$CLASSPATH" org.gradle.wrapper.GradleWrapperMain "$@" 170 | -------------------------------------------------------------------------------- /gradlew.bat: -------------------------------------------------------------------------------- 1 | @if "%DEBUG%" == "" @echo off 2 | @rem ########################################################################## 3 | @rem 4 | @rem Gradle startup script for Windows 5 | @rem 6 | @rem ########################################################################## 7 | 8 | @rem Set local scope for the variables with windows NT shell 9 | if "%OS%"=="Windows_NT" setlocal 10 | 11 | set DIRNAME=%~dp0 12 | if "%DIRNAME%" == "" set DIRNAME=. 13 | set APP_BASE_NAME=%~n0 14 | set APP_HOME=%DIRNAME% 15 | 16 | @rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. 17 | set DEFAULT_JVM_OPTS= 18 | 19 | @rem Find java.exe 20 | if defined JAVA_HOME goto findJavaFromJavaHome 21 | 22 | set JAVA_EXE=java.exe 23 | %JAVA_EXE% -version >NUL 2>&1 24 | if "%ERRORLEVEL%" == "0" goto init 25 | 26 | echo. 27 | echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 28 | echo. 29 | echo Please set the JAVA_HOME variable in your environment to match the 30 | echo location of your Java installation. 31 | 32 | goto fail 33 | 34 | :findJavaFromJavaHome 35 | set JAVA_HOME=%JAVA_HOME:"=% 36 | set JAVA_EXE=%JAVA_HOME%/bin/java.exe 37 | 38 | if exist "%JAVA_EXE%" goto init 39 | 40 | echo. 41 | echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 42 | echo. 43 | echo Please set the JAVA_HOME variable in your environment to match the 44 | echo location of your Java installation. 45 | 46 | goto fail 47 | 48 | :init 49 | @rem Get command-line arguments, handling Windows variants 50 | 51 | if not "%OS%" == "Windows_NT" goto win9xME_args 52 | 53 | :win9xME_args 54 | @rem Slurp the command line arguments. 55 | set CMD_LINE_ARGS= 56 | set _SKIP=2 57 | 58 | :win9xME_args_slurp 59 | if "x%~1" == "x" goto execute 60 | 61 | set CMD_LINE_ARGS=%* 62 | 63 | :execute 64 | @rem Setup the command line 65 | 66 | set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar 67 | 68 | @rem Execute Gradle 69 | "%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %CMD_LINE_ARGS% 70 | 71 | :end 72 | @rem End local scope for the variables with windows NT shell 73 | if "%ERRORLEVEL%"=="0" goto mainEnd 74 | 75 | :fail 76 | rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of 77 | rem the _cmd.exe /c_ return code! 78 | if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1 79 | exit /b 1 80 | 81 | :mainEnd 82 | if "%OS%"=="Windows_NT" endlocal 83 | 84 | :omega 85 | -------------------------------------------------------------------------------- /settings.gradle: -------------------------------------------------------------------------------- 1 | rootProject.name = 'hello-spring-salesforce' 2 | -------------------------------------------------------------------------------- /src/main/java/com/example/Force.java: -------------------------------------------------------------------------------- 1 | package com.example; 2 | 3 | 4 | import com.fasterxml.jackson.annotation.JsonIgnoreProperties; 5 | import org.springframework.beans.factory.annotation.Autowired; 6 | import org.springframework.context.annotation.Bean; 7 | import org.springframework.security.oauth2.client.OAuth2ClientContext; 8 | import org.springframework.security.oauth2.client.OAuth2RestTemplate; 9 | import org.springframework.security.oauth2.client.resource.OAuth2ProtectedResourceDetails; 10 | import org.springframework.security.oauth2.provider.OAuth2Authentication; 11 | import org.springframework.stereotype.Component; 12 | 13 | import java.util.HashMap; 14 | import java.util.List; 15 | import java.util.Map; 16 | 17 | @Component 18 | public class Force { 19 | 20 | private static final String REST_VERSION = "35.0"; 21 | 22 | @Bean 23 | private OAuth2RestTemplate oAuth2RestTemplate(OAuth2ProtectedResourceDetails resource, OAuth2ClientContext context) { 24 | return new OAuth2RestTemplate(resource, context); 25 | } 26 | 27 | @Autowired 28 | private OAuth2RestTemplate restTemplate; 29 | 30 | @SuppressWarnings("unchecked") 31 | private static String restUrl(OAuth2Authentication principal) { 32 | HashMap details = (HashMap) principal.getUserAuthentication().getDetails(); 33 | HashMap urls = (HashMap) details.get("urls"); 34 | return urls.get("rest").replace("{version}", REST_VERSION); 35 | } 36 | 37 | public List accounts(OAuth2Authentication principal) { 38 | String url = restUrl(principal) + "query/?q={q}"; 39 | 40 | Map params = new HashMap<>(); 41 | params.put("q", "SELECT Id, Name, Type, Industry, Rating FROM Account"); 42 | 43 | return restTemplate.getForObject(url, QueryResultAccount.class, params).records; 44 | } 45 | 46 | @JsonIgnoreProperties(ignoreUnknown = true) 47 | public static class Account { 48 | public String Id; 49 | public String Name; 50 | public String Industry; 51 | public String Rating; 52 | } 53 | 54 | @JsonIgnoreProperties(ignoreUnknown = true) 55 | private static class QueryResult { 56 | public List records; 57 | } 58 | 59 | private static class QueryResultAccount extends QueryResult {} 60 | 61 | } 62 | -------------------------------------------------------------------------------- /src/main/java/com/example/SpringSalesforceApplication.java: -------------------------------------------------------------------------------- 1 | package com.example; 2 | 3 | import org.springframework.beans.factory.annotation.Autowired; 4 | import org.springframework.boot.SpringApplication; 5 | import org.springframework.boot.autoconfigure.SpringBootApplication; 6 | import org.springframework.boot.autoconfigure.security.oauth2.client.EnableOAuth2Sso; 7 | import org.springframework.security.oauth2.provider.OAuth2Authentication; 8 | import org.springframework.web.bind.annotation.RequestMapping; 9 | import org.springframework.web.bind.annotation.RestController; 10 | 11 | import java.util.List; 12 | 13 | @SpringBootApplication 14 | @RestController 15 | @EnableOAuth2Sso 16 | public class SpringSalesforceApplication { 17 | 18 | @Autowired 19 | private Force force; 20 | 21 | @RequestMapping("/accounts") 22 | public List accounts(OAuth2Authentication principal) { 23 | return force.accounts(principal); 24 | } 25 | 26 | public static void main(String[] args) { 27 | SpringApplication.run(SpringSalesforceApplication.class, args); 28 | } 29 | 30 | } 31 | -------------------------------------------------------------------------------- /src/main/resources/application.properties: -------------------------------------------------------------------------------- 1 | security.oauth2.client.client-authentication-scheme = form 2 | security.oauth2.client.authentication-scheme = header 3 | security.oauth2.client.grant-type = authorization_code 4 | security.oauth2.client.access-token-uri = https://login.salesforce.com/services/oauth2/token 5 | security.oauth2.client.user-authorization-uri = https://login.salesforce.com/services/oauth2/authorize 6 | security.oauth2.resource.user-info-uri = https://login.salesforce.com/services/oauth2/userinfo 7 | 8 | #logging.level.org.springframework.security = DEBUG 9 | -------------------------------------------------------------------------------- /src/main/resources/static/index.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | Hello Spring Salesforce 9 | 10 | 11 | 12 | 13 | 28 | 29 | 30 |
31 |
32 |
33 |
Hello Spring Salesforce
34 |
35 |
36 |
37 | 38 |
39 |
Salesforce Accounts
40 | 41 | 42 | 43 | 44 | 47 | 50 | 53 | 56 | 57 | 58 | 59 | 60 |
45 |
Id
46 | 		48 |
Name
49 | 		51 |
Industry
52 | 		54 |
Rating
55 |
61 |
62 | 63 | 64 | --------------------------------------------------------------------------------