====== JBoss Seam ======
{{frameworks:seamjboss.gif|}}

Site officiel : [[http://www.seamframework.org/|www.seamframework.org]]


===== Documentation =====
 [[http://docs.jboss.com/seam/2.0.1.GA/reference/en/html/|docs.jboss.com seam]]

[[http://www.wiredit.fr/wiredITBlog/2006/10/jboss_seam_repenser_larchitect.html|JBoss Seam : repenser l'architecture des applications web]]

[[http://valtech.developpez.com/articles/java/javaee/jboss/seam/|Facilitez vos développements J2EE avec JBoss Seam]]

[[http://mikael-robert.developpez.com/tutoriels/java/architecture/maven/seam2/|Architecture Maven d'un projet Seam 2]]

===== Premiers pas avec Windows=====



==== Récupération des softwares ====
  * Java EE 5 SDK 
  * Eclipse IDE for Java EE Developers [[http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/europa/winter/eclipse-jee-europa-winter-win32.zip|(eclipse-jee-europa-fall2-win32.zip)]]
  * Apache Ant 1.70 [[http://ant.apache.org/|(apache-ant-1.7.0-bin.zip)]]
  * wamp [[http://www.wampserver.com/|www.wampserver.com]]
  * Jboss 4.2.2.GA [[http://www.jboss.org/jbossas/downloads/|www.jboss.org]]
  * Jboss Seam 2 [[http://www.seamframework.org/Download|www.seamframework.org]]
  * Jboss Tools 2.0.1.GA [[http://www.jboss.org/tools/download/index.html|(JbossTools-2.0.0.GA-ALL-win32.zip)]] unziper dans eclipse-jee-europa-fall2-win32\plugins.


==== Installation et Configuration ====
Déployer les fichiers dans le répertoire C:\DevRoot\ 

Mettre à jour le fichier C:\DevRoot\jboss-seam-2.0.1.GA\build.properties avec:
   jboss.home C:\\DevRoot\\jboss-4.2.2.GA

Rajouter dans le //PATH// de windows : C:\DevRoot\apache-ant-1.7.0\bin;C:\DevRoot\jboss-seam-2.0.1.GA

Pour tester, taper la commande //c:\seam help//

=== Faire fonctionner les exemples === 

Démarrer le serveur jboss avec la commande :
   C:\DevRoot\jboss-4.2.2.GA\bin\>run.bat

Lancer la tache ant correspondante
   C:\DevRoot\jboss-seam-2.2.2.GA\examples\blog>ant deploy

[[http://localhost:8080/seam-blog/]]



===== Premiers pas avec Linux =====



==== Récupération des softwares ====
  * Java EE 5 SDK 
  * Eclipse IDE for Java EE Developers [[http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/europa/winter/eclipse-jee-europa-winter-linux-gtk.tar.gz|(eclipse-jee-europa-winter-linux-gtk.tar.gz)]]
  * Apache Ant 1.70 [[http://ant.apache.org/|(apache-ant-1.7.0-bin.zip)]]
  * Jboss 4.2.2.GA [[http://www.jboss.org/jbossas/downloads/|www.jboss.org]]
  * Jboss Seam 2 [[http://www.seamframework.org/Download|www.seamframework.org]]
  * Jboss Tools 2.0.1.GA [[http://www.jboss.org/tools/download/index.html|(JBossTools-2.1.1.GA-ALL-linux-gtk.zip)]] unziper dans eclipse-jee-europa-winter-linux\plugins.
  * Maven 2 [[http://maven.apache.org/download.html|maven.apache.org]]

==== Installation et Configuration ====


=== Paramétrage de JAVA ===
Installer le bin java:
<code bash>
   $chmod +x jdk-1_5_0_15-linux-i586-rpm.bin
   $./jdk-1_5_0_15-linux-i586-rpm.bin
</code>

  - Ajouter les variables d'environnements dans .bashrc:
<code bash>
   export JAVA_HOME="/usr/java/jdk1.5.0_15/"
</code>

=== Paramétrage de Maven 2 ===
  - Extraire l'archive dans /usr/local/apache-maven/apache-maven-2.0.9-bin.tar.gz
  - Faire un lien : ln -s /usr/local/apache-maven/maven
  - Ajouter les variables d'environnements dans .bashrc:
<code bash>
   export M2_HOME="/usr/local/apache-maven/maven"
   export M2=$M2_HOME/bin
   export MAVEN_OPTS="-Xms256m -Xmx512m"
   export PATH=$M2:$PATH
</code>

Vérifier si l'installation est correcte:
<code bash>
   mvn --version
</code>

=== Paramétrage de JBoss ===
  - Extraire l'archive dans /usr/local/jboss-4.2.2.GA
  - Faire un lien : ln -s /usr/local/jboss-4.2.2.GA jboss
<code bash>
   $chmod +x /usr/local/jboss/bin/run.sh
   #pour lancer en local
   $./run.sh
   #pour lancer avec un accès depuis un serveur distant
   $./run.sh -b 0.0.0.0
</code>


=== Paramétrage de SEAM ===
  - Extraire l'archive dans /usr/local/jboss-seam-2.0.2.SP1
  - Faire un lien : ln -s /usr/local/jboss-seam-2.0.2.SP1 seam
<code bash>
   $chmod +x /usr/local/seam/seam
</code>
  - Mettre à jour le fichier /usr/local/jboss-seam/build.properties avec:
<code bash>
   jboss.home /usr/local/jboss
</code>

===== Configuration d'un projet avec seam-gen =====

  - Ajouter les variables d'environnements dans .bashrc:
<code bash>
   export SEAM_HOME="/usr/seam"
   export PATH=${PATH}:SEAM_HOME
</code>

seam gen est un utilitaire fourni avec Seam - basé sur ant - qui permet de générer le squelette d'un projet Seam

  - Configuration de l’environnement avec //$ seam setup//
  - Créer le projet dans le workspace indiqué précédemment avec //$ seam new-project//
  - Pour déployer dans JBoss //$ seam explode//
  - Création d'une nouvelle action //$ seam new-action//
  - Création d'une nouvelle form avec une action //$ seam new-form//
  - Redémarrer le serveur //$ seam restart//
  - Déployer l'application en tant que EAR //$ seam unexplode//
  - Générer des forms depuis la base de données //$ seam generate-entities//
  - Création d'une conversation //$ seam new-conversation//
  - Création d'un bean entité //$ seam new-entity//

===== Seam 2 et Maven 2 =====
[[http://software.softeu.cz/seam/| Seam Maven integration]]
[[http://lunarlogic.com/blog.php?p=11|Maven Archetype for JBoss Seam]]


Seam 2 is available from the JBoss Maven 2 repository:

    * Group Id: org.jboss.seam
    * Artifact Ids: jboss-seam, jboss-seam-ui, jboss-seam-remoting, jboss-seam-ioc, jboss-seam-pdf, jboss-seam-mail, jboss-seam-debug



===== Liens utiles =====

[[http://nusairat.blogspot.com/2008/06/authentication-with-seam.html|authentication-with-seam]]