4.2.1 Specifications of the HITACHI JavaBeans Resource Property file

<hitachi-javabeans-resource-property>

Once

This is the root tag.

<description>

Zero or once

Describes the JavaBeans resource.

<display-name>

Once

Specifies the display name of the JavaBeans resource.

1 ≤ character-string-length ≤ 240.

To change the value, you can use alphanumeric characters (0 to 9, A to Z, a to z), and the following special characters:

Space ( ), exclamation mark (!), hash mark (#), dollar sign ($), percent sign (%), ampersand (&), left parenthesis and right parenthesis (() ()), plus sign (+), hyphen (-), period (.), semicolon (;), less-than sign (<), greater-than sign (>), at mark (@), square brackets ([) (]), yen sign (), caret (^), underscore (_), grave accent mark (`), curly brackets ({) (}), vertical bar (|), and tilde (~)

You cannot, however, specify the following names:

• Name containing a period (.) at the beginning or at the end

• Name containing only a period (.)

Also, any single-byte space at the beginning or end of the character string is removed and does not cause an error.

<res-type>

Zero or once

Specifies the resource type.

Specify the class name of the JavaBeans resource. You can omit the resource type when the name is the same as <class-name>.

<class-name>

Once

Specifies the implementation class name.

Specify the implementation class name of the JavaBeans resource.

<runtime>

Once

--

<property>

Zero or more times

If the <property> tag is specified multiple times and if the setup value of <property-name> is the same, the tags are merged together. In this case, a warning message (KDJE37600-W) is output and the value of <property-value> of the <property> tag that was defined later is enabled.

<property-name>

Once

Specifies the property name.

Specify the set method name and get method name of the JavaBeans resource.

<property-type>

Once

Specifies the types of Java property values.

You can specify the following types:

• int

• long

• short

• byte

• double

• float

• boolean

• char

• java.lang.Integer

• java.lang.Long

• java.lang.Short

• java.lang.Byte

• java.lang.Double

• java.lang.Float

• java.lang.Boolean

• java.lang.Character

• java.lang.String

<property-value>

Zero or once

Specifies the property value.

<resource-env-external-property>

Zero or more times

--

<description>

Zero or once

Describes the optional name of the resource environment.

<optional-name>

Once

Specifies the optional name of the resource environment.

You can use alphanumeric characters (0 to 9, A to Z, a to z) and the following special characters in the value:

Space ( ), exclamation mark (!), double quotation mark ("), hash mark (#), dollar sign ($), percent sign (%), ampersand (&), single quotation ('), left parenthesis and right parenthesis (() ()), asterisk (*), plus sign (+), comma (,), hyphen (-), period (.), forward slash (/), colon (:), semicolon (;), less-than sign (<), equal sign (=), greater-than sign (>), question mark (?), at mark (@), square brackets ([) (]), yen sign (), caret (^), underscore (_), grave accent mark (`), curly brackets ({) (}), vertical bar (|), and tilde (~).

You cannot, however, specify the following names:

• Names beginning with the reserved word HITACHI_EJB (case sensitive)

• Names in which forward slash (/) or period (.) is specified at the beginning or end

• Names containing only forward slash (/) or period (.)

• Names containing continuous forward slashes (/)

Any space or linefeed at the beginning or end of the character string is removed and does not cause an error. If a space or linefeed appears in the middle of the character string, an error occurs.

If multiple <resource-external-property> tags are specified within the same resource, and the specified value of <optional-name> configures the lower hierarchy of the specified value of another <optional-name> tag, a warning message (KDJE37602-W) is output.

Example:

Optional name 1: AAA

Optional name 2: AAA/BBB

1 ≤ character-string-length ≤ 255