You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@flex.apache.org by cd...@apache.org on 2016/03/26 11:26:06 UTC

flex-blazeds git commit: Added some documentation.

Repository: flex-blazeds
Updated Branches:
  refs/heads/develop de985b1e4 -> 2f4ba7051


Added some documentation.


Project: http://git-wip-us.apache.org/repos/asf/flex-blazeds/repo
Commit: http://git-wip-us.apache.org/repos/asf/flex-blazeds/commit/2f4ba705
Tree: http://git-wip-us.apache.org/repos/asf/flex-blazeds/tree/2f4ba705
Diff: http://git-wip-us.apache.org/repos/asf/flex-blazeds/diff/2f4ba705

Branch: refs/heads/develop
Commit: 2f4ba7051d794e3dc479c71572c65d7629420e13
Parents: de985b1
Author: Christofer Dutz <ch...@codecentric.de>
Authored: Sat Mar 26 11:26:00 2016 +0100
Committer: Christofer Dutz <ch...@codecentric.de>
Committed: Sat Mar 26 11:26:00 2016 +0100

----------------------------------------------------------------------
 opt/blazeds-spring-boot-starter/README.adoc | 160 +++++++++++++++++++++++
 1 file changed, 160 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/flex-blazeds/blob/2f4ba705/opt/blazeds-spring-boot-starter/README.adoc
----------------------------------------------------------------------
diff --git a/opt/blazeds-spring-boot-starter/README.adoc b/opt/blazeds-spring-boot-starter/README.adoc
new file mode 100644
index 0000000..2a811e2
--- /dev/null
+++ b/opt/blazeds-spring-boot-starter/README.adoc
@@ -0,0 +1,160 @@
+= BlazeDS Spring-Boot Starter
+
+This module can be used to configure a BlazeDS server with Spring-Boot.
+It automatically kicks in as soon as a services-config.xml is detected in
+`META-INF/flex/services-config.xml`
+
+In order to call your Spring services from Flex using Remote objects, all
+you need is a Spring-Boot starter:
+
+.init/Application.java
+----
+package init;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.context.annotation.ComponentScan;
+
+@SpringBootApplication
+@ComponentScan("de.codecentric.iot.rapiro")
+public class Application {
+
+    public static void main(String[] args) {
+        SpringApplication.run(Application.class, args);
+    }
+
+}
+----
+
+The services-config.xml is the core part of this, as it describes
+which channels the BlazeDS instance will provide. It has to be located
+in the applications classpath in `META-INF/flex/servcies-config.xml`:
+
+.src/main/resources/META-INF/flex/services-config.xml
+----
+<?xml version="1.0" encoding="UTF-8"?>
+<services-config>
+    <services>
+        <service id="remoting-service" class="flex.messaging.services.RemotingService">
+            <adapters>
+                <adapter-definition
+                        id="java-object"
+                        class="flex.messaging.services.remoting.adapters.JavaAdapter"
+                        default="true"/>
+            </adapters>
+            <default-channels>
+                <channel ref="websocketAmf"/>
+                <channel ref="longPollingAmf"/>
+                <channel ref="shortPollingAmf"/>
+            </default-channels>
+        </service>
+    </services>
+
+    <channels>
+        <channel-definition id="websocketAmf" class="mx.messaging.channels.StreamingAMFChannel">
+            <endpoint url="http://{server.name}:{server.port}/{context.root}/messagebroker/websocket-amf"
+                      class="flex.messaging.endpoints.StreamingAMFEndpoint"/>
+            <properties>
+                <server-to-client-heartbeat-millis>5000</server-to-client-heartbeat-millis>
+                <add-no-cache-headers>true</add-no-cache-headers>
+            </properties>
+        </channel-definition>
+        <channel-definition id="longPollingAmf" class="mx.messaging.channels.AMFChannel">
+            <endpoint url="http://{server.name}:{server.port}/{context.root}/messagebroker/long-polling-amf"
+                     class="flex.messaging.endpoints.AMFEndpoint"/>
+            <properties>
+                <polling-enabled>true</polling-enabled>
+                <wait-interval-millis>0</wait-interval-millis>
+                <polling-interval-millis>1000</polling-interval-millis>
+                <max-waiting-poll-requests>100</max-waiting-poll-requests>
+                <piggybacking-enabled>true</piggybacking-enabled>
+                <add-no-cache-headers>true</add-no-cache-headers>
+            </properties>
+        </channel-definition>
+        <channel-definition id="shortPollingAmf" class="mx.messaging.channels.AMFChannel">
+            <endpoint url="http://{server.name}:{server.port}/{context.root}/messagebroker/short-polling-amf"
+                      class="flex.messaging.endpoints.AMFEndpoint"/>
+            <properties>
+                <polling-enabled>true</polling-enabled>
+                <polling-interval-millis>3000</polling-interval-millis>
+                <piggybacking-enabled>true</piggybacking-enabled>
+                <add-no-cache-headers>true</add-no-cache-headers>
+            </properties>
+        </channel-definition>
+    </channels>
+
+    <flex-client>
+        <!-- Make sure clients are automatically expired -->
+        <timeout-minutes>720</timeout-minutes>
+    </flex-client>
+
+    <logging>
+        <!--
+                Logging inside BlazeDS is completely turned off.
+                The UniversalExceptionTranslator will handle logging
+                of exceptions inside Spring.
+        -->
+        <target class="flex.messaging.log.ConsoleTarget" level="None"/>
+    </logging>
+</services-config>
+----
+
+As soon as you have Spring services annotated with `@RemotingDestination`
+these are automatically accessible.
+
+.src/main/java/de/codecentric/iot/rapiro/movement/MovementService.java
+----
+package de.codecentric.iot.rapiro.movement;
+
+import org.springframework.flex.remoting.RemotingDestination;
+import org.springframework.stereotype.Service;
+
+@Service("movementService")
+@RemotingDestination
+public class MovementService {
+
+    @Override
+    public void stop() {
+        System.out.println("Stop");
+    }
+
+    @Override
+    public void moveForward() {
+        System.out.println("Forward");
+    }
+
+    @Override
+    public void moveLeft() {
+        System.out.println("Left");
+    }
+
+    @Override
+    public void moveRight() {
+        System.out.println("Right");
+    }
+
+    @Override
+    public void moveBack() {
+        System.out.println("Back");
+    }
+
+}
+----
+
+The Flex code for accessing these methods is now:
+
+.src/main/flex/de/codecentric/iot/rapiro/movement/MovementService.mxml
+----
+    <fx:Declarations>
+        <s:RemoteObject id="movementService"
+                        destination="movementService"
+                        endpoint="http://localhost:8080/messagebroker/short-polling-amf"
+                        fault="onFault(event)">
+            <s:method name="stop" result="onResult(event)"/>
+            <s:method name="moveForward" result="onResult(event)"/>
+            <s:method name="moveLeft" result="onResult(event)"/>
+            <s:method name="moveRight" result="onResult(event)"/>
+            <s:method name="moveBack" result="onResult(event)"/>
+        </s:RemoteObject>
+    </fx:Declarations>
+----


AW: flex-blazeds git commit: Added some documentation.

Posted by Christofer Dutz <ch...@c-ware.de>.
Hi Justin,

this is part of an example application I am building. It's open for anyone, but you are right ... this does apply to only this application ;-) ... I'll sort of generify that.

Chris

________________________________________
Von: Justin Mclean <ju...@classsoftware.com>
Gesendet: Sonntag, 27. März 2016 07:16
An: dev@flex.apache.org
Betreff: Re: flex-blazeds git commit: Added some documentation.

Hi,

> +@ComponentScan("de.codecentric.iot.rapiro”)

I assume that line is only needed for your application not everyones?

Thanks,
Justin

Re: flex-blazeds git commit: Added some documentation.

Posted by Justin Mclean <ju...@classsoftware.com>.
Hi,

> +@ComponentScan("de.codecentric.iot.rapiro”)

I assume that line is only needed for your application not everyones?

Thanks,
Justin