Difference between revisions of "EclipseLink/Development/Documentation/MOXy"

Revision as of 10:37, 6 January 2011

EclipseLink MOXy User's Guide (under development)

Table of Contents

The following is the proposed TOC which is currently under development. Where applicable, show where existing ELUG wiki pages can be mined for initial content.

1. Overview
   1. About EclipseLink
      Review
   2. JAXB Overview
      Review
   3. Metadata
   4. Annotations
   5. Static vs. Dynamic MOXy
      Review
2. Runtime
   Review
   1. Specifying the EclipseLink Runtime - B
      Review
   2. Bootstrapping - B
      1. From a Single Project
      2. From Multiple Projects
      3. Generating Schema
   3. Dynamic JAXB Bootstrapping - B
      1. Specifying the EclipseLink Runtime
         Review
      2. From an XML Schema
         Review
      3. From a Single Project
         1. From OXM using DynamicEntities
         2. From sessions.xml using DynamicEntities
      4. From Multiple Projects
         1. From OXM using DynamicEntities
         2. From sessions.xml using DynamicEntities
   4. Querying Objects by XPath
   5. Converting XML to Objects (Unmarshalling)
      1. Sources (DOM, SAX, StAX, Streams)
      2. Validating Against an XML Schema
      3. Events
      4. Handling Unmapped Content
   6. Convert Objects to XML (Marshalling)
      1. Targets (DOM, SAX, StAX, Streams)
      2. Properties (Formatting & Encoding)
      3. Events
   7. Binding to an Existing Document
      Review
      
3. Type Level - A
   1. Mapping to a Type or Element - A
      1. Default Root Element -
         Review
   2. Setting Up Namespace Information -A
      Review
   3. Creating Objects (Constructors & Factories)
   4. Handling Inheritance
4. Simple Values - A
   1. Single Values - A
      1. Mapping simple values - A
         Approved
   2. Colections -A
      1. Mappng collections of simple values -A
         Approved
   3. Enums
   4. Special Schema Types
      1. Date and Time Types
      2. Binary Types
      3. Leveraging xsi:type
      4. Unions
5. Relationships -A 
   1. Privately Owned - A
      1. One-to-One – XMLCompositeObjectMapping - A 
         Review
      2. One-to-Many – XMLCompositeCollectionMapping - A
         Review
   2. Shared Reference - A
      1. Keys and Foreign Keys - A
         1. Single Key- A
            Review
            
         2. Composite Key A
         3. Embedded Key Class -A
      2. Many-to-One – XMLObjectReferenceMapping -A
      3. Many-to-Many – XMLCollectionReferenceMapping - A
   3. Collections and Maps
   4. Bidirectional Relationships
      1. XMLInverseMapping
6. Advanced XML Schema Concepts - B
   1. Handling Null Values
   2. Substitution Groups and Choices
      1. XMLChoiceObjectMapping
      2. XMLChoiceCollectionMapping
   3. Wildcard Content
      1. XMLAnyAttributeMapping
      2. XMLAnyObjectMapping
      3. XMLAnyCollectionMapping
7. Mapping the Unmappable
   1. Converters
   2. Transformation Mapping
   3. XMLFragmentMapping
   4. XMLFragmentCollectionMapping
8. Customizing Schemas
9. Generating Java Classes from an XML Schema
   Review
10. Mapping JPA Entities to XML
    1. Properties
    2. Bidirectional Relationships
    3. Keys and Foreign Keys
11. Web Services
    1. Attachments
       1. XMLBinaryDataMapping
       2. XMLBinaryDataCollectionMapping
12. Using Eclipselink with Spring