Creating Application Configurations for Connectivity Parameters

Application Configurations allow you to configure the external connectivity parameters for a JBI application and, without changing or rebuilding the application, deploy the same application to a different system. For example, if you have an application that is running in a test environment, you can deploy it to a production environment using new connectivity parameters without rebuilding the application.

The connectivity parameters for the eMail Binding Component are normally defined in the WSDL service extensibility elements. When you create and apply application configurations for these parameters, the values defined for the application configuration override the values defined in the WSDL elements. You apply the configurations to the Composite Application by entering the application configuration name in the Config Extension Name property for the appropriate endpoint in the Service Assembly.

Perform the following procedures to implement application configurations for the eMail Binding Component:

• To Create Application Configurations

• To Add the Application Configuration to the Endpoint

Once you create an application configuration, you can modify it as described in To Change Application Configuration Values.

To Create Application Configurations

You can create several application configurations, which are all referenced by the names you define. Make sure the eMail Binding Component is started before you begin this procedure.

1. On the NetBeans IDE Services window, expand Servers > GlassFish v2.x > JBI > Binding Components.
2. Right-click sun-email-binding, and then select Properties.

   The Properties window appears.

3. Click the ellipsis next to Application Configuration.

   The Application Configuration Editor appears.

4. Click Add.

   A new row appears in the configuration list.

5. In the new row, enter a name for this application configuration, and fill in any of the following fields:

   • Host

   • SMTP Location

   • Password

   • Port

   • UseSSL

   • UserName

   
   
6. Click OK to Close the Application Configuration Editor.

To Add the Application Configuration to the Endpoint

1. Open the Composite Application Service Assembly in the CASA Editor.
2. Select the endpoint to which you want to add the application configuration.

   The Properties Panel appears to the right of the CASA Editor canvas.

3. In the Name property under Config Extension, enter the name of the application configuration to use for the service assembly.
   
4. Click Save All on the NetBeans toolbar.
5. Deploy the application.

To Change Application Configuration Values

The eMail Binding Component must be started in order to perform this procedure.

1. On the NetBeans IDE Services window, expand Servers > GlassFish v2.x > JBI > Binding Components.
2. Right-click sun-email-binding, and then select Properties.

   The Properties window appears.

3. Click the ellipsis next to Application Configuration.

   The Application Configuration Editor appears.

4. Change the value of any of the fields in any of the application configurations.
5. To apply the new values, stop and restart any service assemblies that use the application configurations you updated.