9:18 a.m.
Marek Schmidt created JBSEAM-4987:
-------------------------------------
Summary: Seam2.3.0.Beta2 documentation issues
Key: JBSEAM-4987
URL: https://issues.jboss.org/browse/JBSEAM-4987
Project: Seam 2
Issue Type: Bug
Components: Documentation Issues
Affects Versions: 2.3.0.BETA2
Reporter: Marek Schmidt
Assignee: Marek Novotny
Priority: Critical
Fix For: 2.3.0.CR1
Introduction to JBoss Seam
* Hibernate3
** should be Hibernate4 now
* "Java EE 5" should be updated to Java EE 5 or 6, or just 6 where it makes
sense. Some additional paragraph should be added to the introduction that would explain
how Seam2.3 now works on EE6 server, which part of EE6 it uses, mention the relation to
CDI, etc.
Using the Seam examples
* examples directory is now examples-ee6 (although that should be probably changed for
Final)
* "The example applications run both on JBoss AS and Tomcat with no additional
configuration"
** I don't believe tomcat works ATM, so should be removed
* "Note that all the examples are built and run from the Ant build.xml, so
you'll need a recent version of Ant installed before you get started. "
** should be Maven now
Running the examples on JBoss AS
* "The examples are configured for use on JBoss AS 4.2 or 5.0. "
** Should be "JBoss AS 7.1"
* build and deploy steps should be changed to "mvn clean package" and
$JBOSS_HOME/bin/jboss-cli.sh --connect 'deploy example-ear/target/example.ear'
* "Most of the examples can be deployed as a WAR to Tomcat with Embedded JBoss by
typing ant tomcat.deploy."
** not true anymore AFAIK, should be removed.
Running the examples on Tomcat
* Should be removed, as embedded jboss is no more and the examples have not been
updated for tomcat yet.
Running the example tests
* TestNG should be changed to JUnit.
* Not ant test, but "mvn clean verify -Darquillian=jbossas-managed-7"
1.2.1. Understanding the code
1.2.1.1. The entity bean: User.java
* @Length should be changed to @Size
Example 1.7. web.xml
* web.xml version and schema should be updated to 3.0 and 3_0.xsd respectively.
1.2.1.7. The JSF configuration: faces-config.xml
* The <application> element with the view-handler should be removed.
* version should be updated to 2.1 (2_1.xsd) (actually, the whole file is not necessarry,
so this section could be removed.
1.2.1.9. The EJB persistence deployment descriptor: persistence.xml
* version should be upgraded to 2.0
* java:/DefaultDS should be changed to java:jboss/datasources/ExampleDS
1.3.1.1. The entity bean: Message.java ... and others
* @Length should be changed to @Size, see also other examples
1.3.1.4. The view: messages.jsp .. and other JSP and JSPX examples
* should be converted to xhtml facelets, as we use JSF2 now, so we should not recommend
JSP. See also other examples.
1.6. A complete Seam application: the Hotel Booking example
* s/Hibernate3/Hibernate4
* Richfaces AJAX examples need to be migrated to richfaces4, see the updated examples.
2.1. Before you start
* "Make sure you have JDK 5 or JDK 6 (see Section 42.1, “JDK Dependenciesâ€
for details), JBoss AS 4.2 or 5.0 and Ant 1.7.0, along with recent versions of Eclipse,
the JBoss IDE plugin for Eclipse and the TestNG plugin for Eclipse correctly installed
before starting"
** should probably be "JDK 6 or JDK 7 ... JBoss AS 7.1, Maven 3.0.4, ... "
and TestNG plugin is no longer necessary.
* there are other references to JDK5 in the text that should be fixed
2.9. Using Seam with JBoss 4.0
* section should be removed
3.1. Before you start
* "Make sure you have JDK 5, JBoss AS 4.2 or 5.0, Eclipse 3.3"
** dependencies should be updated, (JDK6, AS7.1, )
3.2. Setting up a new Seam project
* Should be updated according to however it works not in the current jboss tools (at
least JBoss AS versions and Seam versions need to be updated in the text)
16.1.1. Application server configuration
* should be updated to AS7.1, if it is still needed there.
21.3. Configuration
* "The Seam Mail module requires the use of Facelets as the view technology.
Future versions of the library may also support the use of JSP. Additionally, it requires
the use of the seam-ui package. " this note should probably be removed.
21.4. Meldware
* buni.org is a dead link.
26.4. GWT Ant Targets
* should be updated to Maven
29.2. Configuration
* "It is not longer necessary the register the event listeners if Hibernate
Annotations or EntityManager 3.3.x are used. When using Hibernate Search 3.1.x more
eventlisteners are needed, but these are registered automatically by Hibernate
Annotations; refer to the Hibernate Search reference for configuring it without
EntityManager and Annotations." should be removed then, as we now have Hibernate4
* "hibernate-commons-annotations.jar is not needed in JBossAS6." should be
removed or updated to AS7
30.1.2. Using Facelets
* not required for JSF2
30.1.5. Integrating Seam with your EJB container
* JNDI names should be updated to those that are true for AS7
30.6. Configuring Seam in Java SE, with JBoss Embedded
* should probably be removed, together with any other jboss embedded-specific piece of
documentation
30.8. Configuring SFSB and Session Timeouts in JBoss AS
* should be updated for AS7
Chapter 35. Clustering and EJB Passivation
* should be updated for AS7
37.2. Integration testing Seam components
* JBoss Embedded parts should probably be removed
Chapter 39. Seam on BEA's Weblogic
Chapter 40. Seam on IBM's WebSphere AS v7
Chapter 41. Seam on GlassFish application server
* Seam2.3 has not been tested on these platforms, so the docs should at least have a
note that this part has not been updated to Seam2.3 and it has not been tested.
* Also, the ee5/ example is no longer there, so these guides are pretty much useless.
Chapter 42. Dependencies
* Should be updated for AS7
42.3. Dependency Management using Maven
* should be updated.
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators:
https://issues.jboss.org/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira