Moduł Servlet::Http::HttpServlet
Uniwersytet Gdański - Instytut Matematyki - Zakład Informatyki - Strona domowaSpis treści
⇑ Nazwa
Servlet::Http::HttpServlet - klasa servleta HTTP⇑ Jak używać
$servlet->doDelete($request, $response);
$servlet->doGet($request, $response);
$servlet->doHead($request, $response);
$servlet->doOptions($request, $response);
$servlet->doPost($request, $response);
$servlet->doPut($request, $response);
$servlet->doTrace($request, $response);
$time = $servlet->getLastModified($request);
$servlet->service($request, $response);
⇑ Opis
Ta klasa jest klasą bazową dla servletów HTTP. Klasy pochodne muszą nadpisać przynajmniej jedną z poniższych metod:- doGet()
- - jeśli servlet wspiera żądania HTTP GET
- doPost()
- - dla żądań HTTP POST
- doPut()
- - dla żądań HTTP PUT
- doDelete()
- - dla żądań HTTP DELETE
- init() and destroy()
- - do zarządzania zmiennymi utrzymywanymi podczas "życia" servletu
- getServletInfo()
- - metoda, której servlet używa do udostępniania informacji o sobie
Należy pamiętać, że servlety zazwyczaj działają na serwerach wielowątkowych, należy więc z ostrożnością synchronizować dostęp do współdzielonych danych. Do tych danych należą: obiekty, zmienne klasowe, pliki, połączenia do baz danych i połączenia sieciowe.
⇑ Konstruktor
⇑ Metody
Jeśli metoda ta jest źle sformatowana, to zwróci informację "Bad Request".
Parametry:-
$request
- Obiekt Servlet::Http::HttpServletRequest który przechowuje żądanie klienta
-
$response
- Obiekt Servlet::Http::HttpServletResponse który przechowuje odpowiedź dla klienta
-
Servlet::ServletException
- jeśli żadanie nie może być obsłużone
-
Servlet::Util::IOException
- jeśli wystąpiły błędy I/O
Nadpisanie tej metody automatycznie wspiera żądania HTTP HEAD. Żądanie HEAD jest żądaniem GET, które nie zwraca BODY, tylko nagłówki HEAD.
UWAGA! Kontener servletu musi zapisać nagłówki zanim da odpowiedź (response), ponieważ tego wymaga HTTP.
Jeśli metoda ta jest źle sformatowana to zwróci informację "Bad Request".
Parametry:-
$request
- Obiekt Servlet::Http::HttpServletRequest który przechowuje żądanie klienta
-
$response
- Obiekt Servlet::Http::HttpServletResponse który przechowuje odpowiedź dla klienta
-
Servlet::ServletException
- jeśli żadanie nie może być obsłużone
-
Servlet::Util::IOException
- jeśli wystąpiły błędy I/O
Jeśli metoda ta jest źle sformatowana to zwróci informację "Bad Request". /
Parametry:
-
$request
- Obiekt Servlet::Http::HttpServletRequest który przechowuje żądanie klienta
-
$response
- Obiekt Servlet::Http::HttpServletResponse który przechowuje odpowiedź dla klienta
-
Servlet::ServletException
- jeśli żadanie nie może być obsłużone
-
Servlet::Util::IOException
- jeśli wystąpiły błędy I/O
GET, HEAD, TRACE, OPTIONS
Nie ma potrzeby do nadpisywania tej metody dopóki servlet nie implementuje nowych metod HTTP ponad wersję HTTP 1.1.
Jeśli metoda ta jest źle sformatowana to zwróci informację "Bad Request".
Parametry:-
$request
- Obiekt Servlet::Http::HttpServletRequest który przechowuje żądanie klienta
-
$response
- Obiekt Servlet::Http::HttpServletResponse który przechowuje odpowiedź dla klienta
-
Servlet::ServletException
- jeśli żadanie nie może być obsłużone
-
Servlet::Util::IOException
- jeśli wystąpiły błędy I/O
Kontener servletu musi zapisać nagłówki zanim da odpowiedź (respone), ponieważ tego wymaga HTTP.
Jeśli metoda ta jest źle sformatowana to zwróci informację "Bad Request". /
Parametry:
-
$request
- Obiekt Servlet::Http::HttpServletRequest który przechowuje żądanie klienta
-
$response
- Obiekt Servlet::Http::HttpServletResponse który przechowuje odpowiedź dla klienta
-
Servlet::ServletException
- jeśli żadanie nie może być obsłużone
-
Servlet::Util::IOException
- jeśli wystąpiły błędy I/O
Nadpisując tę metodę należy pozostawić niezmienione nagłówki wysyłane razem z żadaniem (Content-Length, Content-Type, Content-Transfer-Encoding, Content-Encoding, Content-Base, Content-Language, Content-Location, Content-MD5 and Content-Range). Jeśli metoda nie może obsłużyć nagłówków zawartości, to musi wysyłać informację o błędzie (HTTP 501 - Not Implemented) i odrzucać żądanie.
Jeśli metoda ta jest źle sformatowana to zwróci informację "Bad Request".
Parametry:-
$request
- Obiekt Servlet::Http::HttpServletRequest który przechowuje żądanie klienta
-
$response
- Obiekt Servlet::Http::HttpServletResponse który przechowuje odpowiedź dla klienta
-
Servlet::ServletException
- jeśli żadanie nie może być obsłużone
-
Servlet::Util::IOException
- jeśli wystąpiły błędy I/O
Servlety wspierające żadania i mogą szybko ustalićczas ostatniej modyfikacji powinnny nadpisywać tę metodę, co pozwoli przeglądarce na szybszą ich obsługę.
Parametry:-
$request
- Obiekt Servlet::Http::HttpServletRequest który przechowuje żądanie klienta
-
$request
- Obiekt Servlet::Http::HttpServletRequest który przechowuje żądanie klienta
-
$response
- Obiekt Servlet::Http::HttpServletResponse który przechowuje odpowiedź dla klienta
-
Servlet::ServletException
- jeśli żadanie nie może być obsłużone
-
Servlet::Util::IOException
- jeśli wystąpiły błędy I/O