java.beans
클래스 Encoder

java.lang.Object 
  java.beans.Encoder

직계의 기존의 서브 클래스:

XMLEncoder

public class Encoder
extends Object 

Encoder 클래스는, 공개 API 에 관해서 복수의 JavaBeans 상태를 encode 하는 파일 또는 스트림을 작성할 때에 사용할 수 있습니다. Encoder 는, 지속적인 위양과 함께, 객체 그래프를 일련의 Statements 와 그것을 작성하는데 사용되는 Expression 로 분해합니다. 일반적으로, 서브 클래스는, 사용자가 읽을 수 있는 서식, 예를 들어 Java 원시 코드나 XML 로서 이러한 식의 구문을 제공합니다.

도입된 버젼:

1.4

생성자 의 개요

Encoder ()

메소드의 개요

Object	get (Object oldInstance) 이 스트림에 의해 작성된, 그 환경에 있어서의 oldInstance 의 시험치를 돌려줍니다.
ExceptionListener	getExceptionListener () 이 스트림의 예외 핸들러를 가져옵니다.
PersistenceDelegate	getPersistenceDelegate (Class <? > type) 지정된 형태의 지속적인 위양을 돌려줍니다.
Object	remove (Object oldInstance) 이 인스턴스의 엔트리를 삭제해, 낡은 엔트리를 돌려줍니다.
void	setExceptionListener (ExceptionListener exceptionListener) 이 스트림의 예외 핸들러를 exceptionListener 로 설정합니다.
void	setPersistenceDelegate (Class <? > type, PersistenceDelegate persistenceDelegate) 이 type 의 지속적인 위양을 persistenceDelegate 로 합니다.
void	writeExpression (Expression oldExp) 구현은, 최초로, 이 값을 가지는 식이 벌써 기입해지고 있는지 어떤지를 확인합니다.
protected void	writeObject (Object o) 지정된 객체를 출력 스트림에 기입합니다.
void	writeStatement (Statement oldStm) 스트림에 oldStm 문을 기입합니다.

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

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

생성자 의 상세

Encoder

public Encoder()

메소드의 상세

writeObject

protected void writeObject(Object  o)

지정된 객체를 출력 스트림에 기입합니다. 직렬화 된 서식은, 일련의 식을 나타냅니다. 식의 편성의 결과, 입력 스트림의 read시에 등가의 객체가 작성됩니다. 디폴트에서는, 객체는 인수 없음의 생성자 (그 상태는 Introspector 가 돌려주는 설정 메소드와 취득 메소드의 조합에 의해 정의된다)을 가지는 JavaBean 가 됩니다.

파라미터:

o - 스트림에 기입해지는 객체

관련 항목:

XMLDecoder.readObject()

setExceptionListener

public void setExceptionListener(ExceptionListener  exceptionListener)

이 스트림의 예외 핸들러를 exceptionListener 로 설정합니다. 이 스트림이 회복 가능한 예외를 캐치 하면(자), 이 예외 핸들러에 통지됩니다.

파라미터:

exceptionListener - 이 스트림의 예외 핸들러. null 의 경우, 디폴트의 예외 청취자가 사용되는

관련 항목:

getExceptionListener()

getExceptionListener

public ExceptionListener  getExceptionListener()

이 스트림의 예외 핸들러를 가져옵니다.

반환값:

이 스트림의 예외 핸들러. 명시적으로 설정되어 있지 않은 경우, 디폴트의 예외 청취자가 반환되는

관련 항목:

setExceptionListener(java.beans.ExceptionListener)

getPersistenceDelegate

public PersistenceDelegate  getPersistenceDelegate(Class <? > type)

지정된 형태의 지속적인 위양을 돌려줍니다. 지속적인 위양은, 다음의 규칙을 올바르게 적용하는 것에 의해 계산됩니다.

• array 형의 경우, 내부의 지속적인 위양이 반환된다. 이 위양은, 적절한 형태 및 길이를 가지는 배열의 인스턴스를 생성해, 개개의 요소를 프로퍼티과 같게 초기화한다
• proxy 형의 경우, 내부의 지속적인 위양이 반환된다. 이 위양은, Proxy 클래스에 정의되고 있는 정적인 newProxyInstance 메소드를 사용해 새로운 프록시의 인스턴스를 생성한다
• 이 형태의 BeanInfo 가 persistenceDelegate 프로퍼티을 정의한 BeanDescriptor 를 가지고 있는 경우, 이 값이 반환된다
• 그 이외의 경우, 디폴트의 지속적인 위양이 반환된다. 이 위양은, 형태가 JavaBean 이다고 본다. 즉, 그 형태가 디폴트의 생성자 을 가져, 그 상태가 Introspector 에 의해 반환되는 설정 메소드와 취득 메소드의 조합에 의해 특색 붙일 수 있는 것을 나타낸다. 디폴트의 생성자 은,ConstructorProperties 주석을 붙일 수 있던, 파라미터의 수가 가장 많은 생성자 입니다. ConstructorProperties 주석을 붙일 수 있었던 생성자 이 없는 경우, 인수 없음의 생성자 (파라미터가 없는 생성자 )이 사용됩니다. 예를 들어 다음의 예에서는,Foo 에서는 인수 없음의 생성자 이 사용되어Bar 에서는 2 개의 파라미터 생성자 이 사용됩니다. public class Foo { public Foo() { ... } public Foo(int x) { ... } } public class Bar { public Bar() { ... }

  파라미터:

  type - 객체의 형태

  반환값:

  이 객체형의 지속적인 위양

  관련 항목:

  setPersistenceDelegate(java.lang.Class, java.beans.PersistenceDelegate) , Introspector.getBeanInfo(java.lang.Class) , BeanInfo.getBeanDescriptor()

setPersistenceDelegate

public void setPersistenceDelegate(Class <? > type,
                                   PersistenceDelegate  persistenceDelegate)

이 type 의 지속적인 위양을 persistenceDelegate 로 합니다.

파라미터:

type - persistenceDelegate 이 적용되는 객체의 클래스

persistenceDelegate - type 의 인스턴스의 지속적인 위양

관련 항목:

getPersistenceDelegate(java.lang.Class) , Introspector.getBeanInfo(java.lang.Class) , BeanInfo.getBeanDescriptor()

remove

public Object  remove(Object  oldInstance)

이 인스턴스의 엔트리를 삭제해, 낡은 엔트리를 돌려줍니다.

파라미터:

oldInstance - 삭제되는 엔트리

반환값:

삭제된 엔트리

관련 항목:

get(java.lang.Object)

get

public Object  get(Object  oldInstance)

이 스트림에 의해 작성된, 그 환경에 있어서의 oldInstance 의 시험치를 돌려줍니다. 지속적인 위양은, 이 값의 초기화에 의해 출력시에 등가 객체를 작성하는지, 혹은 새로운 객체를 인스턴스화할 필요가 있는지 어떤지를,mutatesTo 메소드를 사용하고 판단합니다. 이 값이 스트림에 있어 미지의 값인 경우, 반환값은 null 가 됩니다.

파라미터:

oldInstance - 검색되는 인스턴스

반환값:

미지의 객체의 경우 null

writeStatement

public void writeStatement(Statement  oldStm)

스트림에 oldStm 문을 기입합니다. oldStm 는, 완전하게 호출원의 환경에서 기입해질 필요가 있습니다. 이것은, 타겟과 모든 인수가, 기입해지는 객체 그래프의 일부로 되어 있지 않으면 안 된다고 하는 것입니다. 이러한 식은, 무엇이 일어났는지를 나타내는 일련의 식, 즉, 출력 스트림에 오리지날과 같은 객체 그래프를 생성하는 방법을 나타내는 식이 됩니다.

이 메소드를 구현하면(자), 스트림의 read시에 그 환경내의 식이 되는, 2 번째의 식이 생성됩니다. 이 식을 가져오려면 , 타겟상의 writeObject 와 모든 인수를 호출해, 그 결과를 사용해 새로운 식을 구축합니다.

파라미터:

oldStm - 스트림에 기입해지는 식

writeExpression

public void writeExpression(Expression  oldExp)

구현은, 최초로, 이 값을 가지는 식이 벌써 기입해지고 있는지 어떤지를 확인합니다. 기입해지지 않은 경우는,writeStatement 와 같은 순서로 식이 복제되어writeObject 의 호출에 의해, 복제된 식의 값과 이 식의 값이 조합됩니다.

파라미터:

oldExp - 스트림에 기입해지는 식