Interfata HttpServletResponse

Interfata HttpServletResponse

Aceasta interfata permite servletului sa formateze un raspuns bazat pe un protocol HTTP, care este trimis inapoi catre client. Extinde interfata ServletResponse.

1. Variabile statice

Aceasta interfata contine variabile de clasa care descriu toate codurile de stare standard HTTP; toate detaliile sunt in specificatia HTTP, totusi codurile folosite des sunt redate aici :

int SC_OK Acest cod de stare indica ca o cerere a fost rezolvata.

int SC_BAD_REQUEST Acest cod de stare indica ca a intervenit o eroare la primirea unei cereri

int SC_UNAUTHORIZED Acest cod de stare indica ca apelantul nu este autorizat sa faca o astfel de operatie

int SC_FORBIDDEN Acest cod de stare indica ca operatia ceruta este interzisa

int SC_NOT_FOUND Acest cod de stare indica ca resursa ceruta nu a fost gasita

int SC_INTERNAL_SERVER_ERROR Acest cod de stare indica ca o eroare interna a serverului a fost intalnita.

2. Metode

In plus fata de metodele standard ale interfetei ServletResponse, aceasta interfata are urmatoarele metode:

void setStatus(int statusCode) Aceasta metoda seteaza codul raspunsului HTTP la valoarea specificata statusCode; un mesaj standard adecvat va fi inclus automat. Codul de stare trebuie sa fie unul din constantele predefinite. Nu este necesar sa se apeleze intotdeauna aceasta metoda, deoarece un cod de stare este trimis automat daca nu a fost specificat unul.

void setStatus(int statusCode, String statusMessage) Aceasta metoda este folosita pentru a seta codul de stare si mesajul care apare la inceputul raspunsului HTTP. In general, aceasta metoda nu ar trebui folosita; De fapt, a si fost scoasa din JSDK 2.1. A se folosi sendError in loc.

void setHeader(String name, String value) Aceasta metoda seteaza header-ul name al raspunsului HTTP cu valoarea value.

void setIntHeader(String name, int value) Aceasta metoda seteaza header-ul name al raspunsului HTTP cu valoarea intreaga value.

void setDateHeader(String name, long value) Aceasta metoda seteaza header-ul name al raspunsului HTTP cu valoarea de tip date value.

boolean containsHeader(String name) Aceasta metoda intoarce daca header-ul raspunsului specificat, este deja setat.

void sendError(int statusCode, String statusMessage) throws IOException Aceasta metoda seteaza codul de stare a raspunsului HTTP cu codul de stare si mesajul specificat, si transmite un mesaj de eroare standard catre client.

void sendError(int statusCode) throws IOException Aceasta metoda seteaza starea raspunsului HTTP cu codul de stare specificat si cu un mesaj de eroare standard, si transmite un mesaj de eroare standard catre client.

void sendRedirect(String location) throws IOException Aceasta metoda ca starea raspunsului HTTP sa fie o redirectare standard si transmite clientului o redirectare adecvata a header-ului si un mesaj pentru locatia redirectata specificata. Locatia redirectata trebuie sa fie un URL de forma: https://nitric.com/newLocation.html.

Daca se trimite acest raspuns catre un browser Web, browser-ul va merge automat catre noua locatie si va face download catre respectiva pagina Web. O redirectare Web simpla, ar putea sa aiba urmatoarea metoda doGet():

protected void doGet(HttpServletRequest request, HttpServletResponse response) throws IOException

Atunci cand servletul este invocat cu URL-ul https://nitric.com/servlet/Redirect?https://csr.com/, clientul va fi automat redirectat catre locatia specificata.

void addCookie(Cookie cookie) Aceasta metoda trebuie apelata pentru a adauga un cookie la raspuns.

String encodeUrl(String url) Aceasta metoda face posibila urmarirea sesiunilor prin intermediul rescrierii URL-urilor. Metoda primeste URL-ul specificat si intoarce un URL nou cu ID-ul sesiunii codat in el. Daca rescrierea URL-ului nu este necesara, atunci URL este returnat neschimbat. Pentru a folosi un servlet in contextul unei sesiuni, toate URL-urile trimise inapoi catre client trebuie sa fie mai intai filtrate prin aceasta metoda.

String encodeRedirectUrl(String url) Aceasta metoda este analoga cu metoda encodeUrl(), diferenta fiind ca aceasta metoda este folosita pentru a filtra URL-uri trimise catre metoda sendRedirect().