Quick Start Guide to the CASA Editor


Test Drive This Tutorial: This Quick Start Guide is a tutorial planned for NetBeans 6.0 FCS Release. It provides a quick introduction to the CASA Editor.

Comments on this tutorial are welcome. Either send them to me, Vince Genovese, directly. Or post comments to Vince's Blog.

[Return to Vince's Blog]


This tutorial provides an introduction to the CASA Editor provided with NetBeans 6.0.

For more information about working with NetBeans IDE, see the Support and Docs page on the NetBeans web site.

Warning: This tutorial was created and tested against NetBeans 6.0 Milestone 10 daily builds. Features and procedures in this tutorial might not work with earlier releases or builds of NetBeans 6.0.

Expected duration: 30 minutes

Contents

Tutorial Requirements


Before you proceed, make sure you review the requirements in this section.

Prerequisites

This tutorial assumes that you have basic knowledge of the following technologies.

  • Composite Applications and Service-oriented Architecture (SOA)
  • Web Services

Software Needed for This Tutorial

Before you begin, you need to download and install the following software:

  • NetBeans 6.0 (Milestone 10)

    Download the full distribution. The default installation includes SOA Pack and GlassFish V2, which are required for this tutorial.

GlassFish Application Server

After installing NetBeans 6.0, configure and start the GlassFish Application Server, as described in the following mini-tutorial, Configuring and Starting the GlassFish Application Server.

Window Layout of the NetBeans IDE

This tutorial assumes you have a standard window layout of the NetBeans IDE with the following windows visible:

  • Projects
  • Files
  • Services
  • Properties
  • Palette (for editors using the Palette window)
  • Output

Use the Window menu of the NetBeans IDE to change the layout if necessary.

top

Overview


This tutorial shows how to use the CASA Editor to edit the configuration of a composite application and to build the composite application.

The composite application you configure and build is the Synchronous Sample composite application provided with the NetBeans 6.0 distribution. The tutorial illustrates the following:

  • Building a composite application from within the CASA Editor
  • Deleting a connection to an existing WSDL endpoint in the existing composite application
  • Adding a connection to a new WSDL endpoint to the composite application
  • Modifying the properties of the new WSDL endpoint
  • Deploying the composite application
  • Creating and running a test case for the composite application

top

Create the Sample Application Project

In this section you create a project for the sample Synchronous Composite Application, which is provided with NetBeans 6.0.

To create the Synchronous Sample Application project:

  1. In the NetBeans IDE, select the Projects tab to display the Projects window.
  2. From the File menu, select New Project.
  3. In the Categories list of the New Project window, select Samples > SOA > Synchronous BPEL Process and click Next.

    NewProject, click to enlarge
  4. Accept the default project name and location (or specify an alternate location using the Browse button).
  5. Click Finish to create the project.

    The following projects appear in the Projects window:

    • SynchronousSample BPEL project
    • SynchronousSampleApplication composite application project
    Synchronous Sample Projects

top

Open the CASA Editor and Build the Application

This section shows how you can use the CASA Editor to build a composite application.

To open the CASA Editor and build the composite application:

  1. In the NetBeans IDE, right-click the SynchronousSampleApplication in the Projects window and select Edit Application Configuration.

    Invoke CASA Editor

    The CASA editor opens in the NetBeans IDE, displaying the Design View of the Synchronous Sample application.

    The CASA editor creates and modifies a .casa file, which contains the configuration information for the composite application. For this sample, the CASA Editor created the SynchronousSampleApplication.casa file.

    CASA Editor, click to enlarge
  2. In the CASA Editor, select the Build Project icon to build the composite application.

    CASA Editor, Building an Application

    The Output window displays messages about the build.

    When the build successfully completes, the Design View displays a WSDL port endpoint, a JBI module, and the connection between the endpoint and the JBI module.

    CASA Editor, Showing Application Configuration

top

Modify the WSDL Bindings of the Composite Application

This section shows how to modify connections between a WSDL port and a JBI module, and also how to add and configure new WSDL ports.

To modify the endpoints of the composite application:

  1. In the Design View of the CASA Editor, select the connection between the WSDL port and the JBI module.
  2. Delete the selected connection using the Delete key from your keyboard.

    You can also right-click the connection and select Delete to delete the connection.

    CASA Editor, Deleting a Connection
  3. In the Palette Window of the NetBeans IDE, select the Soap WSDL Binding and drag it to the WSDL Ports area of the CASA Editor.

    CASA Editor, Adding a New WSDL Binding
  4. Select the Consume endpoint of the newly added SOAP Binding and drag it to the Provide endpoint of the JBI module.

    This creates a connection between the SOAP Binding and BPEL JBI module.

    CASA Editor, Adding a Connection
  5. Click the Edit icon for the newly added SOAP Binding to view it's properties.

    This feature allows you to view details of the underlying WSDL without having to navigate through the WSDL file using the WSDL editor interface.

    CASA Editor, Editing the Properties of a Binding
  6. In the Properties window, click the Edit button for the Location property.

    Note that the auto-generated location property is: http://localhost:18181/service

    In the following procedure, you will specify this location in a test case for the composite application.
  7. Select Cancel in both the Location property window and the Properties Window, and save your work.

top

Create a Test Case for the Composite Application

This section shows how to test the newly configured composite application. In this section, the GlassFish Application Server must be configured and started, as explained previously in the Tutorial Requirements section.

To create a test case for the composite application:

  1. In the Project Window of the NetBeans IDE, expand the SynchronousSampleApplication > Test node, right-click the default test case, TestCase0, and select Properties.

    Selecting the Default Test Case
  2. In the Properties window for TestCase0, select the Edit button for the Destination property.
  3. Replace the default Destination property with the auto-generated destination from the previous procedure, and click OK, and then close the Properties window:

    http://localhost:18181/service
  4. Right-click the SynchronousSampleApplication node, and select Deploy.

    In the Select Server window, specify the GlassFish Application Server.

    The Output window informs you when the composite application has been successfully deployed.
  5. In the Services window of the NetBeans IDE, expand the servers > GlassFish V2 > JBI > Service Assemblies node.

    Notice that the SynchronousSampleApplication Service Assembly has been deployed. You can also view the properties of the Service Units within the Service Assembly to see details of the composite application.

    Deployed Service Assembly for Sample Application
  6. In the Projects window, right-click the TestCase0 and select Run.

    The Output window indicates that the test case was successful.

    Test Case Passed

top


[Return to Vince's Blog]