Appreciate APIs on Android
Appreciate APIs on Android
$54.99
Regular Price
$46.99
Bundle Price

Appreciate APIs on Android

Retrofit: Love Working with APIs on Android
Build APIs You Won't Hate
The following 2 books are included in this bundle...

About the Bundle

  • Share this bundle

About the Books

Retrofit: Love Working with APIs on Android

Retrofit: Love Working with APIs on Android

Take delight in building API clients on Android.
  • 422

    Readers

  • 305

    Pages

  • 71,275

    Words

  • 100%

    Complete

  • PDF

  • EPUB

  • MOBI

  • APP

Painless Networking with Retrofit

The content of this book is completely updated to Retrofit 2.3!

Every modern Android app needs to connect to at least one private or public API. Interacting with services can be difficult due to the extreme variety of request and response formats. Depending on the API, you’ll need to change your request payloads, authentication, data formats, and much more.

Retrofit: a type-safe HTTP client for Android and Java

Retrofit handles all of the complicated and repetitive parts of network implementations for you. It hides the entire network layer, from creating a connection to processing the handling on a separate thread, from you. Retrofit even does the mapping of the requests and responses to Java objects for you (e.g., creating a JSON payload from your passed List<User>). You only need to describe what and how you want to send or receive it.

This awesomeness comes at a cost: an initial learning curve. Retrofit might look a little more complicated at the beginning, but pays off multiple times in the long run.

If you’re thinking about using Retrofit, or haven’t developed a deep knowledge of it yet, you’ll benefit from this book. We’ve created this book with the vision of being the ultimate guide to understanding Retrofit. After working through this book, you’ll be able to connect to new APIs and services within minutes.

You can find a Retrofit tutorial series on our website and our free video tutorial series on YouTube, where we describe some elements of Retrofit. The book extends and connects these tutorials into one common thread that guides you through all important aspects of Retrofit. The chapters are structured in a way that rewards a linear reading. Retrofit rookies can and should read it cover to cover. Experienced Retrofit developers can jump to specific sections for guides on how to solve their specific problem.

What Topics Are Covered in This Book?

The list below provides a comprehensive overview of covered topics in the book.

  • Introduction to Retrofit
  • Quick Start Guide to jump right into Retrofit
  • Creating a sustainable Android REST client
  • Extensive manipulation and customization of requests (e.g., query and path parameters, form-urlencoding, synchronous vs. asynchronous)
  • Cancel, analyze and re-use requests
  • Comprehensive overview of response converters and data mapping with plenty practical examples of applied (custom) converters
  • Implementing and handling authentication (basic, token, OAuth, hawk) in a smart way
  • File uploads, including multiple and dynamic amounts of files (optionally with progress updates)
  • File download (optionally with progress updates)
  • Detailed chapter on implementing pagination
  • Introduction and example of possible ways to deal with errors in a clean way
  • Debug requests and responses using three logging tools (OkHttp, Stetho, Android Studio Profiler)
  • Fundamentals for mocking server responses
  • Entire chapter on practical examples of custom converters dealing with specific scenarios
  • Extensive chapter on implementing response caching with Retrofit
  • Example for an offline mode based on cached server responses
  • A chapter with practical tips & tricks for Retrofit
  • App release preparation including ProGuard configuration

Additionally to the regular content we provide an appendix with three sections:

  • Upgrade guide from Retrofit 1.9 to 2.0
  • Java basics for Retrofit
  • Network basics for developers, who just started interacting with APIs

Who Is This Book For?

In short: this book is for you. We believe that every developer reading this book will take away new ideas on how to optimize their Android apps in the sense of interacting with APIs or web services using Retrofit. You’ll recognize goodies that are applicable for the projects you’re working on.

This book is for Android developers, who want to receive a substantial overview and reference book on Retrofit. You’ll benefit from clearly recognizable code examples related to your daily work with Retrofit.

Rookie

If you’re just starting out with Retrofit (or coming from another HTTP library like Android Asynchronous Http Client or Volley) this book will show you all important parts on how to create sustainable REST clients on Android. The provided code snippets let you jumpstart and create your first successful API client within minutes!

Expert

If you’ve already worked with Retrofit, you’ll profit from our extensive code snippets and apply the learnings to your existing code base. Additionally, the book illustrates various use cases for different functionalities and setups like authentication against different backends, request composition, file uploads and downloads, and much more!

One focus of this book is not only to implement the requirements, but also do so in a clean way. We’ve seen way to many complicated and messy usages of Retrofit. We focus on providing code samples which adhere to clean code standards. We avoid any unnecessary duplication at all costs. This has the side effect of some extra app performance gains by efficient Java object handling.

Source Code Samples

With the purchase of this book, you benefit from the sample project that awaits your download within the extras section on Leanpub. The sample project is an Android project based on gradle. You can directly touch and use classes that are only illustrated in excerpts within this book.

Check your Leanpub Library and select Retrofit: Love working with APIs on Android to download the sample code base.

Continuous Updates

We’ve published the first version of this Retrofit book in July 2015. Since this initial release we’ve extended and updated the book more than a dozen times. Once you buy the book, you get all future updates for free. Even if it’s a huge Retrofit update, for example from version 1.9 to 2.0. With every new release of Retrofit we’ll evaluate the entire book content and update it accordingly.

Of course, we’re listening to your feedback and add new sections and even chapters, if it can be useful to all readers. If you still have a question after reading this book, let us know and we might be able to help!

Still Unsure?

If you’re still on the fence if this book helps you, checkout the sample or, even better, use Leanpub’s (and our) happiness guarantee. Try this book out and if you don’t think this book provides enough value, you can refund your money within 45 days with no questions asked. You don’t have any risk in testing this book, which saves you hours of headaches and makes your Android app code so much cleaner.

Final Note: Retrofit Book for Version 1.9

The current version of this book is fully focused on Retrofit 2.x, no hint or code snippet that points to Retrofit 1. If you’re interested in the first version of the book that based on Retrofit 1, please visit this book’s extras page on Leanpub. As a reader of this book, the first version is also available for you!

Build APIs You Won't Hate

Build APIs You Won't Hate

Everyone and their dog wants an API, so you should probably learn how to build them.
  • 4,597

    Readers

  • 194

    Pages

  • 38,206

    Words

  • 100%

    Complete

  • PDF

  • EPUB

  • MOBI

  • APP

API development is becoming increasingly common for server-side developers thanks to the rise of front-end JavaScript frameworks, iPhone applications, and API-centric architectures. It might seem like grabbing stuff from a data source and shoving it out as JSON would be easy, but surviving changes in business logic, database schema updates, new features, or deprecated endpoints can be a nightmare.

After finding many of the existing resources for API development to be lacking, Phil learned a lot of things the hard way through years of trial and error. This book aims to condense that experience, taking examples and explanations further than the trivial apples and pears nonsense tutorials often provide.

Phil worked primarily as an API developer for the last three years. One horror was managing an API built in FuelPHP by a freelancer at the million dollar startup he joined. It was utilizing a then deprecated ORM which had been hacked to death by the previous developer, so took the time to delete that mess and build the next version in Laravel, leveraging it's simple routing, database migrations, schema, seeding, etc. When the following major version of the API was built no rewrite was required, and both managed to live side-by-side on the same "API" servers.

By passing on some best practices and general good advice you can hit the ground running with API development, combined with some horror stories and how they were overcome/avoided/averted. This book will discuss the theory of designing and building APIs in any language or framework, with this theory applied in PHP-based examples.

Some of the more advanced topics covered here are endpoint testing, embedding data objects in a consistent and scalable manner, paginating responses (including embedded objects) and hypermedia "HATEOAS" controls.

About the Authors

Future Studio
Marcus Pöhls

Marcus is an enthusiastic Android & Java developer. He’s developed multiple production-ready client and server applications. While following the core principle of performance for client apps, he also builds REST+JSON APIs that focus on clear and consistent design.

Besides his day job, sharing knowledge and teaching others has become a characteristic he never wants to miss.

Marcus has a Master’s degree in computer science from the Otto von Guericke University Magdeburg.

Feel free to get in touch on Twitter @marcuspoehls.

Phil Sturgeon
Phil Sturgeon

Phil has seen a few trends come and go during a long and varied career of building stuff for money as an employee, freelancer, consultant and now CTO. One trend over recent years is the rise of APIs as an everyday part of the average server-side developers job.

Back in 2009 Phil released a CodeIgniter Rest Server, wrote a few articles about how to use it and built handfuls of APIs for his freelance clients. This tool was fairly basic, but covered HTTP-based routing, HTTP Basic/Digest/API Key authentication, added logging and throttling and did not force CRUD-based conventions. The internet seemed to like it, and this code is still used by Apple, the UN and USA.gov.

Later on as a core-contributor to FuelPHP he added this functionality to the core, and again built out a bunch of APIs for people. Then he got a job in NYC, to take over as Lead Engineer for a company that - you guessed it - had a FuelPHP API and wanted to improve it.

After two years of working on their API, Phil has moved to Ride.com, building their API with an amazing team of developers.

Phil has been building APIs for so long, he has come up with a very long list of ways to make them not suck, and he'd like to share the information with you all.

The Leanpub 45-day 100% Happiness Guarantee

Within 45 days of purchase you can get a 100% refund on any Leanpub purchase, in two clicks.
See full terms

Write and Publish on Leanpub

Authors and publishers use Leanpub to publish amazing in-progress and completed ebooks, just like this one. You can use Leanpub to write, publish and sell your book as well! Leanpub is a powerful platform for serious authors, combining a simple, elegant writing and publishing workflow with a store focused on selling in-progress ebooks. Leanpub is a magical typewriter for authors: just write in plain text, and to publish your ebook, just click a button. It really is that easy.

Learn more about writing on Leanpub