JAXB Release Documentation JAXB Release Documentation Table of Contents
Total Page:16
File Type:pdf, Size:1020Kb
JAXB Release Documentation JAXB Release Documentation Table of Contents Overview .......................................................................................................................... 1 1. Documentation ....................................................................................................... 1 2. Software Licenses ................................................................................................... 1 3. Sample Apps .......................................................................................................... 2 3.1. Using the Runtime Binding Framework ............................................................ 2 Release Notes .................................................................................................................... 6 1. Java™ 2 Platform, Standard Edition (J2SE™) Requirements .......................................... 7 2. Identifying the JAR Files ......................................................................................... 7 3. Locating the Normative Binding Schema .................................................................... 7 4. Changelog ............................................................................................................. 7 4.1. Changes between 2.3.0.1 and 2.4.0 .................................................................. 7 4.2. Changes between 2.3.0 and 2.3.0.1 .................................................................. 7 4.3. Changes between 2.2.11 and 2.3.0 ................................................................... 8 4.4. Changes between 2.2.10 to 2.2.11 ................................................................... 8 4.5. Changes between 2.2.9 to 2.2.10 ..................................................................... 8 4.6. Changes between 2.2.8 to 2.2.9 ....................................................................... 9 4.7. Changes between 2.2.7 to 2.2.8 ....................................................................... 9 4.8. Changes between 2.2.6 to 2.2.7 ..................................................................... 10 4.9. Changes between 2.2.5-2 to 2.2.6 .................................................................. 11 4.10. Changes between 2.2.5-1 to 2.2.5-2 .............................................................. 11 4.11. Changes between 2.2.5 to 2.2.5-1 ................................................................. 11 4.12. Changes between 2.2.4-1 to 2.2.5 ................................................................. 11 4.13. Changes between 2.2.4 to 2.2.4-1 ................................................................. 13 4.14. Changes between 2.2.3u2 to 2.2.4 ................................................................ 13 4.15. Notable Changes between 2.2.3u1 to 2.2.3u2 .................................................. 14 4.16. Notable Changes between 2.2.3 to 2.2.3u1 ..................................................... 15 4.17. Notable Changes between 2.2.2 to 2.2.3 ........................................................ 15 4.18. Notable Changes between 2.2.1.1 to 2.2.2 ...................................................... 15 4.19. Notable Changes between 2.2.1 to 2.2.1.1 ...................................................... 15 4.20. Notable Changes between 2.2 to 2.2.1 ........................................................... 15 4.21. Notable Changes between 2.1.12 to 2.2 ......................................................... 15 4.22. Notable Changes between 2.1.12 to 2.1.13 ..................................................... 15 4.23. Notable Changes between 2.1.11 to 2.1.12 ..................................................... 15 4.24. Notable Changes between 2.1.10 to 2.1.11 ..................................................... 16 4.25. Notable Changes between 2.1.9 to 2.1.10 ....................................................... 16 4.26. Notable Changes between 2.1.8 to 2.1.9 ........................................................ 16 4.27. Notable Changes between 2.1.7 to 2.1.8 ........................................................ 16 4.28. Notable Changes between 2.1.6 to 2.1.7 ........................................................ 16 4.29. Notable Changes between 2.1.5 to 2.1.6 ........................................................ 16 4.30. Notable Changes between 2.1.4 to 2.1.5 ........................................................ 16 4.31. Notable Changes between 2.1.3 to 2.1.4 ........................................................ 16 4.32. Notable Changes between 2.1.2 to 2.1.3 ........................................................ 16 4.33. Notable Changes between 2.1.1 to 2.1.2 ........................................................ 17 4.34. Notable Changes between 2.1 First Customer Ship (FCS) to 2.1.1 ....................... 17 4.35. Notable Changes between 2.1 Early Access 2 to 2.1 First Customer Ship (FCS) ..... 17 4.36. Notable Changes between 2.0.2 to 2.0.3 ........................................................ 17 4.37. Notable Changes between 2.0.1 to 2.0.2 ........................................................ 17 4.38. Notable Changes between 2.0 to 2.0.1 ........................................................... 17 4.39. Notable Changes between 2.0 Early Access 3 and 2.0 First Customer Ship (FCS) ....................................................................................................................... 18 4.40. Notable Changes between 2.0 Early Access 2 and 2.0 Early Access 3 .................. 18 iii JAXB Release Documentation 4.41. Notable Changes between 2.0 Early Access and 2.0 Early Access 2 ..................... 19 4.42. Notable Changes between 1.0.x FCS and 2.0 Early Access ................................ 20 JAXB Users Guide ........................................................................................................... 21 1. Compiling XML Schema ........................................................................................ 22 1.1. Dealing with errors ..................................................................................... 22 1.2. Fixing broken references in schema ................................................................ 24 1.3. Mapping of <xs:any /> ........................................................................... 26 1.4. Mapping of <xs:element /> to JAXBElement ........................................... 28 1.5. How modularization of schema interacts with XJC ............................................ 28 1.6. Adding behaviors ........................................................................................ 28 1.7. Avoid strong databinding ............................................................................. 30 1.8. Working with generated code in memory ........................................................ 32 2. Customization of Schema Compilation ...................................................................... 32 2.1. Customizing Java packages .......................................................................... 32 2.2. Using SCD for customizations ...................................................................... 33 2.3. Using different datatypes .............................................................................. 34 3. Annotating Your Classes ........................................................................................ 35 3.1. Mapping your favorite class .......................................................................... 35 3.2. Mapping interfaces ...................................................................................... 37 3.3. Evolving annotated classes ........................................................................... 42 3.4. XML layout and in-memory data layout .......................................................... 44 3.5. Mapping cyclic references to XML ................................................................ 46 4. Unmarshalling ...................................................................................................... 48 4.1. @XmlRootElement and unmarshalling ........................................................ 48 4.2. Unmarshalling is not working! Help! .............................................................. 49 4.3. Element default values and unmarshalling ....................................................... 50 4.4. Dealing with large documents ....................................................................... 51 5. Marshalling .......................................................................................................... 52 5.1. Changing prefixes ....................................................................................... 52 5.2. Element default values and marshalling .......................................................... 52 5.3. Different ways of marshalling ....................................................................... 53 5.4. Interaction between marshalling and DOM ...................................................... 56 6. Schema Generation ................................................................................................ 57 6.1. Invoking schemagen programatically .............................................................. 57 6.2. Generating Schema that you want .................................................................. 58 7. Deployment .......................................................................................................... 58 7.1. Using JAXB with Maven ............................................................................