book

RESTful Web Clients

by Mike Amundsen

February 2017

Intermediate to advanced

350 pages

8h 1m

English

O'Reilly Media, Inc.

Read now

Unlock full access

What’s in This BookThe ChaptersThe DialoguesThe ArtworkWhat’s Not in This BookUser Interface DesignBasics of HypermediaProgramming with HTML, CSS, and JavaScriptSource CodeExternal ReferencesConventions Used in This BookO’Reilly SafariHow to Contact UsAcknowledgments
References
Credits
The Task Processing System (TPS) Web AppHTML from the ServerCommon Web Browser as the ClientObservationsThe Task Services Web APIWeb API Common PracticeDesigning the TPS Web APIImplementing the TPS Web APIObservationsSummaryReferences
The JSON Web API ClientObjectsAddressesActionsQuick SummaryThe JSON SPA ClientThe HTML ContainerThe Top-Level Parse LoopObjects, Addresses, and ActionsDealing with ChangeAdding a Field and FilterCoding a New ClientSummaryReferences
XML or JSON: Pick a Side!The New Crop of Hypermedia FormatsThe Fallacy of The Right OneReframing the ProblemThe Representor PatternSeparating Format from FunctionalityThe Selection AlgorithmAdapting and TranslatingA Server-Side ModelHandling the HTTP Accept HeaderImplementing the Message Translator PatternGeneral Representor ModulesThe WeSTL FormatA Sample RepresentorSummaryReferences
The HAL FormatLinksObjects and PropertiesEmbedded Links and ObjectsQuick SummaryThe HAL RepresentorLinksPropertiesEmbeddedSample TPS Output from the HAL RepresentorThe HAL SPA ClientThe HTML ContainerThe Top-Level Parse LoopLinksEmbeddedPropertiesHandling Actions for HALQuick SummaryDealing with ChangeAdding an ActionThe HAL-FORMS ExtensionThe SpecificationThe ImplementationSummaryReferences
What Problem Are You Solving?Double Diamond Model of DesignClosed Solution Versus Open SolutionModeling InteractionMaldonado’s MechanismsVerplank’s HumansA Hypermedia Interaction LoopThe Request, Parse, Wait LoopImplementing RPW in CodeHandling Verplank’s KNOW StepSummaryReferences
The Siren FormatEntitiesClassPropertiesLinksActionsSubEntitiesQuick SummaryThe Siren RepresentorThe Top-Level LoopClassPropertiesEntitiesActionsLinksSample TPS Output from the Siren RepresentorThe Siren SPA ClientThe HTML ContainerThe Top-Level Parse LoopLinksEntitiesPropertiesActionsQuick SummaryDealing with ChangeAdding the Email Field and FilterTesting the Email FieldThe Profile Object Description (POD) ExtensionThe POD SpecificationThe ImplementationDisplaying Objects in Siren Using PODQuick SummarySummaryReferences

Versioning for the InternetTCP/IP’s Robustness PrincipleHTTP’s Must IgnoreHTML’s Backward CompatibilityGuidelines for Non-Breaking ChangesAPI DesignersServer ImplementorsClient ImplementorsSummaryReferences
The Collection+JSON FormatLinksItemsQueriesTemplateErrorA Quick SummaryThe Collection+JSON RepresentorThe Top-Level Processing LoopLinksItemsQueriesTemplateErrorThe Collection+JSON SPA ClientThe HTML ContainerThe Top-Level Parse LoopLinksItemsQueriesTemplateErrorQuick SummaryDealing with ChangeAdding the Note Object to the TPS APICj and the OAA ChallengeQuick SummaryExtending Collection+JSONSupporting Improved Input with Cj-TypesThe Cj-Suggest ExtensionQuick SummarySummaryReferences
The Unix PhilosophyThe TPS Microservices at BigCoThe Tasks Service with Collection+JSONThe User Service with SirenThe Notes Service with HALOne Client to Rule Them AllThe Home ServiceThe Multiformat Client SPA ContainerThe Format-Switching Client UISummaryReferences
Chapter 1, Our HTML Roots and Simple Web APIsChapter 2, JSON ClientsChapter 3, The Representor PatternChapter 4, HAL ClientsChapter 5, The Challenge of Reusable Client AppsChapter 6, Siren ClientsChapter 7, Versioning and the WebChapter 8, Collection+JSON ClientsChapter 9, Hypermedia and Microservices
HardwareSoftwareLibrariesServices

Content preview from RESTful Web Clients

Chapter 1. Our HTML Roots and Simple Web APIs

“What’s so fascinating and frustrating and great about life is that you’re constantly starting over, all the time, and I love that.”

Billy Crystal

Bob and Carol

“Hello, Carol. I’m Bob. I wanted to stop by to talk.”

“Right, Bob. I remember you from the acquisition party last month. Good to see you again. What’s up?”

“Well, remember at the party you and I talked about working on a new project together? I was thinking about teaming up to work on taking the TPS project to the next level.”

“Right, the Task Processing System. That’s a great idea, Bob. I think the current TPS HTML app has lots of potential and can help people all over the company better manage their time and resources.”

“I agree. So, as a first step, let’s set up two teams. How about you form a new team to focus on the client side while I take on the existing group to work exclusively on the server side.”

“So, I guess you’ll be in charge of the switch from HTML-only ...