tecnologie di sviluppo per il web - db.unibas.it · tecnologie di sviluppo per il web applicazioni...

01/07/2005

1

G. Mecca – [email protected] – Università della Basilicata

Tecnologie di Sviluppo per il Web

Applicazioni Web J2EE:Struttura dell’Applicazione

versione 3.1Questo lavoro è concesso in uso secondo i termini di una licenza Creative Commons

(vedi ultima pagina)

2G. Mecca - Tecnologie di Sviluppo per il Web

Sommario

mStruttura di un’Applicazione J2EEðOrganizzazione Standard dei FileðAppendice: Deployment DescriptorðURI delle Risorse

m Installazione (“Deployment”)ðIl manager di Tomcat

mUtilizzo di AntmAppendice

Applicazioni Web J2EE: Struttura >> Sommario

01/07/2005

2


Struttura di un’Applicazione J2EE

mApplicazione Web J2EEðuna cartella montata sul file system virtuale

del contenitoreðdeve avere una struttura definitaðed essere visibile sul file system virtuale del

contenitorem Il file system virtualeðcorrisponde al contenuto di una cartella

radice chiamata comunemente “webapps”

Applicazioni Web J2EE: Struttura >> Struttura di un'Applicazione J2EE


Struttura di un’Applicazione J2EE

mEsempio: Tomcatðradice delle applicazioni predefinita:

%TOMCAT_HOME%/webappsmApplicazioni Web predefiniteðROOT (/) (pagina di benvenuto)ðexamples (esempi)ðtomcat-docs (documentazione)ðmanager (gestore delle applicazioni)ðadmin (amministrazione)


01/07/2005

3


Organizzazione Standard dei File


mStruttura dell’applicazioneðfissata dallo standardðè necessario che tutte le applicazioni

seguano la struttura standardðgarantisce la portabilità tra contenitoriðse un’applicazione nella cartella webapps

non rispetta la struttura il server non la rende visibile



m Organizzazione dei file nella cartellaðradice : pagine JSP, pagine HTML, fogli di stile CSS,

immagini (tipicamente organizzati in sottocartelle)ðcartella WEB-INF: “deployment descriptor” web.xmlðcartella WEB-INF/classes: servlet e componenti

(tipicamente organizzati in package)ðcartella WEB-INF/lib: file jar che è necessario

rendere visibili nell’applicazione (es: driver JDBC)


01/07/2005

4


Organizzazione Standard dei FileApplicazioni Web J2EE: Struttura >> Struttura di un'Applicazione J2EE

radice dell’applicazione; es: indovinam1

pagine JSP (event. in sottocartelle) es: tentativo.jsppagine HTML, fogli di stile, immagini, altre cartelle

cartella WEB-INF

Appendice: Deployment Descriptor web.xml

cartella classes

altre classi (organizzati in package)

servlet (organizzati in package)

cartella lib

file jar



mAttenzioneðl’applicazione Web viene eseguita dal

contenitore e non dall’utenteðnon è possibile controllarne direttamente il

classpath, ma bisogna rispettare delle regoleðin particolare, il classpath per l’applicazione

Web è formato solo dalle classi e dai jarcontenuti in particolari cartelle


01/07/2005

5



m Il classpath per l’applicazione Webðtutte le classi in WEB-INF/classesðtutti i jar in /WEB-INF/lib

m Inoltreðè possibile configurare il contenitore in modo

che ci siano classi e/o jar visibili a tutte le applicazioni Web




mComponenti visibili a tutte le applicazioniðle classi in %TOMCAT_HOME%\shared\classes

ðtutti i jar in %TOMCAT_HOME%\shared\lib

ðes: log4j.jar

mComponenti visibili a tutte le applicazioniðe anche al contenitore (es: driver jdbc)ðle classi in %TOMCAT_HOME%\common\classes

ðtutti i jar in %TOMCAT_HOME%\common\lib


01/07/2005

6



m In queste cartelleðdue jar fondamentali

m servlet-api.jarðpackage javax.servlet, javax.servlet.http,

javax.servlet.resourcesm jsp-api.jarðpackage javax.servlet.jsp,

javax.servlet.jsp.el, javax.servlet.tagext.javax.servlet.resources





mWeb Application Archive (WAR)ðle applicazioni Web sono spesso distribuite

sotto forma di file “war”ðarchivio jar con estensione “.war”ðsi creano e si gestiscono con jarðl’archivio deve rispettare l’organizzazione

delle cartelle dell’applicazione Webði contenitori sono in grado di decompattare

ed installare automaticamente i file war

01/07/2005

7


Appendice: Deployment Descriptor


mAppendice: Deployment Descriptorweb.xmlð“deployment descriptor”ðserve a specificare parametri specifici per

l’applicazioneðes: nomi per i servlet; URI per i servlet; file

indice standard (es: index.jsp); “timeout” per le sessioni ecc.ðè indispensabile, ma può essere vuoto (il

contenitore assegna valori standard)



mSintassiðdeve essere un documento XML ben formatoðdeve essere valido rispetto ad uno schema

XML fissato dallo standard: http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsdðfino alla versione 2.3:

http://java.sun.com/dtd/web-app_2_3.dtd


01/07/2005

8



mUn descrittore “minimale”


<?xml version="1.0" encoding="ISO-8859-1"?>

<web-app xmlns="http://java.sun.com/xml/ns/j2ee"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee

http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd„version="2.4">

</web-app>



mUn descrittore completoðviene fornito a corredo di Tomcatðed è raggiungibile a partire dalla

documentazioneðmostra molti dei possibili elementi previsti

dallo schema e può essere utilizzato come base per sviluppare ulteriori descrittori


>> Application Development Guide – Deployment – “basic web-xml file”

01/07/2005

9



mAlcuni elementi interessantimElemento session-configðdefinisce il tempo massimo di inattività di una

sessione (in minuti); per Tomcat standard 30ðsottoelemento: session-timeout

mEsempio


<session-config><session-timeout>15</session-timeout>

</session-config>



mElemento error-pageðserve a specificare l’URI di una pagina da

visualizzare in caso errori, ovvero:ðrisposte HTTP di errore (codici 4xx e 5xx)ðeccezioni nel codice Java

mSottoelementiðerror-codeðexception-typeðlocation


01/07/2005

10



mEsempio


<error-page><error-code>404</error-code><location>/errore.html</location>

</error-page>

<error-page><exception-type>javax.servlet.ServletException

</exception-type><location>/errore.html</location>

</error-page>



mAttenzioneðgli elementi devono comparire in web.xml

nell’ordine previsto dallo schema relativomUn descrittore tipicoðdisplay-nameðdescriptionðservletðservlet-mappingðerror-page


>> indovinam1servlet

01/07/2005

11


URI delle Risorse


mOgni risorsa dell’applicazione ha un URIðhttp://<host>:<porta>/<percorso risorsa>ð<porta>: normalmente diversa da 80ðesempio, per Tomcat: 8080

mEsempio:ðhttp://127.0.0.1:8080/ (pagina di benvenuto)ðhttp://127.0.0.1:8080/manager/html/list ðhttp://127.0.0.1:8080/indovinam1/index.jsp


URI delle Risorse


mNome dell’applicazione (“context path”)ðogni applicazione ha un nome detto “context

path” che viene utilizzato negli URI delle risorseðil nome corrisponde normalmente al nome

della cartella in cui è contenuta l’applicazione (es: indovinam1)ðma può essere alterato utilizzando gli

strumenti di configurazione del contenitore

01/07/2005

12


URI delle Risorse


mPagine JSPðpercorso a partire da “webapps”ð/<contextPath>/<percorso>/<nomeFile>ðes: /indovinam1/fine.jspðes: /studenti/inserimenti/inserisciEsame.jsp

mPagine HTML e connessiðstessa convenzione delle pagine JSP


URI delle Risorse


mServletðun servlet non ha un URI definitoðrisponde a tutte le richieste corrispondenti a

“URL pattern” definiti per quel servlet nel deployment descriptor

mElemento servletðconsente di dare un nome ad un servletðsottoelementi: servlet-name, servlet-class

01/07/2005

13


URI delle Risorse

mSintassi


<servlet><servlet-name>Esci</servlet-name><servlet-class>indovina.ServletEsci</servlet-class>

</servlet>

<servlet><servlet-name>Errore</servlet-name><servlet-class>indovina.ServletErrore</servlet-class>

</servlet>


URI delle Risorse

mElemento servlet-mappingðdeve comparire dopo tutti gli elementi servletðassocia uno o più URI alternativi a quello

standard ad un servletðper fare riferimento al servlet (o alla pagina

Jsp) si utilizza il nome (servlet-name) assegnato con l’elemento servlet


01/07/2005

14


URI delle Risorse

mSintassi:


<servlet-mapping><servlet-name>Esci</servlet-name><url-pattern>/Esci</url-pattern>

</servlet-mapping>

<servlet-mapping><servlet-name>Errore</servlet-name><url-pattern>/Errore</url-pattern>

</servlet-mapping>


URI delle Risorse

mE’ possibile specificare classi di URIðcollezioni di URI che unificano con il patternðcarattere speciale *: qualsiasi stringa

mEsempio: URI che terminano con .asp<servlet-mapping>

<servlet-name>Errore</servlet-name><url-pattern>*.asp</url-pattern>

</servlet-mapping>


pattern; attenzione:non comincia per “/”

01/07/2005

15


Installazione (“Deployment”)

Applicazioni Web J2EE: Struttura >> installazione ("Deployment")

mDifferenza con il server HTTP ordinarioðper rendere eseguibile un’applicazione non

basta renderla visibile sul file system virtuale del contenitoreðè necessaria una operazione aggiuntiva

mDeploymentðoperazione di “messa in opera” di

un’applicazione Web che prepara i componenti all’uso




mOperazioni durante il deploymentðle attività cambiano da server a serverðnormalmente vengono creati e inizializzati i

servlet dell’applicazioneðvengono compilate le pagine JSPðvengono caricati i componenti (Bean)ðviene predisposto il pool di thread di servizio

per l’applicazione

01/07/2005

16




mProcedura di deploymentðlo standard prevede un’unica modalitàðcopiare il file .war dell’applicazione nella

cartella webappsðil contenitore dovrebbe riconoscere il nuovo

file, assegnargli un context path uguale al nome del file war, decomprimerlo in una cartella con lo stesso nome ed effettuare automaticamente il deployment




mAltre operazioni importantið“undeployment”: rimozione dell’applicazione

dal contenitore; ATTENZIONE: equivale e rimuovere fisicamente la cartella ed il war da webappsð“ricaricamento” (“reload”): re-inizializzazione

dei componenti dell’applicazione senza dover effettuare una rimozione ed una nuova installazione

01/07/2005

17




m In concretoðesistono vari modi per effettuare il

deployment e l’undeploymentðI modo: copiare fisicamente/rimuovere il file

war o la cartella decompressa in webappsðII modo: utilizzare gli strumenti di gestione

forniti dal contenitoreðIII modo: utilizzare Ant


Il Manager di Tomcat

mApplicazione Web fornita con Tomcatðconsente di effettuare le principali operazioni

sulle applicazioni Webðinstallazione, rimozione, ricaricamento

mPer utilizzare il managerðè necessario autenticarsi con nome utente e

password come un utente di ruolo “manager” precedentemente creato

Applicazioni Web J2EE: Struttura >> Installazione ("Deployment")

01/07/2005

18


Il Manager di Tomcat

mUtilizzo dell’applicazioneðattraverso il browserðcontext path: /manager

mUtilizzo dell’interfaccia HTMLðper installare un’applicazione basta fornire il

context path e l’URI della cartella relativa o del file warðes: file:///e:/temp/indovinam1

Applicazioni Web J2EE: Struttura >> Installazione ("Deployment")

>> /manager


Utilizzo di Ant

m In processi di sviluppo industrialiðAnt rappresenta la soluzione ideale per le

attività di sviluppo delle applicazioni Web

mDue aspetti nuoviðorganizzazione della cartella di progettoðtask e target orientati alla gestione del

contenitore

Applicazioni Web J2EE: Struttura >> Utilizzo di Ant

01/07/2005

19


Utilizzo di Ant

mOrganizzazione della cartella di progettoðleggermente diversa da quella delle

applicazioni desktopðma basata sullo stesso principio di

separazione dei componentimUna nuova cartella di sorgenti: “web”ðin cui sono contenute pagine JSP, pagine

HTML, immagini, fogli di stileðoltre al deployment descriptor



Utilizzo di Ant

mUna nuova cartella di buildð/build/${ant.project.name}ðin cui viene ricostruita tutta la struttura

dell’applicazione Web rimettendo assieme i vari componentiðsecondo la struttura dello standard J2EE

mNotaðserve anche una cartella per la compilazione

delle pagine JSP (/build/jspc)


01/07/2005

20



${basedir}

${ant.project.name}

build

src

<package dell’applicazione>

dist

<file.zip>

<file.war>

build.xml

test

<package dei test>

javadoc

test

classes

dati

report

dati

varie

web

<pagine JSP, HTML, CSS, immagini>

WEB-INF

web.xml

<pagine JSP, HTML, CSS...>

WEB-INF

web.xml

classes

lib

<file jar>

<.class>

jspcsrc

build

>> indovinaM1, aciM1


Utilizzo di Ant

m I nuovi taskðTomcat fornisce una serie di task di Ant

pronti per l’utilizzoðconsentono di effettuare la compilazione

delle pagine JSP prima dell’installazioneðil deploymentðl’undeploymentðaltre operazioni basate sul manager


01/07/2005

21


Utilizzo di Ant

mPer utilizzarliðè necessario utilizzare il task tasdkef per

introdurre i nuovi taskm I target principaliðcompile-jspsðinstall, uninstall, reinstall (lavora con la

cartella)ðdeploy, undeploy, redeploy (lavorano con il

war)


>> tomcat-template-build.xml


Utilizzo di Ant

mNotaðper poterli utilizzare è necessario fornire i

parametri per l’accesso al managerðhost, porta, nome utente, passwordðin dependent.properties

mModelli di file di buildðuno per le applicazioni a due livelliðuno per le applicazioni a tre livelli


>> web-template-build.xml>> web-dbms-template-build.xml

01/07/2005

22


Utilizzo di Ant

mNetBeansðal solito, la gestione dei progetti Web di

NetBeans è basata su Antðè opportuno definire i progetti come progetti

“freeform” utilizzando i propri file di buildm In alternativaðè possibile utilizzare i progetti Web predefiniti

di NetBeans, che ubbidiscono alla stessa struttura con piccole varianti



Utilizzo di Ant

m Le varianti principaliðNetBeans ricostruisce l’applicazione Web in

una cartella /build/webðinoltre NetBeans installa l’applicazione Web

nel proprio Tomcat (fornito a corredo), che ascolta tipicamente sulla porta 8084

mVantaggio principaleðè possibile utilizzare il debugger anche per le

applicazioni Web


01/07/2005

23


Riassumendo

mStruttura di un’Applicazione J2EEðOrganizzazione Standard dei FileðAppendice: Deployment DescriptorðURI delle Risorse

m Installazione (“Deployment”)ðIl manager di Tomcat

mUtilizzo di AntmAppendice

Applicazioni Web J2EE: Struttura >> Sommario



mOrdine degli elementi in web.xmlðdescription: serve a dare una breve

descrizione dell’applicazione Webðcontext-param: serve a definire parametri di

inizializzazione validi per tutti i servlet/jspðfilter >>ðfilter-mapping >>ðservletðservlet-mapping

Applicazioni Web J2EE : Struttura >> Deployment Descriptor

01/07/2005

24



mOrdine degli elementi in web.xml (cont.)ðsession-configðmime-mapping: definisce il tipo MIME per

estensioni di file inusualiðwelcome-file-list: definisce i file standard da

servire in caso di URI che fanno riferimento a cartelle (es: index.jsp, index.html)ðerror-page




mOrdine degli elementi in web.xml (cont.)ðtaglib >>ðsecurity-constraint: vincola l’accesso ad

opportuni URI dell’applicazioneðlogin-config: configura il tipo di

autenticazione da usare per le risorse protette (es: basic o digest)


01/07/2005

25



mSottoelemento <init-param> di <servlet>ðdefinisce parametri di inizializzazione per il

servlet o la pagina Jspðsono accessibili nel codice Java

mSottoelementiðparam-name: nome del parametroðparam-value: valore del parametro




mSintassi<servlet><servlet-name>Esci</servlet-name><servlet-class>indovina.ServletEsci</servlet-class><init-param>

<param-name>nomeFileLog</param-name><param-value>c:\tmp\logIndovina.txt</param-value>

</init-param></servlet>


01/07/2005

26



mAccesso ai parametri di inizializzazioneðsi utilizza un oggetto ServletConfigðmetodo ServletConfig getServletConfig()ðsull’oggetto è possibile utilizzare il metodo

String getInitParameter(Strin nomeParam)

mEsempio:ServletConfig config=getServletConfig();String nomeFileLog =

config.getInitParameter(“nomeFileLog”);




mUtilizzoðfornire parametri di inizializzazione consente

di modificare l’applicazione senza ricompilareil codiceðma modificare web.xml richiede tipicamente

di re-installare l’applicazione Web (non basta ricaricarla)ðin alcuni casi può essere più conveniente

utilizzare file di configurazione esterni


01/07/2005

27


Termini della LicenzaTermini della Licenza

m This work is licensed under the Creative Commons Attribution-ShareAlike License. To view a copy of this license, visit http://creativecommons.org/licenses/by-sa/1.0/ or send a letter to Creative Commons, 559 Nathan Abbott Way, Stanford, California 94305, USA.

m Questo lavoro viene concesso in uso secondo i termini dellalicenza “Attribution-ShareAlike” di Creative Commons. Per ottenereuna copia della licenza, è possibile visitarehttp://creativecommons.org/licenses/by-sa/1.0/ oppure inviare unalettera all’indirizzo Creative Commons, 559 Nathan Abbott Way, Stanford, California 94305, USA.

tecnologie di sviluppo per il web - db.unibas.it · tecnologie di sviluppo per il web applicazioni...

Documents