REST_Najlepsze_praktyki_i_wzorce_w_jezyku_Java_restja.pdf

(958 KB) Pobierz
Tytuł oryginału: RESTful Java Patterns and Best Practices
Tłumaczenie: Łukasz Piwko
ISBN: 978-83-283-0644-8
Copyright © Packt Publishing 2014.
First published in the English language under the title
„RESTful Java Patterns and Best Practices” (9781783287963).
Polish edition copyright © 2015 by Helion S.A.
All rights reserved.
All rights reserved. No part of this book may be reproduced or transmitted in any form or by any means,
electronic or mechanical, including photocopying, recording or by any information storage retrieval system,
without permission from the Publisher.
Wszelkie prawa zastrzeżone. Nieautoryzowane rozpowszechnianie całości lub fragmentu niniejszej
publikacji w jakiejkolwiek postaci jest zabronione. Wykonywanie kopii metodą kserograficzną,
fotograficzną, a także kopiowanie książki na nośniku filmowym, magnetycznym lub innym powoduje
naruszenie praw autorskich niniejszej publikacji.
Wszystkie znaki występujące w tekście są zastrzeżonymi znakami firmowymi bądź towarowymi ich
właścicieli.
Autor oraz Wydawnictwo HELION dołożyli wszelkich starań, by zawarte w tej książce informacje były
kompletne i rzetelne. Nie biorą jednak żadnej odpowiedzialności ani za ich wykorzystanie, ani za związane
z tym ewentualne naruszenie praw patentowych lub autorskich. Autor oraz Wydawnictwo HELION nie
ponoszą również żadnej odpowiedzialności za ewentualne szkody wynikłe z wykorzystania informacji
zawartych w książce.
Wydawnictwo HELION
ul. Kościuszki 1c, 44-100 GLIWICE
tel. 32 231 22 19, 32 230 98 63
e-mail:
helion@helion.pl
WWW:
http://helion.pl
(księgarnia internetowa, katalog książek)
Drogi Czytelniku!
Jeżeli chcesz ocenić tę książkę, zajrzyj pod adres
http://helion.pl/user/opinie/restja
Możesz tam wpisać swoje uwagi, spostrzeżenia, recenzję.
Printed in Poland.
Kup książkę
Poleć książkę
Oceń książkę
Księgarnia internetowa
Lubię to! » Nasza społeczność
Spis tre ci
O autorce
Podzi kowania
O recenzentach
Wst p
Rozdzia 1. Podstawy REST
Wprowadzenie do REST
REST i bezstanowo
Model dojrza o ci Richardsona
Poziom 0 — zdalne wywo ywanie procedur
Poziom 1 — zasoby REST
Poziom 2 — dodatkowe czasowniki HTTP
Poziom 3 — HATEOAS
Bezpiecze stwo i idempotentno
Bezpiecze stwo metod
Idempotentno metod
Zasady projektowe dotycz ce budowy us ug typu RESTful
Wyznaczenie identyfikatorów URI zasobów
Identyfikacja metod obs ugiwanych przez zasób
Czasowniki HTTP w REST
PUT czy POST
Identyfikacja ró nych reprezentacji zasobu
Implementowanie API
API Javy dla us ug RESTful (JAX-RS)
7
8
9
11
15
16
16
16
17
17
17
18
18
18
18
19
19
20
21
22
22
23
23
Kup książkę
Poleć książkę
REST. Najlepsze praktyki i wzorce w j zyku Java
Wdra anie us ug typu RESTful
Testowanie us ug typu RESTful
API klienta w JAX-RS 2.0
Uzyskiwanie dost pu do zasobów RESTful
Inne narz dzia
Najlepsze praktyki projektowania zasobów
Zalecana lektura
Podsumowanie
25
25
25
27
29
29
30
30
Rozdzia 2. Projektowanie zasobów
Rodzaje odpowiedzi REST
Negocjacja tre ci
Negocjacja tre ci przy u yciu nag ówków HTTP
Negocjacja tre ci poprzez adres URL
Dostawcy jednostek i ró ne reprezentacje
StreamingOutput
ChunkedOutput
Jersey i JSON
Wersjonowanie API
Okre lanie wersji w identyfikatorze URI
Numer wersji w parametrze zapytaniowym dania
Okre lanie numeru wersji w nag ówku Accept
Kody odpowiedzi i wzorce REST
Zalecana lektura
Podsumowanie
31
31
32
32
35
35
36
37
38
40
40
41
41
42
43
44
Rozdzia 3. Bezpiecze stwo i wykrywalno
Rejestrowanie informacji w API REST
Najlepsze praktyki rejestrowania informacji w API REST
Sprawdzanie poprawno ci us ug REST
Obs uga wyj tków i kodów odpowiedzi
zwi zanych z weryfikacj poprawno ci danych
Obs uga b dów w us ugach typu RESTful
Uwierzytelnianie i autoryzacja
Co to jest uwierzytelnianie
Co to jest autoryzacja
Ró nice mi dzy OAuth 2.0 i OAuth 1.0
Tokeny od wie ania a tokeny dost pu
Najlepsze praktyki przy implementacji OAuth w API REST
OpenID Connect
Elementy architektury REST
Zalecana lektura
Podsumowanie
45
46
47
49
50
51
52
53
54
57
57
58
59
59
61
62
4
Kup książkę
Poleć książkę
Spis tre ci
Rozdzia 4. Projektowanie wydajnych rozwi za
Zasady buforowania
Szczegó y buforowania
Typy nag ówków buforowania
Nag ówek Cache-Control i dyrektywy
Nag ówek Cache-Control i API REST
Znaczniki ETag
API REST Facebooka i nag ówki ETag
Asynchroniczne i d ugotrwa e operacje w REST
Asynchroniczne przetwarzanie da i odpowiedzi
Najlepsze praktyki pracy z zasobami asynchronicznymi
Wysy anie kodu statusu 202 Accepted
Ustawianie terminu wyga ni cia dla obiektów w kolejce
Asynchroniczne obs ugiwanie zada przy u yciu kolejek wiadomo ci
Metoda HTTP PATCH i cz ciowe aktualizacje
JSON Patch
Zalecana lektura
Podsumowanie
63
64
64
64
65
66
67
69
70
70
73
73
74
74
74
76
77
77
Rozdzia 5. Zaawansowane zasady projektowania
Techniki ograniczania liczby da
Uk ad projektu
Szczegó owa analiza przyk adu ograniczania liczby da
Najlepsze praktyki pozwalaj ce unikn przekroczenia limitu
Stronicowanie odpowiedzi
Rodzaje stronicowania
Uk ad projektu
Internacjonalizacja i lokalizacja
Ró ne tematy
HATEOAS
API REST portalu PayPal i HATEOAS
REST i rozszerzalno
Inne tematy zwi zane z API REST
Testowanie us ug typu RESTful
Zalecana lektura
Podsumowanie
79
80
81
82
86
87
88
90
91
92
92
93
94
94
95
96
96
da przez klienty
Rozdzia 6. Nowe standardy i przysz o
API reaguj ce na bie co
Sondowanie
Model PuSH — PubSubHubbub
Model strumieniowania
Uchwyty sieciowe
Gniazda sieciowe
technologii REST
97
98
98
99
100
103
104
5
Kup książkę
Poleć książkę
Zgłoś jeśli naruszono regulamin