When a connector is selected in the Connectors View, its properties are shown in the Properties View. The Properties View shows the display name and current value of each property and, if the property is editable, allows you to change a property's value. The classpath is one of the connector properties and has a display name of Class Path. A classpath value is a semicolon-delimited, ordered list of JAR files required by the connector. Whenever this connector is used, these JAR files are searched, from first to last, looking for a specific Java class file that provides connector functionality.
The Classpath Property Editor helps you edit the classpath value. When you click on the classpath property in the Properties View a button is displayed alongside the current value. Pressing this button displays the Classpath Property Editor.
The editor consists of the following:
- Message area - instructions that include the name of the connector being edited.
- Classpath JAR List - the ordered list of JARs the classpath will be set to if the OK button is pressed.
- Add button - allows you to add JARs from the file system.
- JAR names are unique. So if you add a JAR with a name that is already in use, it replaces the current one. A confirmation dialog is shown whenever this occurs as this may cause changes in existing connector behaviour.
- JARs added from the file system can then be added to the classpath of other connectors though this is not a common practice.
- After the OK button is pressed, JARs removed that are not needed by other connectors are no longer available when the Advanced button is pressed.
- Note: Sharing JARs among connectors is not a common practice.
- The semicolon delimiters are automatically inserted when more than one JAR is included.