11.4.3 Rules for determining the modules when application.xml exists

When application.xml exists in an application, the modules except the library JAR are determined from the contents of application.xml according to the Java EE specifications. However, if the application.xml version is 1.4 or earlier, the library JAR is determined according to the specifications unique to Application Server. The rules for determining the library JAR modules are different when the application.xml version is Java EE 5 or later and when the version is J2EE 1.4 or earlier. This subsection describes the rules for determining the library JAR modules separately for the cases when the application.xml version is Java EE 5 or later and when the version is J2EE 1.4 or earlier.

Organization of this subsection
(1) When the application.xml version is Java EE 5 or later
(2) When the application.xml version is J2EE 1.2, 1.3, or 1.4
(3) Examples of JAR files handled as a library JAR

(1) When the application.xml version is Java EE 5 or later

When the application.xml version is Java EE 5 or later, excluding the following files, the JAR files (files with extension .jar in lower case) directly beneath the library directory and those directly beneath the J2EE application root are considered as library JAR:

Excluded files
  • Files written in the <module> tag of application.xml directly beneath the META-INF directory
  • hitachi-runtime.jar directly beneath the J2EE application root

The following table lists the rules for determining the modules when the application.xml version is Java EE 5 or later.

Table 11-9 Rules for determining the modules when the application.xml version is Java EE 5 or later

Value of the <library-directory> tagLibrary JAR#
Existing directory/file-name.jar
Other than /
  • file-name.jar
  • Value of the <library-directory> tag/ file-name.jar
Non-existent directoryfile-name.jar
Existing fileKDJE42360-E is output during import and an error occurs.
Nullfile-name.jar
Tag does not exist
  • file-name.jar
  • /lib (lower case)/file-name.jar
#
Excluding the files listed in Excluded files.

(2) When the application.xml version is J2EE 1.2, 1.3, or 1.4

The JAR files (the files with extension .jar in lower case) other than the following files are considered as library JAR:

(3) Examples of JAR files handled as a library JAR

If library-directory/file-name.jar is written in the <module> tag of application.xml directly beneath the META-INF directory, that JAR file is not recognized as a library JAR. Also, hitachi-runtime.jar is also not recognized as a library JAR. The following table lists the examples of JAR files handled as a library JAR.

Table 11-10 Examples of JAR files handled as a library JAR

Path in the EAR fileapplication.xml version
J2EE1.4Java EE 5 or later
<library-directory> value
liblibraryNo tags
lib1.jarLibrary JARLibrary JARLibrary JARLibrary JAR
lib/lib2.jarLibrary JARLibrary JAR----
library/lib3.jarLibrary JAR--Library JAR--
Legend:
--: Not applicable