TOTD #23: JavaFX Client invoking a Metro endpoint

This TOTD is inspired by

Learning JavaFX Script - Part 3. The original article explains how to invoke
a Web service from a JavaFX client using NetBeans 5.5.1 and GlassFish v1. Newer
version of both NetBeans and GlassFish are available since the article was
written. This TOTD (tip of the day) explains how to invoke a
Metro endpoint deployed on
GlassFish v2 from a
JavaFX client - all using
NetBeans 6.

1. Following
   
   screencast #ws7, create a plain (without Security or Reliability
   enabled) Metro endpoint using NetBeans 6 and GlassFish v2.
2. In NetBeans 6 IDE, install the JavaFX plugin as described
   here.
3. Create Web service client library - Creating a Web service client in
   JavaFX Script Application is causing a NullPointerException (issue
   #126352). The workaround I used is to create a separate library with
   client-side artifacts and then include it as dependency in the JavaFX client
   project.
   1. Create a new project of type "Java Class Library" as
      shown below:
      
      
      
      
      
      
      
      and click on "Finish".
   2. Enter the project name as "MetroClientLibrary" as shown
      below:
      
      
      
      
      
      
      
      and click on "Finish".
   3. Right-click on the newly created project, select "New",
      "Web Service Client...".
   4. Click on "Browse..." button next to "Project"
      radio button and select the deployed Web service from Metro endpoint
      project. If the Web service is deployed on a different machine then you
      may specify the WSDL URL. Specify the package name "client"
      as shown below:
      
      
      
      
      
      
      
      and click on "Finish".
   5. Once the Web service client-side artifacts are generated (indicated
      by expandable Web Service References tree node), right-click on
      the project and select "Build". This generates a JAR file
      that will be utilized later. The location of this jar file is shown in
      the Output console. In our case, it is
      
      
      
      C:\workarea\samples\javafx\MetroClientLibrary\dist\MetroClientLibrary.jar.
4. Create JavaFX project
   1. Create a new JavaFX project by right-clicking in the Project
      explorer, selecting "New Project" and entering the values
      as shown below:
      
      
      
      
   2. Click on "Next >" and enter the values as shown below:
      
      
      
      
      
      
      
      and click on "Finish".
   3. Right-click on the newly created project, "Properties",
      "Libraries", "Add JAR/Folder" and select the
      JAR file created in "MetroClientLibrary" project as shown
      below:
      
      
      
      
      
      
      
      and click on "OK".
      
      
      
      Notice, Java SE 6 U4 is used to compile and run this project. If you are
      using an earlier version of Java SE 6, then you need to override JAX-WS
      2.1 and JAXB 2.1 jars using endorsed mechanism as explained
      
      here. The classes in these jars are
      
      already bundled in Java SE 6 U4.
   4. In metroclient.Main.fx file, replace "

      // place 
      		your code here

      " with the following code:
      
      
      
      

      import java.lang.*;<br>
      		import javafx.ui.*;<br>
      		<br>
      		import client.NewWebServiceService;<br>
      		import client.NewWebService;<br>
      		<br>
      		class InputModel {<br>
      &nbsp;&nbsp;&nbsp; attribute name: String?;<br>
      		}<br>
      		var inputModel = InputModel { };<br>
      		var nameField = TextField { };<br>
      		nameField.action = operation() {<br>
      &nbsp;&nbsp;&nbsp; inputModel.name = nameField.value;<br>
      		};<br>
      		<br>
      		class ButtonClickModel {<br>
      &nbsp;&nbsp;&nbsp; attribute result: String;<br>
      		}<br>
      		var model = new ButtonClickModel();<br>
      		<br>
      		Frame {<br>
      &nbsp;&nbsp;&nbsp; title: &quot;JavaFX Client -&gt; Metro endpoint&quot;<br>
      &nbsp;&nbsp;&nbsp; width: 350<br>
      &nbsp;&nbsp;&nbsp; height: 200<br>
      &nbsp;&nbsp;&nbsp; content: GridPanel {<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; rows: 3<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; vgap: 5<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; cells:<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [SimpleLabel {<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; text: &quot;Name : 
      		&quot;<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; },<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; nameField,<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; SimpleLabel {<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; text: &quot;Result 
      		from endpoint : &quot;<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; },<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Label {<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; text: bind &quot;{model.result}&quot;<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; },<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Button {<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; text: &quot;Invoke 
      		Web Service!&quot;<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; action: 
      		operation() {<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
      		do {<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
      		try {<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
      		var service: NewWebServiceService = new NewWebServiceService();<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
      		var port: NewWebService = service.getNewWebServicePort();<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
      		var name: String = &quot;{nameField.value}&quot;;<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
      		var result: String = port.sayHello(name);<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
      		System.out.println(&quot;response: {result}&quot;);<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
      		model.result = result;<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
      		} catch (e:Exception) {<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
      		System.out.println(&quot;exception: {e}&quot;);<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
      		}<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
      		}<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; }<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; }<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; ]<br>
      &nbsp;&nbsp;&nbsp; }<br>
      &nbsp;&nbsp;&nbsp; visible: true<br>
      		};

5. Invoke the JavaFX client project
   1. Right-click on the recently create project ("MetroClient")
      and select "Run Project". The following window is
      displayed:
      
      
      
      
   2. Enter "Duke" in the text box and click on "

      Invoke 
      		Web Service!

      " button to see the result as shown below:
      
      
      
      

After following these steps, you have created a JavaFX client that can invoke
a Metro endpoint project deployed on GlassFish - all using NetBeans IDE.

Now Metro provides secure, reliable, transactional and .NET 3.0 interoperable
Web service. Have you tried/used any of those features in Metro ?

Please leave suggestions on other TOTD that you'd like to see. A complete
archive is available here.

Technorati: totdd
javafx
metro
glassfish
netbeans
webservices