Copy files "flamingo-services-common-2.1.jar", "flamingo-service-2.1.jar", "scannotation-1.0.2.jar", "amf-serializer-2.1.jar" (for AMF) and/or "hessian-3.1.3.jar"(for Hessian) into the "WEB-INF/lib" folder of your application. For EAR projects file "flamingo-service-2.1.jar" should be copied to the EAR root and specified in the "application.xml" file as a module.

If Seam Remoting is used in your project, you don't need any additional configuration and now can call the Seam components directly from Flex 2 using AMF and/or Hessian protocols.

<context-param>
    <param-name>flamingoConfig.webRemoteEnabled</param-name>
    <param-value>true</param-value>
</context-param>

If Seam Remoting is not used in your project:

This parameter shows that calls coming to URL "[server_name]/[context]/flamingo/amf/*" will be passed to the com.exadel.flamingo.service.seam.AMFToSeamServlet servlet.

Thus, using URL "/flamingo/amf/" you can call the servlet to access the Seam components via the AMF protocol.

This parameter shows that calls coming to URL "[server_name]/[context]/flamingo/hessian/*" will be passed to the com.exadel.flamingo.service.seam.HessianToSeamServlet servlet.

Thus, using URL "/flamingo/hessian/ " you can call the servlet to access the Seam components via the Hessian protocol.

<context-param>

    <param-name>flamingoConfig.webRemoteEnabled</param-name>

    <param-value>true</param-value>

</context-param>

where

"{server.name}:{server.port}" is server name:server port where your existing JBoss Seam application is running;

"helloworld" is the name of your existing application;

"helloAction" is the name of the component specified in the "HelloAction.java" file (see annotation @Name("helloAction") in 3.3.1);

"seam/resource/amf/" is the standard configuration while using Remoting. If you use another mapping for SeamResourceServlet or one of the Flamingo servlets, use the path specified in the "web.xml" file of your application for destination:

uri="http://{server.name}:{server.port}/helloworld/flamingo/amf"

Figure 3.1. HelloWorld.swf

...

<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" xmlns:word="*">

            

<hessian:HessianService xmlns:hessian="hessian.mxml.*"

id="service" destination="seam/resource/hessian/<property>helloAction</property>"/>

            

<mx:Panel title="Flamingo Hessian Hello World Sample"

paddingTop="10" paddingBottom="10" paddingLeft="10" paddingRight="10">

            

<mx:HBox>

   <mx:Label text='Whom do you want to say "Hello" to?'/>

            

   <mx:TextInput id="who"/>

            

   <mx:Button label="Say Hello" click="service.hello.send(who.text)"/>

</mx:HBox>

            

<mx:Label text='The server said: "{service.hello.lastResult}"'/>

            

</mx:Panel>

</mx:Application>

...

This sample shows how the hello method of server Seam component helloAction can be called using HessianService when clicking on the "Say Hello" button,

where

"helloAction" is the name of the component specified in the "HelloAction.java" file (see annotation @Name("helloAction") in 3.3.1);

"seam/resource/hessian/" is the standard configuration while using Remoting. Please note that the URL is relative, so the application will contact http://[origin server]/[application context]/[path to Seam/Flamingo servlet]/helloAction as a service. If you use another mapping for SeamResourceServlet or one of the Flamingo servlets, use the path specified in the "web.xml" file of your application in the URL pattern:

destination="flamingo/hessian/helloAction"

Figure 3.2. HelloWorld.swf

- classes

- lib

- src

...





package com.exadel.flamingo.javafx;

          

import javafx.stage.Stage;

import javafx.scene.Scene;

import javafx.scene.text.Text;

import javafx.scene.text.Font;

import javafx.scene.layout.HBox;

import javafx.scene.paint.Color;

import javafx.scene.text.TextOrigin;

import javafx.ext.swing.SwingButton;

import javafx.scene.layout.VBox;

import javafx.scene.control.TextBox;

          

import com.exadel.flamingo.javafx.samples.helloworld.javafx.HelloworldClient;

          

class Hello {

        public var name:String;

        public var str:String;

}

var helloModel = new Hello();

          

HelloworldClient.setServerUrl("http://localhost:8080/helloworld/seam/resource/hessian/<property>helloAction</property>");

          

          

var helloText: TextBox = TextBox {

       text: bind helloModel.name with inverse

       columns: 7

       selectOnFocus:true

}

          

var helloLabel = Text{

      y:8

      font: Font { name:"sansserif", size: 12 }

      fill: Color.BLACK

      content: bind "Server says: {helloModel.str}"

      textOrigin: TextOrigin.TOP

}

          

var helloButton = SwingButton  {

      text:"Say Hello!"

      action: function(){

             helloModel.str = HelloworldClient.CLIENT.<property>hello</property>(helloModel.name);

       }

}

          

Stage {

        title: "Helloworld Sample"

        width: 200

        height: 150

        scene: Scene {

                 content: VBox {

                         translateX: 5

                         translateY: 5

                         spacing: 10

                         content: [                

                                 HBox {

                                            content: helloText

                                            spacing: 10

                                 },

                                 HBox {

                                            content: helloButton

                                            spacing: 10

                             },

                                 HBox {

                                            content: helloLabel

                                            spacing: 10

                           }]

                 }

         }

}  

...

This file creates a visual form to send data from the client side to the server,

where

"helloAction" is the name of the component specified in the "HelloAction.java" file created for the Seam application (see annotation @Name("helloAction") in 3.3.1);

"http://localhost:8080/helloworld/seam/resource/hessian/" is the standard configuration while using Remoting. Please note that the URL is relative, so the application will contact http://[origin server]/[application context]/[path to Seam/Flamingo servlet]/helloAction as a service. If you use another mapping for SeamResourceServlet or one of the Flamingo servlets, use the path specified in the "web.xml" file of your application in the URL pattern:

destination="flamingo/hessian/helloAction"

package com.exadel.flamingo.javafx.samples;

public interface IHelloAction {

    public String hello(String name);

}

...

 package com.exadel.flamingo.javafx.samples.javafx;



import com.caucho.hessian.client.HessianProxyFactory;

import com.exadel.flamingo.javafx.samples.IHelloAction;

import java.net.MalformedURLException;



public class HelloworldClient {

    public static HelloworldClient CLIENT;

    private String _url;

    private HelloworldClient(String string) {

        _url = string;

    }

    private IHelloAction _service;

    public static void setServerUrl(String url) {

        CLIENT = new HelloworldClient(url);

    }

    private IHelloAction getService() {

        if (_service == null) {

            try {

                HessianProxyFactory factory = new HessianProxyFactory();



                _service = (IHelloAction) factory.create(IHelloAction.class, _url);

            } catch (MalformedURLException ex) {

                System.out.println(ex);

            }



        }



        return _service;

    }



    public String <property>hello</property>(String s) {

        return getService().hello(s);

    }

} 

...

This sample shows how the HelloworldClient class creates a connection with the server with the help of the HessianProxyFactory class and calls the corresponding methods of the component on the server.

Here is an example of usage of the JavaFX interpretator:

Figure 3.3. HelloWorld

For more information about usage Flamingo with Android can be obtained from the examples of the use (examples/expression/swing).

This parameter shows that calls coming to URL "[server_name]/[context]/flamingo/amf/*" will be passed to the com.exadel.flamingo.service.spring.AMFToSpringServlet servlet.

Thus, using URL "/flamingo/amf/" you can call the servlet to access the Spring beans via the AMF protocol.

This parameter shows that calls coming to URL "[server_name]/[context]/flamingo/hessian/*" will be passed to the com.exadel.flamingo.service.spring.HessianToSpringServlet servlet.

Thus, using URL "/flamingo/hessian/ " you can call the servlet to access the Seam components via the Hessian protocol.

where

"{server.name}:{server.port}" is server name:server port where your existing JBoss Seam application is running;

"helloworld" is the name of your existing application;

"helloService" is the name of the bean specified in the application context file or via annotation like @Component(“helloService”) added to the HelloService class;

"flamingo/amf/" is the standard configuration while using servlets. If you use another mapping for HessianToSpringServlet, use the path specified in the "web.xml" file of your application for destination.

Figure 3.4. HelloWorld.swf

...

<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" xmlns:word="*">         

<hessian:HessianService xmlns:hessian="hessian.mxml.*"

id="service" destination="flamingo/hessian/<property>helloService</property>"/>        

<mx:Panel title="Flamingo Spring Hessian Hello World Sample"

paddingTop="10" paddingBottom="10" paddingLeft="10" paddingRight="10">       

<mx:HBox>

   <mx:Label text='Whom do you want to say "Hello" to?'/>       

   <mx:TextInput id="who"/>        

   <mx:Button label="Say Hello" click="service.hello.send(who.text)"/>

</mx:HBox>         

<mx:Label text='The server said: "{service.hello.lastResult}"'/>        

</mx:Panel>

</mx:Application>

...

This sample shows how the hello method of server Spring service bean helloService can be called using "HessianService" when clicking on the "Say Hello" button,

where

"helloService" is the name of the component specified in the application context file;

"flamingo/hessian/" is the standard servlet configuration. Please note that the URL is relative, so the application will contact http://[origin server]/[application context]/[path to Spring/Flamingo servlet]/helloService as a service. If you use another mapping for HessianToSpringServlet use the path specified in the "web.xml" file of your application in the URL pattern.

Figure 3.5. HelloWorld.swf

Example of creation of a simple application on Swing and Spring is similar to the one described for Swing/Seam.