JavaServer Pages

Šiam straipsniui ar jo daliai trūksta išnašų į patikimus šaltinius.
Jūs galite padėti Vikipedijai pridėdami tinkamas išnašas su šaltiniais.

JavaServer Pages – technologija, leidžianti dinamiškai generuoti HTML, XML, ar kito tipo puslapius. Ši technologija suteikia galimybę į statinį puslapį įterpti Java kodą ir kitą dinaminį turinį.

JSP puslapyje kaitaliojasi įprastine HTML kalba parašyti fragmentai bei java kalba parašytos sekcijos. J2EE serveris vykdo puslapyje esantį java kodą kuris iš anksto specialia JSP direktyva deklaruotiems kintamiesiems priskiria reikiamas reikšmes. Kita JSP direktyva šias reikšmes galima reikiamoje vietoje įterpti į dokumentą.

Gerai parašytoje sistemoje JSP puslapio kodas atsakingas tik už paties dokumento generavimą. Sąveika su duomenų bazėmis, sudėtingesni skaičiavimo algoritmai, sprendimų priėmimas bei kiti panašūs algoritmai turi būti koduojami aukštesniame, EJB lygyje (JSP puslapis turi kviesti EJB modulius).

Paprastas^{[reikalingas šaltinis]} pavyzdys

<html>
  <body>
<%!String intarpas; %>
    <p>Cia paprastas HTML tekstas</p>
<%
  // O čia java kodas:
  int s = 0;
  for (int i = 1; i < 10; i++)
    s += i;
  intarpas = "Skaiciu nuo vieno iki devyniu suma: "+s;
%> 
</pre>
<p>Java kodo rezultatas:</p>
<b><i><u> <%= intarpas %></b></i></u>
  </body>
</html>

Puslapis naršykėje atrodys taip (tikrinta su JOnAS^{[reikalingas šaltinis]}):

Čia paprastas HTML tekstas

Java kodo rezultatas:
Skaičių nuo vieno iki devynių suma: 45

Pavyzdys su ciklu

JSP nesunku generuoti ir iš anksto nežinomo ilgio sąrašą, lentelę ar kitą panašų dokumento elementą. Šiuo atveju programuojamas java ciklas su jame esančia HTML sekcija, kuri į generuojamą dokumentą keliskart įterpiama pakartotinai:

<ul>
<%
 for (int i = 0; i <3; i++)
   {
     %>
     <li> <%=i %> </li>
     <%
   }
%>
</ul%>

Ši seka generuos trijų eilučių sąrašą:

1
2
3

Parametrai

JSP java kodas gali pasiekti keletą iš anksto apibrėžtų kintamųjų, iš kurių svarbiausias yra request (angl užklausa). Iš request objekto galima sužinoti, kokie buvo puslapio kvietimo parametrai (jei puslapis generuojamas kaip vartotojo atsakas į užpildyta HTML formą) bei kokie yra anksčiau toje naršyklėje pasidėti slapukai. Slapukams padėti naudojamas kitas iš anksto apibrėžtas kintamasis, response. Slapukai dažniausiai reikalingi įsiregistravimui į slaptažodžiu apsaugotą sistemą.

JSP puslapio dalys

JSP puslapis paprastai turi tokias dalis:

statiniai duomenys, pavyzdžiui, HTML
JSP direktyvos (directives), pavyzdžiui, „include“ direktyva
JSP skripto elementai ir kintamieji
JSP veiksmai
papildomi (custom) tag'ai

Statiniai duomenys

Statiniai duomenys yra tiesiogiai perrašomi į HTTP atsakymą. Taigi paprastas HTML failas yra suprantamas kaip korektiškas JavaServer puslapis be jokių specifinių JSP elementų. Tokiu atveju į HTTP atsakymą visą laiką būtų siučiama ta pati informacija. Bet JSP tikslas yra papildyti puslapį dinaminiu turiniu, todėl vien tik paprasto HTML pateikimas JSP kompiliatoriui retai kada yra prasmingas.

JSP direktyvos

JSP direktyvos kontroliuoja kaip JSP kompiliatorius generuoja servletą. Žemiau pateiktas galimų direktyvų sąrašas:

include – Include direktyva informuoja JSP kompiliatorių įterpti (angl. paste) pilną failą į redaguojamą. Įterpimą galima įsivaizduoti kaip veiksmą „įterpti“ toje vietoje kur įrašyta direktyva. Include direktyva funkcionuoja panašiai kaip include C preprocesoriuje.

    <%@ include file="betkoksfailas.jspf" %>

page – Yra keletas page direktyvos variantų:

import	jei norima į galutinį failą įterpti „java import“ sakinį
contentType	nustato generuojamo failo turinio tipą. Reiktų naudoti, jei generuojamas failas ne HTML arba „character set“ nėra standartinis character set.
errorPage	nurodo puslapį kuris bus parodomas įvykus generavimo klaidai.
isErrorPage	jeigu nustatyta „true“ reikšmė, šis failas laikomas klaidos puslapiu.
isThreadSafe	nurodo ar servletas, kuris bus sugeneruotas, yra saugus gijų atžvilgiu.

Pavyzdžiai:

   <%@ page import="java.util.*" %>
   <%@ page contentType="text/html" %>
   <%@ page isErrorPage=false %>
   <%@ page isThreadSafe=true %>

Tik import direktyva gali būti naudojama daugiau nei vieną kartą tame pačiame JSP puslapyje.

taglib – Taglib direktyva nurodo kad bus naudojama JSP žymių (angl. tag) biblioteka. Direktyva reikalauja kad būtų nurodytas prefiksas (prefix) ir tag'o biblioteką aprašantis URI.

    <%@ taglib prefix="myprefix" uri="taglib/mytag.tld" %>

JSP skripto elementai ir kintamieji

Standartiniai skripto kintamieji

Visąlaik prieinami skripte yra šie kintamieji:

out – JSPWriter, naudojamas perduoti duomenis į HTTP atsakymo srautą (stream).
page – Pats servletas.
pageContext – PageContext objekto instanc'as (?lt) laikantis su visu puslapiu susijusią informaciją. Tokiu būdu keliems JSP gali būti perduodamas tas pats HTML puslapis.
request – HTTP request objektas.
response – HTTP response objektas.
session – HTTP session objektas kuris gali būti naudojamas sekti vartotojo sesijai tarp atskirų puslapių.

Paprastas[reikalingas šaltinis] pavyzdys