2.2.5 criticalList.cfg (Protected areas list file)
Set the classes that prohibit method cancellation in the protected area.
If you need to set this protected areas list file, you specify the settings as per the instructions provided in the notes of the documents provided with the configuration software of each Cosminexus product and the related products.
- Organization of this subsection
(1) Format
Specify the definition file in the following format:
element
You can specify either of the following in element.
-
class-name
Specify the class name to be specified in the protected area.
-
prefix-name
Specify the prefix name of the package that includes the classes specified in the protected area. All classes having the specified prefix are specified as the protected area.
- How to specify:
-
-
Specify the specifiable elements by demarcating with a linefeed.
-
A blank line is ignored.
-
A line beginning with a hash mark (#) is a comment.
-
You cannot add a space or a comment after element.
(Example) class-name#comment
-
Code the class name including the package name. Do not, however, mention the suffix ".class".
(Example) pacA.pacB.pacC.pacD.MyTestClass.class
In this case, code as pacA.pacB.pacC.pacD.MyTestClass.
-
You cannot specify the prefix of a class name.
(Example) pacA.pacB.pacC.pacD.My*
If you specify a class name in the protected area that uses "My" in the prefix(MyTestClass), you cannot use an asterisk (*) in the class name.
In this case, specify as pacA.pacB.pacC.*.
-
You cannot specify only an asterisk (*).
-
The single-byte space before and after element is ignored.
-
The double-byte spaces before and after element are treated as characters and are considered as invalid values.
-
(2) File storage location
-
In Windows
Cosminexus-installation-directory\CC\server\usrconf\
-
In UNIX
/opt/Cosminexus/CC/server/usrconf/
(3) Examples of coding
- When specifying a prefix name
#specify-prefix-name pacA.pacB.*
All classes below the package pacA.pacB as well as those included in the package will form the protected area.
For example, if pacA.pacB.pacC.pacD is present below the package pacA.pacB.pacC, all classes below pacA.pacB.pacC.pacD will also become the protected area.
- When specifying a class name
#specify-class-name pacX.pacY.pacZ.MyTestpacX.pacY.pacZ.CommonTest
(4) Precautions
-
The protected areas list file is a product-based definition. This file is enabled in all the J2EE servers running on the machine on which the Cosminexus Component Container is installed.
-
The protected areas list file is read when starting a J2EE server. If you want to enable the changed contents, you need to restart the J2EE server.
-
If the protected areas list file does not exist or if the settings are invalid when starting a J2EE server, the J2EE server fails to start.