jaxws/src/java.xml.bind/share/classes/javax/xml/bind/DatatypeConverterInterface.java
changeset 32795 5a5710ee05a0
parent 30005 b2f720a258c4
equal deleted inserted replaced
32712:f61a63b7d1e5 32795:5a5710ee05a0
   192 
   192 
   193     /**
   193     /**
   194      * Converts the string argument into a QName value.
   194      * Converts the string argument into a QName value.
   195      *
   195      *
   196      * <p>
   196      * <p>
   197      * String parameter <tt>lexicalXSDQname</tt> must conform to lexical value space specifed at
   197      * String parameter {@code lexicalXSDQname} must conform to lexical value space specifed at
   198      * <a href="http://www.w3.org/TR/xmlschema-2/#QName">XML Schema Part 2:Datatypes specification:QNames</a>
   198      * <a href="http://www.w3.org/TR/xmlschema-2/#QName">XML Schema Part 2:Datatypes specification:QNames</a>
   199      *
   199      *
   200      * @param lexicalXSDQName
   200      * @param lexicalXSDQName
   201      *     A string containing lexical representation of xsd:QName.
   201      *     A string containing lexical representation of xsd:QName.
   202      * @param nsc
   202      * @param nsc
   203      *     A namespace context for interpreting a prefix within a QName.
   203      *     A namespace context for interpreting a prefix within a QName.
   204      * @return
   204      * @return
   205      *     A QName value represented by the string argument.
   205      *     A QName value represented by the string argument.
   206      * @throws IllegalArgumentException  if string parameter does not conform to XML Schema Part 2 specification or
   206      * @throws IllegalArgumentException  if string parameter does not conform to XML Schema Part 2 specification or
   207      *      if namespace prefix of <tt>lexicalXSDQname</tt> is not bound to a URI in NamespaceContext <tt>nsc</tt>.
   207      *      if namespace prefix of {@code lexicalXSDQname} is not bound to a URI in NamespaceContext {@code nsc}.
   208      */
   208      */
   209     public javax.xml.namespace.QName parseQName( String lexicalXSDQName,
   209     public javax.xml.namespace.QName parseQName( String lexicalXSDQName,
   210                                              javax.xml.namespace.NamespaceContext nsc);
   210                                              javax.xml.namespace.NamespaceContext nsc);
   211 
   211 
   212     /**
   212     /**
   247      * @param lexicalXSDUnsignedInt
   247      * @param lexicalXSDUnsignedInt
   248      *     A string containing lexical representation
   248      *     A string containing lexical representation
   249      *     of xsd:unsignedInt.
   249      *     of xsd:unsignedInt.
   250      * @return
   250      * @return
   251      *     A long value represented by the string argument.
   251      *     A long value represented by the string argument.
   252      * @throws NumberFormatException if string parameter can not be parsed into a <tt>long</tt> value.
   252      * @throws NumberFormatException if string parameter can not be parsed into a {@code long} value.
   253      */
   253      */
   254     public long parseUnsignedInt( String lexicalXSDUnsignedInt );
   254     public long parseUnsignedInt( String lexicalXSDUnsignedInt );
   255 
   255 
   256     /**
   256     /**
   257      * Converts the string argument into an int value.
   257      * Converts the string argument into an int value.
   258      * @param lexicalXSDUnsignedShort
   258      * @param lexicalXSDUnsignedShort
   259      *     A string containing lexical
   259      *     A string containing lexical
   260      *     representation of xsd:unsignedShort.
   260      *     representation of xsd:unsignedShort.
   261      * @return
   261      * @return
   262      *     An int value represented by the string argument.
   262      *     An int value represented by the string argument.
   263      * @throws NumberFormatException if string parameter can not be parsed into an <tt>int</tt> value.
   263      * @throws NumberFormatException if string parameter can not be parsed into an {@code int} value.
   264      */
   264      */
   265     public int parseUnsignedShort( String lexicalXSDUnsignedShort );
   265     public int parseUnsignedShort( String lexicalXSDUnsignedShort );
   266 
   266 
   267     /**
   267     /**
   268      * Converts the string argument into a Calendar value.
   268      * Converts the string argument into a Calendar value.
   311      * Converts a BigInteger value into a string.
   311      * Converts a BigInteger value into a string.
   312      * @param val
   312      * @param val
   313      *     A BigInteger value
   313      *     A BigInteger value
   314      * @return
   314      * @return
   315      *     A string containing a lexical representation of xsd:integer
   315      *     A string containing a lexical representation of xsd:integer
   316      * @throws IllegalArgumentException <tt>val</tt> is null.
   316      * @throws IllegalArgumentException {@code val} is null.
   317      */
   317      */
   318     public String printInteger( java.math.BigInteger val );
   318     public String printInteger( java.math.BigInteger val );
   319 
   319 
   320     /**
   320     /**
   321      * Converts an int value into a string.
   321      * Converts an int value into a string.
   349      * Converts a BigDecimal value into a string.
   349      * Converts a BigDecimal value into a string.
   350      * @param val
   350      * @param val
   351      *     A BigDecimal value
   351      *     A BigDecimal value
   352      * @return
   352      * @return
   353      *     A string containing a lexical representation of xsd:decimal
   353      *     A string containing a lexical representation of xsd:decimal
   354      * @throws IllegalArgumentException <tt>val</tt> is null.
   354      * @throws IllegalArgumentException {@code val} is null.
   355      */
   355      */
   356     public String printDecimal( java.math.BigDecimal val );
   356     public String printDecimal( java.math.BigDecimal val );
   357 
   357 
   358     /**
   358     /**
   359      * Converts a float value into a string.
   359      * Converts a float value into a string.
   397      *     A QName value
   397      *     A QName value
   398      * @param nsc
   398      * @param nsc
   399      *     A namespace context for interpreting a prefix within a QName.
   399      *     A namespace context for interpreting a prefix within a QName.
   400      * @return
   400      * @return
   401      *     A string containing a lexical representation of QName
   401      *     A string containing a lexical representation of QName
   402      * @throws IllegalArgumentException if <tt>val</tt> is null or
   402      * @throws IllegalArgumentException if {@code val} is null or
   403      * if <tt>nsc</tt> is non-null or <tt>nsc.getPrefix(nsprefixFromVal)</tt> is null.
   403      * if {@code nsc} is non-null or {@code nsc.getPrefix(nsprefixFromVal)} is null.
   404      */
   404      */
   405     public String printQName( javax.xml.namespace.QName val,
   405     public String printQName( javax.xml.namespace.QName val,
   406                               javax.xml.namespace.NamespaceContext nsc );
   406                               javax.xml.namespace.NamespaceContext nsc );
   407 
   407 
   408     /**
   408     /**
   409      * Converts a Calendar value into a string.
   409      * Converts a Calendar value into a string.
   410      * @param val
   410      * @param val
   411      *     A Calendar value
   411      *     A Calendar value
   412      * @return
   412      * @return
   413      *     A string containing a lexical representation of xsd:dateTime
   413      *     A string containing a lexical representation of xsd:dateTime
   414      * @throws IllegalArgumentException if <tt>val</tt> is null.
   414      * @throws IllegalArgumentException if {@code val} is null.
   415      */
   415      */
   416     public String printDateTime( java.util.Calendar val );
   416     public String printDateTime( java.util.Calendar val );
   417 
   417 
   418     /**
   418     /**
   419      * Converts an array of bytes into a string.
   419      * Converts an array of bytes into a string.
   420      * @param val
   420      * @param val
   421      *     an array of bytes
   421      *     an array of bytes
   422      * @return
   422      * @return
   423      *     A string containing a lexical representation of xsd:base64Binary
   423      *     A string containing a lexical representation of xsd:base64Binary
   424      * @throws IllegalArgumentException if <tt>val</tt> is null.
   424      * @throws IllegalArgumentException if {@code val} is null.
   425      */
   425      */
   426     public String printBase64Binary( byte[] val );
   426     public String printBase64Binary( byte[] val );
   427 
   427 
   428     /**
   428     /**
   429      * Converts an array of bytes into a string.
   429      * Converts an array of bytes into a string.
   430      * @param val
   430      * @param val
   431      *     an array of bytes
   431      *     an array of bytes
   432      * @return
   432      * @return
   433      *     A string containing a lexical representation of xsd:hexBinary
   433      *     A string containing a lexical representation of xsd:hexBinary
   434      * @throws IllegalArgumentException if <tt>val</tt> is null.
   434      * @throws IllegalArgumentException if {@code val} is null.
   435      */
   435      */
   436     public String printHexBinary( byte[] val );
   436     public String printHexBinary( byte[] val );
   437 
   437 
   438     /**
   438     /**
   439      * Converts a long value into a string.
   439      * Converts a long value into a string.
   457      * Converts a Calendar value into a string.
   457      * Converts a Calendar value into a string.
   458      * @param val
   458      * @param val
   459      *     A Calendar value
   459      *     A Calendar value
   460      * @return
   460      * @return
   461      *     A string containing a lexical representation of xsd:time
   461      *     A string containing a lexical representation of xsd:time
   462      * @throws IllegalArgumentException if <tt>val</tt> is null.
   462      * @throws IllegalArgumentException if {@code val} is null.
   463      */
   463      */
   464     public String printTime( java.util.Calendar val );
   464     public String printTime( java.util.Calendar val );
   465 
   465 
   466     /**
   466     /**
   467      * Converts a Calendar value into a string.
   467      * Converts a Calendar value into a string.
   468      * @param val
   468      * @param val
   469      *     A Calendar value
   469      *     A Calendar value
   470      * @return
   470      * @return
   471      *     A string containing a lexical representation of xsd:date
   471      *     A string containing a lexical representation of xsd:date
   472      * @throws IllegalArgumentException if <tt>val</tt> is null.
   472      * @throws IllegalArgumentException if {@code val} is null.
   473      */
   473      */
   474     public String printDate( java.util.Calendar val );
   474     public String printDate( java.util.Calendar val );
   475 
   475 
   476     /**
   476     /**
   477      * Converts a string value into a string.
   477      * Converts a string value into a string.