HTTPBuilder NG: Back From The Dead

BACK FROM THE DEAD:
HTTP BUILDER NG
NoamTenne

$WHOAMI
Hacking around the JVM for the past ~15Years
healthy.io 
 
@NoamTenne
http://blog.10ne.org

LET’S ROLL
http://bit.ly/2kmffDe

A SHOW OF HANDS
http://bit.ly/2nK3I4v

HTTPBUILDER
http://read.bi/2kmcYaZ
Haha! Good one,
HTTPBuilder!

HTTP BUILDER NG
http://bit.ly/2l1hjzN

HTTP BUILDER NG
Source:
github.com/http-builder-ng/http-builder-ng
Docs:
http-builder-ng.github.io/http-builder-ng/

INSTALLATION
compile 'io.github.http-builder-ng:http-builder-ng-core:0.14.1'

INSTALLATION
compile 'io.github.http-builder-ng:http-builder-ng-apache:0.14.1'

INSTALLATION
compile 'io.github.http-builder-ng:http-builder-ng-apache:0.14.1'
compile 'io.github.http-builder-ng:http-builder-ng-okhttp:0.14.1'

INITIALIZATION - CORE
import groovyx.net.http.HttpBuilder
class Core {
private HttpBuilder httpBuilder
void init() {
httpBuilder = HttpBuilder.configure()
}
}

class Core {
void init() {
}
}
Consistent namespace

class Core {
void init() {
}
}
Consistent namespace
Consistent
conﬁguration method

INITIALIZATION - APACHE
import groovyx.net.http.ApacheHttpBuilder
class Apache {
void init() {
httpBuilder = HttpBuilder.configure({ c ->
new ApacheHttpBuilder(c)
})
}
}

INITIALIZATION - APACHE
import groovyx.net.http.ApacheHttpBuilder
class Apache {
void init() {
new ApacheHttpBuilder(c)
})
}
} Factory function for
conﬁguration

INITIALIZATION - OKHTTP
import groovyx.net.http.OkHttpBuilder
class Ok {
void init() {
new OkHttpBuilder(c)
})
}
}

INITIALIZATION - OKHTTP
import groovyx.net.http.OkHttpBuilder
class Ok {
void init() {
new OkHttpBuilder(c)
})
}
} Same factory. 
Different Impl

INITIALIZED! NOW WHAT?
def result = HttpBuilder.configure({
request.uri = 'http://serenity.ship'
})
.get()

})
.get()
Conﬁgure can access
request

})
.post({
request.uri.path = '/api'
response.success({})
})

})
.post({
})
Method may extend
request conﬁg

})
.post({
})
Method may extend
request conﬁg
Method may also hook
to response events

GREAT!
BUT LET’S SEETHE GOOD STUFF

HEADER PARSERS
if (headerName == 'Last-Modified') {
//Construct proper date pattern and parse
} else if (headerName == 'Age') {
//Parse long
} else if (headerName == 'Content-Disposition') {
//Parse and assemble map
}

HEADER PARSERS
Easily parse commonly used headers such as:

HEADER PARSERS
Allow -> CsvList

HEADER PARSERS
Last-Modified -> HttpDate
Allow -> CsvList

HEADER PARSERS
Last-Modified -> HttpDate
Allow -> CsvList
Cache-Control -> MapPairs

HEADER PARSERS
ZonedDateTime date = HttpBuilder.configure {
request.uri = 'https://google.com'
}
.head(ZonedDateTime) {
response.success { FromServer resp ->
resp.headers.find({ h ->
h.key == 'Date'
}).parse()
}
}

HEADER PARSERS
}
h.key == 'Date'
}).parse()
}
}
Declare return type

HEADER PARSERS
}
h.key == 'Date'
}).parse()
}
}
Declare return type
Find the relevant
header

HEADER PARSERS
}
h.key == 'Date'
}).parse()
}
}
Declare return type
Find the relevant
headerJust
call .parse()

CONTENT PARSERS
Auto parse response content according to type:

CONTENT PARSERS
HTML

CONTENT PARSERS
HTML
JSON

CONTENT PARSERS
HTML
JSON XML

CONTENT PARSERS
HTML
JSON
CSV
XML

CONTENT PARSERS
HTML
JSON
CSV
XML
Text

CONTENT PARSERS
Register custom parsers per content type!

CONTENT PARSERS
def inflated = HttpBuilder.configure {
request.uri = 'http://serenity.com/bundle.zip'
}
.get(String) {
response.parser('application/zip') { config, fromServer ->
def inflaterStream = new GZIPInputStream(fromServer.inputStream)
inflaterStream.getText('UTF-8')
}
}

CONTENT PARSERS
}
.get(String) {
}
}
call .parser()

CONTENT PARSERS
}
.get(String) {
}
}
call .parser()
Specify content
type

CONTENT PARSERS
}
.get(String) {
}
}
call .parser()
Specify content
type
Provide closure to
handle content

REQUEST INTERCEPTORS
Perform an operation on every response received

REQUEST INTERCEPTORS -
SINGLETYPE
HttpBuilder.conﬁgure {
request.uri = 'http://google.com'
execution.interceptor(GET) { cfg, fx ->
println "${cfg.request.uri.toURI()} was requested"
fx.apply(cfg)
}
}

SINGLETYPE
fx.apply(cfg)
}
}
Call interceptor

SINGLETYPE
fx.apply(cfg)
}
}
Call interceptor
Specify method

SINGLETYPE
fx.apply(cfg)
}
}
Call interceptor
Specify method Access conﬁg and
actual function

SINGLETYPE
fx.apply(cfg)
}
} Do the business

SINGLETYPE
fx.apply(cfg)
}
} Do the business
3. PROFIT

ANYTYPE
HttpBuilder.configure {
HttpVerb[] verbs = [GET, POST, PUT, DELETE]
execution.interceptor(verbs) { cfg, fx ->
fx.apply(cfg)
}
}

ANYTYPE
fx.apply(cfg)
}
}
Apply to multiple
methods

MODIFY RESPONSE
def result = fx.apply(cfg)
"magic:marker:${result}"
}
}

MODIFY RESPONSE
def result = fx.apply(cfg)
"magic:marker:${result}"
}
}
Modify the value!

REQUEST ENCODERS
Perform an operation on every request sent

REQUEST ENCODERS
{
"body": {},
"metadata": {
"clientId": "abcdef123456789"
}
}

REQUEST ENCODERS
request.uri = 'http://serenity.com/report'
request.encoder('application/json') { config, ToServer req ->
def w = "{"body":${config.request.body},"clientId": ”bla""
req.toServer(new ByteArrayInputStream(w.bytes))
}
}

REQUEST ENCODERS
}
}
call .encoder()

REQUEST ENCODERS
}
}
call .encoder() Specify content type

REQUEST ENCODERS
}
}
Modiﬁed content
back to the server
handle

BONUS: CAN BE USED BY JAVA
Use Java 8 lambdas or function objects

BONUS: DIY
extends groovyx.net.http.HttpBuilder

BONUS: DIY
protected abstract ChainedHttpConfig getObjectConfig()

BONUS: DIY
Retrieve client
conﬁguration

BONUS: DIY
public abstract Executor getExecutor()
Retrieve client
conﬁguration

BONUS: DIY
public abstract Executor getExecutor()
Provides a threading
interface
Retrieve client
conﬁguration

BONUS: DIY
protected abstract Object doGet(final ChainedHttpConfig config)
protected abstract Object doHead(final ChainedHttpConfig config)
protected abstract Object doPost(final ChainedHttpConfig config)
protected abstract Object doPut(final ChainedHttpConfig config)
protected abstract Object doDelete(final ChainedHttpConfig config)

HTTPBuilder NG: Back From The Dead

HTTPBuilder NG: Back From The Dead

More Related Content

Viewers also liked

Similar to HTTPBuilder NG: Back From The Dead

More from noamt

Recently uploaded

HTTPBuilder NG: Back From The Dead