Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

 

In the UserInputSpec.xml resource, define a panel containing the main input fields for a MSSQL database connection, containing several field validators to directly verify the user input of each single input field:

Code Block
languagejava
titleResource userInputSpec.xml
<panel id="panel.mssql">
   <field id="panel.mssql.title" txt="Microsoft SQL Server Connection" type="title"/>
   <field type="text" variable="mssql.host">
      <spec id="panel.mssql.host" size="30" txt="DB host name:"/>
      <validator class="com.izforge.izpack.panels.userinput.validator.NotEmptyValidator" id="panel.mssql.host.error" txt="The host name must not be empty!"/>
   </field>
   <field type="space"/>
   <field type="rule" variable="mssql.port">
      <spec id="panel.mssql.port" layout="N:5:5" txt="Port:"/>
      <validator class="com.izforge.izpack.panels.userinput.validator.NotEmptyValidator" id="panel.mssql.port.error" txt="The port must not be empty!"/>
      <validator class="com.izforge.izpack.panels.userinput.validator.IsPortValidator" id="panel.mssql.port.error.invalid" txt="The port is invalid!"/>
   </field>
   <field type="space"/>
   <field type="divider"/>
   <field type="space"/>
   <field type="text" variable="mssql.user">
      <spec id="panel.mssql.user" size="20" txt="User name:"/>
      <validator class="com.izforge.izpack.panels.userinput.validator.RegularExpressionValidator" id="panel.mssql.user.error" txt="The user name is invalid!">
         <param name="pattern" value="[a-zA-Z0-9._-]+"/>
      </validator>
   </field>
   <field type="space"/>
   <field type="password" variable="mssql.password">
      <spec>
         <pwd id="panel.mssql.password" size="20" txt="Password:"/>
      </spec>
      <validator class="com.izforge.izpack.panels.userinput.validator.NotEmptyValidator" id="panel.mssql.password.error" txt="The password must not be empty!"/>
   </field>
</panel>

 

The installer descriptor contains elements like this containing a panel validator verifying the connection assembled from the values of all user input fields in summary if he/she presses Next:

 

Code Block
languagexml
titleinstall.xml
<resources
   <res id="userInputSpec.xml" src="@{izpack.build.directory}/userInputSpec.xml"/>
</resources>
...
<!-- Maven dependency after invoking dependency:properties in the POM -->
<jar src="@{net.sourceforge.jtds:jtds:jar}" stage="install"/>
<jar src="@{com.mysoft:validators:jar}" stage="install"/>
...
<panel classname="UserInputPanel" id="panel.mssql">
   <validator classname="com.mysoft.izpack.validators.MssqlConnectionValidator"/>
</panel>

 

Last but not least there is one custom panel validator MssqlConnectionValidator:

...