src/share/jaxws_classes/javax/xml/bind/DatatypeConverterInterface.java

Print this page
rev 507 : 8047724: @since tag cleanup in jaxws
Reviewed-by:


  61  * or a subclass of IllegalArgumentException must be thrown by the method.
  62  *
  63  * </p>
  64  *
  65  * <p>
  66  * A print method for a XML schema datatype can output any lexical
  67  * representation that is valid with respect to the XML schema datatype.
  68  * If an error is encountered during conversion, then an IllegalArgumentException,
  69  * or a subclass of IllegalArgumentException must be thrown by the method.
  70  * </p>
  71  *
  72  * The prefix xsd: is used to refer to XML schema datatypes
  73  * <a href="http://www.w3.org/TR/xmlschema-2/"> XML Schema Part2: Datatypes
  74  * specification.</a>
  75  *
  76  * <p>
  77  * @author <ul><li>Sekhar Vajjhala, Sun Microsystems, Inc.</li><li>Joe Fialli, Sun Microsystems Inc.</li><li>Kohsuke Kawaguchi, Sun Microsystems, Inc.</li><li>Ryan Shoemaker,Sun Microsystems Inc.</li></ul>
  78  * @see DatatypeConverter
  79  * @see ParseConversionEvent
  80  * @see PrintConversionEvent
  81  * @since JAXB1.0
  82  */
  83 
  84 public interface DatatypeConverterInterface {
  85     /**
  86      * <p>
  87      * Convert the string argument into a string.
  88      * @param lexicalXSDString
  89      *     A lexical representation of the XML Schema datatype xsd:string
  90      * @return
  91      *     A string that is the same as the input string.
  92      */
  93     public String parseString( String lexicalXSDString );
  94 
  95     /**
  96      * <p>
  97      * Convert the string argument into a BigInteger value.
  98      * @param lexicalXSDInteger
  99      *     A string containing a lexical representation of
 100      *     xsd:integer.
 101      * @return




  61  * or a subclass of IllegalArgumentException must be thrown by the method.
  62  *
  63  * </p>
  64  *
  65  * <p>
  66  * A print method for a XML schema datatype can output any lexical
  67  * representation that is valid with respect to the XML schema datatype.
  68  * If an error is encountered during conversion, then an IllegalArgumentException,
  69  * or a subclass of IllegalArgumentException must be thrown by the method.
  70  * </p>
  71  *
  72  * The prefix xsd: is used to refer to XML schema datatypes
  73  * <a href="http://www.w3.org/TR/xmlschema-2/"> XML Schema Part2: Datatypes
  74  * specification.</a>
  75  *
  76  * <p>
  77  * @author <ul><li>Sekhar Vajjhala, Sun Microsystems, Inc.</li><li>Joe Fialli, Sun Microsystems Inc.</li><li>Kohsuke Kawaguchi, Sun Microsystems, Inc.</li><li>Ryan Shoemaker,Sun Microsystems Inc.</li></ul>
  78  * @see DatatypeConverter
  79  * @see ParseConversionEvent
  80  * @see PrintConversionEvent
  81  * @since 1.6, JAXB 1.0
  82  */
  83 
  84 public interface DatatypeConverterInterface {
  85     /**
  86      * <p>
  87      * Convert the string argument into a string.
  88      * @param lexicalXSDString
  89      *     A lexical representation of the XML Schema datatype xsd:string
  90      * @return
  91      *     A string that is the same as the input string.
  92      */
  93     public String parseString( String lexicalXSDString );
  94 
  95     /**
  96      * <p>
  97      * Convert the string argument into a BigInteger value.
  98      * @param lexicalXSDInteger
  99      *     A string containing a lexical representation of
 100      *     xsd:integer.
 101      * @return