Capitolo 42. Dipendenze

Seam non funziona con JDK 1.4 e richiede JDK 5 o superiore, poiché impiega annotazioni ed altre caratteristiche di JDK 5.0. Seam è stato testato usando i JDK di Sun. Comunque con Seam non ci sono problemi noti usando altri JDK.

42.1.1. Considerazioni su JDK 6 di Sun

Le prime versioni di JDK 6 di Sun contenevano un versione incompatibile di JAXB e richiedevano l'override di questa usando la directory "endorsed". La release JDK6 Update 4 di SUn ha aggiornato JAXB 2.1 e rimosso questo requisito. In fase di building, di testing o di esecuzione assicurarsi di utilizzare questa versione o successive.

Seam usa JBoss Embedded nei propri test di unità e di integrazione. JBoss Embedded ha un requisito aggiuntivo con JDK 6; occorre impostare il seguente argomento JVM:

-Dsun.lang.ClassLoader.allowArraySyntax=true

. Il sistema di build interno a Seam imposta di default questo valore quando si esegue la suit di test. Comunque usando JBoss Embedded per i test va impostato questo valore.

42.2. Dipendenze del progetto

Questa sezione elenca le dipendenze di Seam sia a compile-time sia a runtime. Laddove il tipo viene elencato come ear, la libreria deve essere inclusa nella directory /lib del proprio ear dell'applicazione. Laddove il tipo viene elencato come war, la libreria deve essere collocata nella directory /WEB-INF/lib del proprio file war. Lo scope della dipendenze è tutto, runtime o provided (da JBoss AS 4.2 o 5.0).

Le informazioni sulla versione e sulle dipendenze non sono incluse nella documentazione, ma sono fornite in /dependency-report.txt che viene generato dai POM di Maven memorizzati in /build. E' possibile generare questo file eseguendo ant dependencyReport.

42.2.1. Core

Tabella 42.1.

Nome	Scope	Tipo	NOte
`jboss-seam.jar`	tutti	ear	La libreria base di Seam è sempre richiesta.
`jboss-seam-debug.jar`	runtime	war	I
`jboss-seam-ioc.jar`	runtime	war	Richiesto con l'uso di Seam con Spring
`jboss-seam-pdf.jar`	runtime	war	Richiesto con l'uso delle funzionalità PDF di Seam
`jboss-seam-excel.jar`	runtime	war	Richiesto con l'uso delle funzionalità di Microsoft® Excel® in Seam
`jboss-seam-rss.jar`	runtime	war	Richiesto con l'uso delle funzionalità di generazione RSS in Seam
`jboss-seam-remoting.jar`	runtime	war	Richiesto con l'uso di Seam Remoting
`jboss-seam-ui.jar`	runtime	war	Richiesto con l'uso dei controlli JSF in Seam
`jsf-api.jar`	fornito		JSF API
`jsf-impl.jar`	fornito		Implementazione di riferimento JSF
`jsf-facelets.jar`	runtime	war	Facelets
`urlrewrite.jar`	runtime	war	Libreria URL Rewrite
`quartz.jar`	runtime	ear	Richiesto per usare Quartz assieme alle funzionalità asincrone di Seam

42.2.2. RichFaces

Tabella 42.2. Dipendenze di RichFaces

Nome	Scope	Tipo	NOte
`richfaces-api.jar`	tutti	ear	Richiesto per l'uso di RichFaces. Fornisce classi API per l'uso nella propria applicazione, per esempio per creare un albero
`richfaces-impl.jar`	runtime	war	Richiesto per l'uso di RichFaces.
`richfaces-ui.jar`	runtime	war	Richiesto per l'uso di RichFaces. Fornisce tutti i componenti UI.

42.2.3. Seam Mail

Tabella 42.3. Dipendenze di Seam Mail

Nome	Scope	Tipo	NOte
`activation.jar`	runtime	ear	Richiesto per il supporto agli allegati
`mail.jar`	runtime	ear	Richiesto per il supporto alle email d'uscita
`mail-ra.jar`	solo compilazione		Richiesto per il supporto alle email d'ingresso mail-ra.rar dovrebbe essere deployato nell'application server a runtime
`jboss-seam-mail.jar`	runtime	war	Seam Mail

42.2.4. Seam PDF

Tabella 42.4. Dipendenze di Seam PDF

Nome	Tipo	Scope	NOte
`itext.jar`	runtime	war	Libreria PDF
`jfreechart.jar`	runtime	war	Libreria grafici
`jcommon.jar`	runtime	war	Richiesto da JFreeChart
`jboss-seam-pdf.jar`	runtime	war	Libreria principale PDF di Seam

42.2.5. Seam Microsoft® Excel®

Tabella 42.5. Dipendenze di Microsoft® Excel® in Seam

Nome	Tipo	Scope	NOte
`jxl.jar`	runtime	war	Libreria JExcelAPI
`jboss-seam-excel.jar`	runtime	war	Libreria base Microsoft® Excel® in Seam

42.2.6. Supporto Seam RSS

Tabella 42.6. Dipendenze di Seam RSS

Nome	Tipo	Scope	NOte
`yarfraw.jar`	runtime	war	Libreria YARFRAW RSS
`JAXB`	runtime	war	Librerie JAXB XML per il parsing
`http-client.jar`	runtime	war	Librerie Apache HTTP Client
`commons-io`	runtime	war	Libreria Apache commons IO
`commons-lang`	runtime	war	Libreria Apache commons lang
`commons-codec`	runtime	war	Libreria Apache commons codec
`commons-collections`	runtime	war	Libreria Apache commons collections
`jboss-seam-rss.jar`	runtime	war	Libreria Seam RSS core

42.2.7. JBoss Rules

Le librerie di JBoss Rules libraries sono nella directory drools/lib di Seam.

Tabella 42.7. Dipendenze di JBoss Rules

Nome	Scope	Tipo	NOte
`antlr-runtime.jar`	runtime	ear	Libreria ANTLR Runtime
`core.jar`	runtime	ear	Eclipse JDT
`drools-compiler.jar`	runtime	ear
`drools-core.jar`	runtime	ear
`janino.jar`	runtime	ear
`mvel.jar`	runtime	ear

42.2.8. JBPM

Tabella 42.8. Dipendenze JBPM

Nome	Scope	Tipo	NOte
`jbpm-jpdl.jar`	runtime	ear

42.2.9. GWT

Queste librerie sono richieste se si desidera usare Google Web Toolkit (GWT) nella propria applicazione Seam.

Tabella 42.9. Dipendenze GWT

Nome	Scope	Tipo	NOte
`gwt-servlet.jar`	runtime	war	Librerie GWT Servlet

42.2.10. Spring

Queste librerie sono richieste se si desidera usare Spring Framework nella propria applicazione Seam.

Tabella 42.10. Dipendenze in Spring Framework

Nome	Scope	Tipo	NOte
`spring.jar`	runtime	ear	Libreria Spring Framework

42.2.11. Groovy

Queste librerie sono richieste se si desidera usare Groovy nella propria applicazione Seam.

Tabella 42.11. Dipendenze di Groovy

Nome	Scope	Tipo	NOte
`groovy-all.jar`	runtime	ear	Librerie di Groovy

42.3. Gestione delle dipendenze usando Maven

Maven offre un supporto per la gestione transitiva delle dipendenze e può essere usato per gestire le dipendenze nei progetti Seam. Maven Ant Tasks intergra Maven nel build di Ant, e Maven può essereimpiegato per fare ilbuild ed il deploy dei propri progetti.

Qui non si discute l'uso di Maven, ma soltanto un utilizzo base del POM.

Le versioni rilasciate di Seam sono disponibili all'indirizzo http://repository.jboss.org/maven2 e gli snapshot notturni sono disponibili all'indirizzo http://snapshots.jboss.org/maven2.

Tutti gli artifact di Seam sono disponibili in Maven:


<dependency>

  <groupId

>org.jboss.seam</groupId>

  <artifactId

>jboss-seam</artifactId>

</dependency

>


<dependency>

  <groupId

>org.jboss.seam</groupId>

  <artifactId

>jboss-seam-ui</artifactId>

</dependency

>


<dependency>

  <groupId

>org.jboss.seam</groupId>

  <artifactId

>jboss-seam-pdf</artifactId>

</dependency

>


<dependency>

  <groupId

>org.jboss.seam</groupId>

  <artifactId

>jboss-seam-remoting</artifactId>

</dependency

>


<dependency>

  <groupId

>org.jboss.seam</groupId>

  <artifactId

>jboss-seam-ioc</artifactId>

</dependency

>


<dependency>

  <groupId

>org.jboss.seam</groupId>

  <artifactId

>jboss-seam-ioc</artifactId>

</dependency

>

Questo POM d'esempio fornirà Seam, JPA (tramite Hibernate) e Hibernate Validator:


<?xml version="1.0" encoding="UTF-8"?>

<project xmlns="http://maven.apache.org/POM/4.0.0"

  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">

  <modelVersion

>4.0.0</modelVersion>

  <groupId

>org.jboss.seam.example/groupId>

  <artifactId

>my-project</artifactId>

  <version

>1.0</version>

  <name

>My Seam Project</name>

  <packaging

>jar</packaging>

  <repositories>

    <repository>

      <id

>repository.jboss.org</id>

      <name

>JBoss Repository</name>

      <url

>http://repository.jboss.org/maven2</url>

    </repository>

  </repositories>



  <dependencies>



    <dependency>

      <groupId

>org.hibernate</groupId>

      <artifactId

>hibernate-validator</artifactId>

      <version

>3.0.0.GA</version>

    </dependency>



    <dependency>

      <groupId

>org.hibernate</groupId>

      <artifactId

>hibernate-annotations</artifactId>

      <version

>3.3.0.ga</version>

    </dependency>



    <dependency>

      <groupId

>org.hibernate</groupId>

      <artifactId

>hibernate-entitymanager</artifactId>

      <version

>3.3.1.ga</version>

    </dependency>



    <dependency>

      <groupId

>org.jboss.seam</groupId>

      <artifactId

>jboss-seam</artifactId>

      <version

>2.0.0.GA</version>

    </dependency>

    

  </dependencies>



</project

>