Configuring and Starting the GlassFish Application Server

When you install the "All" NetBeans 6.1 download, it includes the GlassFish Application Server. NetBeans will automatically start GlassFish V2 when needed.

To start the GlassFish Application Server:

1. If the Services window is not visible, choose Window > Services.
2. In the Services window, expand the Servers node.
   The Servers node contains a GlassFish V2 subnode. If a GlassFish Application Server node does not appear, go to To configure the GlassFish Application Server .

   

3. Right-click the GlassFish V2 node and select Start.
   
   The Output window displays logging information about the application startup. If the Output window is not visible, choose Window > Output > Output.
   When the message Application server startup complete appears in the Output window, the application server is running.
   
   

   Note: If a green arrow badge appears on the GlassFish Application Server node, the server is running.
   
   Did You Know: Deploying an application to the GlassFish Application Server automatically starts the GlassFish. Thus you do not have to manually start the application server.

Selecting an alternative application server:

The following procedure shows how to configure the NetBeans 6.1 IDE to use an alternate version of the GlassFish V2 Application Server. It assumes that you have downloaded and installed the alternate version of the application server.

1. In the Services window, right-click the Servers node and choose Add Server from the pop-up menu.
   The Add Server Instance dialog box opens.
2. In the Choose Server page, from the Server drop-down list, select GlassFish V2.
3. Click Next.
   The Platform Folder Location page opens.
4. In the Platform Location field, use the Browse button to navigate to and select the installation location of the application server.
   
   If you installed the GlassFish application server in the default location, then use Table 1 as a guide for locating the installation. Otherwise, navigate to the location where you installed GlassFish V2 Application Server.
   
   

   Table 1: Default Application Server Installation Directory

   Platform	Installing As...	SOA Installation	Tools Bundle Installation
   Solaris OS  Linux	root	/opt/SUNWappserver	/opt/SDK
   Solaris OS Linux	user	~/SUNWappserver	~/SDK
   Mac OS X	N/A	~/SUNWappserver	~/SDK
   Windows	N/A	C:\Sun\AppServer	C:\Sun\SDK

5. Select the Register Local Default Domain radio button and click Next.
6. Enter the user name and password for the domain's administrator.
   If you accepted the default values during the installation, the user name is admin and the password is adminadmin.
7. Click Finish.

top

Creating the BPEL Module Project

In this section, you create a BPEL Module project called SynchronousSample.

To create the SynchronousSample project:

1. From the main menu, choose File > New Project.
   The New Project wizard opens.
2. In the Categories list, select the SOA node, and in the Projects list, select the BPEL Module node.
3. Click Next.
4. In the Project Name field, type SynchronousSample.
5. (Optional) In the Project Location field, use the Browse button to navigate to and select a different folder where the IDE will store the project files.
6. Click Finish.
   The Projects window now contains a project node for a BPEL Module project called SynchronousSample.
   
   

   

top

Creating the XML Schema

In this section, you add a new XML schema file to your BPEL Module project and then add XML schema components to the schema.

To create SynchronousSample.xsd:

1. In the Projects window, expand the SynchronousSample project node, then right-click the Process Files node and choose New > Other.
   The New File wizard opens.
2. In the New File wizard, do the following:
   
   1. In the Choose File Type page, in the Categories list, select the XML node, then in the File Types list, select the XML Schema node and click Next.
   2. In the File Name field, type SynchronousSample.
   3. Click Finish.
   In the Projects window, the Process Files node now contains a subnode labeled SynchronousSample.xsd. The Source Editor contains a tab for the XML schema file, SynchronousSample.xsd, with the Schema view open.
3. In the Schema view, click the Design button to open the Design view of the XML schema editor.
   
   

   

To add a complex type to the XML schema:

1. In the Palette, visible on the right when the Design view is selected, expand the XML Schema Components section and select the Complex Type icon.
   If the Palette window is not visible, choose Window > Palette from the main menu.
2. Drag your selection to the schema design area, immediately below the Complex Types node.
   The IDE adds a complex type node and the name of the complex type (newComplexType) is selected and ready for you to change.
3. Type simpleProcess in the new node and press Enter.
   The design area now shows your new complex type, called simpleProcess.
   
   

   

To add a local element to simpleProcess:

1. In the XML Components section of the Palette, select the Element icon and drag your selection onto the simpleProcess node in the schema design area.
   The IDE adds an element node labeled newElement.
2. If the Properties window is not visible, choose Window > Properties.
3. In the schema design area, select the newElement node.
4. In the Properties window, select the value field of the Name property to make it editable and type paramA.
5. In the Properties window, in the Definition property, click the ellipsis button.
   The Definition dialog box opens.
6. In the list, expand the Built-in Types node and select the string node.
7. Click OK.
   The IDE updates the Design view.
   
   

   

To add a global element:

1. In the XML Components section of the Palette, select the Element icon and drag your selection to the design area, immediately below the Elements node.
   The IDE adds a newElement component below the Elements nodes in the schema design area.
2. In the schema design area of the Design view, select the newElement node.
3. In the Properties window, select the value field of the Name property to make it editable and type typeA.
4. In the Properties window, in the Definition property, click the ellipsis button.
   The Element's definition - Definition dialog box opens.
5. In the list of types, expand the Complex Types node and select the simpleProcess complex type node.
6. Click OK.
   In the Design view, the IDE now shows the selected simpleProcess complex type next to the typeA element node.
   
   

   

7. To save your changes, in the Projects window, select the SynchronousSample project node, and from the main menu, choose File > Save All.

top

Creating the WSDL Document

In this section, you add a WSDL file to your BPEL Module project and then configure the components of the WSDL Document.

To create SynchronousSample.wsdl:

1. In the Projects window, expand the SynchronousSample project node, then right-click the Process Files node and choose New > WSDL Document.
   The New WSDL Document wizard opens.
2. In the Name and Location page, do the following:
   
   1. In the File Name field, type SynchronousSample.
   2. Select the Import XML Schema File(s) checkbox.
   3. In the XML Schema(s) field, click the Browse button.
      The Add Import dialog box opens. This dialog box shows the XML schemas you can import.
   4. Expand By File > SynchronousSample > Process Files, select SynchronousSample.xsd.
      Make sure the checkbox in the Import column is selected for SynchronousSample.xsd.
      
      

      

   5. Click OK.
   6. Click Next.
   The Abstract Configuration page opens.
3. In the Input area of the Abstract Configuration page, do the following:
   
   1. In the Message Part Name column, double-click the default value (part1) to make the field editable.
   2. Type inputType and press Enter.
   3. In the Element Or Type column, click the ellipsis button.
      The Select Element Or Type dialog box opens.
   4. Expand By File > SynchronousSample > src/SynchronousSample.xsd > Elements.
      
      Note: You may need to scroll up to the top of the list in the Select Element Or Type dialog box to see the By File node.
      
   5. Under the Elements node, select the typeA node and click OK.
4. In the Output area of the Abstract Configuration page, do the following:
   
   1. In the Message Part Name column, double-click the default value (part1) to make the field editable.
   2. Type resultType and press Enter.
   3. In the Element Or Type column, click the ellipsis button.
      The Select Element Or Type dialog box opens.
   4. Expand By File > SynchronousSample > src/SynchronousSample.xsd > Elements.
      
      Note: You may need to scroll up to the top of the list in the Select Element Or Type dialog box to see the By File node.
      
   5. Under the Elements node, select typeA and click OK.
   The completed Abstract Configuration page should look like the one shown below.
   
   

   

5. Click Next.
   The Concrete Configuration page opens.
6. Under Binding Subtype, select the Document Literal radio button.
7. Click Finish.
   In the Projects window, the Process Files node now contains a subnode labeled SynchronousSample.wsdl.
   The Source Editor contains a tab for the WSDL file, SynchronousSample.wsdl, with the WSDL view open.
   
   

   

top

Creating the BPEL Process

In this section, you create a .bpel file for the BPEL process. You then add a partner link and three activities to the process.

To create SynchronousSample.bpel:

1. In the Projects window, right-click the Process Files node and choose New > BPEL Process.
   The New BPEL Process wizard opens.
2. In the File Name field, type SynchronousSample.
3. Click Finish.
   In the Projects window, the Process Files node now contains a subnode labeled SynchronousSample.bpel.
   The Source Editor contains a tab for the BPEL process, SynchronousSample.bpel, with the Design view of the BPEL Designer open.
   
   

   

To add a partner link:

1. Make sure the Design view for the SynchronousSample.bpel is the active window in the Source Editor.
2. In the Projects window, expand the SynchronousSample project node, then expand the Process Files node and select the SynchronousSample.wsdl node.
3. Drag your selection (SynchronousSample.wsdl) from the Projects window to the Design view.
   The IDE adds a box for the partner link to the design area.
   
   
   

   

To add a receive activity:

1. Make sure the Design view for the SynchronousSample.bpel is the active window in the Source Editor.
2. In the Web Service section of the Palette, select the Receive icon.
3. Drag your selection to the SynchronousSample process box in the design area, between the Process Start and the Process End activities.
   The IDE provides you with visual clues to show you where you can drop the selection.
   This action places a receive activity called Receive1 in the Design view.
4. Click the Receive1 activity Edit button.
   The Receive1 [Receive] - Property Editor opens.
5. On the Main tab, change the value in the Name field to start.
6. From the Partner Link drop-down list, select PartnerLink1.
   The IDE fills in the Operation field with SynchronousSampleOperation.
7. Create a new input variable by doing the following:
   
   1. Click the Create button next to the Input Variable field.
      The New Input Variable dialog box opens.
   2. Change the value in the Name field to inputVar.
   3. Click OK.
8. Click OK to close the Receive1 [Receive] - Property Editor.
   The Design view now shows a connection between PartnerLink1 and the start activity in the SynchronousSample process box.
   
   

   

To add a reply activity:

1. Make sure the Design view for the SynchronousSample.bpel is the active window in the Source Editor.
2. In the Web Service section of the Palette, select the Reply icon.
3. Drag your selection to the design area between the start activity and the Process End activity.
   The IDE provides you with visual clues to show you where you can drop the selection.
   This action places a reply activity called Reply1 in the Design view.
4. Click the Edit button for the Reply1 activity.
   The Reply1 [Reply] - Property Editor opens.
5. On the Main tab, change the value in the Name field to end.
6. From the Partner Link drop-down list, select PartnerLink1.
   The IDE fills in the Operation field with SynchronousSampleOperation.
7. Create a new output variable by doing the following:
   
   1. Make sure the Normal Response radio button is selected.
   2. Click the Create button next to the Output Variable field.
      The New Output Variable dialog box opens.
   3. Change the value in the Name field to outputVar.
   4. Click OK.
8. Click OK to close the Reply1 [Reply] - Property Editor.
   The Design view now shows a connection between the end activity in the SynchronousSample process box and PartnerLink1.
   
   

   

To add an assign activity:

1. Make sure the Design view for the SynchronousSample.bpel is the active window in the Source Editor.
2. In the Basic Activities section of the Palette, select the Assign icon.
3. Drag your selection to the design area between the start activity and the end activity.
   This action places an assign activity called Assign1 in the Design view.
4. Select the Assign1 activity.
5. On the editors toolbar, click the Mapper button.
   The BPEL Mapper appears.
6. In the Output tree pane (left pane) of the BPEL Mapper, under Variables, expand inputVar > inputType.
   A paramA node appears under the inputVar node.
7. In the Input tree pane (right pane) of the BPEL Mapper, under Variables, expand outputVar > resultType.
   A paramA node appears under the resultType node.
8. In the Output tree pane, select the paramA node and drag your selection to the paramA node in the Input pane.
   This assignment copies the input statement into the output.
   
   

   

9. To save your changes, in the Projects window, select the SynchronousSample project node, and from the main menu, choose File > Save All.

top

Creating and Deploying the Composite Application

Before you deploy the BPEL Module project, you must add the JBI module to the deployment project. Deploying the project makes the service assembly available to the application server, thus allowing its service units to be run.

To create the Composite Application project and add the JBI module:

1. From the main menu, choose File > New Project.
   The New Project wizard opens.
2. In the Categories list, select the SOA node and in the Projects list, select the Composite Application node.
3. Click Next.
4. In the Project Name field, type SynchronousSampleApplication.
5. Click Finish.
   The Projects window now contains a project node for a Composite Application project called SynchronousSampleApplication.
6. In the Projects window, right-click the SynchronousSampleApplication project node and choose Add JBI Module from the pop-up menu.
   The Select Project dialog box opens.
7. Select the SynchronousSample project you created earlier in this tutorial and click Add Project JAR Files.
   The Select Project dialog box closes.
8. In the Projects window, expand the SynchronousSampleApplication project node and then expand the JBI Modules node.
   Notice that a SynchronousSample.jar node has been added.
   
   

   

To deploy the Composite Application:

• Right-click the SynchronousSampleApplication project node and choose Deploy.
  If a message similar to the following message appears in the Output window, then the deployment has succeeded:
  BUILD SUCCESSFUL (total time: 11 seconds)

top

Testing the Composite Application

You can enhance the Composite Application project by adding test cases, binding to the operation, supplying input, and then using the tester.

To test the SynchronousSampleApplication composite application:

1. In the Projects window, expand the SynchronousSampleApplication project node, right-click the Test node, and choose New Test Case from the pop-up menu.
   The New Test Case wizard opens.
2. Accept the default test case name, TestCase1, and click Next.
3. In the Select the WSDL Document page, expand the SynchronousSample node, select SynchronousSample.wsdl, and click Next.
4. In the Select the Operation to Test page, select the SynchronousSampleOperation and click Finish.
   Notice the following:
   
   • In the Projects window, under Test, a new TestCase1 node has been added.
   • The TestCase1 node contains two subnodes: Input and Output.
   • The Source Editor contains a tab for the Input file, Input.xml.

   

   
   Note: If the Source Editor does not contain a tab for Input.xml, double-click the Input node in the Projects window to open the file.
   
5. In the Source Editor tab for the Input.xml file, do the following:
   
   1. Locate the following line:
      <syn:paramA>?string?<syn:paramA>.
   2. Replace ?string? with Hello World.
      The line should look like this:
      <syn:paramA>Hello World<syn:paramA>.
   3. From the main menu, choose File > Save All.
6. In the Projects window, double-click the Output node under Test > TestCase1 to examine its contents.
   Initially, output.xml is empty. Therefore the first test run will populate output.xml with the real output. Subsequent test runs will compare the real output against the contents of output.xml.
7. In the Projects window, right-click the TestCase1 node and choose Run from the pop-up menu.
   
   Note: The first run is a special case because Output.xml is empty and the output is written to Output.
   
   Notice the failed message in the Output window.
   The Overwrite Empty Output dialog box opens.
8. Click Yes.
9. In the Projects window, right-click the TestCase1 node and choose Run from the pop-up menu.
   After the first run, Output is no longer empty. The file's contents are preserved and are not overwritten by the new result.
   
   

   

top

Summary

In this tutorial, you created a simple BPEL Module project called SynchronousSample and a Composite Application project called SynchronousSampleApplication. You then designed an XML schema file and a WSDL file. You learned how to design a BPEL process and deploy. You also learned how to create and perform a test run of a composite application.

After completing the steps in this tutorial, you have built the sample Synchronous BPEL Process project that is available in the IDE (New > Project > Samples > SOA > Synchronous BPEL Process).

Next Steps

• To send comments and suggestions, obtain support, and stay informed of the latest changes to the NetBeans IDE J2EE development features, join the mailing list.

See Also

• Developer Guide to the WSDL Editor
• Developer Guide to the BPEL Designer  

top