Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Speaker Deck
PRO
Sign in
Sign up for free
ApiBuilder
sullis
July 18, 2017
Technology
1
330
ApiBuilder
Portland Java User Group
July 18, 2017
Portland Oregon
#rest #java #scala #json #gilt #apibuilder
sullis
July 18, 2017
Tweet
Share
More Decks by sullis
See All by sullis
Code generation on the Java VM 2022-04-19
sullis
0
35
Mockito 2022-01-25
sullis
0
89
GitHub Actions 2021-12-16
sullis
0
11
Apache Struts and the Equifax data breach 2021-06-03
sullis
0
20
Guardrail State of the Union 2021-04-13
sullis
0
140
Guardrail: State of the Union 2021-03-18
sullis
0
78
Java on AWS 2020-12-15
sullis
0
150
Continuous Delivery with GitHub Actions - DeliveryConf 2020
sullis
0
490
OpenAPI and Java - Portland - 2019-12-10
sullis
0
170
Other Decks in Technology
See All in Technology
開発組織の生産性を可視化する State of DevOpsとFour Keysとは / deep dive into State of DevOps
yfcgpsebp
0
180
JAWS-UG re:Habilitaion 報告 / JAWS-UG OITA rehabilitation
hiranofumio
0
130
スタートアップと技術選定と AWS
track3jyo
PRO
2
330
セキュリティ 開運研修2022 / security 2022
cybozuinsideout
PRO
3
3.7k
Strategyパターン
hankehly
0
120
ソフトウェアテスト自動化、一歩前へ
yoshikiito
3
250
Camp Digital 2022: tailored advice
kyliehavelock
0
140
リファインメントは楽しいかね?
kitamu_mu
1
420
Oracle Cloud Infrastructure:2022年6月度サービス・アップデート
oracle4engineer
PRO
0
130
複数のスクラムチームをサポートするエンジニアリングマネジメントの話
okeicalm
0
1.1k
越境チャレンジの現在地 〜Epic大臣制度の今〜
yousak
0
900
Lessons Learned from Scaling Infrastructure as Code
joatmon08
0
790
Featured
See All Featured
Practical Orchestrator
shlominoach
178
8.6k
ParisWeb 2013: Learning to Love: Crash Course in Emotional UX Design
dotmariusz
100
5.9k
KATA
mclloyd
7
8.7k
A Tale of Four Properties
chriscoyier
149
21k
Clear Off the Table
cherdarchuk
79
280k
Testing 201, or: Great Expectations
jmmastey
21
5.4k
Music & Morning Musume
bryan
35
4.2k
Product Roadmaps are Hard
iamctodd
34
6.5k
The Mythical Team-Month
searls
209
39k
Large-scale JavaScript Application Architecture
addyosmani
499
110k
Creating an realtime collaboration tool: Agile Flush - .NET Oxford
marcduiker
4
510
Mobile First: as difficult as doing things right
swwweet
213
7.5k
Transcript
Sean Sullivan July 18, 2017 Portland Java User Group
• software engineer • 21 years on the JVM •
back office systems @ HBC About me
https://en.wikipedia.org/wiki/Hudson%27s_Bay_Company
saksfifthavenue.com saksoff5th.com lordandtaylor.com gilt.com thebay.com
API driven development
API descriptors
API descriptors are not a new concept
• 1996: CORBA 2.0 IDL • 1997: Java RMI remote
interfaces • 1999: EJB remote interfaces • 2000: WSDL 1.0 (SOAP)
• 2006: WADL (REST) • 2011: Swagger (REST) • 2014:
ApiDoc (REST) • 2017: ApiDoc rebranded to ApiBuilder
www.apibuilder.io
None
describe REST API in a JSON file
1. start by describing your models 2. map your models
to resources
gilt.com
www.gilt.com
• Rails app • one Git repo • monolith! Gilt:
2007 => 2008
• Rails app • JSP web framework • ~10 services
(Java) • handcrafted Java clients • weak typing (java.util.HashMap) Gilt: 2009 => 2010
• JSP’s • 100+ services (Java, Scala) • strongly typed
client libraries • Gilt “Commons” library Gilt: 2011 => 2013
• Gilt Commons library • 250+ services • dependency hell
• ApiBuilder project started on Github Gilt: 2014
Dependency hell Java runtime hell
• java.lang.NoClassDefFoundError • java.lang.NoSuchFieldError • java.lang.NoSuchMethodError Java runtime hell
Dependency hell kills productivity
None
Mitigating dependency hell • API design must be first class
• backwards and forward compatibility • accurate documentation • generated client libraries
• 350+ services • new services built with ApiBuilder +
generated clients • Gilt Commons library is deprecated Gilt: 2015 => 2017
Web Checkout Android Checkout iPhone Checkout Checkout service api.json
Generating client libraries with ApiBuilder
Code generators
None
None
Conclusion • API driven development • visit www.apibuilder.io
The end
None
Additional resources
Gilt 2013
Gilt 2015