quality@glassfish.java.net

[FishCAT] Developer's Guide Review

From: Manfred Riem <mriem_at_manorrock.org>
Date: Sat, 20 Sep 2008 16:29:18 -0600

Developer's Guide

 

Page 11

 

 ** No figures listed in the Figures section

 

Page 22

 

  * The Java ES edition of the Enterprise Server is based on

    the GlassFish source code, but provides additional value-added

    features such as access to a high-availability database (HADB)

    for session persistence and failover.

 

 ** Consider providing a link to Java ES edition.

 

Page 23

 

  * The GlassFish edition of the Enterprise Server is bundled

    with the NetBeans 5.5 IDE.

 

 ** Is this still the case, should this not be NetBeans 6.1?

 

Page 24

 

  * Sample Applications

 

 ** Are they also going to be available using the Update Center,

    similar to the Update Tool of V2? If so, consider mentioning

    that here.

 

Page 45

 

  * Supported Realms

 

 ** How about the LDAP realm? Is that not a supported one as well?

    Or is that excluded out of this release?

 

Page 46

 

  * http://glassfish.dev.java.net/nonav/javaee5/api/index.html

 

 ** Refers to Glassfish 9.0, is there API doc specific to V3?

    If so consider linking that here.

 

 

Page 61

 

  * To use the Java Persistence API in Java SE mode, do not

    specify the jta-data-source or non-jta-data-source elements

    if the DataSource is not available. Instead, specify the

    provider element and any additional properties required by

    the JDBC driver or the database.

 

 ** I would recommend putting this in an Appendix since not a

    lot of people are going to do this when using Glassfish ;)

 

Page 62

 

  * Setting the logging level to OFF disables EclipseLink logging.

    A logging level set in the persistence.xml file takes

    precedence over the global logging level.

 

 ** In the original TopLink implementation of V2 setting it in

    persistence.xml caused that setting to propagate to the

    global level. Is this still the case? If so, please mention

    that in here with a LOT of emphasis ;)

 

Page 82

 

  * Using the Grizzly Comet API

 

 ** Can this be put into a separate guide? Just like the other

    ones. This will make it more visible to the general public.

    I was not aware there was a Grizzly example in any of the

    documentation of Glassfish.

 

Page 95

 

  * Creating a Simple Grails Application

 

 ** Can the example be put into a separate guide?