Bugzilla – Full Text Bug Listing
| Summary: | Validation, defaults, and content assist support for JAXB 2.2 object factories | ||
|---|---|---|---|
| Product: | [WebTools] Dali JPA Tools | Reporter: | Paul Fullbright <paul.fullbright> |
| Component: | JAXB | Assignee: | Paul Fullbright <paul.fullbright> |
| Status: | RESOLVED FIXED | QA Contact: | |
| Severity: | enhancement | ||
| Priority: | P3 | CC: | neil.hauge |
| Version: | 3.0 | Keywords: | plan |
| Target Milestone: | 3.2 M6 | ||
| Hardware: | PC | ||
| OS: | Windows Vista | ||
| Whiteboard: | EclipseLink | ||
|
Description
Paul Fullbright
This should address support for the following annotations:
* @XmlRegistry
* @XmlElementDecl
as well as general support for the types of factory methods that are a part of an object factory.
@XmlRegistry and @XmlElementDecl are "... intended primarily for use by schema
compiler in annotating element factory methods in the schema derived ObjectFactory class ... They are not expected to be used when mapping existing classes to schema." (sec. 8.10)
As such, there is less validation than might be expected for such a construct. It is mostly value add for classes generated from a schema.
@XmlRegistry
- There should only be one per JAXB package
(and that's pretty much it)
@XmlElementDecl
- annotation can only be used on an element factory method (Section 5.2, “Java Package”). The annotation creates a mapping between an XML schema element declaration and a element factory method that returns a JAXBElement instance representing the element declaration. Typically, the element factory method is generated (and annotated) from a schema into the ObjectFactory class in a Java package that represents the binding of the element declaration's target namespace. Thus, while the annotation syntax allows @XmlElementDecl to be
used on any method, semantically its use is restricted to annotation of element factory method. [ Not sure how this can be handled with our framework - we only would recognize the annotation only when it is used within a class already annotated with @XmlRegistry. Instead we'd validate that the method annotated within the object factory fits the profile of a factory method. ]
- class containing the element factory method annotated with @XmlElementDecl must be annotated with @XmlRegistry. [ See above comment. ]
- element factory method must take one parameter assignable to java.lang.Object.
- two or more element factory methods annotated with @XmlElementDecl must not map to element declarations with identical {name} {target namespace} values.
- if type Foo has an element factory method and is also annotated with @XmlRootElement, then they must not map to element declarations with identical {name} and {target namespace} values.
Most of this was committed for 3.1. All of this complete by 3.2 M7. |