Kluczowe wnioski
Traktuj sieć jako system hipermedialny, a nie potok JSON
Sieć to system. Hipermedia to treści zawierające mechanizmy nawigacji lub działania, takie jak łącza i formularze HTML. System hipermedialny łączy ten format z protokołem sieciowym, serwerem zwracającym reprezentacje oraz klientem, który potrafi je wyświetlać. W sieci te elementy to HTML, HTTP, serwery WWW i przeglądarki. Książka określa aplikacje zbudowane wokół takich wymian mianem aplikacji sterowanych hipermediami (Hypermedia-Driven Applications, czyli HDA).
REST to coś więcej niż HTTP. Roy Fielding użył pojęcia REST do opisania architektury sieciowej WWW, w której klienci i serwery komunikują się za pośrednictwem hipermediów. Odpowiedź JSON zawierająca wyłącznie dane nie jest hipermediami: klient musi już wiedzieć, co oznaczają poszczególne pola i do których punktów końcowych wysyłać żądania. Autorzy argumentują, że nazywanie każdego interfejsu JSON opartego na HTTP interfejsem REST zaciera tę różnicę.
Uderzające jest to, że spór dotyczy miejsca, w którym znajduje się wiedza o aplikacji, a nie tego, czy modniejszy jest JSON, czy HTML. W API danych klient ma mapę domeny i jej operacji. W systemie hipermedialnym serwer wysyła wraz z bieżącą reprezentacją zestaw dostępnych działań. To rozróżnienie pomaga zespołom precyzyjnie rozmawiać o architekturze. Zapobiega też błędowi kategorialnemu: samo HTTP nie sprawia, że API jest REST-owe w rozumieniu Fieldinga. Argument jest najmocniejszy w odniesieniu do interfejsów przeznaczonych dla ludzi, a nie jako teza, że API danych są z zasady chybionym pomysłem.
Niech każda odpowiedź serwera ujawnia działania dostępne w bieżącym stanie
Mechanizmy sterujące zawierają instrukcje. Mechanizm sterujący hipermedialny opisuje interakcję, w tym miejsce, do którego trafia żądanie, i sposób jego wysłania. W HTML element kotwicy wskazuje cel żądania GET, a formularz określa adres docelowy, metodę i wartości do przesłania. Przeglądarka może wyświetlać takie mechanizmy i z nich korzystać, nie znając pojęć leżących u podstaw aplikacji.
Stan jest przekazywany razem z interfejsem. Przykład kontaktu w książce dobrze to ilustruje. Reprezentacja aktywnego kontaktu udostępnia działanie „Archiwizuj”; po zarchiwizowaniu zamiast niego pojawia się „Przywróć z archiwum”. HTML przekazuje zarówno stan kontaktu widoczny na ekranie, jak i działanie, które ma sens w danej chwili. Klient JSON otrzymujący jedynie pole statusu musi zawierać dodatkowe reguły, by wywnioskować, jakie działania udostępnić. Ta zasada hipermedialna nosi nazwę HATEOAS: hipermedia pełnią rolę silnika stanu aplikacji.
Taka konstrukcja przenosi miejsce wprowadzania zmian, zamiast je eliminować. Serwer może zmieniać dostępne działania, a klient nadal może je wyświetlać, ograniczając potrzebę skoordynowanych wydań klienta w miarę rozwoju procesów. Przeglądarka sprawdza się, ponieważ jej zadanie jest celowo ogólne: ma interpretować HTML, a nie rozumieć kontakty. Równie ważne jest jednak ograniczenie. Klient hipermedialny musi rzeczywiście umieć interpretować dany format; niestandardowy program oczekujący ustalonego schematu JSON nie skorzysta po prostu z odnośników, których nie potrafi użyć.
Stosuj hipermedia w procesach sterowanych przez serwer, nie w każdym interfejsie
Nie komplikuj zwykłych zadań. Contact.app to typowa aplikacja do tworzenia, odczytywania, aktualizowania i usuwania danych. Jej wartość tkwi głównie w danych i regułach po stronie serwera, dlatego łącza i formularze dobrze się tu sprawdzają. Dzięki HTML renderowanemu na serwerze przeglądarka obsługuje nawigację, bezpośrednie odnośniki i przycisk Wstecz, bez routera po stronie klienta ani drugiego modelu domeny.
Złożoność stosuj wybiórczo. Arkusz kalkulacyjny to inny przypadek: zmiana jednej komórki może wpłynąć na wiele pozostałych, być może przy każdym naciśnięciu klawisza. Przesyłanie każdej zmiany na serwer i z powrotem może być zbyt wolne, a interfejs nie ma wyraźnej granicy określającej, co trzeba zaktualizować. Autorzy zalecają bogaty klient do obsługi tej podstawowej funkcji, a proste elementy, takie jak strony ustawień, pozostawiają sterowane hipermediami. Projekt ma ograniczony budżet złożoności, więc rozbudowane rozwiązania warto stosować tam, gdzie wymaga tego zadanie.
Praktyczny wniosek dotyczy podziału odpowiedzialności architektonicznej, a nie rywalizacji, w której jeden wybór zawsze wygrywa. Produkt może mieć złożony rdzeń i wiele prostych elementów na obrzeżach; traktowanie wszystkich ekranów jako równie wymagających prowadzi do nieefektywnego wykorzystania wysiłku inżynierskiego. Przykład arkusza kalkulacyjnego dobrze wyznacza granicę, bo pokazuje, czym szybkie, ściśle powiązane interakcje różnią się od procesów sterowanych przez serwer. Ta sama zasada przestrzega przed wciskaniem hipermediów do interakcji tylko po to, by zachować ideologiczną spójność. Prostota jest cechą całego systemu, a nie pojedynczej technologii.
Używaj htmx, by uatrakcyjnić interakcje z HTML bez zmiany architektury
Rozszerz istniejące mechanizmy. W zwykłym HTML żądania do serwera wysyła się głównie za pomocą łączy i formularzy, a dostępne są tylko metody GET i POST. Biblioteka htmx dodaje atrybuty, dzięki którym inne elementy mogą wysyłać żądania GET, POST, PUT, PATCH lub DELETE, określać zdarzenia je wyzwalające oraz wskazywać fragmenty strony do zastąpienia. Odpowiedzią nadal pozostaje HTML, więc interfejs dostarcza serwer, a nie ładunek JSON renderowany po stronie klienta.
Contact.app rozwija się stopniowo. Dzięki htmx nawigację można zamienić w żądania wysyłane w tle, sprawdzać adres e-mail podczas wpisywania, dopisywać wyniki po kliknięciu „Załaduj” lub podczas nieskończonego przewijania, a także usuwać wiersz tabeli po usunięciu kontaktu. Biblioteka obsługuje również historię przeglądarki i wskaźniki aktywności żądań. Te dodatki zapewniają bogatszą interakcję, zachowując centralną rolę znaczników renderowanych na serwerze i wymiany HTTP.
Kluczowym wyborem projektowym w tej bibliotece jest niewielki dystans pojęciowy od HTML. Zamiast budować równoległy model klienta i potok renderowania, programiści deklarują w znacznikach żądanie i element docelowy. Dzięki temu łatwiej sprawdzić, jak działa interakcja, w miejscu, w którym została zdefiniowana. Kompromis polega na tym, że deklaratywne atrybuty także mogą prowadzić do skomplikowanych zachowań, zwłaszcza gdy wiele elementów wzajemnie się aktualizuje. To podejście ogranicza pewien rodzaj złożoności, ale nie zwalnia z projektowania interakcji, dbałości o dostępność ani testowania.
Używaj metod HTTP i odpowiedzi, które opisują, co naprawdę się wydarzyło
Pozwól protokołowi spełniać jego zadanie. GET pobiera reprezentację, a POST, PUT, PATCH i DELETE oznaczają różne rodzaje zmian. Zwykły HTML nie może bezpośrednio wysyłać żądań każdą z tych metod, ale htmx już tak. Dzięki temu Contact.app może usunąć kontakt za pomocą DELETE pod adresem URL tego kontaktu, zamiast wymyślać osobną ścieżkę usuwania i wysyłać żądanie POST.
Kody przekierowań mają znaczenie. Po żądaniu powodującym nieodwracalną zmianę odpowiedź 303 informuje klienta, by pobrał następną stronę metodą GET. Kod 302 może zachować pierwotną metodę, co oznaczałoby, że przekierowane żądanie DELETE nadal pozostałoby żądaniem DELETE. Książka zwraca też uwagę na buforowanie HTTP za pomocą nagłówków takich jak Cache-Control i Vary. Jeśli punkt końcowy zwraca różną treść w zależności od nagłówka żądania htmx, nagłówek Vary musi wskazywać tę różnicę, aby buforowane pełne strony nie były mylone z odpowiedziami częściowymi.
Semantyka protokołu jest przydatna, ponieważ pozwala zrozumieć zachowanie niezależnie od konkretnego kodu, który je realizuje. Żądanie DELETE komunikuje zamiar, a kod przekierowania mówi klientowi, co ma zrobić dalej. Te konwencje ujawniają też błędy, które framework mógłby w przeciwnym razie ukryć. Przykłady z książki pokazują, że pozornie nieistotna wartość domyślna kodu odpowiedzi może zmienić znaczenie całej interakcji. Zespoły powinny jednak sprawdzać rzeczywiste zachowanie frameworka i klienta, zamiast zakładać, że sformułowania standardów gwarantują identyczne działanie każdej implementacji.
Zwracaj tylko ten fragment interfejsu, którego użytkownik potrzebuje w danej chwili
Małe odpowiedzi mogą sprawiać wrażenie szybszych. W Contact.app aktywne wyszukiwanie odczekuje chwilę po wpisaniu tekstu, a następnie prosi serwer o pasujące wiersze kontaktów. Serwer może zwrócić tylko te wiersze, zamiast całej strony. Opóźnienie zapobiega wysyłaniu żądania po każdym naciśnięciu klawisza, a wskaźnik żądania informuje użytkownika, że operacja trwa. Zwykły formularz nadal umożliwia wyszukiwanie bez JavaScriptu, dzięki czemu ulepszenie ma charakter progresywny.
Odkładaj na później zadania drugorzędne. Obliczenie łącznej liczby kontaktów w aplikacji może potrwać nawet półtorej sekundy. Przeniesienie go do osobnego punktu końcowego i załadowanie po wyświetleniu głównej strony pozwala użytkownikom wcześniej rozpocząć pracę. Samo obliczenie nie stało się szybsze — jego opóźnienie przestało blokować główne zadanie. Ten sam wzorzec sprawdza się przy długotrwałym archiwizowaniu: rozpocznij zadanie, odpytuj o postęp, a po jego zakończeniu pokaż odnośnik do pobrania.
Te przykłady pokazują różnicę między odczuwaną responsywnością a rzeczywistym czasem wykonania. Użytkownik może korzystać z przydatnej części strony, gdy docierają informacje drugorzędne, a odpowiedzi częściowe pozwalają uniknąć ponownego generowania niezmienionych treści. Nie chodzi tu tyle o asynchroniczność wszystkiego, ile o ustalenie, co musi być gotowe w pierwszej kolejności. Odłożone zadania nadal zużywają zasoby i mogą dezorientować użytkowników, jeśli ich stan nie jest widoczny — dlatego wskaźnik postępu archiwizacji i animacja ładowania przy wyszukiwaniu są równie ważne jak samo żądanie.
Ogranicz skrypty klienckie do obsługi interakcji, zamiast budować drugi model aplikacji
Pisz skrypty, nie porzucając hipermediów. Książka definiuje skrypty przyjazne hipermediom za pomocą dwóch ograniczeń: głównym formatem komunikacji między klientem a serwerem pozostają hipermedia, a stan poza DOM-em jest ograniczony. Skrypty mogą obsługiwać lokalne interakcje, takie jak menu, skrót klawiszowy czy pasek narzędzi do operacji zbiorczych, podczas gdy serwer zachowuje kontrolę nad regułami biznesowymi i decyzjami dotyczącymi prezentacji.
Dbaj o łatwą lokalizację zachowania. Lokalność zachowania (Locality of Behavior) oznacza, że czytelnik powinien móc ustalić, co robi dany element, oglądając jego znaczniki, bez przeszukiwania niepowiązanych selektorów i plików. Książka porównuje zwykły JavaScript, Alpine.js i hyperscript jako sposoby dodawania zachowania w pobliżu odpowiedniego elementu. Zaleca też wykorzystanie zdarzeń do łączenia komponentów bez wpisywania na sztywno bezpośrednich zależności. Jeśli funkcja wymaga rozbudowanego modelu po stronie klienta, lepszym wyborem może być bogatsza architektura kliencka.
To użyteczniejsze rozróżnienie niż samo liczenie wierszy JavaScriptu. Krótki skrypt nadal może tworzyć ukrytą aplikację po stronie klienta, podczas gdy bardziej rozbudowana lokalna interakcja może pozostawać podporządkowana hipermediom renderowanym na serwerze. Nacisk na lokalność sprawia, że przegląd kodu i jego utrzymanie stają się bardziej konkretne: zachowanie powinno być łatwe do odnalezienia, a stan powinien mieć jasno określone miejsce. To podejście wymaga jednak dyscypliny. Przy złożonych interakcjach stan DOM-u może być niewygodny, dlatego ograniczanie stanu zewnętrznego powinno być celem projektowym, a nie regułą nadrzędną wobec rzeczywistych potrzeb funkcji.
Przeznacz API JSON do odrębnej roli, zamiast zmuszać jeden interfejs do obsługi wszystkich
Różni klienci potrzebują różnych kontraktów. Przeglądarka może korzystać z API hipermedialnego, bo rozumie HTML i jego mechanizmy sterujące. Zautomatyzowany import, integracja partnerska lub klient mobilny bez mechanizmu renderującego hipermedia mogą wymagać zamiast tego ustrukturyzowanych danych. Książka zaleca udostępnienie do takich zastosowań API danych JSON, zamiast zmuszać klientów do analizowania HTML.
Pozwól, by kontrakty rozwijały się niezależnie. Klienci JSON zwykle zależą od udokumentowanych nazw pól, punktów końcowych i zachowania, więc zmiany mogą wymagać wersjonowania i zachowania zgodności wstecznej. Interfejs hipermedialny może zmieniać dostępne łącza i formularze wraz ze zmianami odpowiedzi serwera. Contact.app umieszcza punkty końcowe JSON pod wersjonowaną ścieżką, na przykład /api/v1, oddzielnie od ścieżek interfejsu użytkownika. Wspólna logika domenowa może pozostać w modelu, a każde API może mieć kontrolery i odpowiedzi dostosowane do swoich klientów.
Rozdzielenie interfejsów nie jest niepotrzebnym powielaniem, jeśli służą różnym celom. Proces dla użytkownika korzysta z reprezentacji zawierającej dostępne działania, a proces wsadowy — z przewidywalnych struktur danych. Kluczowe jest współdzielenie reguł domenowych bez udawania, że potrzeby klientów są identyczne. Taki podział oznacza jednak dodatkowe ścieżki i konieczność testowania. Opłaca się, gdy zespół potrafi utrzymać wyraźne granice, zamiast pozwolić, by specjalny punkt końcowy interfejsu stał się przypadkowo publicznym kontraktem danych.
Wybieraj mobilne hipermedia, gdy kontrola serwera jest ważniejsza niż niezależność działania offline
Interfejsy renderowane na serwerze sprawdzają się również na urządzeniach mobilnych. Hyperview to mobilny system hipermedialny oparty na HXML, formacie przypominającym XML, oraz kliencie dla systemów iOS i Android. Odpowiedzi opisują ekrany, mechanizmy sterujące i zachowania aplikacji mobilnej. Serwer może definiować nawigację, formularze, aktualizacje list i działania, zamiast dzielić reguły aplikacji między natywnego klienta a API JSON.
Jeden model, reprezentacje dostosowane do potrzeb. W książce Contact.app zostaje przeniesiona z ponownym wykorzystaniem jej tras Flask, modelu domenowego i szablonów Jinja, przy jednoczesnym dodaniu szablonów HXML dla urządzeń mobilnych. Negocjacja zawartości HTTP może wysyłać HTML do przeglądarki, a HXML do Hyperview. Klienta mobilnego można też rozszerzyć o natywne działania i komponenty, takie jak połączenia telefoniczne, e-mail, wiadomości i przesuwane wiersze. Aplikację przeznaczoną do jednego celu nadal trzeba dystrybuować za pośrednictwem sklepów z aplikacjami mobilnymi.
Hyperview pokazuje, że hipermedia to koncepcja architektoniczna, a nie synonim stron przeglądarkowych. Serwer może pozostać źródłem logiki procesów, a jednocześnie dostarczać reprezentację uwzględniającą wzorce nawigacji i interakcji danej platformy. Ważna jest możliwość dostosowania klienta: sterowanie przez serwer nie oznacza, że każdy ekran musi wyglądać tak samo. Model ten wymaga jednak dostępnej sieci i odpowiedniego klienta. Tryb offline-first oraz wysoce dynamiczne interfejsy lokalne nadal przemawiają za przeniesieniem większej odpowiedzialności na urządzenie.
Traktuj semantyczny HTML jako umowę z przeglądarkami i narzędziami asystującymi
Wybieraj elementy zgodnie z ich określoną rolą. Zwykły element div z obsługą kliknięcia nie zachowuje się automatycznie jak przycisk: może nie otrzymywać fokusu z klawiatury, a technologia asystująca może nie rozpoznawać jego przeznaczenia. Prawdziwy przycisk ma wbudowaną semantykę interakcji. HTML pomaga też przeglądarkom, czytnikom ekranu, wyszukiwarkom i innym programom zrozumieć stronę.
Znaczniki nie są magicznym rozwiązaniem. Książka przestrzega przed założeniem, że HTML jest domyślnie dostępny. Niestandardowe karty, menu i inne improwizowane mechanizmy sterujące wymagają prawidłowej obsługi klawiatury i atrybutów dostępności, a niepoprawne znaczniki semantyczne mogą wprowadzać oprogramowanie w błąd. Wybieraj elementy zgodnie ze specyfikacją HTML i testuj rezultat za pomocą klawiatury oraz technologii asystujących. Gdy bezpieczniej jest użyć komponentu przeznaczonego do danego celu lub biblioteki interakcji, lepiej z nich skorzystać, niż unikać JavaScriptu dla samej zasady.
Głębsza lekcja jest taka, że znaczniki stanowią interfejs współdzielony przez różne narzędzia interpretujące, a nie tylko rusztowanie do stylizacji dla osób widzących. Natywne elementy zapewniają zachowanie i znaczenie, które w przypadku niestandardowych mechanizmów trzeba odtworzyć samodzielnie. Dzięki temu semantyczny HTML jest praktyczną strategią zwiększania niezawodności, a nie tylko kwestią gustu programistycznego. Semantyka sama w sobie nie gwarantuje jednak użyteczności. Strona może używać poprawnych znaczników, a mimo to mieć mylącą kolejność fokusu lub niewygodną obsługę. Słuszny nacisk książki na testowanie stanowi ważne zastrzeżenie wobec wszelkich twierdzeń o domyślnej dostępności.
Ogranicz logikę grubego klienta do arkuszy kalkulacyjnych, aplikacji offline i podobnie wymagających interakcji
Wymiany z serwerem mają swoje ograniczenia. Hipermedia sprawdzają się szczególnie dobrze, gdy działania użytkownika mają wyraźne granice, a serwer może zwrócić zaktualizowaną reprezentację. Wzorzec ten nie pasuje do arkusza kalkulacyjnego, jeśli edycja jednej komórki przy każdym naciśnięciu klawisza może wywołać kaskadę zmian w całym interfejsie. Książka wskazuje aplikacje mobilne w modelu offline-first jako kolejny przypadek, w którym to rozwiązanie sprawdza się słabo, ponieważ interfejs renderowany na serwerze zależy od łączności.
Łącz architektury świadomie. Złożona aplikacja nie musi stosować jednego rozwiązania architektonicznego na każdym ekranie. Edytor przypominający arkusz kalkulacyjny może wymagać grubego klienta, a ustawienia konta, strony pomocy czy zwykłe formularze kontaktowe mogą pozostać sterowane hipermediami. Taki podział pozwala skoncentrować rozbudowane rozwiązania klienckie na częściach, które ich potrzebują, zamiast rozciągać je na cały produkt.
Ta granica ma znaczenie, ponieważ dyskusje o architekturze często sprowadzają różne wzorce interakcji do jednej kategorii zwanej aplikacją. O tym, czy wymiany z serwerem są naturalnym wyborem, decydują tempo, lokalność i zależności zmian stanu. System hybrydowy może być spójny, jeśli każda granica odzwierciedla rzeczywistą różnicę w potrzebach użytkowników, a nie stanowi arbitralnego kompromisu. Wyzwanie ma charakter operacyjny: zespoły muszą określić, w jaki sposób bogatszy klient i obszary renderowane na serwerze wymieniają stan. Wybiórcze podejście ogranicza złożoność tylko wtedy, gdy takie połączenia są odpowiednio zaprojektowane i przetestowane.
Analiza
Najważniejszym posunięciem książki jest ponowne zdefiniowanie aplikacji internetowej jako rozmowy między reprezentacjami, a nie interfejsu JavaScript, który przypadkiem działa w przeglądarce. Ta zmiana przesuwa punkt ciężkości projektu. Zamiast pytać, jak model klienta mapuje się na punkty końcowe, programiści zastanawiają się, czy odpowiedź serwera zawiera dość informacji, by ogólny klient mógł przedstawić następne dostępne działanie. Przykłady z Contact.app konkretyzują tę ideę: niewielki system CRUD zyskuje wyszukiwanie, częściowe aktualizacje, walidację, odpytywanie o postęp i ekrany mobilne, nie oddając klientowi kontroli nad domeną.
Najmocniejsza teza nie głosi, że hipermedia wygrywają każde porównanie. Chodzi o to, że domyślna architektura SPA często wprowadza złożoność, zanim wymaga jej dana interakcja. Hipermedia ograniczają potrzebę koordynacji w procesach sterowanych przez serwer i pozwalają rozwijać interfejsowe API po stronie serwera za pomocą zwracanych mechanizmów sterujących. Książka unika też fałszywego testu czystości: dopuszcza skrypty, odrębne API danych i grubych klientów tam, gdzie są uzasadnione. Ta pragmatyczna granica jest niezbędna dla argumentacji autorów.
Wiążą się z tym realne koszty. Hipermedia wymagają sprawnych klientów, a natywne mechanizmy HTML same w sobie nie zapewniają zakresu interakcji, jakiego mogą oczekiwać użytkownicy. htmx w dużej mierze wypełnia tę lukę, lecz atrybuty, nagłówki, przepływy zdarzeń, buforowanie, dostępność i szablony częściowe nadal wymagają starannej pracy inżynierskiej. Podobnie kontrola po stronie serwera pozwala scentralizować użyteczną logikę, ale może sprawić, że opóźnienia i dostępność serwera będą bardziej odczuwalne. Przypadek mobilny wymaga specjalistycznego klienta i formatu, zamiast całkowicie eliminować oprogramowanie klienckie.
Trwałym wkładem książki jest zatem precyzyjniejszy język opisu architektury. API hipermedialne służy ludziom za pośrednictwem klientów rozumiejących hipermedia; API danych służy programom oczekującym kontraktów danych. Aplikacje mogą łączyć oba rozwiązania. Przydatne pytanie nie brzmi, czy aplikacja jest wystarczająco nowoczesna, by korzystać z HTML, lecz gdzie powinien znajdować się jej stan, jak szybko się zmienia, jacy klienci z niego korzystają i jaką złożoność zespół jest w stanie utrzymać.
Podsumowanie recenzji
Hypermedia Systems zbiera przeważnie pozytywne recenzje; czytelnicy chwalą powrót do podstaw w podejściu do tworzenia stron internetowych. Wielu docenia krytykę współczesnych frameworków oraz promowanie HTMX i aplikacji sterowanych hipermediami. Czytelnicy uważają przedstawione koncepcje za odświeżające i przydatne w rzeczywistych sytuacjach. Część krytyki dotyczy złożoności większych aplikacji i obaw związanych z rozdzieleniem odpowiedzialności. Rozdział o tworzeniu aplikacji mobilnych spotyka się z mieszanymi reakcjami. Ogólnie książka jest postrzegana jako skłaniająca do refleksji i potencjalnie zmieniająca paradygmat tworzenia oprogramowania internetowego.
Inni czytali również
Słowniczek
sterowanie hipermedialne
Wbudowane instrukcje interakcjiElement reprezentacji hipermedialnej, który opisuje interakcję — często z serwerem zdalnym — kodując w sobie szczegóły tej interakcji. Przykładami są kotwice i formularze HTML: określają miejsca docelowe, metody, a w przypadku formularzy także przesyłane wartości. Klient może wyświetlać te elementy sterujące bez rozumienia modelu danych leżącego u podstaw aplikacji.
aplikacja sterowana hipermediami
Aplikacja kierowana przez hipermediaAplikacja, która jako podstawowy sposób komunikacji z serwerem wykorzystuje hipermedia i wymianę treści hipermedialnych. Jej klient interpretuje otrzymaną reprezentację i zawarte w niej elementy sterujące, zamiast opierać się przede wszystkim na odrębnym modelu po stronie klienta i API udostępniającym wyłącznie dane.
HATEOAS
Hipermedia napędza stan aplikacjiSkrót od Hypermedia As The Engine of Application State (hipermedia jako silnik stanu aplikacji). Zgodnie z tym ograniczeniem architektonicznym klient odkrywa dostępne działania za pomocą elementów sterujących w reprezentacjach dostarczanych przez serwer. Klient nie musi z góry znać każdego punktu końcowego ani każdej operacji dla poszczególnych stanów zasobu; odpowiedź hipermedialna wskazuje, jakie działania są obecnie dostępne.
htmx
Rozszerzenie interaktywności HTMLBiblioteka JavaScript rozszerzająca HTML o deklaratywne atrybuty umożliwiające wysyłanie żądań HTTP z elementów, wybieranie zdarzeń je wyzwalających, określanie metod żądań oraz podmienianie zwróconego kodu HTML w wybranych częściach strony. Ma wzbogacać interakcje hipermedialne, zachowując odpowiedzi HTML i podstawowy model komunikacji klient–serwer w sieci.
lokalność zachowania (Locality of Behavior)
Zachowanie widoczne przy elemencieZasada projektowania oprogramowania, zgodnie z którą zachowanie danej jednostki kodu powinno być widoczne podczas jej sprawdzania. W interfejsach internetowych zachowanie powinno dać się odkryć w pobliżu znaczników odpowiedniego elementu, zamiast wymagać od programistów śledzenia odległych selektorów i procedur obsługi zdarzeń. Zasada ta nie wymaga umieszczania każdego szczegółu implementacji bezpośrednio w znacznikach.
API danych JSON
Interfejs danych strukturalnychAPI, które zwraca uporządkowane dane domenowe, zwykle w formacie JSON, ale nie zawiera elementów sterujących hipermediami opisujących dostępne działania. Klienci muszą wiedzieć, jak interpretować pola i które punkty końcowe wywoływać, zazwyczaj na podstawie wcześniejszej dokumentacji lub skoordynowanej implementacji. Takie API może sprawdzać się w przypadku skryptów, integracji i klientów, którzy nie renderują hipermediów.
HXML
Format mobilny HyperviewOparty na XML formatu hipermedialny używany przez Hyperview do opisywania ekranów aplikacji mobilnych, elementów interfejsu i interakcji. Zawiera elementy przeznaczone dla urządzeń mobilnych oraz deklaratywne zachowania służące nawigacji, aktualizowaniu treści i wywoływaniu funkcji systemowych. Serwery mogą go generować przy użyciu znanych technik szablonów, a klient Hyperview interpretuje go w systemie iOS lub Android.
Hyperview
Mobilny system hipermedialnyOtwarty system hipermedialny dla urządzeń mobilnych, obejmujący HXML, klienta dla systemów iOS i Android oraz punkty rozszerzeń dla niestandardowych elementów i działań. Serwer zwraca reprezentacje, które definiują znaczną część mobilnego interfejsu i jego interakcji. Programiści mogą rozszerzać klienta, gdy aplikacja wymaga natywnych funkcji platformy lub wyspecjalizowanych komponentów.
wzorzec POST/przekierowanie/GET (Post/Redirect/Get)
Przekierowanie po wysłaniu formularzaWzorzec interakcji internetowej, w którym po pomyślnym żądaniu POST następuje przekierowanie do strony pobieranej metodą GET. Dzięki temu odświeżenie strony w przeglądarce nie wysyła ponownie pierwotnego formularza i nie powtarza przypadkowo zmiany. Książka omawia również użycie odpowiedzi 303 po żądaniu DELETE, aby kolejne żądanie było wysyłane metodą GET.
stos HOWL (HOWL stack)
Hipermedia na dowolnym zapleczuŻartobliwe określenie używane przez społeczność htmx na wykorzystanie hipermediów z dowolnym językiem lub frameworkiem po stronie serwera, który pasuje do projektu. Ponieważ przeglądarka komunikuje się za pomocą HTTP i HTML, zespoły mogą wybierać technologię zaplecza na podstawie potrzeb domeny i posiadanej wiedzy, zamiast przyjmować JavaScript po stronie serwera tylko po to, by dopasować go do klienta intensywnie wykorzystującego JavaScript.
FAQ
O czym jest Hypermedia Systems Carsona Grossa?
- Główny temat: Książka opisuje, jak hipermedia, tradycyjnie kojarzone z dokumentami, mogą stanowić solidną podstawę do tworzenia nowoczesnych, interaktywnych aplikacji internetowych i mobilnych.
- Nacisk na architekturę: Przedstawia pełną architekturę hipermedialną — obejmującą HTML, HTTP, serwery i klientów — oraz sposób, w jaki te elementy współdziałają, tworząc elastyczne aplikacje zgodne z REST.
- Znaczenie we współczesnym świecie: Carson Gross twierdzi, że aplikacje sterowane hipermediami (HDA) nie są przestarzałe, lecz stanowią zaawansowaną i konkurencyjną alternatywę dla aplikacji jednostronicowych (SPA).
- Praktyczny przykład: Książka posługuje się rzeczywistymi przykładami, takimi jak budowa aplikacji do zarządzania kontaktami, by osadzić omawiane koncepcje w praktycznym kodzie.
Dlaczego warto przeczytać Hypermedia Systems Carsona Grossa?
- Wyjaśnia nieporozumienia: Książka obala mit, że hipermedia są przestarzałe, i pokazuje ich przydatność w dynamicznych, złożonych aplikacjach.
- Praktyczne wskazówki: Zawiera przykłady i samouczki krok po kroku, w tym opis budowy i rozwijania aplikacji do zarządzania kontaktami za pomocą htmx oraz przenoszenia jej na urządzenia mobilne z Hyperview.
- Alternatywa dla SPA: Gross przedstawia hipermedia jako prostszą, łatwiejszą w utrzymaniu i bezpieczniejszą alternatywę dla rozbudowanych frameworków JavaScript i aplikacji SPA.
- Nacisk na prostotę: Książka pokazuje, jak interfejs sterowany przez serwer i ograniczenie skryptów po stronie klienta mogą zmniejszyć złożoność oraz ułatwić utrzymanie.
Jakie są najważniejsze wnioski z Hypermedia Systems Carsona Grossa?
- Hipermedia jako nowoczesna architektura: Hipermedia to solidne, elastyczne i nowoczesne podejście do tworzenia aplikacji internetowych i mobilnych, a nie jedynie przestarzała technologia.
- Znaczenie zasad REST: Prawdziwe systemy REST wymagają elementów sterujących hipermediami (HATEOAS), których brakuje wielu API JSON, co prowadzi do silniejszych zależności i większej kruchości aplikacji.
- Narzędzia rozszerzające możliwości: Biblioteki takie jak htmx i Hyperview mogą zapewnić aplikacjom sterowanym hipermediami interaktywność zbliżoną do SPA, bez rezygnacji z prostoty ani projektu zgodnego z REST.
- Ulepszanie krok po kroku: Aplikacje można rozwijać stopniowo, dodając interaktywność i zaawansowane wzorce interfejsu, a jednocześnie zachowując podstawową architekturę hipermedialną.
Jak Hypermedia Systems Carsona Grossa definiuje system hipermedialny i jego elementy?
- Podstawa REST: System hipermedialny stosuje zasady REST opisane przez Roya Fieldinga i wykorzystuje elementy sterujące hipermediami, by umożliwiać nieliniowe, dynamiczne interakcje.
- Kluczowe elementy: Obejmuje formaty hipermedialne (takie jak HTML lub HXML), protokoły sieciowe (HTTP), serwery udostępniające API hipermedialne oraz klientów (przeglądarki lub aplikacje mobilne) interpretujących odpowiedzi.
- Różnica w stosunku do API JSON: Książka podkreśla, że wiele API nazywanych REST nie jest naprawdę zgodnych z REST, jeśli nie zawiera elementów sterujących hipermediami służących do nawigacji i interakcji.
- Luźne powiązanie: Systemy hipermedialne umieszczają w odpowiedziach wszystkie informacje potrzebne do interakcji, ograniczając konieczność wcześniejszej znajomości API przez klientów.
Czym, według Carsona Grossa, aplikacje sterowane hipermediami (HDA) różnią się od aplikacji jednostronicowych (SPA)?
- Różnica architektoniczna: Aplikacje HDA wykorzystują hipermedia jako silnik stanu aplikacji i wymieniają HTML (lub HXML) przez HTTP, podczas gdy SPA opierają się na JavaScript i API JSON.
- Powiązania i elastyczność: Aplikacje HDA unikają ścisłego powiązania klienta z serwerem, osadzając logikę interakcji w hipermediach, natomiast SPA wymagają wcześniejszej znajomości struktury API po stronie klienta.
- Kompromisy związane z doświadczeniem użytkownika: SPA zapewniają bogatszą interaktywność, ale zwiększają złożoność i powodują „zmęczenie JavaScriptem”; HDA oferują prostotę i niezawodność oraz wykorzystują funkcje przeglądarki, takie jak buforowanie.
- Łatwość utrzymania: Dzięki samoopisującym się odpowiedziom hipermedialnym aplikacje HDA lepiej tolerują zmiany API i są łatwiejsze w utrzymaniu.
Czym jest htmx i jak rozszerza możliwości HTML przy tworzeniu aplikacji sterowanych hipermediami, zgodnie z opisem w Hypermedia Systems?
- AJAX sterowany atrybutami: htmx rozszerza HTML o atrybuty (np. hx-get, hx-post, hx-trigger, hx-swap, hx-target), które pozwalają deklaratywnie określać żądania AJAX i aktualizacje DOM bez pisania kodu JavaScript.
- Przezwyciężanie ograniczeń HTML: Umożliwia dowolnemu elementowi wysyłanie żądań dowolną metodą HTTP, reagowanie na dowolne zdarzenie i dynamiczne aktualizowanie części strony, rozwiązując problem ograniczonej interaktywności natywnego HTML.
- Zaawansowane funkcje: htmx obsługuje filtrowanie zdarzeń, synchronizację żądań, podmianę elementów poza głównym obszarem aktualizacji oraz integrację z przejściami CSS, zapewniając płynne, dynamiczne interfejsy.
- Progresywne ulepszanie: htmx zachowuje HTML jako hipermedia i rozszerza jego możliwości, zapewniając nowoczesną interaktywność przy jednoczesnym przestrzeganiu zasad REST i progresywnego ulepszania.
Jak Hypermedia Systems Carsona Grossa objaśnia REST i HATEOAS w kontekście hipermediów?
- Ograniczenia REST: Książka omawia ograniczenia REST Fieldinga, podkreślając bezstanowość, buforowanie, system warstwowy, a zwłaszcza jednolity interfejs, w którym hipermedia pełnią funkcję silnika stanu aplikacji (HATEOAS).
- Samoopisujące się komunikaty: Odpowiedzi zgodne z REST muszą zawierać wszystkie informacje (elementy sterujące hipermediami) potrzebne klientom do nawigacji i interakcji bez wcześniejszej znajomości API.
- Zalety HATEOAS: Odpowiedzi hipermedialne dynamicznie określają dostępne działania, dzięki czemu klienci mogą dostosowywać się do zmian API bez awarii, ograniczając problemy z wersjonowaniem typowe dla API JSON.
- Luźne powiązanie: Takie podejście pozwala tworzyć bardziej elastyczne i łatwiejsze do rozwoju systemy, w których klienci i serwery mogą zmieniać się niezależnie.
Jakiego praktycznego przykładu Carson Gross używa w Hypermedia Systems, by pokazać tworzenie aplikacji sterowanych hipermediami?
- Contact.app: Książka przedstawia prostą aplikację internetową do zarządzania kontaktami, zbudowaną w Pythonie z użyciem Flask i szablonów Jinja2. Pokazuje ona operacje CRUD realizowane za pomocą czystych elementów sterujących hipermediami HTML.
- Stopniowe ulepszanie: Pokazuje, jak stopniowo dodawać interaktywność za pomocą htmx, na przykład nawigację AJAX, usuwanie wierszy bezpośrednio na stronie, wyszukiwanie na bieżąco, leniwe ładowanie i wskaźniki postępu.
- Wartość edukacyjna: Przykład osadza teoretyczne pojęcia w praktycznym kodzie i pokazuje, jak budować oraz ulepszać aplikacje sterowane hipermediami krok po kroku.
- Rozszerzenie na urządzenia mobilne: Aplikacja jest również przenoszona na urządzenia mobilne za pomocą Hyperview, co pokazuje wszechstronność hipermediów na różnych platformach.
Jakie kluczowe koncepcje dotyczące skryptów przyjaznych hipermediom omawia Hypermedia Systems?
- Ograniczenia skryptów: W aplikacjach HDA główny format danych powinien pozostać hipermedialny, a stan po stronie klienta poza DOM należy ograniczyć, tak aby logika biznesowa i logika prezentacji pozostały po stronie serwera.
- Narzędzia do skryptów: Książka omawia Vanilla JavaScript (uporządkowany zgodnie z RSJS), Alpine.js (deklaratywny i reaktywny) oraz _hyperscript (zapis przypominający język angielski, skoncentrowany na obsłudze zdarzeń) jako zgodne z tym podejściem rozwiązania.
- Lokalność zachowania: Podkreśla umieszczanie deklaracji zachowania blisko elementów HTML, na które wpływają, co poprawia czytelność i ułatwia utrzymanie.
- Kontrast z tradycyjnym JavaScriptem: To podejście różni się od tradycyjnego rozdzielania odpowiedzialności — na rzecz bliskości znaczników i zachowania, która poprawia przejrzystość.
Jak Hypermedia Systems Carsona Grossa stosuje zasady hipermediów do tworzenia natywnych aplikacji mobilnych za pomocą Hyperview?
- Format HXML: Hyperview wykorzystuje HXML, oparty na XML formatu hipermedialny inspirowany HTML, do deklaratywnego opisywania elementów interfejsu mobilnego, układów, pól wejściowych i zachowań.
- Model klient–serwer: Klient Hyperview (aplikacja React Native) renderuje ekrany HXML pobierane z serwera; logika aplikacji i interfejs są definiowane po stronie serwera, co pozwala uniknąć złożoności grubego klienta.
- Możliwość rozszerzania: Hyperview obsługuje niestandardowe elementy interfejsu i działania, umożliwiając głęboką integrację z platformą oraz bogate interakcje przy zachowaniu architektury sterowanej hipermediami.
- Spójność: Podejście to przenosi zalety hipermediów — luźne powiązanie, elastyczność i łatwość utrzymania — do tworzenia natywnych aplikacji mobilnych.
Jakie zaawansowane wzorce interfejsu i zachowania realizuje się za pomocą htmx i Hyperview w Hypermedia Systems?
- Wyszukiwanie na bieżąco: Umożliwia wyszukiwanie podczas wpisywania, wykorzystując opóźnione żądania AJAX, które dynamicznie aktualizują wyniki. Poprawia to komfort użytkowania bez konieczności pisania niestandardowego kodu JavaScript.
- Leniwe ładowanie: Odkłada wczytanie kosztownych w obliczeniu danych (takich jak łączna liczba kontaktów) do chwili, gdy będą potrzebne, wykorzystując wyzwalacze htmx w celu optymalizacji wydajności.
- Usuwanie pojedynczych i wielu elementów: Umożliwia usuwanie kontaktów bezpośrednio z list, z oknami potwierdzenia, płynnymi animacjami zanikania i operacjami zbiorczymi — wszystko deklaratywnie, za pomocą atrybutów htmx lub HXML.
- Zachowania mobilne: Hyperview wykorzystuje elementy <behavior> do definiowania wyzwalaczy i działań (nawigacji, aktualizacji, funkcji systemowych), umożliwiając bogate, luźno powiązane interakcje mobilne.
Jakie są, według Carsona Grossa, zalety i wyzwania związane z używaniem Vanilla JavaScript i innych narzędzi skryptowych w aplikacjach sterowanych hipermediami?
- Zalety: VanillaJS nie wymaga dodatkowych bibliotek, zmniejsza złożoność w porównaniu z frameworkami SPA i można go skutecznie uporządkować zgodnie z wytycznymi RSJS, co ułatwia utrzymanie i zachowanie lokalności zachowania.
- Wyzwania: Nie ma domyślnego stylu architektonicznego, może prowadzić do „zupy jQuery” z rozproszonymi procedurami obsługi zdarzeń, a API DOM jest rozwlekłe i czasem nieintuicyjne.
- Dobre praktyki: Wywoływanie zachowań za pomocą atrybutów data- i organizowanie kodu według komponentów lub plików poprawia przejrzystość oraz możliwość ponownego użycia, dostosowując VanillaJS do zasad skryptów przyjaznych hipermediom.
- Alternatywne narzędzia: Alpine.js i _hyperscript oferują bardziej deklaratywne, czytelne i łatwiejsze w utrzymaniu sposoby osadzania zachowań w aplikacjach sterowanych hipermediami.
Jakie znaczenie ma przesłanie Carsona Grossa o przyszłości hipermediów w tworzeniu oprogramowania internetowego w Hypermedia Systems?
- Powrót hipermediów: Książka przekonuje, że hipermedia to „świetny pomysł” o ogromnym, niewykorzystanym potencjale, któremu należy ponownie poświęcić uwagę we współczesnym tworzeniu oprogramowania internetowego.
- Wezwanie do działania: Gross zachęca programistów, by poznawali i tworzyli architektury sterowane hipermediami oraz je promowali, rzucając wyzwanie dominacji SPA.
- Inspiracja filozoficzna: Przytaczając słowa z Terminatora 2: „Przyszłość nie jest przesądzona. Nie ma przeznaczenia poza tym, które sami sobie tworzymy”, książka zachęca czytelników do kształtowania przyszłości architektury internetowej poprzez przyjęcie hipermediów.
- Wizja sieci: Przesłanie mówi, że programiści mogą tworzyć prostsze, solidniejsze i łatwiejsze w utrzymaniu systemy, powracając do zasad hipermediów i rozwijając je.
Pobierz PDF
Pobierz EPUB
.epub idealnie nadaje się do czytania e-booków na telefonach, tabletach i czytnikach.