Using the Sun Data Mashup Engine

Creating and Deploying a Composite Application for a Data Mashup Project

Before a Data Mashup project can be opened and used in a browser, it must be added to a composite application (CA) project. You use the composite application project to assemble a deployment unit, which includes the Data Mashup project, for the Java Business Integration (JBI) server. A composite application project can have multiple BPEL modules and Java Business Integration (JBI) modules.

It is only after a successful deployment of the composite application project that you can open and run your Data Mashup project as a web service in a browser, allowing you to view your data on the web.

Perform the following steps to create and deploy the Data Mashup composite application:

ProcedureTo Create the Composite Application

Before You Begin

Before you can create and deploy a composite application, you must have created a Data Mashup project, set the join conditions, the NetBeans IDE must be running, and you must be connected to the virtual database. For information on how to perform these tasks, see Designing Data Mashup Projects and Configuring Data Mashup Projects Using Joins.

  1. In the NetBeans IDE tool bar select File->New Project.

    The New Composite Application window appears.

  2. In the Choose Project window, select SOA under Categories and select Composite Application under Projects.

  3. Click Next.

    The Name and Location window appears.

  4. Enter a name for the project and enter the location for the project files.


    Note –

    If you do not want this project to be set as a main project, deselect the Set as Main Project check box.


  5. Click Finish.

    The following happens:

    • An empty composite application project is created on the Projects page.

    • The Composite Application Service Assembly (CASA) editor opens up in the NetBeans IDE.

    You are now ready to add a Data Mashup application to the JBI modules of the composite application.

ProcedureTo Add the Data Mashup Application to the Composite Application

This step adds the Data Mashup project and its JAR files to the composite application.

  1. On the Projects window, expand the Composite Application Tree, right-click JBI Modules and select Add JBI Module.

  2. In the Select Project window, select the Data Mashup application in the list (demoDMProject for this exercise), and click Add Project JAR Files.

    This adds the Data Mashup application to the CASA Editor canvas as a JBI module and builds the service engine deployment JAR file.


    Tip –

    If you do not see the Data Mashup project in the left pane of the window, navigate to the directory that contains it.


  3. In the CASA Editor, right-click in the WSDL Ports area and select Add WSDL Port.

    The Select WSDL Port window appears, listing all the available WSDL ports.

  4. In the Select WSDL Port window, select http and soap and then click OK.

    An HTTP port named casaPort1 and a SOAP port named casaPort2 appear in the WSDL Ports area of the canvas.


    Note –

    Data Mashup only supports the http and the soap WSDL bindings. If you want to use the procedure to test the deployment of your composite application, when creating the WSDL port you must use the soap WSDL binding and not the http WSDL binding.


  5. Click Save All.

  6. In the Projects window, right-click the composite application and click Build.

    Check the output in the bottom panel to ensure that the composite application built successfully.


    Note –

    If the build fails, do the following:

    1. In the Projects window, expand the composite application project, and select the WSDL file under Process Files.

    2. In the CASA Editor, select the Source tab.

    3. Scroll down until you see

      <http:address location="http://localhost:${HttpDefaultPort}/
      casaservice1/casaPort1"/>
    4. Change casaPort1 to another port number, such as casaPort6.

    5. Build the composite application again.


  7. On the CASA Editor, drag the purple HTTP and SOAP consumer endpoints in the WSDL Ports pane to the green endpoint for the Data Mashup project.

  8. Click Save All.

    You are now ready to build and deploy the composite application.

ProcedureTo Build and Deploy the Composite Application

  1. In the Projects window, right–click the composite application and click Build.

    A message appears in the Output panel letting you know whether the build was successful.

  2. After the build process completes successfully, right-click the composite application and click Deploy.

    A message appears in the Output panel letting you know whether the deployment was successful.


    Note –

    If the application server was not already started before beginning the deploy process, NetBeans automatically starts the server for you.


Next Steps

If you used the soap WSDL binding, you can test the deployment of your composite application. For more information, see Testing the Deployment of a Composite Application.