Java Servlets och JavaServer Pages

HTTP och program på serversidan

Fall 1: HTTP-servern levererar statiska filer

Fall 2: HTTP-servern levererar ett dynamiskt genererat svar

JavaServer Pages (JSP)

Vad är en JSP och när ska de användas?

Att exekvera en enkel JSP (hello world)

1. Ladda hem Orion från länken överst på sidan och installera den enligt anvisningarna på http://www.orionserver.com/docs/install.html. Kolla att det går att starta den enligt punkt åtta i Step-by-step Installation Guide på sidan ovan. Notera att du måste byta port servern lyssnar på (enligt punkt fyra i Step-by-step Installation Guide) om du redan har någon annan server som lyssnar på port 80. I UNIX/Linux är det dessutom bara root som har rättighet att använda portnummer under 1024. Om du vill köra Orion på port 80 måste du alltså logga in som root varje gång du ska starta servern.
   
   
2. Skapa en katalog för den nya webapplikationen (hello world). Denna kan heta helloworld och ska ligga i ORION_HOME/applications.
   
   
3. Placera filen hello-world.jsp i katalogen ORION_HOME/applications/helloworld som skapades i föregående punkt.
   
   
4. Skapa en fil som heter web.xml och ligger i katalogen ORION_HOME/applications/helloworld/WEB-INF (som måste skapas först). Denna fil kallas deployment descriptor och kan innehålla information till servern om en webapplikation. Vi återkommer till den senare. I det här exemplet behöver den inte innehålla någon information, det räcker att den finns och innehåller en enda rad där det står
   

   <web-app></web-app>
   
   

5. Nu måste vi tala om för Orion att vi har skapat en ny webapplikation. Det gör vi genom att i filen ORION_HOME/config/application.xml lägga till raden
   

   <web-module id="helloworld" path="../applications/helloworld"/>
   

   Värdet av path måste vara sökvägen från application.xml till rotkatalogen för webapplikationen, dvs den katalog där hello-world.jsp placerades. Min application.xml ser nu ut så här, application.xml.
   
   
6. Till slut måste vi koppla vår webapplikation till en web site på Orion. Samma Orion-server kan lyssna på flera olika portar och IP-adresser och varje unik port är en web site. Vi behöver inte krångla till det genom att gräva djupare i detta utan låter alla våra webapplikationer tillhöra Orions default web site, den som användes i punkt ett ovan. Vi kopplar vår webapplikation till den genom att i filen ORION_HOME/config/default-web-site.xml lägga till raden
   

   <web-app application="default" name="helloworld" root="/hello-world"/>
   

   Alla webapplikationer i Orion måste tillhöra en J2EE-applikation. Även detta kan vi strunta i genom att låta alla våra webapplikationer tillhöra default-applikationen (det var den som vi konfigurerade i punkt 5). För att de ska tillhöra default-applikationen måste värdet av application vara just default. Värdet av name måste vara exakt detsamma som värdet av id i raden vi lade in i punkt fem. Värdet av root blir början på path:en i URL:en för vår webapplikation. Eftersom värdet av root är /hello-world kommer vi att hitta vår webapplikation på http://localhost:8080/hello-world (om servern finns på localhost och lyssnar på port 8080). Observera att värdet på root måste börja med en slash (/). Min default-web-site.xml ser ut så här, default-web-site.xml.
   
   
7. Nu går det att surfa till våran JSP. Starta en browser och surfa till http://localhost:8080/hello-world/hello-world.jsp (om servern finns på localhost och lyssnar på port 8080). Förhoppningsvis får du då uppleva tillfredsställelsen att se den hett efterlängtade texten Hello World!!
   

Inkludera filer i en JSP

Anropa Java-objekt från en JSP

1. De måste ha en konstruktor som inte tar några inparametrar. Den kommer att anropas när ett objekt instansieras.
2. De måste gå att serialisera.
3. De metoder som ska anropas från en JSP måste följa JavaBeans-definitionen av properties. Detta innebär att de måste ha publik åtkomst och heta setXXX() eller getXXX(). Hur XXX lagras eller beräknas spelar ingen roll.

HTTP-sessioner

Java Servlets

Vad är en servlet och när ska de användas?

Ett exempel på en servlet

javac -classpath .:ORION_HOME/orion.jar SysOutServlet.java 

Deployment descriptor

  <servlet>
    <servlet-name>SysOutServlet</servlet-name>
    <servlet-class>ai1.serverjava.servlet.SysOutServlet</servlet-class>
  </servlet>

  <servlet-mapping>
    <servlet-name>SysOutServlet</servlet-name>
    <url-pattern>SysOutServlet/*</url-pattern>
  </servlet-mapping>

Att skicka ett request vidare från en servlet till en JSP (eller HTML-fil)

1. Skaffa ett objekt av javax.servlet.RequestDispatcher genom att anropa metoden getParameter() i javax.servlet.http.HttpServletRequest och skicka med en sträng som är den URL till vilken requestet ska vidarebefodras. URL:en kan anges absolut, den börjar då efter webapplikationens rotkatalog och dess första tecken ska vara en slash (/). Den kan också anges relativt den URL som browsern skickade requestet till, dess första tecken ska då inte vara en slash (/). 
2. Anropa metoden forward() i RequestDispatchern och skicka med request- och response-objekten. Detta metodanrop betyder att svaret till browsern skickas från den URL som RequestDispatchern är kopplad till. Observera dock att metoden forward() sedan returnerar och att exekveringen av koden i servleten fortsätter.

En komplett webapplikation (number guess game)

• Applikationens struktur
  
  1. Alla jsp- och html-filer finns under katalogen WEB-INF. Det beror på att innehållet i den katalogen aldrig får visas för en klient (enligt servlet-specifikationen). Det enda sättet för en klient att komma åt dessa filer är att FrontController gör forward till någon av dem. På det sättet kan vi förhindra att användaren hoppar över inloggningen och skriver in url:en direkt till någon viss fil. Att index.jsp finns direkt i roten (alltså utanför WEB-INF) beror på att det är tillåtet för användaren att se inloggningssidan utan att vara inloggad.
  2. All navigering mellan olika vyer sker med värdet av request-parametern action. Dess värde sätts i de olika HTML-formulären som visas för användaren. I metoden processRequest() på rad 38 i FrontController läses action. Beroende på dess värde avgörs vilka operationer som ska utföras och vilken vy som ska visas härnäst.
     
  
  
• FrontController.java
  
  1. På rad 86 kan vi se hur ett sessionsobjekt skapas, det görs genom att anropa metoden getSession() i klassen HttpServletRequest. Den returnerar ett objekt av typen HttpSession. 
  2. I sessionsobjekt (se punkt 1) kan vi spara andra objekt på det vis som sker på rad 86, genom att anropa metoden setAttribute(String, Object). Strängen är ett godtyckligt namn som används för att hämta objektet. 
  3. Objekt som sparats i sessionsobjekt (se punkt 1 och 2) hämtas med metoden getAttribute(String) som finns i klassen HttpSession, eller med taggen jsp:useBean i en jsp. Detta görs på rad 109 i FrontController repsektive (tex) rad 3 i fail.jsp.
  4. På rad 62 anropas metoden getSession(false) i HttpServletRequest. Den returnerar ett sessionsobjekt om användaren deltar i en session, annars returneras null. Eftersom sessionsobjektet skapas när användaren loggar in kan vi på detta sätt kolla om användaren är inloggad. Finns det ett sessionsobjekt är hon/han inloggad, annars inte.
  5. När användaren loggar ut exekveras rad 99 därmetoden invalidate() i klassen HttpSession anropas. Den tar bort sessionsobjektet.
  6. På rad 90 anropas metoden setAttribute(String, Object) i klassen HttpServletRequest. Den används fär att spara ett objekt i request-objektet på precis samma sätt som i ett sessionsobjekt, se punkt 2.
  7. Det objekt som sparats i request-objektet hämtas på precis samma sätt som objekt hämtas ur sessionsobjekt, se punkt 3. Detta sker i filen index.jsp, se punkt 2 under index.jsp nedan.
     
  
  
• index.jsp
  
  1. Det går att skriva java-kod i en jsp. Den läggs då in i den automatgenererade java-klassen på exakt den plats den står i jsp-filen. Det är inte lämpligt att använda den möjligheten eftersom syftet med jsp:er och servlets är att dela upp javakod och vyer. Desto mer java-kod det finns i jsp:erna desto svårare är det att underhålla dem. Speciellt svårt blir det för en person som inte kan java. tex någon som arbetar med grafisk layout av sidorna i applikationen. Det går utmärkt att helt undvika java-kod i jsp:erna, men inte utan att lära sig mer än vad som finns på den här sidan. Med de kunskaper vi har nu finns inget annat sätt än java-kod att skriva villkorssatser och loopar i en jsp. Hur det sker syns på rad 10 och 12 i index.jsp.
  2. På rad 11 i index.jsp finns taggen <%= ... %>. Inom den taggen ska det stå java-kod som returnerar ett värde. Det värdet kommer att skickas till browsern. Om värdet inte är en sträng omvandlas det automatiskt till en sträng. Här används denna tag för att returnera felmeddelandet som läses från request-objektet. I punkt 6 under FrontController.java ovan förklaras hur felmeddelandet hamnade där.