Module JMX- Management application wizard - UI Specification

Authors: Alexandre Neubert, Thomas leveque,  Jean-Francois Denise

I18N

All localized strings will be in bundle.properties.

JMX Management Application  Wizard

Input validation

Inputs are validated in the usual way. Whenever you change fields, a validation is applied to the input field.

Launching the Wizard

The JMX Management application Wizard is launched by the main menu action File/New File.... It is located
in the Management category.

Scope Of the wizard

The wizard should be accessible from any kind of project. 

Wizard panels

Step 1  Select Class Name, package and the set of features to enable

This first panel is, like the agent wizard, an extension of Class wizard panel.
Three optional steps can be checked/unchecked to change the code that will be finally generated. By default they are all checked.

• Generate a main method so the manager becomes runable
  

• Current class becomes the main project class (essential if one wants to run this class).
  

• Sample MBean discovery code generation.

The first checkbox controlls the other two, i.e when disabled, the generated class cannot become the project's main class and no
sample code is generated.

In either cases, once the Class name and package names are selected, Next button is enabled.

Step 2  Specify Agent URL to connect to

This panel allows the user to specify the Agent URL to which the management application will connect to.
Two URL specifications are supported:

• URL specification with the standard RMI protocol
• URL specification with a custom protocol (e.g JMXMP)

Default values are provided.

URL specification

The user may add his custom URL directly into the text field



Or press the RMI URL Button if his URL uses RMI protocol, which will display the RMI popup:



The different parameters that can be specified are:

• The host name or IP which is mandatory (default value localhost)
  
• The port to connect to which is mandatory (default value 1099)

If the OK  Button is clicked, the information about host and port are reported in the JMX Agent URL text field.

Authenticated connection

Additionnaly, the user may specify authenticate his connection by checking the Authenticaticated Connection Box.
His authentication may be:

• Generating sample credential code

• Specifying his own credential parameters (user name and password which are mandatory)

Note: As long as the User Name and/or Password field are empty, the Finish button remains disabled.



Click the Finish button will generate a manager application class.