Java Server Pages

Compilazione ed esecuzione

Quando una Java Server Page viene richiesta il container jsp provvede a convertirla in una servlet e quindi autorizza la servlet ad elaborare la richiesta http.

La conversione avviene soltanto nei casi in cui il sorgente della pagina ha subito modifiche rispetto all’ultima conversione effettuata dal container.

In tal modo si riducono i tempi di elaborazione delle richieste e si ottiene un incremento generale delle prestazioni.

• direttive: servono a comunicare al container jsp le informazioni globali sulla pagina che determinano il processo di compilazione in servlet.
• scripting: includono delle istruzione nel linguaggio di scripting associato alla pagina (tipicamente java).
• commenti: sono usati per includere una documentazione alle pagine JSP
• action: supportano diversi comportamenti e possono trasferire il controllo ai vari componenti della web application servlet, javabeans o altre java server pages.
  
  Tipicamente si dividono in:
  • standard: sono definiti dallo standard jsp, associati al namespace jsp e compaiono all’interno della pagina col prefisso "jsp:"
  • custom: manifestano dei comportamenti che vengono aggiunti all’ambiente mediante le API fornite dagli standard JSP e sono generalmente raggruppati in tag libraries (importate nella pagina mediante la direttiva <%@ taglib %>

Le direttive

  <%@ page attribute1="value1" attribute2="value2" ... %>

• info permette all’autore di includere una stringa di documentazione alla pagina per indicarne quelle che sono le funzionalità principali.
  
  
  Tipicamente tale attributo viene utilizzato per memorizzare anche informazioni relative all’autore, alla versione, al copyright...

    <%@ page info="autore: ...; versione: ..." %>
  

• language permette di specificare il linguaggio di scripting utilizzato all’interno della pagina: sebbene il linguaggio Java sia quello più utilizzato è possibile specificare qualsiasi linguaggio di scripting in grado di:
  • manipolare oggetti Java (creare, modificare ed accedere a JavaBeans)
  • invocare i metodi di un oggetto Java
  • gestire le eccezioni Java

    <%@ page language="java" ... %>
  

• contentType indica il mime type della risposta generata dalla pagina jsp (text/html, text/plain ...)

    <%@ page contentType="text/html" ... %>
  

  è possibile specificare contestualmente anche la codifica di caratteri utilizzata nel seguente modo:

    <%@ page contentType="text/html; charset = ISO-8859-1" ... %>
  

• pageEncoding fornisce una maniera alternativa per indicare la codifica di caratteri utilizzata

    <%@ page pageEncoding="ISO-8859-1" ... %>
  

• extends identifica la superclasse utilizzata dal container jsp per convertire la pagina in una servlet.
  
  Generalmente se la pagina deve essere compatibile col protocollo http la superclasse deve implementare l’interfaccia javax.servlet.jsp.HttpJspPage viceversa deve implementare l’interfaccia javax.servlet.jsp.JspPage

    <%@ page extends="miopackage.miaClasseJSP" ... %>
  

• import permette di importare una classe o un intero package all’interno della pagina

    <%@ page import="miopackage.miaClasse, miosecondopackage.*" ...  %>
  

• session viene usato per indicare se la pagina partecipa o meno alla gestione delle sessioni utente (aggiunge, rimuove o recupera attributi dalla sessione)

    <%@ page session="true" ...  %>
  

• buffer permette di controllare il buffer di output della pagina jsp: se si vuole inviare direttamente il risultato della pagina jsp alla risposta http va settato a "none"

    <%@ page buffer="none" ... %>
  

  viceversa occorre indicare la dimensione del buffer in kilobytes

    <%@ page buffer="12kb" ... %>
  

• autoFlush permette di controllare il comportamento del container jsp quando il buffer di output diventa pieno.
  
  Se il valore è settato a true il buffer viene automaticamente svuotato ed il contenuto inviato come risposta http viceversa se è settato a false ed il buffer è pieno viene generata un’eccezione.

    <%@ page autoFlush="true" ...  %>
  

• isThreadSafe è usato per indicare se una volta convertita in una servlet la pagina jsp è in grado di supportare più richieste contemporaneamente: se settato a false il container jsp accoderà le richieste e le elaborerà singolarmente.

    <%@ page isThreadSafe="true" ...  %>
  

• errorPage serve ad indicare la pagina di errore che il container jsp deve invocare qualora si verifichi un errore durante il processing della pagina jsp corrente.

    <%@ page errorPage="/error/miaPagina.jsp" ...  %>
  

• isErrorPage viene utilizzato per indicare se la pagina viene utilizzata da una o più pagine jsp per la gestione degli errori.

    <%@ page isErrorPage="true" ...   %>
  

  <%@ include file="url" %>

  <%@ taglib uri="TagLibraryURI" prefix="prefisso" %>

Scripting e commenti

• dichiarazioni: sono usate per definire variabili e metodi appartenenti alla pagina

  <%! int contatore=0; %>
  <%!
     public int raddoppia(int i)
     {
        return i*i*;
     }
  
  %>
  

  Le variabili definite all’interno di una dichiarazione diventano variabili istanziate all’interno della servlet quando la pagina viene compilata dal container jsp: se tali variabili vengono modificate i successivi riferimenti a queste utilizzeranno i nuovi valori.
  E’ possibile quindi in tal modo condividere una variabile fra le diverse istanze di una pagina jsp: se un thread (un’istanza della pagina) ne modifica il valore tutte le altre istanze recupereranno il nuovo valore della variabile.
• espressioni: sono utilizzate per generare output secondo la seguente sintassi:

  <%= espressione di output%>
  

  Possono essere usate per inviare in output il valore di una variabile o il risultato di un’operazione o di un metodo.
• scriptlet: possono contenere porzioni arbitrarie di codice Java fra i tag <% e %> che vengono eseguite ad ogni richiesta da parte di un client.
  Le variabili dichiarate all’interno di una scriptlet non vengono condivise fra le diverse istanze di una stessa pagina (ovvero fra tutti i client che ne fanno richiesta) ma di volta in volta ne vengono istanziate di nuove.

  <% ... codice java %>
  

<%-- commenti --%>

Action tag

• forward: è utilizzato per trasferire il controllo dalla pagina jsp ad un altro web component secondo la seguente sintassi:
  E’ possibile specificare anche dei parametri che possono essere inviati insieme al forward specificando per ognuno il nome ed il valore

  
     
     ...
  
  

• include permette di includere nella pagina l’output generato da altri documenti
  Anche in questo caso è possibile specificare dei parametri da inviare alla risorsa da includere.

  
     
     ...
  
  

• plug-in è utilizzato per generare il codice HTML necessario per includere Applet Java nella pagina.
• use-beans permette alla pagina jsp di includere e manipolare oggetti JavaBean settando e recuperando proprietà.
  Il tag viene utilizzato per creare un bean o recuperarne uno già esistente: gli attributi class e id identificano la classe di appartenenza del bean che si vuole creare e l’ identificativo univoco del bean così da poterlo recuperare in un secondo momento.
  E’ possibile specificare un attributo type che identifica la classe con la quale si farà riferimento al bean (se ad esempio un bean implementa una determinata interfaccia è possibile fare riferimento a quel bean attraverso l’interfaccia che implementa) ed un attributo scope che imposta la visibilità del bean e può assumere i seguenti valori:
  • page: il bean è accessibile soltanto all’interno della pagina
  • request: il bean è accessibile finchè la richiesta non viene completamente elaborata e la risposta inviata al client
  • session: il bean è accessibile per tutta la durata della sessione
  • application: il bean "vive" finchè la web application non viene interrotta

public class mioBean
{
   private int anno;

   mioBean()
   {
   }

   public int getAnno()
   {
      return anno;
   }

   public void setAnno(int anno1)
   {
      anno=anno1;
   }
}

...


   


...



...

...

<%

...

String attributo = session.getAttribute("nomeattributo");

...

%>

...

...

<%

...

String parametro = request.getParameter("nomeattributo");
...

%>

...

<%@ taglib uri="TagLibraryURI" prefix="prefisso" %>

xmlns:c="http://java.sun.com/jsp/jstl/core"
xmlns:u="urn:jsptld:/WEB-INF/tlds/mialibrary.tld"
xmlns:u="urn:jsptagdir:/WEB-INF/tags/miatagsdir"

 dichiarazioni 
 espressioni 
 scriptlet 

...