Table Of ContentServer Side Swift with Kitura
Server Side Swift with Kitura
By Chris Bailey & David Okun
Copyright ©2019 Razeware LLC.
Notice of Rights
All rights reserved. No part of this book or corresponding materials (such as text,
images, or source code) may be reproduced or distributed by any means without prior
written permission of the copyright owner.
Notice of Liability
This book and all corresponding materials (such as source code) are provided on an “as
is” basis, without warranty of any kind, express or implied, including but not limited to
the warranties of merchantability, fitness for a particular purpose, and
noninfringement. In no event shall the authors or copyright holders be liable for any
claim, damages or other liability, whether in action of contract, tort or otherwise,
arising from, out of or in connection with the software or the use of other dealing in the
software.
Trademarks
All trademarks and registered trademarks appearing in this book are the property of
their own respective owners.
raywenderlich.com 2
Server Side Swift with Kitura
Dedications
"To the Kitura core team and community, without whom none of this
would exist, and to Dave Okun who said the ominous words: “It’ll be
fun, it’ll only take a couple of weeks…"
— Chris Bailey
"To anyone who’s ever stepped outside of your comfort zone - this is
for you. Also, thank you to Kendrick Lamar, Trent Reznor, Atticus
Ross, Gaspard Augé, Xavier du Rosnay, and Mick Gordon."
— David Okun
raywenderlich.com 3
Server Side Swift with Kitura
About the Authors
Chris Bailey is a co-author of this book. Chris is a software developer
and architect at IBM. He’s been working on programming languages
and web frameworks longer than it's polite to discuss. Somewhere
along that journey, he got got involved in the very early days of Swift
on Linux and became the chief architect for the Kitura web
framework.
David Okun is a co-author of this book. He is a mobile software
developer turned developer advocate for IBM in Austin, Texas. David
has been primarily focused on iOS mobile software, but is also
interested in Swift on the Server, and other web technologies such as
Node.js.
About the Editors
Yono Mittlefehldt is a Tech Editor of this book. He is an indie
developer specializing in iOS and backend development. He is a co-
creater of Gus on the Go, a language learning app for kids. Yono
speaks 3 languages fluently and 4 more at a novice level. He has been
programming since he was 7 years old, because he enjoys it. Basically,
he likes languages and coding. That's his jam.
Brian Schick is a Tech Editor of this book. Brian lives in Ashland,
Oregon, and is Mobile Team Lead with Beezwax in Oakland,
California. Brian has mastered a wide range of technologies, from
deep data to frontend UI and UX tools and approaches. Currently, he's
very happily obsessed with all things Swift. When not coding, Brian
can be found exploring the mountains and coast of southern Oregon,
tending bamboo groves, working with wood, or hanging with a craft
brew in hand.
Manda Frederick is the Editor of this book. She has been involved in
publishing for over ten years through various creative, educational,
medical and technical print and digital publications, and is thrilled to
bring her experience to the raywenderlich.com family as Managing
Editor.
raywenderlich.com 4
Server Side Swift with Kitura
Jerry Beers is the Final Pass Editor of this book. Jerry is co-founder of
Five Pack Creative, a mobile development company specializing in
iOS development. He is passionate about creating well-crafted code
and teaching others. You can find his company's site at
fivepackcreative.com.
About the Artist
Vicki Wenderlich is the designer and artist of the cover of this book.
She is Ray's wife and business partner. She is a digital artist who
creates illustrations, game art and a lot of other art or design work for
the tutorials and books on raywenderlich.com. When she's not
making art, she loves hiking, a good glass of wine and attempting to
create the perfect cheese plate.
raywenderlich.com 5
Server Side Swift with Kitura
Table of Contents: Overview
Book License ............................................................................ 12
Book Source Code & Forums............................................. 13
Book Updates .......................................................................... 14
About the Cover ..................................................................... 15
Chapter 1: Introduction....................................................... 16
Chapter 2: Hello, World!..................................................... 23
Chapter 3: RESTful APIs...................................................... 49
Chapter 4: Introduction to Codable ............................... 62
Chapter 5: Codable Routing .............................................. 76
Chapter 6: The OpenAPI Specification.......................... 94
Chapter 7: KituraOpenAPI.............................................. 111
Chapter 8: SwiftKueryORM............................................ 131
Chapter 9: Authentication............................................... 150
Chapter 10: Multi-User Support................................... 165
Chapter 11: KituraStencil: Getting Started.............. 186
Chapter 12: KituraStencil: Authentication,
Adding & Deleting............................................................... 200
Chapter 13: Using Other Services................................ 221
Chapter 14: HTTPS Certificates.................................... 243
raywenderlich.com 6
Server Side Swift with Kitura
Chapter 15: Going Live...................................................... 255
Conclusion.............................................................................. 291
raywenderlich.com 7
Server Side Swift with Kitura
Table of Contents: Extended
Book License ............................................................................ 12
Book Source Code & Forums............................................. 13
Book Updates .......................................................................... 14
About the Cover ..................................................................... 15
Chapter 1: Introduction....................................................... 16
What is Kitura?................................................................................................................... 16
EmojiJournal........................................................................................................................ 22
Chapter 2: Hello, World!..................................................... 23
Creating your project....................................................................................................... 23
Working in Xcode.............................................................................................................. 27
Creating a Kitura server.................................................................................................. 28
Creating a “Hello, world!” response........................................................................... 30
A fully featured “Hello, world!” Kitura project....................................................... 32
Running your app on Linux using Docker................................................................. 44
Chapter 3: RESTful APIs...................................................... 49
REpresentational State Transfer (REST).................................................................. 49
HyperText Transfer Protocol (HTTP)......................................................................... 51
HTTP-based RESTful APIs............................................................................................. 51
Building RESTful APIs...................................................................................................... 60
Chapter 4: Introduction to Codable ............................... 62
The bare necessities......................................................................................................... 63
Expanding your type declaration................................................................................. 65
Date formatting and the ISO8601 standard........................................................... 68
Nested objects and custom coding keys................................................................... 71
Where to go from here?.................................................................................................. 75
Chapter 5: Codable Routing .............................................. 76
raywenderlich.com 8
Server Side Swift with Kitura
Raw Routing and Codable Routing............................................................................. 77
Building a RESTful API to store a journal entry..................................................... 78
Adding a GET API to retrieve all JournalEntry data............................................ 88
Adding a DELETE API to remove a journal entry.................................................. 90
Your completed RESTful API!....................................................................................... 92
Where to go from here?.................................................................................................. 93
Chapter 6: The OpenAPI Specification.......................... 94
The goals of Swagger........................................................................................................ 95
Generating your specification...................................................................................... 97
Examining your specification..................................................................................... 100
Using the Kitura OpenAPI UI..................................................................................... 102
Generating an SDK for your iOS app....................................................................... 106
Where to go from here?................................................................................................ 109
Chapter 7: KituraOpenAPI.............................................. 111
Updating a journal entry.............................................................................................. 112
Retrieving a journal entry by its id........................................................................... 115
Retrieving filtered results............................................................................................ 119
Examining your latest OpenAPI specification..................................................... 122
Updating your iOS app.................................................................................................. 122
Retrieving your journal entries on iOS................................................................... 124
Adding a new entry on iOS.......................................................................................... 125
Filtering GET requests on iOS................................................................................... 126
Updating a journal entry on iOS................................................................................ 129
Deleting a journal entry from the iOS app............................................................ 130
Where to go from here?................................................................................................ 130
Chapter 8: SwiftKueryORM............................................ 131
SwiftKueryORM and the Model protocol............................................................. 132
Enabling SwiftKueryORM in your EmojiJournalServer project................... 134
Installing PostgreSQL.................................................................................................... 134
Connecting SwiftKueryORM to PostgreSQL...................................................... 135
Making your JournalEntry conform to Model..................................................... 137
Saving, fetching and deleting JournalEntry instances...................................... 138
raywenderlich.com 9
Server Side Swift with Kitura
More complex database queries............................................................................... 145
Running on Linux in Docker........................................................................................ 146
Where to go from here?................................................................................................ 148
Chapter 9: Authentication............................................... 150
Types of authentication................................................................................................ 150
Authentication for your EmojiJournalServer...................................................... 152
Authentication for your EmojiJournalMobileApp............................................. 161
Enhancing your security............................................................................................... 163
Chapter 10: Multi-User Support................................... 165
Managing users................................................................................................................ 165
Adding multi-user support.......................................................................................... 173
Cleaning up........................................................................................................................ 182
Expanding user support................................................................................................ 185
Chapter 11: KituraStencil: Getting Started.............. 186
Web frontends................................................................................................................. 187
Wait... templating?.......................................................................................................... 188
Loops and other operations in Stencil.................................................................... 190
Adding Stencil to your project................................................................................... 191
Where to go from here?................................................................................................ 199
Chapter 12: KituraStencil: Authentication,
Adding & Deleting............................................................... 200
Finishing your web layout............................................................................................ 201
Making the web buttons work................................................................................... 208
Signup and login functionality.................................................................................... 210
Adding a journal entry on the web........................................................................... 214
Deleting a journal entry on the web........................................................................ 218
Viewing only your journal entries............................................................................ 219
Where to go from here?................................................................................................ 220
Chapter 13: Using Other Services................................ 221
The Fortune Cookie API............................................................................................... 221
raywenderlich.com 10
