javax.xml.bind
인터페이스 DatatypeConverterInterface

public interface DatatypeConverterInterface

DatatypeConverterInterface 는, JAXB 프로바이더에만 따라 사용됩니다. JAXB 프로바이더는, 이 인터페이스를 구현한 클래스를 제공할 필요가 있습니다. JAXB 프로바이더는, 최초의 정렬화 또는 비정렬화 조작이 불려 가기 전이 있는 시점에서 (아마, JAXBContext.newInstance 의 호출중),DatatypeConverter.setDatatypeConverter API 를 호출할 필요가 있습니다. 이 스텝은, 출력 및 해석 기능을 실행하는데 있어서 사용해야 할 컨버터를 설정하기 위해서 필요하게 됩니다. 이 API 를 반복해 호출해도 효과는 없습니다. 최초의 호출에게 건네진 DatatypeConverter 인스턴스가, 그 이후 사용되는 인스턴스입니다.

이 인터페이스는, 해석 메소드 및 출력 메소드를 정의합니다. JAXB 스펙의 디폴트 바인딩 테이블 5-1 로 지정된 각 XML schema 데이터형에 대해, 1 개의 해석 메소드 및 출력 메소드가 있습니다.

여기에 정의하는 해석 메소드 및 출력 메소드는,DatatypeConverter 클래스에 정의된 static 해석 메소드 및 출력 메소드에 의해 불려 갑니다.

XML schema 데이터형용의 해석 메소드는, 「XML Schema Part2: Datatypes 」로 지정되고 있는 XML schema 데이터형의 자구 표현을, XML schema 데이터형의 값영역내의 값으로 변환할 수 있을 필요가 있습니다. 변환중에 에러가 발생했을 경우, 이 메소드는 IllegalArgumentException, 또는, IllegalArgumentException 의 서브 클래스를 throw 할 필요가 있습니다.

XML schema 데이터형의 출력 메소드는, XML schema 데이터형으로서 유효한 자구 표현을 출력 가능합니다. 변환중에 에러가 발생했을 경우, 이 메소드는 IllegalArgumentException, 또는, IllegalArgumentException 의 서브 클래스를 throw 할 필요가 있습니다.

접두사 xsd: 는, XML schema 데이터형을 참조하기 위해서 사용됩니다. 「XML Schema Part2: Datatypes」의 스펙

도입된 버젼:

JAXB1. 0

관련 항목:

DatatypeConverter , ParseConversionEvent , PrintConversionEvent

메소드의 개요

String	parseAnySimpleType (String lexicalXSDAnySimpleType) 단순형의 자구 표현을 포함한 캐릭터 라인을 돌려줍니다.
byte[]	parseBase64Binary (String lexicalXSDBase64Binary) 캐릭터 라인 인수를 바이트 배열로 변환합니다.
boolean	parseBoolean (String lexicalXSDBoolean) 캐릭터 라인 인수를 boolean 치로 변환합니다.
byte	parseByte (String lexicalXSDByte) 캐릭터 라인 인수를 byte 치로 변환합니다.
Calendar	parseDate (String lexicalXSDDate) 캐릭터 라인 인수를 Calendar 치로 변환합니다.
Calendar	parseDateTime (String lexicalXSDDateTime) 캐릭터 라인 인수를 Calendar 치로 변환합니다.
BigDecimal	parseDecimal (String lexicalXSDDecimal) 캐릭터 라인 인수를 BigDecimal 치로 변환합니다.
double	parseDouble (String lexicalXSDDouble) 캐릭터 라인 인수를 double 치로 변환합니다.
float	parseFloat (String lexicalXSDFloat) 캐릭터 라인 인수를 float 치로 변환합니다.
byte[]	parseHexBinary (String lexicalXSDHexBinary) 캐릭터 라인 인수를 바이트 배열로 변환합니다.
int	parseInt (String lexicalXSDInt) 캐릭터 라인 인수를 int 치로 변환합니다.
BigInteger	parseInteger (String lexicalXSDInteger) 캐릭터 라인 인수를 BigInteger 치로 변환합니다.
long	parseLong (String lexicalXSDLong) 캐릭터 라인 인수를 long 치로 변환합니다.
QName	parseQName (String lexicalXSDQName, NamespaceContext nsc) 캐릭터 라인 인수를 QName 치로 변환합니다.
short	parseShort (String lexicalXSDShort) 캐릭터 라인 인수를 short 치로 변환합니다.
String	parseString (String lexicalXSDString) 캐릭터 라인 인수를 캐릭터 라인으로 변환합니다.
Calendar	parseTime (String lexicalXSDTime) 캐릭터 라인 인수를 Calendar 치로 변환합니다.
long	parseUnsignedInt (String lexicalXSDUnsignedInt) 캐릭터 라인 인수를 long 치로 변환합니다.
int	parseUnsignedShort (String lexicalXSDUnsignedShort) 캐릭터 라인 인수를 int 치로 변환합니다.
String	printAnySimpleType (String val) 캐릭터 라인치를 캐릭터 라인으로 변환합니다.
String	printBase64Binary (byte[] val) 바이트 배열을 캐릭터 라인으로 변환합니다.
String	printBoolean (boolean val) boolean 치를 캐릭터 라인으로 변환합니다.
String	printByte (byte val) byte 치를 캐릭터 라인으로 변환합니다.
String	printDate (Calendar val) Calendar 치를 캐릭터 라인으로 변환합니다.
String	printDateTime (Calendar val) Calendar 치를 캐릭터 라인으로 변환합니다.
String	printDecimal (BigDecimal val) BigDecimal 치를 캐릭터 라인으로 변환합니다.
String	printDouble (double val) double 치를 캐릭터 라인으로 변환합니다.
String	printFloat (float val) float 치를 캐릭터 라인으로 변환합니다.
String	printHexBinary (byte[] val) 바이트 배열을 캐릭터 라인으로 변환합니다.
String	printInt (int val) int 치를 캐릭터 라인으로 변환합니다.
String	printInteger (BigInteger val) BigInteger 치를 캐릭터 라인으로 변환합니다.
String	printLong (long val) long 치를 캐릭터 라인으로 변환합니다.
String	printQName (QName val, NamespaceContext nsc) QName 인스턴스를 캐릭터 라인으로 변환합니다.
String	printShort (short val) short 치를 캐릭터 라인으로 변환합니다.
String	printString (String val) 캐릭터 라인 인수를 캐릭터 라인으로 변환합니다.
String	printTime (Calendar val) Calendar 치를 캐릭터 라인으로 변환합니다.
String	printUnsignedInt (long val) long 치를 캐릭터 라인으로 변환합니다.
String	printUnsignedShort (int val) int 치를 캐릭터 라인으로 변환합니다.

메소드의 상세

parseString

String  parseString(String  lexicalXSDString)

캐릭터 라인 인수를 캐릭터 라인으로 변환합니다.

파라미터:

lexicalXSDString - XML Schema 데이터형 xsd:string 의 자구 표현

반환값:

입력 캐릭터 라인과 같은 캐릭터 라인

parseInteger

BigInteger  parseInteger(String  lexicalXSDInteger)

캐릭터 라인 인수를 BigInteger 치로 변환합니다.

파라미터:

lexicalXSDInteger - xsd:integer 의 자구 표현을 포함한 캐릭터 라인

반환값:

캐릭터 라인 인수가 나타내는 BigInteger 치

예외:

NumberFormatException - lexicalXSDInteger 가 BigInteger 치의 캐릭터 라인 표현으로서 무효인 경우

parseInt

int parseInt(String  lexicalXSDInt)

캐릭터 라인 인수를 int 치로 변환합니다.

파라미터:

lexicalXSDInt - xsd:int 의 자구 표현을 포함한 캐릭터 라인

반환값:

캐릭터 라인 인수가 나타내는 int 치

예외:

NumberFormatException - lexicalXSDInt 가 int 치의 캐릭터 라인 표현으로서 무효인 경우

parseLong

long parseLong(String  lexicalXSDLong)

캐릭터 라인 인수를 long 치로 변환합니다.

파라미터:

lexicalXSDLong - xsd:long 의 자구 표현을 포함한 캐릭터 라인

반환값:

캐릭터 라인 인수가 나타내는 long 치

예외:

NumberFormatException - lexicalXSDLong 가 long 치의 캐릭터 라인 표현으로서 무효인 경우

parseShort

short parseShort(String  lexicalXSDShort)

캐릭터 라인 인수를 short 치로 변환합니다.

파라미터:

lexicalXSDShort - xsd:short 의 자구 표현을 포함한 캐릭터 라인

반환값:

캐릭터 라인 인수가 나타내는 short 치

예외:

NumberFormatException - lexicalXSDShort 가 short 치의 캐릭터 라인 표현으로서 무효인 경우

parseDecimal

BigDecimal  parseDecimal(String  lexicalXSDDecimal)

캐릭터 라인 인수를 BigDecimal 치로 변환합니다.

파라미터:

lexicalXSDDecimal - xsd:decimal 의 자구 표현을 포함한 캐릭터 라인

반환값:

캐릭터 라인 인수가 나타내는 BigDecimal 치

예외:

NumberFormatException - lexicalXSDDecimal 가 BigDecimal 의 캐릭터 라인 표현으로서 무효인 경우

parseFloat

float parseFloat(String  lexicalXSDFloat)

캐릭터 라인 인수를 float 치로 변환합니다.

파라미터:

lexicalXSDFloat - xsd:float 의 자구 표현을 포함한 캐릭터 라인

반환값:

캐릭터 라인 인수가 나타내는 float 치

예외:

NumberFormatException - lexicalXSDFloat 가 float 치의 캐릭터 라인 표현으로서 무효인 경우

parseDouble

double parseDouble(String  lexicalXSDDouble)

캐릭터 라인 인수를 double 치로 변환합니다.

파라미터:

lexicalXSDDouble - xsd:double 의 자구 표현을 포함한 캐릭터 라인

반환값:

캐릭터 라인 인수가 나타내는 double 치

예외:

NumberFormatException - lexicalXSDDouble 가 double 치의 캐릭터 라인 표현으로서 무효인 경우

parseBoolean

boolean parseBoolean(String  lexicalXSDBoolean)

캐릭터 라인 인수를 boolean 치로 변환합니다.

파라미터:

lexicalXSDBoolean - xsd:boolean 의 자구 표현을 포함한 캐릭터 라인

반환값:

캐릭터 라인 인수가 나타내는 boolean 치

예외:

IllegalArgumentException - 캐릭터 라인 파라미터가 「XML Schema Part 2: Datatypes」의 xsd:boolean 에 관한 스펙으로 정의된 자구치 영역에 준거하고 있지 않는 경우

parseByte

byte parseByte(String  lexicalXSDByte)

캐릭터 라인 인수를 byte 치로 변환합니다.

파라미터:

lexicalXSDByte - xsd:byte 의 자구 표현을 포함한 캐릭터 라인

반환값:

캐릭터 라인 인수가 나타내는 byte 치

예외:

NumberFormatException - lexicalXSDByte 가 해석 가능한 byte 를 포함하지 않는 경우

IllegalArgumentException - 캐릭터 라인 파라미터가 「XML Schema Part 2: Datatypes」의 xsd:byte 에 관한 스펙으로 정의된 자구치 영역에 준거하고 있지 않는 경우

parseQName

QName  parseQName(String  lexicalXSDQName,
                 NamespaceContext  nsc)

캐릭터 라인 인수를 QName 치로 변환합니다.

캐릭터 라인 파라미터 lexicalXSDQname 는,「XML Schema Part 2:Datatypes specification:QNames」로 지정되고 있는 자구치 영역에 준거하고 있을 필요가 있습니다.

파라미터:

lexicalXSDQName - xsd:QName 의 자구 표현을 포함한 캐릭터 라인

nsc - QName 내의 접두사를 해석하기 위한 이름 공간 문맥

반환값:

캐릭터 라인 인수가 나타내는 QName 치

예외:

IllegalArgumentException - 캐릭터 라인 파라미터가 「XML Schema Part 2」스펙에 준거하고 있지 않는 경우, 또는, lexicalXSDQname 의 이름 공간 접두사가 NamespaceContext nsc 내의 URI 에 바인드되어 있지 않은 경우

parseDateTime

Calendar  parseDateTime(String  lexicalXSDDateTime)

캐릭터 라인 인수를 Calendar 치로 변환합니다.

파라미터:

lexicalXSDDateTime - xsd:datetime 의 자구 표현을 포함한 캐릭터 라인

반환값:

캐릭터 라인 인수가 나타내는 Calendar 객체

예외:

IllegalArgumentException - 캐릭터 라인 파라미터가 「XML Schema Part 2: Datatypes」의 xsd:dateTime 에 관한 스펙으로 정의된 자구치 영역에 준거하고 있지 않는 경우

parseBase64Binary

byte[] parseBase64Binary(String  lexicalXSDBase64Binary)

캐릭터 라인 인수를 바이트 배열로 변환합니다.

파라미터:

lexicalXSDBase64Binary - xsd:base64Binary 의 자구 표현을 포함한 캐릭터 라인

반환값:

캐릭터 라인 인수가 나타내는 바이트 배열

예외:

IllegalArgumentException - 캐릭터 라인 파라미터가 「XML Schema Part 2: Datatypes」의 xsd:base64Binary 에 관한 스펙으로 정의된 자구치 영역에 준거하고 있지 않는 경우

parseHexBinary

byte[] parseHexBinary(String  lexicalXSDHexBinary)

캐릭터 라인 인수를 바이트 배열로 변환합니다.

파라미터:

lexicalXSDHexBinary - xsd:hexBinary 의 자구 표현을 포함한 캐릭터 라인

반환값:

캐릭터 라인 인수가 나타내는 바이트 배열

예외:

IllegalArgumentException - 캐릭터 라인 파라미터가 「XML Schema Part 2: Datatypes」의 xsd:hexBinary 에 관한 스펙으로 정의된 자구치 영역에 준거하고 있지 않는 경우

parseUnsignedInt

long parseUnsignedInt(String  lexicalXSDUnsignedInt)

캐릭터 라인 인수를 long 치로 변환합니다.

파라미터:

lexicalXSDUnsignedInt - xsd:unsignedInt 의 자구 표현을 포함한 캐릭터 라인

반환값:

캐릭터 라인 인수가 나타내는 long 치

예외:

NumberFormatException - 캐릭터 라인 파라미터를 long 치에 구문 분석 할 수 없는 경우

parseUnsignedShort

int parseUnsignedShort(String  lexicalXSDUnsignedShort)

캐릭터 라인 인수를 int 치로 변환합니다.

파라미터:

lexicalXSDUnsignedShort - xsd:unsignedShort 의 자구 표현 (을)를 포함한 캐릭터 라인

반환값:

캐릭터 라인 인수가 나타내는 int 치

예외:

NumberFormatException - 캐릭터 라인 파라미터를 int 치에 구문 분석 할 수 없는 경우

parseTime

Calendar  parseTime(String  lexicalXSDTime)

캐릭터 라인 인수를 Calendar 치로 변환합니다.

파라미터:

lexicalXSDTime - xsd:time 의 자구 표현을 포함한 캐릭터 라인

반환값:

캐릭터 라인 인수가 나타내는 Calendar 치

예외:

IllegalArgumentException - 캐릭터 라인 파라미터가 「XML Schema Part 2: Datatypes」의 xsd:time 에 관한 스펙으로 정의된 자구치 영역에 준거하고 있지 않는 경우

parseDate

Calendar  parseDate(String  lexicalXSDDate)

캐릭터 라인 인수를 Calendar 치로 변환합니다.

파라미터:

lexicalXSDDate - xsd:date 의 자구 표현을 포함한 캐릭터 라인

반환값:

캐릭터 라인 인수가 나타내는 Calendar 치

예외:

IllegalArgumentException - 캐릭터 라인 파라미터가 「XML Schema Part 2: Datatypes」의 xsd:Date 에 관한 스펙으로 정의된 자구치 영역에 준거하고 있지 않는 경우

parseAnySimpleType

String  parseAnySimpleType(String  lexicalXSDAnySimpleType)

단순형의 자구 표현을 포함한 캐릭터 라인을 돌려줍니다.

파라미터:

lexicalXSDAnySimpleType - 단순형의 자구 표현을 포함한다 캐릭터 라인

반환값:

단순형의 자구 표현을 포함한 캐릭터 라인

printString

String  printString(String  val)

캐릭터 라인 인수를 캐릭터 라인으로 변환합니다.

파라미터:

val - 캐릭터 라인치

반환값:

xsd:string 의 자구 표현을 포함한 캐릭터 라인

printInteger

String  printInteger(BigInteger  val)

BigInteger 치를 캐릭터 라인으로 변환합니다.

파라미터:

val - BigInteger 치

반환값:

xsd:integer 의 자구 표현을 포함한 캐릭터 라인

예외:

IllegalArgumentException - val 가 null 의 경우

printInt

String  printInt(int val)

int 치를 캐릭터 라인으로 변환합니다.

파라미터:

val - int 치

반환값:

xsd:int 의 자구 표현을 포함한 캐릭터 라인

printLong

String  printLong(long val)

long 치를 캐릭터 라인으로 변환합니다.

파라미터:

val - long 치

반환값:

xsd:long 의 자구 표현을 포함한 캐릭터 라인

printShort

String  printShort(short val)

short 치를 캐릭터 라인으로 변환합니다.

파라미터:

val - short 치

반환값:

xsd:short 의 자구 표현을 포함한 캐릭터 라인

printDecimal

String  printDecimal(BigDecimal  val)

BigDecimal 치를 캐릭터 라인으로 변환합니다.

파라미터:

val - BigDecimal 치

반환값:

xsd:decimal 의 자구 표현을 포함한 캐릭터 라인

예외:

IllegalArgumentException - val 가 null 의 경우

printFloat

String  printFloat(float val)

float 치를 캐릭터 라인으로 변환합니다.

파라미터:

val - float 치

반환값:

xsd:float 의 자구 표현을 포함한 캐릭터 라인

printDouble

String  printDouble(double val)

double 치를 캐릭터 라인으로 변환합니다.

파라미터:

val - double 치

반환값:

xsd:double 의 자구 표현을 포함한 캐릭터 라인

printBoolean

String  printBoolean(boolean val)

boolean 치를 캐릭터 라인으로 변환합니다.

파라미터:

val - boolean 치

반환값:

xsd:boolean 의 자구 표현을 포함한 캐릭터 라인

printByte

String  printByte(byte val)

byte 치를 캐릭터 라인으로 변환합니다.

파라미터:

val - byte 치

반환값:

xsd:byte 의 자구 표현을 포함한 캐릭터 라인

printQName

String  printQName(QName  val,
                  NamespaceContext  nsc)

QName 인스턴스를 캐릭터 라인으로 변환합니다.

파라미터:

val - QName 치

nsc - QName 내의 접두사를 해석하기 위한 이름 공간 문맥

반환값:

QName 의 자구 표현을 포함한 캐릭터 라인

예외:

IllegalArgumentException - val 가 null, 또는, nsc 가 null 이외, 또는,nsc.getPrefix(nsprefixFromVal) 가 null 의 경우

printDateTime

String  printDateTime(Calendar  val)

Calendar 치를 캐릭터 라인으로 변환합니다.

파라미터:

val - Calendar 치

반환값:

xsd:dateTime 의 자구 표현을 포함한 캐릭터 라인

예외:

IllegalArgumentException - val 가 null 의 경우

printBase64Binary

String  printBase64Binary(byte[] val)

바이트 배열을 캐릭터 라인으로 변환합니다.

파라미터:

val - 바이트의 배열

반환값:

xsd:base64Binary 의 자구 표현을 포함한 캐릭터 라인

예외:

IllegalArgumentException - val 가 null 의 경우

printHexBinary

String  printHexBinary(byte[] val)

바이트 배열을 캐릭터 라인으로 변환합니다.

파라미터:

val - 바이트의 배열

반환값:

xsd:hexBinary 의 자구 표현을 포함한 캐릭터 라인

예외:

IllegalArgumentException - val 가 null 의 경우

printUnsignedInt

String  printUnsignedInt(long val)

long 치를 캐릭터 라인으로 변환합니다.

파라미터:

val - long 치

반환값:

xsd:unsignedInt 의 자구 표현을 포함한 캐릭터 라인

printUnsignedShort

String  printUnsignedShort(int val)

int 치를 캐릭터 라인으로 변환합니다.

파라미터:

val - int 치

반환값:

xsd:unsignedShort 의 자구 표현을 포함한 캐릭터 라인

printTime

String  printTime(Calendar  val)

Calendar 치를 캐릭터 라인으로 변환합니다.

파라미터:

val - Calendar 치

반환값:

xsd:time 의 자구 표현을 포함한 캐릭터 라인

예외:

IllegalArgumentException - val 가 null 의 경우

printDate

String  printDate(Calendar  val)

Calendar 치를 캐릭터 라인으로 변환합니다.

파라미터:

val - Calendar 치

반환값:

xsd:date 의 자구 표현을 포함한 캐릭터 라인

예외:

IllegalArgumentException - val 가 null 의 경우

printAnySimpleType

String  printAnySimpleType(String  val)

캐릭터 라인치를 캐릭터 라인으로 변환합니다.

파라미터:

val - 캐릭터 라인치

반환값:

xsd:AnySimpleType 의 자구 표현을 포함한 캐릭터 라인