scribejava · xcomprs · Mar 11, 2016 · Mar 11, 2016 · Mar 14, 2016 · Mar 14, 2016
diff --git a/.travis.yml b/.travis.yml
@@ -0,0 +1,8 @@
+language: java
+script: mvn clean package
+jdk:
+  - oraclejdk8
+  - oraclejdk7
+  - openjdk7
+os:
+  - linux
diff --git a/README.md b/README.md
@@ -1,4 +1,8 @@
-# Welcome to the home of ScribeJava, the simple OAuth Java lib!
+# Welcome to the home of ScribeJava, the simple OAuth client Java lib!
+
+[![Build Status](https://travis-ci.org/scribejava/scribejava.svg?branch=master)](https://travis-ci.org/scribejava/scribejava)
+[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.github.scribejava/scribejava/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.github.scribejava/scribejava)
+
 
 # Why use ScribeJava?
 
@@ -15,45 +19,63 @@ OAuthService service = new ServiceBuilder()
 
 That **single line** (added newlines for readability) is the only thing you need to configure ScribeJava with LinkedIn's OAuth API for example.
 
+Working runnable examples are [here](https://github.com/scribejava/scribejava/tree/master/scribejava-apis/src/test/java/com/github/scribejava/apis/examples)
+
 ### Threadsafe
 
 Hit ScribeJava as hard and with many threads as you like.
 
-### Async
+### Async and other HTTP clients
 
-You can user ning async http client out-of-box, just use ServiceBuilderAsync
+ScribeJava support out-of-box several HTTP clients:
+ * ning async http client 1.9.x (maven module scribejava-httpclient-ning)
+ * asynchttpclient 2.x (maven module scribejava-httpclient-ahc)
+ * OkHttp (maven module scribejava-httpclient-okhttp)
+
+ just add corresponding maven modules to your pom
 
 ### Supports all major 1.0a and 2.0 OAuth APIs out-of-the-box
 
-* Google
-
-* Facebook
-
-* Yahoo
-
-* LinkedIn
-
-* Twitter
-
-* Foursquare
-
-* Evernote
-
-* Vimeo
-
-* Windows Live
-
-* Odnoklassniki
-
-* Mail.ru
-
-* LinkedIn2.0
-
-* Google2.0
-
-* GitHub
-
-* and many more! check the [examples folder](https://github.com/scribejava/scribejava/tree/master/scribejava-apis/src/test/java/com/github/scribejava/apis/examples)
+* AWeber (http://www.aweber.com/)
+* Box (https://www.box.com/)
+* Digg (http://digg.com/)
+* Доктор на работе (https://www.doktornarabote.ru/)
+* Facebook (https://www.facebook.com/)
+* Flickr (https://www.flickr.com/)
+* Foursquare (https://foursquare.com/)
+* Freelancer (https://www.freelancer.com/)
+* Genius (http://genius.com/)
+* GitHub (https://github.com/)
+* Google (https://www.google.com/)
+* HeadHunter ХэдХантер (https://hh.ru/)
+* Imgur (http://imgur.com/)
+* Kaixin 开心网 (http://www.kaixin001.com/)
+* LinkedIn (https://www.linkedin.com/)
+* Microsoft Live (https://login.live.com/)
+* Mail.Ru (https://mail.ru/)
+* Meetup (http://www.meetup.com/)
+* NAVER (http://www.naver.com/)
+* NetEase (http://www.163.com/)
+* Odnoklassniki Одноклассники (http://ok.ru/)
+* Pinterest (https://www.pinterest.com/)
+* 500px (https://500px.com/)
+* Renren (http://renren.com/)
+* Salesforce (https://www.salesforce.com/)
+* Sina (http://www.sina.com.cn/ http://weibo.com/login.php)
+* Skyrock (http://skyrock.com/)
+* sohu 搜狐 (http://www.sohu.com/)
+* StackExchange (http://stackexchange.com/)
+* The Things Network (v1-staging and v2-preview) (https://www.thethingsnetwork.org/)
+* Trello (https://trello.com/)
+* Tumblr (https://www.tumblr.com/)
+* TUT.BY (http://www.tut.by/)
+* Twitter (https://twitter.com/)
+* Viadeo (http://viadeo.com/)
+* VK ВКонтакте (http://vk.com/)
+* XING (https://www.xing.com/)
+* Yahoo (https://www.yahoo.com/)
+* Misfit (http://misfit.com/)
+* check the [examples folder](https://github.com/scribejava/scribejava/tree/master/scribejava-apis/src/test/java/com/github/scribejava/apis/examples)
 
 ### Small and modular
 
@@ -78,7 +100,7 @@ You can pull ScribeJava from the central maven repository, just add these to you
 <dependency>
     <groupId>com.github.scribejava</groupId>
     <artifactId>scribejava-apis</artifactId>
-    <version>2.2.2</version>
+    <version>4.1.1</version>
 </dependency>
 ```
 
@@ -87,7 +109,7 @@ And in case you need just core classes (that's it, without any external API (FB,
 <dependency>
     <groupId>com.github.scribejava</groupId>
     <artifactId>scribejava-core</artifactId>
-    <version>2.2.2</version>
+    <version>4.1.1</version>
 </dependency>
 ```
 
@@ -103,6 +125,4 @@ Feel free to drop us an email or create issue right here on github.com
 
 ## Forks
 
-Looking for a ScribeJava variation? check the [Fork List](https://github.com/scribejava/scribejava/wiki/Forks)
-
 If you have a useful fork that should be listed there please contact us
diff --git a/changelog b/changelog
@@ -1,7 +1,120 @@
 [SNAPSHOT]
+ * LinkedIn use Header to sign OAuth2 requests
+ * upgrade ServiceBuilder to check apiKey preconditions compile-tim (not run-time)
+
+[4.1.1]
+ * omit the client_secret parameter if it is an empty string while refreshing token (thanks to https://github.com/KungfuPancake)
+ * allow perms to be specified in Flickr Api (read, write, or delete) (thanks to https://github.com/rogerhu)
+ * OdnoklassnikiService should consider params in a body while signing the request (thanks to https://github.com/MrNeuronix)
+ * do not open OutputStream for output while sending empty body in HTTP requests in the default JDK Http client
+
+[4.1.0]
+ * make client_secret optional in OAuth2 while requesting AccessToken (if set to null, it's not required by OAuth2 specs)
+ * move OAuth1 SignatureType from ServiceBuilder to API
+ * add body for PATCH HTTP method
+ * make addOAuthParams appendSignature methods protected in OAuth10aService (to override them in case of need) (thanks to https://github.com/vivin)
+
+[4.0.0]
+ * Remove OAuthRequestAsync, just OAuthRequest. Request should know about sync vs async. Move default Http engine to JDKHttpClient.
+ * introduce SignatureType for OAuth2.0 to implement Bearer signing for the requests
+ * switch Google, GitHub, Facebook OAuth2.0 oauth requests signing to more secured recommended variant (GET-param -> header Bearer)
+ * introduce custom nonstandard Facebook AccessTokenErrorResponse
+
+[3.4.1]
+ * Drop deprecated methods
+ * Move doktornarabote.ru urls to https (thanks to https://github.com/ezibrov)
+
+[3.4.0]
+ * uncouple OAuthRequest and Service. OAuthRequest shouldn't know anything about OAuthservice.
+   You don't need OAuthService to create OAuthRequest anymore. Async request should be sent via OAuthService method.
+ * add support for byte[] and File (async only) payload in OAuth Requests (thanks to https://github.com/keijohyttinen)
+ * add support for  HTTP verbs (thanks to https://github.com/keijohyttinen)
+ * add OkHttp http client support (thanks to https://github.com/arcao)
+ * add default HTTP client configs (to use like 'new ServiceBuilder().httpClientConfig(OkHttpHttpClientConfig.defaultConfig())')
+ * you can use your own impl of AsyncHttpClient
+
+[3.3.0]
+ * update Facebook v2.6 -> v2.8
+ * add The Things Network API (v1-staging and v2-preview) (thanks to https://github.com/jpmeijers)
+ * add Box (thanks to https://github.com/MclaughlinSteve)
+ * fix: OAuth20Service::refreshAccessToken should use RefreshTokenEndpoint, not AccessTokenEndpoint (thanks to https://github.com/vivin)
+ * move signRequest method to OAuthService (common for OAuth1 and OAuth2) (thanks to https://github.com/apomelov)
+ * drop deprecated setConnectionKeepAlive method
+
+[3.2.0]
+ * Add Naver API (thanks to chooco)
+ * handle OAuth2 error response for Issuing an Access Token (thanks to juherr)
+
+[3.1.0]
+ * fix OdnoklassnikiServiceImpl signature, params for hash must be sorted in lexicographic order, see http://new.apiok.ru/dev/methods/
+ * add posibility to use externally created http client
+ * make ScribeJava compilable under jdk7 (checkstyle downgraded for jdk 1.7)
+ * add travis CI (check [oracle|open]jdk7 oraclejdk8)
+
+[3.0.0]
+ * create abstract HTTP Client layer to support different HTTP clients as plugins (AHC and Ning support becames maven submodules)
+ * remove changing global JVM property http.keepAlive, deprecate controlling this property inside of ScribeJava (thanks to wldaunfr and rockihack)
+
+[2.8.1]
+ * add Salesforce sandbox API support
+
+[2.8.0]
+ * add Salesforce API
+ * update Linked In API
+
+[2.7.3]
+ * FIX: ScribeJava shouldn't require all async http client provider to be on the classpath if using only one of them
+
+[2.7.2]
+ * FIX: ScribeJava shouldn't require any async http client provider to be on the classpath (neither ning neither AHC)
+
+[2.7.1]
+ * do not hide checked IOException in unchecked IllegalArgumentException
+
+[2.7.0]
+ * make http async client implementation be more pluggable
+ * add async-http-client 2.0 support (thanks to Sai Chandrasekharan https://github.com/saichand)
+ * add Misfit (http://misfit.com/) API
+ * implement async version getting Request Token for OAuth 1.0a
+
+[2.6.0]
+ * simplify async/sync usages
+ * add optional "User-Agent" config option to use while making http calls
+ * refactor usage of grant_type [authorization_code|refresh_token|password|etc]
+ * add Genius.com API authentication (OAuth2)
+ * fix GitHub API
+ * standardize authorization url generation for OAuth2
+ * update Facebook to v2.6
+ * cleanup: drop old APIs without Examples and with outdated domains
+
+[2.5.3]
+ * fix - do not send two Content-Type header in async requests
+ * improve OK example
+
+[2.5.2]
+ * add Google Async Exmaple (with bugfix for it to work)
+ * add OSGI manifest metadata
+ * apiSecret is not mandatory parameter in config (to use on client sides and other flows without need of the API secret)
+ * implement OAuth2 Authorization Response parsing in the OAuth20Service (to extract code and state from url, useful for Android)
+ * update ok.ru API urls, add 'state' support, add refresh token to the example
+
+[2.4.0]
+ * APIs 2.0 can define different endpoints for access token and for refresh token (the same urls by default)
+ * mark Facebook doesn't support refresh token by throwing UnsupportedOperationException
+ * make JSON Access Token Extractor be the default for OAuth 2.0 (according to RFC 6749)
+ * drop Google OAuth 1.0 support (OAuth 1.0 was officially deprecated by Google)
+ * add response_type parameter to the ServiceBuilder/OAuthConfig to use not only "code" for authorization code
+ * remove Verifier object, we just need Strings, 'code' for OAuth2 and 'oauthVerifier' for OAuth1
+ * default HTTP verb for OAuth 2.0 Access Token EndPoint is POST (http://tools.ietf.org/html/rfc6749#section-3.2)
+ * send missed headers in async version (as in sync)
+ * support 'password' grant_type for OAuth 2.0
+
+[2.3.0]
  * Stack Exchange authentication via OAuth 2.0 (stackoverflow.com, askubuntu.com, etc.).
  * Support response in gzip.
  * differentiate OAuth1 Access token, OAuth 1 Request Token and OAuth 2 Access token, make them conforms RFCs
+ * OAuth 1 APIs can choose whether to pass empty oauth_token param in requests
+ * Support refresh tokens for OAuth2 (very thanks to P. Daniel Tyreus https://github.com/pdtyreus)
 
 [2.2.2]
  * make all APIs to be extentable (have protected constructors, useful for testing)