XMLGregorianCalendar parsing enhancements

[glassfishrobot]

Submitted by David Bau, entered initially by Joe Fialli

Rather than having eight separate parsing functions, (for all of the g*, date,
dateTime
datatypes), there simply should be one parsing function that can accept all the
forms
(with any of the five subfields Y/M/D/time/timezone omitted); this is simple
to implement; it would be a simpler API; it is a nice solution for unions;
and validators could use a getXmlSchemaType() method to verify that the
proper form were loaded.

Environment

Operating System: All
Platform: All

Affected Versions

[2.0 draft]

[glassfishrobot]

Reported by @jfialli

[glassfishrobot]

@jfialli said:
Note: - dependency on resolution for issue 7, "parse methods should use
CharSequence, not String". If issue 7 resolved to use CharSequence,
these methods could have "String" changed to "CharSequence".

Change:
public static XMLGregorianCalendar fromDateType(String lexicalRep);
public static XMLGregorianCalendar fromDateTimeType(String lexicalRep);
public static XMLGregorianCalendar fromTimeType(String lexicalRep)
public static XMLGregorianCalendar fromGYearMonthType(String lexicalRep)
public static XMLGregorianCalendar fromGYearType(String lexicalRep)
public static XMLGregorianCalendar fromGMonthDayType(String lexicalRep)
public static XMLGregorianCalendar fromGDayType(String lexicalRep)
public static XMLGregorianCalendar fromGMonthType(String lexicalRep)
To:
/** parse as described in lexical representation sections for all XML Schema

• calendar datatypes dateTime, time, g* in XSD Part 2 specification,
• sections 3.2.[7.1-14.1]).
• IllegalArgument exception is thrown if lexicalRepresentation does not
• conform to the lexical formats decribed in
  */
  public static XMLGregorianCalendar parse(String lexicalRep)

---

While this issue did not discuss consolidating the toXXX() methods, it is
natural to consider if this symmetrical change should be made to the
"toXXX"() methods.

Change:
public String toDateType()
public String toDateTimeType()
public String toTimeType() {
public String toGYearMonthType()
public String toGYearType()
public String toGMonthDayType()
public String toGDayType()
public String toGMonthType()
To:
// format based on implied builtin XML Schema datatype.
// Compute datatype based on Calendar fields that are set.
public String toXmlFormat() // name inspired some by DateFormat.format.

[glassfishrobot]

This issue was imported from java.net JIRA JSR222-4