--- old/src/java.xml.bind/share/classes/javax/xml/bind/DatatypeConverterInterface.java 2015-04-21 17:20:12.124098479 +0400 +++ new/src/java.xml.bind/share/classes/javax/xml/bind/DatatypeConverterInterface.java 2015-04-21 17:20:12.020098479 +0400 @@ -38,19 +38,16 @@ * functionality. Calling this api repeatedly will have no effect - the * DatatypeConverter instance passed into the first invocation is the one that * will be used from then on. - *

* *

* This interface defines the parse and print methods. There is one * parse and print method for each XML schema datatype specified in the * the default binding Table 5-1 in the JAXB specification. - *

* *

* The parse and print methods defined here are invoked by the static parse * and print methods defined in the {@link DatatypeConverter DatatypeConverter} * class. - *

* *

* A parse method for a XML schema datatype must be capable of converting any @@ -60,21 +57,23 @@ * If an error is encountered during conversion, then an IllegalArgumentException * or a subclass of IllegalArgumentException must be thrown by the method. * - *

- * *

* A print method for a XML schema datatype can output any lexical * representation that is valid with respect to the XML schema datatype. * If an error is encountered during conversion, then an IllegalArgumentException, * or a subclass of IllegalArgumentException must be thrown by the method. - *

* + *

* The prefix xsd: is used to refer to XML schema datatypes * XML Schema Part2: Datatypes * specification. * - *

- * @author

+ * @author * @see DatatypeConverter * @see ParseConversionEvent * @see PrintConversionEvent @@ -83,7 +82,6 @@ public interface DatatypeConverterInterface { /** - *

* Convert the string argument into a string. * @param lexicalXSDString * A lexical representation of the XML Schema datatype xsd:string @@ -93,91 +91,83 @@ public String parseString( String lexicalXSDString ); /** - *

* Convert the string argument into a BigInteger value. * @param lexicalXSDInteger * A string containing a lexical representation of * xsd:integer. * @return * A BigInteger value represented by the string argument. - * @throws NumberFormatException lexicalXSDInteger is not a valid string representation of a {@link java.math.BigInteger} value. + * @throws NumberFormatException {@code lexicalXSDInteger} is not a valid string representation of a {@link java.math.BigInteger} value. */ public java.math.BigInteger parseInteger( String lexicalXSDInteger ); /** - *

* Convert the string argument into an int value. * @param lexicalXSDInt * A string containing a lexical representation of * xsd:int. * @return * An int value represented byte the string argument. - * @throws NumberFormatException lexicalXSDInt is not a valid string representation of an int value. + * @throws NumberFormatException {@code lexicalXSDInt} is not a valid string representation of an {@code int} value. */ public int parseInt( String lexicalXSDInt ); /** - *

* Converts the string argument into a long value. * @param lexicalXSDLong * A string containing lexical representation of * xsd:long. * @return * A long value represented by the string argument. - * @throws NumberFormatException lexicalXSDLong is not a valid string representation of a long value. + * @throws NumberFormatException {@code lexicalXSDLong} is not a valid string representation of a {@code long} value. */ public long parseLong( String lexicalXSDLong ); /** - *

* Converts the string argument into a short value. * @param lexicalXSDShort * A string containing lexical representation of * xsd:short. * @return * A short value represented by the string argument. - * @throws NumberFormatException lexicalXSDShort is not a valid string representation of a short value. + * @throws NumberFormatException {@code lexicalXSDShort} is not a valid string representation of a {@code short} value. */ public short parseShort( String lexicalXSDShort ); /** - *

* Converts the string argument into a BigDecimal value. * @param lexicalXSDDecimal * A string containing lexical representation of * xsd:decimal. * @return * A BigDecimal value represented by the string argument. - * @throws NumberFormatException lexicalXSDDecimal is not a valid string representation of {@link java.math.BigDecimal}. + * @throws NumberFormatException {@code lexicalXSDDecimal} is not a valid string representation of {@link java.math.BigDecimal}. */ public java.math.BigDecimal parseDecimal( String lexicalXSDDecimal ); /** - *

* Converts the string argument into a float value. * @param lexicalXSDFloat * A string containing lexical representation of * xsd:float. * @return * A float value represented by the string argument. - * @throws NumberFormatException lexicalXSDFloat is not a valid string representation of a float value. + * @throws NumberFormatException {@code lexicalXSDFloat} is not a valid string representation of a {@code float} value. */ public float parseFloat( String lexicalXSDFloat ); /** - *

* Converts the string argument into a double value. * @param lexicalXSDDouble * A string containing lexical representation of * xsd:double. * @return * A double value represented by the string argument. - * @throws NumberFormatException lexicalXSDDouble is not a valid string representation of a double value. + * @throws NumberFormatException {@code lexicalXSDDouble} is not a valid string representation of a {@code double} value. */ public double parseDouble( String lexicalXSDDouble ); /** - *

* Converts the string argument into a boolean value. * @param lexicalXSDBoolean * A string containing lexical representation of @@ -189,20 +179,18 @@ public boolean parseBoolean( String lexicalXSDBoolean ); /** - *

* Converts the string argument into a byte value. * @param lexicalXSDByte * A string containing lexical representation of * xsd:byte. * @return * A byte value represented by the string argument. - * @throws NumberFormatException lexicalXSDByte does not contain a parseable byte. + * @throws NumberFormatException {@code lexicalXSDByte} does not contain a parseable byte. * @throws IllegalArgumentException if string parameter does not conform to lexical value space defined in XML Schema Part 2: Datatypes for xsd:byte. */ public byte parseByte( String lexicalXSDByte ); /** - *

* Converts the string argument into a QName value. * *

@@ -222,7 +210,6 @@ javax.xml.namespace.NamespaceContext nsc); /** - *

* Converts the string argument into a Calendar value. * @param lexicalXSDDateTime * A string containing lexical representation of @@ -234,7 +221,6 @@ public java.util.Calendar parseDateTime( String lexicalXSDDateTime ); /** - *

* Converts the string argument into an array of bytes. * @param lexicalXSDBase64Binary * A string containing lexical representation @@ -246,7 +232,6 @@ public byte[] parseBase64Binary( String lexicalXSDBase64Binary ); /** - *

* Converts the string argument into an array of bytes. * @param lexicalXSDHexBinary * A string containing lexical representation of @@ -258,7 +243,6 @@ public byte[] parseHexBinary( String lexicalXSDHexBinary ); /** - *

* Converts the string argument into a long value. * @param lexicalXSDUnsignedInt * A string containing lexical representation @@ -270,7 +254,6 @@ public long parseUnsignedInt( String lexicalXSDUnsignedInt ); /** - *

* Converts the string argument into an int value. * @param lexicalXSDUnsignedShort * A string containing lexical @@ -282,7 +265,6 @@ public int parseUnsignedShort( String lexicalXSDUnsignedShort ); /** - *

* Converts the string argument into a Calendar value. * @param lexicalXSDTime * A string containing lexical representation of @@ -294,7 +276,6 @@ public java.util.Calendar parseTime( String lexicalXSDTime ); /** - *

* Converts the string argument into a Calendar value. * @param lexicalXSDDate * A string containing lexical representation of @@ -306,7 +287,6 @@ public java.util.Calendar parseDate( String lexicalXSDDate ); /** - *

* Return a string containing the lexical representation of the * simple type. * @param lexicalXSDAnySimpleType @@ -319,7 +299,6 @@ public String parseAnySimpleType( String lexicalXSDAnySimpleType ); /** - *

* Converts the string argument into a string. * @param val * A string value. @@ -329,7 +308,6 @@ public String printString( String val ); /** - *

* Converts a BigInteger value into a string. * @param val * A BigInteger value @@ -340,7 +318,6 @@ public String printInteger( java.math.BigInteger val ); /** - *

* Converts an int value into a string. * @param val * An int value @@ -351,7 +328,6 @@ /** - *

* Converts a long value into a string. * @param val * A long value @@ -361,7 +337,6 @@ public String printLong( long val ); /** - *

* Converts a short value into a string. * @param val * A short value @@ -371,7 +346,6 @@ public String printShort( short val ); /** - *

* Converts a BigDecimal value into a string. * @param val * A BigDecimal value @@ -382,7 +356,6 @@ public String printDecimal( java.math.BigDecimal val ); /** - *

* Converts a float value into a string. * @param val * A float value @@ -392,7 +365,6 @@ public String printFloat( float val ); /** - *

* Converts a double value into a string. * @param val * A double value @@ -402,7 +374,6 @@ public String printDouble( double val ); /** - *

* Converts a boolean value into a string. * @param val * A boolean value @@ -412,7 +383,6 @@ public String printBoolean( boolean val ); /** - *

* Converts a byte value into a string. * @param val * A byte value @@ -422,7 +392,6 @@ public String printByte( byte val ); /** - *

* Converts a QName instance into a string. * @param val * A QName value @@ -437,7 +406,6 @@ javax.xml.namespace.NamespaceContext nsc ); /** - *

* Converts a Calendar value into a string. * @param val * A Calendar value @@ -448,7 +416,6 @@ public String printDateTime( java.util.Calendar val ); /** - *

* Converts an array of bytes into a string. * @param val * an array of bytes @@ -459,7 +426,6 @@ public String printBase64Binary( byte[] val ); /** - *

* Converts an array of bytes into a string. * @param val * an array of bytes @@ -470,7 +436,6 @@ public String printHexBinary( byte[] val ); /** - *

* Converts a long value into a string. * @param val * A long value @@ -480,7 +445,6 @@ public String printUnsignedInt( long val ); /** - *

* Converts an int value into a string. * @param val * An int value @@ -490,7 +454,6 @@ public String printUnsignedShort( int val ); /** - *

* Converts a Calendar value into a string. * @param val * A Calendar value @@ -501,7 +464,6 @@ public String printTime( java.util.Calendar val ); /** - *

* Converts a Calendar value into a string. * @param val * A Calendar value @@ -512,7 +474,6 @@ public String printDate( java.util.Calendar val ); /** - *

* Converts a string value into a string. * @param val * A string value