Group items tagged

GraniteDS validation framework provides a set of standard constraints

Constraint Description AssertFalse The annotated element must be false AssertTrue The annotated element must be true DecimalMax The annotated element must be a number whose value must be lower or equal to the specified maximum DecimalMin The annotated element must be a number whose value must be greater or equal to the specified minimum Digits The annotated element must be a number whithin accepted range Future The annotated element must be a date in the future Max The annotated element must be a number whose value must be lower or equal to the specified maximum Min The annotated element must be a number whose value must be greater or equal to the specified minimum NotNull The annotated element must not be null Null The annotated element must be null Past The annotated element must be a date in the past Pattern The annotated String must match the supplied regular expression Size The annotated element size must be between the specified boundaries (included)

must use

Note that the bundle name must always be set to "ValidationMessages".

granite-beanvalidation.jar if you want to benefit from the integration with the Bean Validation API

configuration file declares 3 differents things

Channel endpoint

Service factories

Service/destinations

destinations using this factory will route incoming remote calls to EJB 3

endpoint

factory 

destination

channel 

factory

org.granite.gravity.tomcat.GravityTomcatServlet

/gravityamf/*

6.3.1. Supported Application Servers

GraniteDS provides a generic servlet implementation that can work in any compliant servlet container

blocking IO and thus will provide relatively limited scalability

GraniteDS thus provides implementations of non blocking messaging for the most popular application servers.

asynchronous non blocking servlets

JBoss 5+org.granite.gravity.jbossweb.GravityJBossWebServletOnly with APR/NIO enabled (APR highly recommended)

GlassFish 3.xorg.granite.gravity.async.GravityAsyncServletUsing Servlet 3.0

Tomcat 7.x / Jetty 8.xorg.granite.gravity.async.GravityAsyncServletUsing Servlet 3.0

GraniteDS now fully supports Hibernate 4

use the granite-hibernate4.jar instead of granite-hibernate.jar

Flex 4.5 broke a few APIs and there were two main issues with Tide : The client libraries crashed when run in a mobile application The PagedQuery was unusable

These two issues are now fixed

granite-flex45.swc

Flex SDK 4.5 here

services-config.xml

define manually the endpoint for remote services

service initializer in a static block of the main mxml file

Cdi.getInstance().addComponentWithFactory("serviceInitializer", DefaultServiceInitializer, { contextRoot: "/my-cdi-app" } );

tideAnnotations

3 separate projects: a Java project, a Flex project and a Webapp project.

GraniteDS archetypes

archetypeGroupId: org.graniteds.archetypes archetypeVersion: 1.1.0.GA archetypeArtifactId:

Maven 3.x required

mvn archetype:generate    -DarchetypeGroupId=org.graniteds.archetypes    -DarchetypeArtifactId=graniteds-tide-spring-jpa-hibernate    -DarchetypeVersion=1.1.0.GA    -DgroupId=org.example    -DartifactId=springgds    -Dversion=1.0-SNAPSHOT

cd springgdsmvn clean package

build the project

CDI archetype requires a Java EE 6 server and uses an embedded GlassFish

cd webappmvn embedded-glassfish:run

With the Eclipse Maven integration (the M2E plugin), you can simply choose one of the archetypes when doing New Maven Project.

mvn war:war

two very easy ways to quickly create a new GraniteDS project

GraniteDS does not support the standard Consumer and Producer Flex messaging API

its own client implementations of these classes org.granite.gravity.Consumer and org.granite.gravity.Producer that provide very similar functionality

most advanced features and greatly simplifies asynchronous handling and client data management

preferred for new projects

Server Options

two options

RemoteObject API,

GraniteDS support for externalization of lazily loaded JPA entities/collections, and support for scalable messaging though Gravity

Tide API

full feature set of Tide data management and further integration with data push through Gravity

complete support for Spring and Seam security or integration with CDI events

Tide/CDI/JPA2/Java EE 6 on JBoss 6/7 or GlassFish 3

If you are on a Java EE 6 compliant application server, it is definitely the best option

granite-core

granite-hibernate

GraniteDS/Tide/CDI/JPA: graniteds-tide-cdi-jpa

Maven archetypes

<category name="org.granite.messaging.webapp.AMFMessageServlet"> <priority value="DEBUG" /> </category>

always have to include this library in either WEB-INF/lib

support for CDI is included in the library granite-cdi.jar

10.1. Configuration with Servlet 3 On Servlet 3 compliant containers, GraniteDS can use the new APIs to automatically register its own servlets and filters and thus does not need any particular configuration in web.xml. This automatic setup is triggered when GraniteDS finds a class annotated with @FlexFilter in one of the application archives:

@FlexFilter(configProvider=CDIConfigProvider.class) public class GraniteConfig { }  

list of annotation names that enable remote access to CDI beans

@FlexFilter declaration will setup an AMF processor for the specified url pattern

@TideEnabled

@RemoteDestination

always declared by default

10.3.2. Typesafe Remoting with Dependency Injection

It is possible to benefit from even more type safety by using the annotation [Inject] instead of In. When using this annotation, the full class name is used to find the target bean in the CDI context instead of the bean name.

Security

integration between the client RemoteObject credentials and the server-side container security

client-side component named

API to define runtime authorization checks on the Flex UI

bindable property

clear the security cache manually with

integrated with server-side role-based security

represents the current authentication state

JSR-303 (“Bean Validation”) ActionScript3 framework for form validation

validation framework is a specific adaptation of the JSR-303 (Bean Validation) specification to Flex: like its Java counterpart, it relies on validation annotations placed on bean properties and provides an engine API that lets you validate your forms without writing by hand a specific validator for each of your input fields

code generation tools provided by GraniteDS so that when you write your Java entity bean with validation annotations, they are automatically replicated in your ActionScript3 beans

problem with LCDS is mainly that it promotes a strict “client / server” architecture, with – roughly speaking – a heavy Flex client application connected to a server almost reduced to a database frontend

big majority of  these organizations use BlazeDS, a free and open-source subset of LCDS

need more advanced mechanisms than just Remoting start looking for open-source libraries to enable deeper integrations with the Java business layer, and GraniteDS is for sure the most popular project

“Flex Data Services” (now renamed to “Live Cycle Data Services”)

Flex Data Services seemed too “client-centric”

Due to the limited capabilities of the ActionScript 3 reflection API than cannot access private fields, it is necessary to create an externalizable AS3 class (implementing flash.utils.IExternalizable and its corresponding externalizable Java class

In both classes you have to implement two methods

the Gas3 generator can automatically generate the writeExternal and readExternal methods.

With GraniteDS automated externalization and without any modification made to our bean, we may serialize all properties of the Person class, private or not

In order to externalize the Person.java entity bean, we must tell GraniteDS which classes we want to externalize with a

externalize all classes named com.myapp.entity.Person by using the org.granite.hibernate.HibernateExternalizer

you could use this declaration, but note that type in the example above is replaced by

            <include annotated-with="javax.persistence.Entity"/>             <include annotated-with="javax.persistence.MappedSuperclass"/>             <include annotated-with="javax.persistence.Embeddable"/>

: type

annotated-with

Instead of configuring externalizers with the above method, you may use the

feature:

precedence rules for these three configuration options:

Maven 3 is highly recommended but Maven 2.2 should also work

CDI archetype defines an embedded GlassFish run configuration

mvn embedded-glassfish:run

Class as parameter

serverside

Remote call using class as parameter

Does GraniteDS could manage date and TimeZone ?

Flash Player (GMT +X) -> IExternizable methods (GMT + X - X = GMT + 0) - > AMF over HTTP (GMT + 0) -> Granite AMF0Deserializer (GMT + 0) -> Granite Converter (GMT + 0 + Y = GMT + Y) -> Java Services (GMT + Y)Java Services (GMT + Y) -> Granite Converter (GMT + Y - Y = GMT + 0) -> Granite AMF0Deserializer (GMT + 0) -> AMF over HTTP (GMT + 0) -> IExternizable methods (GMT + 0 + X = GMT + X) -> Flash Player (GMT + X)

We use

for AMF for convention

define a

for your AMF that is over HTTP

: timezone for your flex client

: timezone for your server

don't want to modify the default templates

GraniteDS also integrates with container security for authentication and role-based authorization

granite-cdi.jar

JBoss 6 and GlassFish v3