java.text
클래스 Format

java.lang.Object 
  java.text.Format

모든 구현된 인터페이스:

Serializable, Cloneable

알려진 직계 서브 클래스:

DateFormat, MessageFormat, NumberFormat

public abstract class Format
extends Object 
implements Serializable,
 Cloneable 

Format는 날짜와 시간, 메세지, 숫자등의 로케일에 의존된 정보를 포맷 하는 abstract base class입니다.

Format는 로케일에 의존된 정보를 String에 포맷 하기 위한(해) (format 메서드) 및 String를 해석해 객체에 되돌리기 때문에 (parseObject 메서드)의 프로그래밍 인터페이스를 정의하는 것입니다.

보통, format parseObject 메서드는 그 format 메서드에 의해 포맷된 임의의 캐릭터 라인을 해석할 수 있을 필요가 있습니다. 다만, 이것이 가능하지 않은 예외적인 경우가 있습니다. 예를 들어, format 메서드는 사이에 단락지어 문자가 없는 2개의 인접하는 정수값을 생성하는 경우가 있습니다. 이 경우 parseObject는 각 숫자가 어느 수치에 속하는지를 나타낼 수가 없습니다.

상속

Java 2 플랫폼에서는 날짜와 시간, 메세지, 숫자를 각각 포맷 하기 위한, 3개의 특수한 서브 클래스 DateFormat, MessageFormat, NumberFormat이 Format에 준비되어 있습니다.

구상 서브 클래스에는 아래의 3개의 메서드를 구현하지 않으면 안됩니다.

1. format(Object obj, StringBuffer toAppendTo, FieldPosition pos)
2. formatToCharacterIterator(Object obj)
3. parseObject (String source, ParsePosition pos)

이러한 일반적인 메서드에의해 객체의 다양한 해석과 포맷이 가능하게 됩니다. 이러한 메서드는 MessageFormat 등에 의해 사용됩니다. 서브 클래스는 많은 경우, 특정의 입력 타입을 위한 추가의 format 메서드나 특정의 결과 타입을 위한 parse 메서드도 제공합니다. ParsePosition인수를 취하지 않는 parse는 요구된 포맷의 텍스트가 입력 텍스트의 선두에 없는 경우, ParseException을 Throw 합니다.

대부분의 서브 클래스에는 또한 아래의 팩토리 메서드가 구현됩니다.

1. getInstance는 현재의 로케일에 적절한 편리한 포맷 객체를 취득하기 위한 것입니다.
2. getInstance(Locale)는 지정된 로케일에 적절한 편리한 포맷 객체를 취득하기 위한 것입니다.

또, 서브 클래스에 따라서는 또한 특수한 제어를 위해서 다른 getXxxxInstance 메서드를 구현하는 경우도 있습니다. 예를 들어, NumberFormat 클래스에는 특수한 숫자 포매터를 얻기 위한 getPercentInstance 및 getCurrencyInstance 메서드가 있습니다.

로케일용의 객체를 프로그래머가 생성할 수 있도록 하는 경우 (getInstance(Locale) 등)는 Format 서브 클래스에 또한 다음의 클래스 메서드의 구현이 필요합니다.

 public static Locale[] getAvailableLocales()
 

마지막으로 서브 클래스에는 포맷된 다양한 출력 필드를 식별하기 위해서 1 조의 정수를 정의할 수 있습니다 . 이러한 정수는 FieldPosition 객체를 작성하기 위해서 사용됩니다. 이 객체는 포맷된 결과에서의 필드의 정보와 그 위치를 식별합니다. 이러한 정수의 이름은, item_FIELD가 아니면 안됩니다. item는 그 필드를 나타냅니다. 이러한 정수의 예에 대해서는 DateFormat ERA_FIELD 등을 참조하십시오.

동기

포맷은 동기화 되지 않습니다. thread 마다 다른 포맷 인스턴스를 작성하는 것을 추천합니다. 복수의 thread가 포맷에 동시에 액세스 하는 경우는 외부적으로 동기화할 필요가 있습니다.

관련 항목:

ParsePosition, FieldPosition, NumberFormat, DateFormat, MessageFormat, 직렬화 된 형식

중첩(Nested) 클래스 개요

static class

Format.Field Format.formatToCharacterIterator로 부터 리턴된 AttributedCharacterIterator 내의 속성 키 및 FieldPosition 내의 필드 식별자로서 사용하는 정수를 정의합니다.

생성자 개요

Format ()

메서드 개요

Object	clone () 이 객체의 복사본을 작성해, 리턴합니다.
String	format (Object obj) 객체를 포맷의해 캐릭터 라인을 작성합니다.
abstract StringBuffer	format (Object obj, StringBuffer toAppendTo, FieldPosition pos) 객체를 포맷 해, 지정된 캐릭터 라인 버퍼에 결과의 텍스트를 추가합니다.
AttributedCharacterIterator	formatToCharacterIterator (Object obj) Object를 포맷 해, AttributedCharacterIterator를 생성합니다.
Object	parseObject (String source) 지정된 캐릭터 라인의 선두로부터 텍스트를 해석해 객체를 생성합니다.
abstract Object	parseObject (String source, ParsePosition pos) 캐릭터 라인으로부터 텍스트를 해석해 객체를 생성합니다.

클래스 java.lang. Object 로부터 상속된 메서드

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

생성자 상세

Format

public Format()

메서드의 상세

format

public final String  format(Object  obj)

객체를 포맷의해 캐릭터 라인을 작성합니다. 이것은 다음과 동등합니다.

format (obj, new StringBuffer(), new FieldPosition(0)). toString();

파라미터:

obj - 포맷 하는 객체

반환값:

포맷된 캐릭터 라인

예외:

IllegalArgumentException - 지정된 객체를 Format 로 포맷 할 수 없는 경우

format

public abstract StringBuffer  format(Object  obj,
                                    StringBuffer  toAppendTo,
                                    FieldPosition  pos)

객체를 포맷 해, 지정된 캐릭터 라인 버퍼에 결과의 텍스트를 추가합니다. pos인수가 포맷에 의해 사용되는 필드를 식별하는 경우는 그 인수의 인덱스는 최초로 검출된 필드의 개시와 종료로 설정됩니다.

파라미터:

obj - 포맷 하는 객체

toAppendTo - 텍스트를 추가하는 위치

pos - 포맷된 텍스트내의 필드를 식별하는 FieldPosition

반환값:

toAppendTo로 서 건네받는 캐릭터 라인 버퍼. 포맷된 텍스트가 추가된다

예외:

NullPointerException - toAppendTo 또는 pos가 null인 경우

IllegalArgumentException - 지정된 객체를 Format 로 포맷 할 수 없는 경우

formatToCharacterIterator

public AttributedCharacterIterator  formatToCharacterIterator(Object  obj)

Object를 포맷 해, AttributedCharacterIterator를 생성합니다. 리턴된 AttributedCharacterIterator를 사용하면, 결과의 String를 구축할 수 있는 것과 동시에 결과의 String에 대한 정보를 판정할 수 있습니다.

AttributedCharacterIterator 각 속성 키는 Field 형입니다. AttributedCharacterIterator 내의 각 속성에 대한 정당한 값의 정의는 각각의 Format 구현에 의존합니다만, 보통, 속성 키는 속성값라고 해도 사용됩니다.

디폴트의 구현에서는 속성 없음의 AttributedCharacterIterator가 생성됩니다. 필드를 지원하는 서브 클래스는 이것을 오버라이드(override) 해, 유효한 속성을 가지는 AttributedCharacterIterator를 생성합니다.

파라미터:

obj - 포맷 하는 객체

반환값:

포맷된 값을 설명하는 AttributedCharacterIterator

예외:

NullPointerException - obj가 null인 경우

IllegalArgumentException - 지정된 객체를 Format 로 포맷 할 수 없는 경우

도입된 버전 :

1.4

parseObject

public abstract Object  parseObject(String  source,
                                   ParsePosition  pos)

캐릭터 라인으로부터 텍스트를 해석해 객체를 생성합니다.

메서드는 pos에 의해 지정된 인덱스를 개시 위값으로 텍스트의 해석을 시도합니다. 해석이 완료하면, pos 인덱스는 사용된 마지막 문자 (해석에서는 캐릭터 라인의 끝까지의 모든 문자를 사용한다고는 할 수 없다)의 뒤의 인덱스에 갱신되어 해석된 객체가 리턴됩니다 . 갱신된 pos는 이 메서드의 다음의 호출의 개시점을 나타내는데 사용할 수 있습니다. 에러가 발생했을 경우는 pos 인덱스는 변경되지 않고, 에러가 발생한 문자의 인덱스에 pos 에러 인덱스가 설정되어 null이 리턴됩니다 .

파라미터:

source - 부분적으로 해석되는 String

pos - 상기의 인덱스 및 에러 인덱스 정보를 가지는 ParsePosition 객체

반환값:

캐릭터 라인으로부터 해석된 Object. 에러의 경우는 null

예외:

NullPointerException - pos가 null인 경우

parseObject

public Object  parseObject(String  source)
                   throws ParseException 

지정된 캐릭터 라인의 선두로부터 텍스트를 해석해 객체를 생성합니다. 메서드는 지정된 캐릭터 라인의 텍스트 전체에 사용되지 않는 경우도 있습니다.

파라미터:

source - 선두가 해석되는 String

반환값:

캐릭터 라인으로부터 해석되는 Object

예외:

ParseException - 지정된 캐릭터 라인의 선두를 해석할 수 없는 경우

clone

public Object  clone()

이 객체의 복사본을 작성해, 리턴합니다.

오버라이드(override):

클래스 Object 내의 clone

반환값:

이 인스턴스의 복제

관련 항목:

Cloneable