Jak korzystać z "HttpRequest", "FullHttpRequest", "HttpMessage", "FullHttpMessage" i "LastHttpContent"?

Question

Próbuję użyć netty do napisania aplikacji HTTP. Ale ja jestem pomylony przez tak wielu podobnych typów:

• HttpRequest
• FullHttpRequest
• HttpMessage
• FullHttpMessage
• HttpResponse
• FullHttpResponse
• LastHttpContent

Chyba brakuje mi zrozumienia netty's design philosophy za tym.

Czy ktoś może rzucić trochę światła?

Answer 1

Gdy wiadomość HTTP jest dekodowany przez HttpObjectDecoder dekoder wytwarza następujące obiekty:

1. HttpRequest lub HttpResponse który zapewnia właściwości dekodowane z linii początkowej i jego nagłówkami.
2. Seria HttpContent. Ostatni HttpContent jest LastHttpContent.

Typowy kod obsługi będzie wyglądać następująco:

if (msg instanceof HttpRequest) { 
    ... 
} 
if (msg instanceof HttpContent) { 
    ... 
    if (msg instanceof LastHttpContent) { 
     ... 
    } 
} 

Należy pamiętać, że if bloki nie wykluczają się wzajemnie, a więc handler nie powróci, gdy jeden z 3 warunków powyższe jest spełnione. Zajrzyj do HttpSnoopServerHandler, aby uzyskać konkretny przykład.

Teraz spójrzmy na FullHttpRequest. Implementuje on kod: HttpRequest, i. Dobrze napisany program obsługi powinien działać po włożeniu HttpObjectAggregator do potoku bez zmiany jakiegokolwiek kodu.

Intencją tej dziwacznie wyglądającej hierarchii klas jest umożliwienie użytkownikowi wyboru użycia HttpObjectAggregator lub nie.

Jednakże zgadzam się, że nie jest to intuicyjne. Naprawimy to w Netty 5 w taki sposób, że dekoder produkuje tylko jeden obiekt wiadomości HTTP i przesyła strumieniowo jego zawartość do niego później.