DatatypeConverterInterface (Java EE 5)

该 DatatypeConverterInterface 仅适用于 JAXB 提供者。JAXB 提供者必须提供一个实现此接口的类。JAXB 提供者需要在第一次执行编组或解组操作之前（可能在调用 JAXBContext.newInstance 期间）的某个时间点调用 DatatypeConverter.setDatatypeConverter。要配置用于执行打印和解析功能的转换器，这一步是必需的。重复调用此 api 是无效的，传入第一个调用中的 DatatypeConverter 实例将是将从那时起有效的实例。

此接口定义了一些 parse 和 print 方法。在 JAXB 规范的默认绑定 Table 5-1 中指定的每个 XML 模式数据类型都有一个 parse 和 print 方法。

此处定义的 parse 和 print 方法由 DatatypeConverter 类中定义的静态 parse 和 print 方法调用。

XML 模式数据类型的 parse 方法必须能够将 XML 模式数据类型的任何词汇表示形式（由 XML Schema Part 2: Datatypes specification 指定）转换为 XML 模式数据类型的值空间中的值。如果在转换期间发生错误，则该方法将抛出 IllegalArgumentException，或者抛出 IllegalArgumentException 的子类。

XML 模式数据类型的 print 方法可以输出对于 XML 模式数据类型有效的任何词汇表示形式。如果在转换期间发生错误，则该方法将抛出 IllegalArgumentException，或者抛出 IllegalArgumentException 的子类。

前缀 xsd：用于引用 XML 模式数据类型 XML Schema Part 2: Datatypes specification。

version	en $Revision: 1.5 $
since	JAXB1.0
See also	javax.xml.bind.DatatypeConverter, javax.xml.bind.ParseConversionEvent, javax.xml.bind.PrintConversionEvent

英文文档：

The DatatypeConverterInterface is for JAXB provider use only. A JAXB provider must supply a class that implements this interface. JAXB Providers are required to call the DatatypeConverter.setDatatypeConverter api at some point before the first marshal or unmarshal operation (perhaps during the call to JAXBContext.newInstance). This step is necessary to configure the converter that should be used to perform the print and parse 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 DatatypeConverter class.

A parse method for a XML schema datatype must be capable of converting any lexical representation of the XML schema datatype ( specified by the XML Schema Part2: Datatypes specification into a value in the value space of 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.

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.

Since:

JAXB1.0

Version:

$Revision: 1.5 $

Author:

• Sekhar Vajjhala, Sun Microsystems, Inc.
• Joe Fialli, Sun Microsystems Inc.
• Kohsuke Kawaguchi, Sun Microsystems, Inc.
• Ryan Shoemaker,Sun Microsystems Inc.

See Also:

DatatypeConverter, ParseConversionEvent, PrintConversionEvent

---

Method Summary
String	parseAnySimpleType(String lexicalXSDAnySimpleType)            Return a string containing the lexical representation of the simple type.
byte[]	parseBase64Binary(String lexicalXSDBase64Binary)            Converts the string argument into an array of bytes.
boolean	parseBoolean(String lexicalXSDBoolean)            Converts the string argument into a boolean value.
byte	parseByte(String lexicalXSDByte)            Converts the string argument into a byte value.
Calendar	parseDate(String lexicalXSDDate)            Converts the string argument into a Calendar value.
Calendar	parseDateTime(String lexicalXSDDateTime)            Converts the string argument into a Calendar value.
BigDecimal	parseDecimal(String lexicalXSDDecimal)            Converts the string argument into a BigDecimal value.
double	parseDouble(String lexicalXSDDouble)            Converts the string argument into a double value.
float	parseFloat(String lexicalXSDFloat)            Converts the string argument into a float value.
byte[]	parseHexBinary(String lexicalXSDHexBinary)            Converts the string argument into an array of bytes.
int	parseInt(String lexicalXSDInt)            Convert the string argument into an int value.
BigInteger	parseInteger(String lexicalXSDInteger)            Convert the string argument into a BigInteger value.
long	parseLong(String lexicalXSDLong)            Converts the string argument into a long value.
QName	parseQName(String lexicalXSDQName, NamespaceContext nsc)            Converts the string argument into a QName value.
short	parseShort(String lexicalXSDShort)            Converts the string argument into a short value.
String	parseString(String lexicalXSDString)            Convert the string argument into a string.
Calendar	parseTime(String lexicalXSDTime)            Converts the string argument into a Calendar value.
long	parseUnsignedInt(String lexicalXSDUnsignedInt)            Converts the string argument into a long value.
int	parseUnsignedShort(String lexicalXSDUnsignedShort)            Converts the string argument into an int value.
String	printAnySimpleType(String val)            Converts a string value into a string.
String	printBase64Binary(byte[] val)            Converts an array of bytes into a string.
String	printBoolean(boolean val)            Converts a boolean value into a string.
String	printByte(byte val)            Converts a byte value into a string.
String	printDate(Calendar val)            Converts a Calendar value into a string.
String	printDateTime(Calendar val)            Converts a Calendar value into a string.
String	printDecimal(BigDecimal val)            Converts a BigDecimal value into a string.
String	printDouble(double val)            Converts a double value into a string.
String	printFloat(float val)            Converts a float value into a string.
String	printHexBinary(byte[] val)            Converts an array of bytes into a string.
String	printInt(int val)            Converts an int value into a string.
String	printInteger(BigInteger val)            Converts a BigInteger value into a string.
String	printLong(long val)            Converts a long value into a string.
String	printQName(QName val, NamespaceContext nsc)            Converts a QName instance into a string.
String	printShort(short val)            Converts a short value into a string.
String	printString(String val)            Converts the string argument into a string.
String	printTime(Calendar val)            Converts a Calendar value into a string.
String	printUnsignedInt(long val)            Converts a long value into a string.
String	printUnsignedShort(int val)            Converts an int value into a string.

 

Method Detail

public String parseString(String lexicalXSDString)

将字符串参数转换为一个字符串。

lexicalXSDString	XML 模式数据类型 xsd:string 的词汇表示形式
return	与输入字符串相同的字符串。

英文文档：

parseString

String parseString(String lexicalXSDString)

Convert the string argument into a string.

Parameters:

lexicalXSDString - A lexical representation of the XML Schema datatype xsd:string

Returns:

A string that is the same as the input string.

---

public java.math.BigInteger parseInteger(String lexicalXSDInteger)

将字符串参数转换为一个 BigInteger 值。

lexicalXSDInteger	包含 xsd:integer 的词汇表示形式的字符串。
return	字符串参数表示的 BigInteger 值。
Throws	NumberFormatException: 如果 lexicalXSDInteger 不是 java.math.BigInteger 值的有效字符串表示形式。

英文文档：

parseInteger

BigInteger parseInteger(String lexicalXSDInteger)

Convert the string argument into a BigInteger value.

Parameters:

lexicalXSDInteger - A string containing a lexical representation of xsd:integer.

Returns:

A BigInteger value represented by the string argument.

Throws:

NumberFormatException - lexicalXSDInteger is not a valid string representation of a BigInteger value.

---

public int parseInt(String lexicalXSDInt)

将字符串参数转换为一个 int 值。

lexicalXSDInt	包含 xsd:int 的词汇表示形式的字符串。
return	字符串参数表示的 int 值。
Throws	NumberFormatException: 如果 lexicalXSDInt 不是 int 值的有效字符串表示形式。

英文文档：

parseInt

int parseInt(String lexicalXSDInt)

Convert the string argument into an int value.

Parameters:

lexicalXSDInt - A string containing a lexical representation of xsd:int.

Returns:

An int value represented byte the string argument.

Throws:

NumberFormatException - lexicalXSDInt is not a valid string representation of an int value.

---

public long parseLong(String lexicalXSDLong)

将字符串参数转换为一个 long 值。

lexicalXSDLong	包含 xsd:long 的词汇表示形式的字符串。
return	字符串参数表示的 long 值。
Throws	NumberFormatException: 如果 lexicalXSDLong 不是 long 值的有效字符串表示形式。

英文文档：

parseLong

long parseLong(String lexicalXSDLong)

Converts the string argument into a long value.

Parameters:

lexicalXSDLong - A string containing lexical representation of xsd:long.

Returns:

A long value represented by the string argument.

Throws:

NumberFormatException - lexicalXSDLong is not a valid string representation of a long value.

---

public short parseShort(String lexicalXSDShort)

将字符串参数转换为一个 short 值。

lexicalXSDShort	包含 xsd:short 的词汇表示形式的字符串。
return	字符串参数表示的 short 值。
Throws	NumberFormatException: 如果 lexicalXSDShort 不是 short 值的有效字符串表示形式。

英文文档：

parseShort

short parseShort(String lexicalXSDShort)

Converts the string argument into a short value.

Parameters:

lexicalXSDShort - A string containing lexical representation of xsd:short.

Returns:

A short value represented by the string argument.

Throws:

NumberFormatException - lexicalXSDShort is not a valid string representation of a short value.

---

public java.math.BigDecimal parseDecimal(String lexicalXSDDecimal)

将字符串参数转换为一个 BigDecimal 值。

lexicalXSDDecimal	包含 xsd:decimal 的词汇表示形式的字符串。
return	字符串参数表示的 BigDecimal 值。
Throws	NumberFormatException: 如果 lexicalXSDDecimal 不是 java.math.BigDecimal 的有效字符串表示形式。

英文文档：

parseDecimal

BigDecimal parseDecimal(String lexicalXSDDecimal)

Converts the string argument into a BigDecimal value.

Parameters:

lexicalXSDDecimal - A string containing lexical representation of xsd:decimal.

Returns:

A BigDecimal value represented by the string argument.

Throws:

NumberFormatException - lexicalXSDDecimal is not a valid string representation of BigDecimal.

---

public float parseFloat(String lexicalXSDFloat)

将字符串参数转换为一个 float 值。

lexicalXSDFloat	包含 xsd:float 的词汇表示形式的字符串。
return	字符串参数表示的 float 值。
Throws	NumberFormatException: 如果 lexicalXSDFloat 不是 float 值的有效字符串表示形式。

英文文档：

parseFloat

float parseFloat(String lexicalXSDFloat)

Converts the string argument into a float value.

Parameters:

lexicalXSDFloat - A string containing lexical representation of xsd:float.

Returns:

A float value represented by the string argument.

Throws:

NumberFormatException - lexicalXSDFloat is not a valid string representation of a float value.

---

public double parseDouble(String lexicalXSDDouble)

将字符串参数转换为一个 double 值。

lexicalXSDDouble	包含 xsd:double 的词汇表示形式的字符串。
return	字符串参数表示的 double 值。
Throws	NumberFormatException: 如果 lexicalXSDDouble 不是 double 值的有效字符串表示形式。

英文文档：

parseDouble

double parseDouble(String lexicalXSDDouble)

Converts the string argument into a double value.

Parameters:

lexicalXSDDouble - A string containing lexical representation of xsd:double.

Returns:

A double value represented by the string argument.

Throws:

NumberFormatException - lexicalXSDDouble is not a valid string representation of a double value.

---

public boolean parseBoolean(String lexicalXSDBoolean)

将字符串参数转换为一个 boolean 值。

lexicalXSDBoolean	包含 xsd:boolean 的词汇表示形式的字符串。
return	字符串参数表示的 boolean 值。
Throws	IllegalArgumentException: 如果字符串参数不符合 XML Schema Part 2: Datatypes 中为 xsd:boolean 定义的词汇值空间。

英文文档：

parseBoolean

boolean parseBoolean(String lexicalXSDBoolean)

Converts the string argument into a boolean value.

Parameters:

lexicalXSDBoolean - A string containing lexical representation of xsd:boolean.

Returns:

A boolean value represented by the string argument.

Throws:

IllegalArgumentException - if string parameter does not conform to lexical value space defined in XML Schema Part 2: Datatypes for xsd:boolean.

---

public byte parseByte(String lexicalXSDByte)

将字符串参数转换为一个 byte 值。

lexicalXSDByte	包含 xsd:byte 的词汇表示形式的字符串。
return	字符串参数表示的 byte 值。
Throws	NumberFormatException: 如果 lexicalXSDByte 不包含可解析的字节。
Throws	IllegalArgumentException: 如果字符串参数不符合 XML Schema Part 2: Datatypes 为 xsd:byte 定义的词汇值空间。

英文文档：

parseByte

byte parseByte(String lexicalXSDByte)

Converts the string argument into a byte value.

Parameters:

lexicalXSDByte - A string containing lexical representation of xsd:byte.

Returns:

A byte value represented by the string argument.

Throws:

NumberFormatException - lexicalXSDByte does not contain a parseable byte.

IllegalArgumentException - if string parameter does not conform to lexical value space defined in XML Schema Part 2: Datatypes for xsd:byte.

---

public javax.xml.namespace.QName parseQName(String lexicalXSDQName, javax.xml.namespace.NamespaceContext nsc)

将字符串参数转换为一个 QName 值。

字符串参数 lexicalXSDQname 必须符合 XML Schema Part 2: Datatypes specification:QNames 中指定的词汇值空间。

lexicalXSDQName	包含 xsd:QName 的词汇表示形式的字符串。
nsc	解释 QName 中前缀的名称空间上下文。
return	字符串参数表示的 QName 值。
Throws	IllegalArgumentException: 如果字符串参数不符合 XML Schema Part 2 规范，或者 lexicalXSDQname 的名称空间前缀未绑定到 NamespaceContext nsc 中的 URI。

英文文档：

parseQName

QName parseQName(String lexicalXSDQName,
                 NamespaceContext nsc)

Converts the string argument into a QName value.

String parameter lexicalXSDQname must conform to lexical value space specifed at XML Schema Part 2:Datatypes specification:QNames

Parameters:

lexicalXSDQName - A string containing lexical representation of xsd:QName.

nsc - A namespace context for interpreting a prefix within a QName.

Returns:

A QName value represented by the string argument.

Throws:

IllegalArgumentException - if string parameter does not conform to XML Schema Part 2 specification or if namespace prefix of lexicalXSDQname is not bound to a URI in NamespaceContext nsc.

---

public java.util.Calendar parseDateTime(String lexicalXSDDateTime)

将字符串参数转换为一个 Calendar 值。

lexicalXSDDateTime	包含 xsd:datetime 的词汇表示形式的字符串。
return	字符串参数表示的 Calendar 对象。
Throws	IllegalArgumentException: 如果字符串参数不符合 XML Schema Part 2: Datatypes 为 xsd:dateTime 定义的词汇值空间。

英文文档：

parseDateTime

Calendar parseDateTime(String lexicalXSDDateTime)

Converts the string argument into a Calendar value.

Parameters:

lexicalXSDDateTime - A string containing lexical representation of xsd:datetime.

Returns:

A Calendar object represented by the string argument.

Throws:

IllegalArgumentException - if string parameter does not conform to lexical value space defined in XML Schema Part 2: Datatypes for xsd:dateTime.

---

public byte[] parseBase64Binary(String lexicalXSDBase64Binary)

将字符串参数转换为一个字节数组。

lexicalXSDBase64Binary	包含 xsd:base64Binary 的词汇表示形式的字符串。
return	字符串参数表示的字节数组。
Throws	IllegalArgumentException: 如果字符串参数不符合 XML Schema Part 2: Datatypes 为 xsd:base64Binary 定义的词汇值空间。

英文文档：

parseBase64Binary

byte[] parseBase64Binary(String lexicalXSDBase64Binary)

Converts the string argument into an array of bytes.

Parameters:

lexicalXSDBase64Binary - A string containing lexical representation of xsd:base64Binary.

Returns:

An array of bytes represented by the string argument.

Throws:

IllegalArgumentException - if string parameter does not conform to lexical value space defined in XML Schema Part 2: Datatypes for xsd:base64Binary

---

public byte[] parseHexBinary(String lexicalXSDHexBinary)

将字符串参数转换为一个字节数组。

lexicalXSDHexBinary	包含 xsd:hexBinary 的词汇表示形式的字符串。
return	字符串参数表示的字节数组。
Throws	IllegalArgumentException: 如果字符串参数不符合 XML Schema Part 2: Datatypes 为 xsd:hexBinary 定义的词汇值空间。

英文文档：

parseHexBinary

byte[] parseHexBinary(String lexicalXSDHexBinary)

Converts the string argument into an array of bytes.

Parameters:

lexicalXSDHexBinary - A string containing lexical representation of xsd:hexBinary.

Returns:

An array of bytes represented by the string argument.

Throws:

IllegalArgumentException - if string parameter does not conform to lexical value space defined in XML Schema Part 2: Datatypes for xsd:hexBinary.

---

public long parseUnsignedInt(String lexicalXSDUnsignedInt)

将字符串参数转换为一个 long 值。

lexicalXSDUnsignedInt	包含 xsd:unsignedInt 的词汇表示形式的字符串。
return	字符串参数表示的 long 值。
Throws	NumberFormatException: 如果不能将字符串参数解析为 long 值。

英文文档：

parseUnsignedInt

long parseUnsignedInt(String lexicalXSDUnsignedInt)

Converts the string argument into a long value.

Parameters:

lexicalXSDUnsignedInt - A string containing lexical representation of xsd:unsignedInt.

Returns:

A long value represented by the string argument.

Throws:

NumberFormatException - if string parameter can not be parsed into a long value.

---

public int parseUnsignedShort(String lexicalXSDUnsignedShort)

将字符串参数转换为一个 int 值。

lexicalXSDUnsignedShort	包含 xsd:unsignedShort 的词汇表示形式的字符串。
return	字符串参数表示的 int 值。
Throws	NumberFormatException: 如果不能将字符串参数解析为 int 值。

英文文档：

parseUnsignedShort

int parseUnsignedShort(String lexicalXSDUnsignedShort)

Converts the string argument into an int value.

Parameters:

lexicalXSDUnsignedShort - A string containing lexical representation of xsd:unsignedShort.

Returns:

An int value represented by the string argument.

Throws:

NumberFormatException - if string parameter can not be parsed into an int value.

---

public java.util.Calendar parseTime(String lexicalXSDTime)

将字符串参数转换为一个 Calendar 值。

lexicalXSDTime	包含 xsd:Time 的词汇表示形式的字符串。
return	字符串参数表示的 Calendar 值。
Throws	IllegalArgumentException: 如果字符串参数不符合 XML Schema Part 2: Datatypes 为 xsd:Time 定义的词汇值空间。

英文文档：

parseTime

Calendar parseTime(String lexicalXSDTime)

Converts the string argument into a Calendar value.

Parameters:

lexicalXSDTime - A string containing lexical representation of xsd:Time.

Returns:

A Calendar value represented by the string argument.

Throws:

IllegalArgumentException - if string parameter does not conform to lexical value space defined in XML Schema Part 2: Datatypes for xsd:Time.

---

public java.util.Calendar parseDate(String lexicalXSDDate)

将字符串参数转换为一个 Calendar 值。

lexicalXSDDate	包含 xsd:Date 的词汇表示形式的字符串。
return	字符串参数表示的 Calendar 值。
Throws	IllegalArgumentException: 如果字符串参数不符合 XML Schema Part 2: Datatypes 为 xsd:Date 定义的词汇值空间。

英文文档：

parseDate

Calendar parseDate(String lexicalXSDDate)

Converts the string argument into a Calendar value.

Parameters:

lexicalXSDDate - A string containing lexical representation of xsd:Date.

Returns:

A Calendar value represented by the string argument.

Throws:

IllegalArgumentException - if string parameter does not conform to lexical value space defined in XML Schema Part 2: Datatypes for xsd:Date.

---

public String parseAnySimpleType(String lexicalXSDAnySimpleType)

返回包含简单类型的词汇表示形式的字符串。

lexicalXSDAnySimpleType	包含简单类型的词汇表示形式的字符串。
return	包含简单类型的词汇表示形式的字符串。

英文文档：

parseAnySimpleType

String parseAnySimpleType(String lexicalXSDAnySimpleType)

Return a string containing the lexical representation of the simple type.

Parameters:

lexicalXSDAnySimpleType - A string containing lexical representation of the simple type.

Returns:

A string containing the lexical representation of the simple type.

---

public String printString(String val)

将字符串参数转换为一个字符串。

val	字符串值。
return	包含 xsd:string 的词汇表示形式的字符串

英文文档：

printString

String printString(String val)

Converts the string argument into a string.

Parameters:

val - A string value.

Returns:

A string containing a lexical representation of xsd:string

---

public String printInteger(java.math.BigInteger val)

将 BigInteger 值转换为一个字符串。

val	一个 BigInteger 值
return	包含 xsd:integer 的词汇表示形式的字符串
Throws	IllegalArgumentException: 如果 val 为 null。

英文文档：

printInteger

String printInteger(BigInteger val)

Converts a BigInteger value into a string.

Parameters:

val - A BigInteger value

Returns:

A string containing a lexical representation of xsd:integer

Throws:

IllegalArgumentException - val is null.

---

public String printInt(int val)

将 int 值转换为一个字符串。

val	一个 int 值
return	包含 xsd:int 的词汇表示形式的字符串

英文文档：

printInt

String printInt(int val)

Converts an int value into a string.

Parameters:

val - An int value

Returns:

A string containing a lexical representation of xsd:int

---

public String printLong(long val)

将 long 值转换为一个字符串。

val	一个 long 值
return	包含 xsd:long 的词汇表示形式的字符串

英文文档：

printLong

String printLong(long val)

Converts a long value into a string.

Parameters:

val - A long value

Returns:

A string containing a lexical representation of xsd:long

---

public String printShort(short val)

将 short 值转换为一个字符串。

val	一个 short 值
return	包含 xsd:short 的词汇表示形式的字符串

英文文档：

printShort

String printShort(short val)

Converts a short value into a string.

Parameters:

val - A short value

Returns:

A string containing a lexical representation of xsd:short

---

public String printDecimal(java.math.BigDecimal val)

将 BigDecimal 值转换为一个字符串。

val	一个 BigDecimal 值
return	包含 xsd:decimal 的词汇表示形式的字符串
Throws	IllegalArgumentException: 如果 val 为 null。

英文文档：

printDecimal

String printDecimal(BigDecimal val)

Converts a BigDecimal value into a string.

Parameters:

val - A BigDecimal value

Returns:

A string containing a lexical representation of xsd:decimal

Throws:

IllegalArgumentException - val is null.

---

public String printFloat(float val)

将 float 值转换为一个字符串。

val	一个 float 值
return	包含 xsd:float 的词汇表示形式的字符串

英文文档：

printFloat

String printFloat(float val)

Converts a float value into a string.

Parameters:

val - A float value

Returns:

A string containing a lexical representation of xsd:float

---

public String printDouble(double val)

将 double 值转换为一个字符串。

val	一个 double 值
return	包含 xsd:double 的词汇表示形式的字符串

英文文档：

printDouble

String printDouble(double val)

Converts a double value into a string.

Parameters:

val - A double value

Returns:

A string containing a lexical representation of xsd:double

---

public String printBoolean(boolean val)

将 boolean 值转换为一个字符串。

val	一个 boolean 值
return	包含 xsd:boolean 的词汇表示形式的字符串

英文文档：

printBoolean

String printBoolean(boolean val)

Converts a boolean value into a string.

Parameters:

val - A boolean value

Returns:

A string containing a lexical representation of xsd:boolean

---

public String printByte(byte val)

将 byte 值转换为一个字符串。

val	一个 byte 值
return	包含 xsd:byte 的词汇表示形式的字符串

英文文档：

printByte

String printByte(byte val)

Converts a byte value into a string.

Parameters:

val - A byte value

Returns:

A string containing a lexical representation of xsd:byte

---

public String printQName(javax.xml.namespace.QName val, javax.xml.namespace.NamespaceContext nsc)

将 QName 实例转换为一个字符串。

val	一个 QName 值
nsc	解释 QName 中前缀的名称空间上下文。
return	包含 QName 的词汇表示形式的字符串
Throws	IllegalArgumentException: 如果 val 为 null、nsc 为非 null 或 nsc.getPrefix(nsprefixFromVal) 为 null。

英文文档：

printQName

String printQName(QName val,
                  NamespaceContext nsc)

Converts a QName instance into a string.

Parameters:

val - A QName value

nsc - A namespace context for interpreting a prefix within a QName.

Returns:

A string containing a lexical representation of QName

Throws:

IllegalArgumentException - if val is null or if nsc is non-null or nsc.getPrefix(nsprefixFromVal) is null.

---

public String printDateTime(java.util.Calendar val)

将 Calendar 值转换为一个字符串。

val	一个 Calendar 值
return	包含 xsd:dateTime 的词汇表示形式的字符串
Throws	IllegalArgumentException: 如果 val 为 null。

英文文档：

printDateTime

String printDateTime(Calendar val)

Converts a Calendar value into a string.

Parameters:

val - A Calendar value

Returns:

A string containing a lexical representation of xsd:dateTime

Throws:

IllegalArgumentException - if val is null.

---

public String printBase64Binary(byte[] val)

将字节数组转换为一个字符串。

val	字节数组
return	包含 xsd:base64Binary 的词汇表示形式的字符串
Throws	IllegalArgumentException: 如果 val 为 null。

英文文档：

printBase64Binary

String printBase64Binary(byte[] val)

Converts an array of bytes into a string.

Parameters:

val - an array of bytes

Returns:

A string containing a lexical representation of xsd:base64Binary

Throws:

IllegalArgumentException - if val is null.

---

public String printHexBinary(byte[] val)

将字节数组转换为一个字符串。

val	字节数组
return	包含 xsd:hexBinary 的词汇表示形式的字符串
Throws	IllegalArgumentException: 如果 val 为 null。

英文文档：

printHexBinary

String printHexBinary(byte[] val)

Converts an array of bytes into a string.

Parameters:

val - an array of bytes

Returns:

A string containing a lexical representation of xsd:hexBinary

Throws:

IllegalArgumentException - if val is null.

---

public String printUnsignedInt(long val)

将 long 值转换为一个字符串。

val	一个 long 值
return	包含 xsd:unsignedInt 的词汇表示形式的字符串

英文文档：

printUnsignedInt

String printUnsignedInt(long val)

Converts a long value into a string.

Parameters:

val - A long value

Returns:

A string containing a lexical representation of xsd:unsignedInt

---

public String printUnsignedShort(int val)

将 int 值转换为一个字符串。

val	一个 int 值
return	包含 xsd:unsignedShort 的词汇表示形式的字符串

英文文档：

printUnsignedShort

String printUnsignedShort(int val)

Converts an int value into a string.

Parameters:

val - An int value

Returns:

A string containing a lexical representation of xsd:unsignedShort

---

public String printTime(java.util.Calendar val)

将 Calendar 值转换为一个字符串。

val	一个 Calendar 值
return	包含 xsd:time 的词汇表示形式的字符串
Throws	IllegalArgumentException: 如果 val 为 null。

英文文档：

printTime

String printTime(Calendar val)

Converts a Calendar value into a string.

Parameters:

val - A Calendar value

Returns:

A string containing a lexical representation of xsd:time

Throws:

IllegalArgumentException - if val is null.

---

public String printDate(java.util.Calendar val)

将 Calendar 值转换为一个字符串。

val	一个 Calendar 值
return	包含 xsd:date 的词汇表示形式的字符串
Throws	IllegalArgumentException: 如果 val 为 null。

英文文档：

printDate

String printDate(Calendar val)

Converts a Calendar value into a string.

Parameters:

val - A Calendar value

Returns:

A string containing a lexical representation of xsd:date

Throws:

IllegalArgumentException - if val is null.

---

public String printAnySimpleType(String val)

将字符串值转换为一个字符串。

val	字符串值
return	包含 xsd:AnySimpleType 的词汇表示形式的字符串

英文文档：

printAnySimpleType

String printAnySimpleType(String val)

Converts a string value into a string.

Parameters:

val - A string value

Returns:

A string containing a lexical representation of xsd:AnySimpleType

---

Overview  Package   Class  Tree  Deprecated  Index  Help
PREV CLASS   NEXT CLASS	FRAMES    NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

Submit a bug or feature

Copyright 2007 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.