Interfata HttpServletRequest

Interfata HttpServletRequest

Aceasta interfata extinde ServletRequest pentru a da informatii de un nivel mai inlat pentru cereri specifice HTTP

1. Metode

Aceasta interfata defineste urmatoarele metode in plus fata de metodele ServletRequest:

String getMethod() Aceasta metoda intoarce metoda cererii; de obicei, fie get, head, ori post, ori una dintre optiunile HTTP/1.1 put, delete, trace, ori options.

String getRequestURI() Aceasta metoda intoarce intreaga cerere URI; aceasta este URL-ul ori URI-ul folosit de client pentru a accesa acest servlet.

String getServletPath() Aceasta metoda intoarce calea cererii care conduce catre acest servlet; de obicei este de forma /servlet/MyServlet

String getPathInfo() Aceasta metoda intoarce o informati despre cale, care este o portiune din cererea URI ori null, daca nu a fost nimic specificat. Informatia despre cale incepe de la primul slash dupa servletul cerut si se termina cu primul semn de intrebare, daca exista; slash este inclus in sir; De exemplu, informatia despre cale in cazul https://host/servlet/Servlet/pathInfo?query este /pathInfo

Acesta este unul din mecanismele prin care se pot transmite parametrii catre servleturi. Un servlet care converteste documente plain text in HTML ar putea accepta calea catre documentul plain text, drept informatie pentru cale in urmatorul nume de servlet, acceptand URL-uri de urmatorul format; https://host/servlet/Text2HTML/rfcs/rfc1.txt.

String getPathTranslated() Aceasta metoda intoarce informatia despre cale, ca portiune din cererea URI, translatat pentru metoda ServletContext getRealPath(); acesta este un nume de fisier local care poate fi accesat, daca fisierul exista, prin intermediul mecanismului de acces la fisiere Java.

String getQueryString() Aceasta metoda intoarce sirul interogarii din cererea URI. {irul de interogare porneste dupa primul semn de intrebare al cererii si se termina la sfarsitul cererii URI. Semnul de intrebare nu este inclus in rezultatul acestei metode, si se intoarce null daca nu sa specificat nici un sir de interogare. Aceasta este alternativa standard pentru trimiterea de parametrii catre servlet-uri.

Cand un servlet este tinta unei forme HTML cu o metoda get, atunci servletul este invocat in felul urmator: https://host/servlet/ProcessForm?name=Jim+Bean&ssn=n%2Fa. Servletul poate apoi imparti aceasta cerere in elemente ale formei: (name si ssn in acest caz) prin decodarea standard URL. Alternativ, daca elementele unui sir de interogare respecta codarea standard URL se secvente nume/valuare, asa cum se intampla in acest exemplu, metodele mostenite getRequestParameter() ale ServletRequest pot fi folosite pentru a imparti automat acesti parametrii ceruti.

Daca un servlet este tinta unei operatii post si un sir de interogare este inclus in cererea URI, numai aceasta metoda poate fi folosita pentru a extrage sirul de interogare. Metoda mostenita getRequestParameter() presupune ca parametrii cererii vor fi codati in corpul cererii clientului si nu vor mai cauta aici.

String getRemoteUser() Daca acest servlet a fost accesat folosindu-se unul din mecanismele de autentificare HTTP, aceasta metoda va intoarce numele utilizatorului care a accesat servletul, ori va intoarce null.

String getAuthType() Aceasta metoda intoarce schema de autentificare folosita pentru a accesa acest servlet, ori null daca nu a fost folosita nici o autentificare.

String getHeader(String name) Metoda getHeader() intoarce valoarea campului header-ului HTTP specificat in cererea clientului, ori null daca nu a fost inclus.

int getIntHeader(String name) Aceasta metoda intoarce valoarea header-ului HTTP specificat, ca o valoare intreaga, ori -1 daca parametrul nu a fost specificat.

Eumeration getHeaderNames() Aceasta metoda intoarce o enumeratie al numelor tuturor headerelor incluse in cererea HTTP a clientului.

Cookie getCookies() Aceasta metoda intoarce un tablou cu cookies gasiti in aceasta cerere.

String getRequestedSessionId() Aceasta metoda intoarce indentificatorul de sesiune specificat in aceasta cerere, ori o nou identificator de sesiune daca identificatorul cerut a fost invalid.

HttpSession (boolean create) Aceasta metoda intoarce sesiunea asociata cu aceasta cerere. Daca o sesiune valida nu este gasita, atunci o noua sesiune este creata si intoarsa daca flag-ul create     este true; altfel aceasta metoda intoarce null. Pentru a mentine o sesiune valida, scriitorii de servleturi trebuie sa se asigure ca aceasta metoda este apelata macar o data pentru o cerere.

HttpSession getSession() Aceasta metoda apeleaza metoda anterioara cu parametrul true.

boolean isRequestedSessionIdFromCookie() Aceasta metoda determina daca clientul a specificat un identificator de sesiune intr-o cerere cookie. Daca identificatorul de sesiune cerut este invalid, atunci identificatorul de sesiune trimis de client s-ar putea sa nu se potriveasca cu ceea ce este intors de getRequestedSessionId() ori getSession().

boolean isRequestedSessionIdFromUrl() Aceasta metoda determina daca clientul a specificat un identificator de sesiune ca parte dintr-o cerere URI. Daca identificatorul de sesiune cerut este invalid, atunci identificatorul de sesiune trimis de client s-ar putea sa nu se potriveasca cu ceea ce este intors de getRequestedSessionId() ori getSession().

boolean isRequestedSessionIdFromURL() Aceasta este inlocuirea JSDK 2.1 pentru pentru metoda anterioara JSDK 2.0 boolean isRequestedSessionIdFromUrl().

boolean isRequestedSessionIdValid() Aceasta metoda verifica daca indentificatorul de sesiune trimis de client este asociat curent cu o sesiune valida.