Documentation - 1.0

 Documentation Summary

 API Documentation

Stable (production ready)

• AMF3 (de)serialization (with RemoteObject),
• Ejb3 services (session beans),
• Ejb3 persistence (Hibernate) with lazy-loading support,
• Spring services with Acegi security,
• Pojo services.

Experimental (beta)

• Data push (Gravity),
• Seam services,
• Guice/Warp services.
   

Version 1.0.1_GA

Improvement

• GDS-86 - Add support for the <legacy-xml> channel option
• GDS-88 - Add support for the <legacy-collection> channel option

Bug

• GDS-87 - ArrayCollections may be empty after deserialization when they need to be converted to special collection types

Version 1.0.0_GA

Improvement

• GDS-79 - Use org.jboss.seam.security.Identity in SeamSecurityService
• GDS-80 - ServiceExceptionHandler should handle NoSuchMethodException

Bug

• GDS-81 - DefaultExternalizer does not serialize correctly Map instances
• GDS-82 - Gas3 generation in different directory (with translators) fail to map to correct java class.
• GDS-83 - Gas3 does not provide a way to load a custom enum template
• GDS-84 - HibernateExternalizer not resolving initialised Hibernate proxies

Version 1.0.0_RC2

New Feature

• GDS-70 - Add Guice/Warp support & sample application.

Improvement

• GDS-72 - AcegiSecurityService lookup of AuthenticationManager
• GDS-77 - Move SecureRemoteObject.as from sample app to core GDS
• GDS-78 - Add version informations in all Granite Jar/Swc.

Bug

• GDS-71 - Gas3 does not generate correct code lazy-loaded entity beans with inheritance
• GDS-73 - EnumExternalizer should use name() instead of toString() in writeExternal(...)
• GDS-75 - Ensure Flex3 beta3 compatibility (especially for Gravity)

Task

• GDS-74 - Add separated source folder for Spring & build a granite-spring.jar library.
• GDS-76 - Rename granite jars with a '-' separator instead of a '.' (eg: granite.hibernate.jar -> granite-hibernate.jar)

Version 1.0.0_RC1

New Feature

• GDS-60 - Implement a Data Push feature for both Tomcat and Jetty containers
• GDS-68 - Add Spring/Acegi security in core GDS
• GDS-69 - Seam Integration

Improvement

• GDS-40 - GAS3 should generate code for enum types
• GDS-43 - Pojo services should support "*" source property in destination configuration
• GDS-55 - Should not require Eclipse (build files)
• GDS-62 - Update to Groovy 1.5 (Gas3 performances)
• GDS-66 - Add the possibility to change Gas3 target package

Bug

• GDS-32 - Exception: ArrayCollection<Number> to be cast to List<Long>
• GDS-41 - Other classes not serializable preventing proper session clustering for pojo service
• GDS-51 - Gas3 Generator fails with MappedSuperclass without Id
• GDS-52 - org.hibernate.LazyInitializationException occur when Entity with Lazy objects where log level is debug. Returns faultCode = "Server.Acknowledge.Failed"
• GDS-57 - Incomplete setHeader implementation of AbstractMessage class
• GDS-61 - DATA_XML deserialization in AMF0 message is broken.
• GDS-63 - Complex Lazy relations are not correctly encoded in AMF3Serializer or decoded in as.
• GDS-64 - Build generates non Java 5.0 compatible jars.
• GDS-65 - Ant cannot Instantiate Java2As3 class.

1. Project Overview

• 1.1. What is Granite Data Services
• 1.2. Why this Project
• 1.3. Who We Are

2. Developer Guide

• 2.1. Installation
  • 2.1.1. Using Flex Builder 3
• 2.2. RemoteObject and AMF3 Format
• 2.3. EJB3 Services
• 2.4. Configurable Options
  • 2.4.1. Externalizers
  • 2.4.2. Lazy Initialization
  • 2.4.3. Instanciators
  • 2.4.4. Miscanellous
• 2.5. Gas3 Code Generator
• 2.6. Spring Services
• 2.7. Seam Services
• 2.8. Guice Services
• 2.9. Pojo Services
• 2.10. Data Push (Gravity)
• 2.11. Security
• 2.12. Logging

3. Appendix

• 3.1. Granite Config DTD