GlassFish - World's first Java EE 7 Application Server


A component's description is shown to the user as the installation sequence reaches the Product Selection Page

The information is stored in the component's dependency descriptor.
the following excerpts define how the information is stored from the viewpoint of the schema:

1- the Identity element
The modification consists in allowing more than one element Description while requiring that one, at least, Description element exist.

<xs:element name="Identity">
    <xs:annotation>
      <xs:documentation>Definition of the identity of the component.</xs:documentation>
    </xs:annotation>
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="component:Identifier"/>
        <xs:element ref="component:Categories" minOccurs="0"/>
        <xs:element ref="component:Description" maxOccurs="unbounded"/>
        <xs:element ref="component:IdentityVersion"/>
        <xs:element ref="component:Capabilities" minOccurs="0"/>
        <xs:element ref="component:Vendor"/>
        <xs:element ref="component:Other"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>

2- the Description element
The element was modified so as to contain an attribute where the language identifier will be stored. The use of this attribute is optional however, it defaults to "en_US.UTF-8"
Although there is no verification in the schema, the attribute Locale is expected to contain a proper locale codeset.

<xs:element name="Description">
    <xs:complexType>
      <xs:simpleContent>
        <xs:extension base="xs:string">
          <xs:attribute default="en_US.UTF-8" name="Locale" type="xs:string" use="optional">
          </xs:attribute>
        </xs:extension>
      </xs:simpleContent>
    </xs:complexType>
  </xs:element>

The definition of a description in a dependency descriptor should look like

<Identity>
    <Identifier feature="true">P1S1</Identifier>
    <Description>product P1S1</Description>
    <Description Locale="fr_FR.UTF-8">produit P1S1</Description>
    <IdentityVersion>
      <VersionBaseline>v_P1S1</VersionBaseline>
    </IdentityVersion>
    <Vendor>Sun Microsystems Inc.</Vendor>
    <Other>Java Enterprise System</Other>
  </Identity>