You
can set values that control the class-loading behavior
of an installed enterprise application. Class loaders enable an application
to access repositories of available classes and resources.
About this task
Configure the class loaders of
an enterprise application
to set class-loader policy and mode values for this application.
An
application class loader groups enterprise bean (EJB) modules, shared
libraries, resource adapter archive (RAR) files, and dependency Java™ archive (JAR) files associated to an application.
Dependency JAR files are JAR files that contain code which can be
used by both enterprise beans and servlets.
An application class
loader is the parent of a web application archive (WAR) class loader.
By default, a web module has its own WAR class loader to load the
contents of the web module. The WAR class-loader policy value of an
application class loader determines whether the WAR class loader or
the application class loader is used to load the contents of the Web
module.
Use the administrative console to configure the class
loaders.
Attention: 如果應用程式在執行中,變更應用程式設定會使應用程式重新啟動。
在獨立式伺服器上,會在儲存變更之後重新啟動應用程式。
在多重伺服器產品上,會在儲存變更之後重新啟動應用程式,在安裝應用程式的節點上,檔案會同步化。
如果要控制多重伺服器產品上的同步化時機,請在「主控台」喜好設定頁面上取消選取與節點同步變更。
- Click to
access the settings page for an application class loader.
- Specify whether to reload application classes when the
application or its files are updated.
By default, class
reloading is not enabled. Select Override class reloading
settings for web and EJB modules to choose to reload application
classes. You might specify different values for EJB modules and for
web modules such as servlets and JavaServer Pages (JSP) files.
- Specify the number of seconds to scan the application's
file system for updated files.
The value specified for Polling
interval for updated files takes effect only if class
reloading is enabled. The default is the value of the reloading interval
attribute in the IBM® extension (META-INF/ibm-application-ext.xmi)
file of the enterprise application (EAR file). You might specify different
values for EJB modules and for web modules such as servlets and JSP
files.
To enable reloading, specify an integer value that is
greater than zero (for example, 1 to 2147483647).
To disable
reloading, specify zero (0).
支援的配置: 對於 IBM 延伸和連結檔而言,.xmi 或 .xml 副檔名取決於您是使用 Java EE 5 之前的應用程式或模組,或 Java EE 5 或更新版本的應用程式或模組。
IBM 延伸或連結檔稱為 ibm-*-ext.xmi 或 ibm-*-bnd.xmi,其中 * 是延伸或連結檔的類型,例如:app、application、ejb-jar 或 web。
適用的條件如下:
- 如果應用程式或模組使用第 5 版之前的 Java EE,副檔名必須是 .xmi。
- 如果應用程式或模組使用 Java EE 5 或更新的版本,副檔名必須是 .xml。
如果 .xmi 檔是隨附在應用程式或模組,則本產品會忽略 .xmi 檔。
不過,即使應用程式含有 Java EE 5 之前的檔案,且所用的副檔名是 .xmi,其中也可以有 Java EE 5 或更新版本的模組。
ibm-webservices-ext.xmi、ibm-webservices-bnd.xmi、ibm-webservicesclient-bnd.xmi、ibm-webservicesclient-ext.xmi 和 ibm-portlet-ext.xmi 檔會繼續使用 .xmi 副檔名。
sptcfg
- Specify the class
loader order for the application.
The application class
loader order specifies whether the
class loader searches in the parent class loader or in the application
class loader first to load a class. The default is to search in the
parent class loader before searching in the application class loader
to load a class.
Select either of the following values for Classes
loader order:
Option |
Description |
Classes
loaded with parent class loader first |
Causes the
class loader to search in the parent class loader
first to load a class. This value is the standard for Development
Kit class loaders and WebSphere® Application Server class
loaders. |
Classes loaded with local
class loader first (parent last) |
Causes the class
loader to search in the application class
loader first to load a class. By specifying Classes loaded
with local class loader first (parent last), your application
can override classes contained in the parent class loader. 避免困難: Specifying the Classes loaded with local
class loader first (parent last) value might result in
LinkageErrors or ClassCastException messages if you have mixed use
of overridden classes and non-overridden classes. gotcha
|
- Specify whether to use a single
or multiple class loaders
to load web application archives (WAR files) of your application.
By default, web modules have their own WAR class loader to
load the contents of the WEB-INF/classes and WEB-INF/lib directories.
The default WAR class loader value is Class loader for each
WAR file in application, which uses a separate class loader
to load each WAR file. Setting the value to Single class loader
for application causes the application class loader to load
the web module contents as well as the EJB modules, shared libraries,
RAR files, and dependency JAR files associated to the application.
The application class loader is the parent of the WAR class loader.
Select
either of the following values for WAR class loader policy:
Option |
Description |
Class loader for each WAR file in application |
Uses a different class loader for each WAR file. |
Single class loader for application |
Uses a single class loader to load all of the WAR files in
your application. |
- Click OK.
What to do next
Save the changes to the administrative configuration.