AWWW-1st3.6-w05.tresc-1.0-Slajd15
Przykładowy serwlet Java
Na slajdzie zamieszczono kod źródłowy przykładowego serwletu Java. Jego klasa nazywa się MyServlet1 i zawiera tylko jedną metodę: doGet(). Metoda ta będzie wywoływana w odpowiedzi na każde otrzymane żądanie HTTP. Oto najważniejsze składniki kodu źródłowego:
1. Metoda doGet() przyjmuje dwa obiektowe argumenty: request i response. Obiekt request zawiera metadane żądania, natomiast obiekt response służy do przekazywania odpowiedzi. W pewnym uproszczeniu, obiekty te stanowią jednokierunkowe kanały komunikacyjne pomiędzy serwerem aplikacji a serwletem Java. Metoda doGet() propaguje wyjątki typu IOException, które mogą być generowane przez wywołanie response.getWriter().
2. Serwlet pobiera wartość parametru wejściowego o nazwie "imie". Parametr ten jest przekazywany przez użytkownika końcowego i zawiera jego imię. Do odczytu wartości parametrów wejściowych służy metoda getParameter() obiektu request.
3. Serwlet przekazuje serwerowi aplikacji informację o formacie generowanego dokumentu wynikowego. Na tej podstawie serwer aplikacji wygeneruje nagłówek odpowiedzi HTTP zawierający pole "Content-type".
4. Serwlet powołuje nowy obiekt klasy PrintWriter, stanowiący wyjściowy strumień alfanumeryczny, poprzez który zostanie przekazana treść ciała odpowiedzi HTTP.
5. Serwlet wysyła treść ciała odpowiedzi HTTP w formie dokumentu HTTP. W treść dokumentu wpleciono wartość odebranego parametru wywołania. Zapis do strumienia wyjściowego odbywa się za pomocą metody println() obiektu out.
W celu uruchomienia serwletu Java, użytkownik końcowy formułuje żądanie zawierające adres URL klasy serwletu. Adres ten zwykle zawiera nazwę klasy oraz zdefiniowaną przez administratora wirtualną ścieżkę dostępową. Parametry wejściowe mogą być przekazywane za pomocą dowolnej z metod protokołu HTTP (GET lub POST).
