Documentation

Cette section décrit les problèmes détectés dans la documentation et les solutions associées.

Incohérences Javadoc. (Plusieurs ID)

Une documentation Javadoc est absente ou incorrecte pour plusieurs interfaces et méthodes AMX:

• Les méthodes liées au mécanisme d'obtention des statistiques NumConnAcquired et NumConnReleased ne figurent pas dans ConnectorConnectionPoolStats et AltJDBCConnectionPoolStats. Ces méthodes vont être ajoutées dans une version ultérieure en tant que getNumConnAcquired() et getNumConnReleased().

• L'appel des méthodes suivantes dans EJBCacheStats renvoie une exception : getPassivationSuccesses(), getExpiredSessionsRemoved(), getPassivationErrors(), getPassivations(). Ce problème sera résolu dans une version ultérieure.

• Une fois le serveur démarré, les MBeans AMX nécessitent plusieurs secondes avant d'être tous enregistrés et disponibles. Il vous sera bientôt possible, dans une version ultérieure, de déterminer le moment où les MBeans AMX seront complètement chargés.

• La constante XTypes.CONNNECTOR_CONNECTION_POOL_MONITOR est mal orthographiée ("NNN"). Ce problème sera corrigé dans une version ultérieure.

L'outil ANT intégré renvoie java.lang.NoClassDefFoundError . (ID 6265624)

L'exception suivante est générée dans le thread principal "main" java.lang.NoClassDefFoundError: org/apache/tools/ant/launch/Launcher.

Solution

Il est conseillé de ne pas utiliser l'outil ANT intégré ailleurs que dans Application Server.

Documentation des options de journalisation incorrecte. (ID 6463965)

Le manuel Sun Java System Application Server Enterprise Edition 8.2 Performance Tuning Guide décrit de manière erronée les options de journalisation suivantes :

L'interface utilisateur d'administration propose les deux options de journalisation suivantes :

• Option 1 – Consigne le contenu stdout ( System.out.print) dans le journal des événements

• Option 2 – Consigne le contenu stderr ( System.err.print) dans le journal des événements

Ces options de journalisation n'existent plus dans Application Server Enterprise Edition 8.2.

Informations conflictuelles relatives à la fonction de mise en cache de fichier HTTP dans Application Server 8.2. (ID 6474799)

La documentation d'Application Server Enterprise Edition 8.2 décrit une fonction de mise en cache de fichier HTTP, à la section HTTP File Cache du Sun Java System Application Server Enterprise Edition 8.2 Performance Tuning Guide. Cette fonction n'est cependant pas incluse dans Application Server Enterprise Edition 8.2. Notez que cette fonction a été réintroduite dans Application Server 9.0.

La documentation sur la réalisation d'une connexion physique à partir d'une connexion enroulée est désormais erronée (ID 6486123)

Conséquence d'autres défaillances (probablement 6295215), le code fourni dans la section Obtaining a Physical Connection from a Wrapped Connection du Sun Java System Application Server Enterprise Edition 8.2 Developer’s Guide du Chapitre 11, Using the JDBC API for Database Access du Sun Java System Application Server Enterprise Edition 8.2 Developer’s Guide est désormais erroné. La ligne :

Connection drivercon = ds.getConnection(con);

est maintenant remplacée par :

Connection drivercon = ((com.sun.gjc.spi.DataSource)ds).getConnection(con);