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

Revision as of 11:37, 15 March 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
   Generic EclipseLink info (i.e., non-MOXy) will be used to create a separate "Welcome to EclispeLink" guide.
   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
   2. Bootstrapping - B
      in progress
      1. From a Single Project
      2. From Multiple Projects
      3. Generating Schema
   3. Dynamic JAXB Bootstrapping - B
      in progress
      1. Specifying the EclipseLink Runtime
      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
      need info
   5. Converting XML to Objects (Unmarshalling)
      in progress
      1. Sources (DOM, SAX, StAX, Streams)
      2. Validating Against an XML Schema
      3. Events
      4. Handling Unmapped Content
   6. Convert Objects to XML (Marshalling)
      need info
      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
   2. Setting Up Namespace Information
   3. Creating Objects (Constructors & Factories)
   4. Handling Inheritance (need info)
      1. http://bdoughan.blogspot.com/2010/11/jaxb-and-inheritance-using-xsitype.html
      2. http://bdoughan.blogspot.com/2010/11/jaxb-and-inheritance-using-substitution.html
      3. http://bdoughan.blogspot.com/2010/11/jaxb-and-inheritance-moxy-extension.html
4. Simple Values - A
   1. Single Values - A
      1. Mapping Simple Values
   2. Colections -A
      1. Mappng Collections of Simple Values
   3. Enums Review
   4. Special Schema Types
      1. Date and Time Types (more info)
         1. http://bdoughan.blogspot.com/2011/01/jaxb-and-datetime-properties.html
      2. Binary Types
      3. Leveraging xsi:type
      4. Unions
5. Relationships -A 
   1. Privately Owned - A
      1. Mapping One-to-One Relationships - A 
      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
            Review
         3. Embedded Key Class -A
            in progress
      2. Many-to-One – XMLObjectReferenceMapping -A
         need info
      3. Many-to-Many – XMLCollectionReferenceMapping - A
         need info
   3. Collections and Maps
      in progress
   4. Bidirectional Relationships
      in progress
      1. http://bdoughan.blogspot.com/2010/07/jpa-entities-to-xml-bidirectional.html
      2. XMLInverseMapping
6. Advanced XML Schema Concepts - B
   1. Handling Null Values
      Review
   2. Substitution Groups and Choices
      Need info
      1. XMLChoiceObjectMapping
      2. XMLChoiceCollectionMapping
   3. Wildcard Content
      Need info
      1. XMLAnyAttributeMapping
      2. XMLAnyObjectMapping
      3. XMLAnyCollectionMapping
7. Mapping the Unmappable
   1. Converters
   2. Transformation Mapping
   3. XMLFragmentMapping
   4. XMLFragmentCollectionMapping
8. Customizing Schemas
   Need info
9. Generating Java Classes from an XML Schema
   Review
10. Mapping JPA Entities to XML
    Need info
    1. Properties
    2. Bidirectional Relationships
    3. Keys and Foreign Keys
11. Web Services
    Need info
    1. Attachments
       1. XMLBinaryDataMapping
       2. XMLBinaryDataCollectionMapping
12. Using Eclipselink with Spring
    Need info