ServletRequest-rajapinta
Kun asiakas lähettää pyynnön web-palvelimelle, servlet-kontti luo ServletRequest- ja ServletResponse-oliot ja välittää ne parametreina servletin service()-metodille. Pyytävä objekti tarjoaa pääsyn pyydetyihin tietoihin, kuten pyydetyn datan otsikoon ja runkotietoihin.
Tätä rajapintaa käytetään datan siirtämiseen asiakkaalta palvelupyynnön servletille. Määrittele objekti, joka toimittaa asiakaspuolen pyyntötiedot servletille. Servlet-kontti luo ServletRequest-objektin ja välittää sen parametrina servletin palvelumenetelmälle. ServletRequest-objektin tarjoama data sisältää parametrien nimet ja arvot, attribuutit sekä syötevirrat. ServletRequestin rajapinnan laajentaminen voi tarjota lisäprotokollakohtaista tietoa.
ServletRequest-rajapinta
- getAttribute(String): Se palauttaa pyydetyn nimellisen ominaisuuden arvon, tai nullin, jos ominaisuutta ei ole.
- getAttributeNames(): Se palauttaa luettelon tähän pyyntöön sisältyvistä ominaisuuksien nimistä.
- getCharacterEncoding(): Palauttaa pyyntöön syötetyn merkistökoodauksen.
- getContentLength(): Se palauttaa pyydetyn entiteettidatan koon, tai -1, jos se ei ole tiedossa.
- getContentType(): Se palauttaa Internet-median tyypin, joka pyytää entiteettitietoja, tai nullin, jos se ei ole tiedossa.
- getInputstream(): Se palauttaa syötevirran, joka lukee binääridatan pyyntörungosta.
- getParameter(String): Se palauttaa merkkijonon, joka sisältää yksilöllisen arvon määritellyn parametrin osalta, ja jos parametria ei ole, se palauttaa nullin.
- getParameterNames(): Se palauttaa pyynnön parametrin nimen merkkijonon enumina ja tyhjänä enumina, jos parametreja ei ole tai syötevirta on tyhjä.
- getParameterValues(String): Se palauttaa pyydetyn parametrin arvon merkkijonojen taulukkona, tai nullina, jos nimettyä parametria ei ole.
- getProtocol(): Se palauttaa pyydetyn protokollan ja version <protocol>merkkijonona muodossa /<major version>.<minor version>.
- getReader(): Se palauttaa puskurinlukijan, joka lukee tekstin pyynnön rungossa.
- getRealPath(String): Soveltaa alias-sääntöä määritellylle virtuaalipolulle ja palauttaa vastaavan reaalipolun, palauttaen nullin, jos muunnosta ei voida suorittaa jostain syystä.
- getRemoteAddr(): Se palauttaa pyynnön lähettäneen välityspalvelimen IP-osoitteen.
- getRemoteHost(): Se palauttaa täysin kelvollisen palvelimen isäntänimen, joka lähetti pyynnön.
- getScheme(): Se palauttaa tässä pyynnössä käytetyn URL-osoitteen kaavion.
- getServerName(): Se palauttaa pyynnön vastaanottaneen palvelimen isäntänimen.
- getServerPort(): Se palauttaa porttinumeron, joka vastaanotti tämän pyynnön.
- setAttribute(String, Object): Se tallentaa ominaisuuden pyynnön kontekstissa; Nämä ominaisuudet nollautuvat pyyntöjen välillä.
HttpServletRequest-rajapinta
Se laajentaa ServletRequest-rajapintaa tarjoamaan pyyntötietoja HTTP-servleteille. Servlet-kontti luo HttpServletRequest-objektin ja välittää sen parametrina servletin palvelumenetelmälle (doGet, doPost jne.).
HttpServletRequest-rajapinta
- getContextPath(): Se palauttaa pyynnön URI:n osan, joka ilmaisee pyynnön kontekstin.
- getCookies(): Se palauttaa taulukon, joka sisältää kaikki evästeobjektit, jotka asiakas lähetti tämän pyynnön yhteydessä.
- getQuesryString(): Auttaa palauttamaan kyselyjonon, joka sisältyy pyyntö-URL:ään polun jälkeen.
- getSession(): Se palauttaa nykyisen HttpSessionin, joka liittyy tähän pyyntöön.
- getMethod(): Se palauttaa HTTP-metodin nimen, joka teki tämän pyynnön.
- getPart(merkkijonon nimi): On hyödyllistä saada osia, joilla on etunimi.
- getPathInfo(): Se palauttaa kaikki URL-osoitteeseen liittyvät lisäpolkutiedot.
- getServletPath(): Se auttaa palauttamaan pyynnön URL-osoitteen, joka kutsuu servletiä.
|