java.beans
클래스 Encoder

java.lang.Object 
  |
  +--java.beans.Encoder

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

XMLEncoder

public class Encoder

extends Object

Encoder 클래스는 공개 API 를 사용해 복수의 JavaBeans 상태를 코드화하는 파일 또는 스트림을 작성할 때에 사용됩니다. Encoder 는 지속적인 delegate과 함께, 오브젝트 그래프를 일련의 Statements 와 그것을 작성하는 Expression 로 분해합니다. 통상, 서브 클래스는 유저가 읽을 수 있는 서식, 예를 들어 Java 원시 코드나 XML 로서 이러한 식의 구문을 제공합니다.

도입된 버젼:

1.4

생성자의 개요

Encoder ()

메소드의 개요

Object	get (Object oldInstance) 이 스트림에 의해 작성된, 그 환경에 있어서의 oldInstance 의 시험치를 돌려줍니다.
ExceptionListener	getExceptionListener () 이 스트림의 예외 핸들러를 취득합니다.
PersistenceDelegate	getPersistenceDelegate (Class type) 지정된 형태의 지속적인 delegate을 돌려줍니다.
Object	remove (Object oldInstance) 이 인스턴스의 엔트리를 삭제해, 낡은 엔트리를 돌려줍니다.
void	setExceptionListener (ExceptionListener exceptionListener) 이 스트림의 예외 핸들러를 exceptionListener 로 합니다.
void	setPersistenceDelegate (Class type, PersistenceDelegate persistenceDelegate) 이 type 의 지속적인 delegate을 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)

지정된 오브젝트를 출력 스트림에 기입합니다. 직렬화 된 서식은 일련의 식을 나타냅니다. 식의 편성의 결과, 입력 스트림의 독해시에 등가의 오브젝트가 작성됩니다. 디폴트에서는 오브젝트는 nullary 의 constructor (그 상태는 Introspector 가 돌려주는 set 메소드와 get 메소드의 조합에 의해 정의된다)을 가지는 JavaBean 가 됩니다.

파라미터:

o - 스트림에 기입해지는 오브젝트

관련 항목:

XMLDecoder.readObject()

setExceptionListener

public void setExceptionListener(ExceptionListener  exceptionListener)

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

파라미터:

exceptionListener - 이 스트림의 예외 핸들러

관련 항목:

getExceptionListener()

getExceptionListener

public ExceptionListener  getExceptionListener()

이 스트림의 예외 핸들러를 취득합니다.

반환값:

이 스트림의 예외 핸들러

관련 항목:

setExceptionListener(java.beans.ExceptionListener)

getPersistenceDelegate

public PersistenceDelegate  getPersistenceDelegate(Class  type)

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

• array 형의 경우, 내부의 지속적인 delegate이 돌려주어진다. 이 delegate은 적절한 형태 및 길이를 가지는 배열의 인스턴스를 생성해, 개개의 요소를 프로퍼티와 같게 초기화한다
• proxy 형의 경우, 내부의 지속적인 delegate이 돌려주어진다. 이 delegate은 Proxy 클래스에 정의되고 있는 정적인 newProxyInstance 메소드를 사용해 새로운 프록시의 인스턴스를 생성한다
• 이 형태의 BeanInfo 가 persistenceDelegate 프로퍼티를 정의한 BeanDescriptor 를 가지고 있는 경우, 이 값이 돌려주어진다
• 그 이외의 경우, 디폴트의 지속적인 delegate이 돌려주어진다. 이 delegate은 형태가 JavaBean 이다고 본다. 즉, 그 형태가 nullary 의 constructor를 가져, 그 상태가 Introspector 에 의해 돌려주어지는 set 메소드와 get 메소드의 조합에 의해 특색 붙일 수 있는 것을 나타낸다

파라미터:

type - 오브젝트의 형태

반환값:

이 오브젝트형의 지속적인 delegate

관련 항목:

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

setPersistenceDelegate

public void setPersistenceDelegate(Class  type,
                                   PersistenceDelegate  persistenceDelegate)

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

파라미터:

type - persistenceDelegate 이 적용되는 오브젝트의 클래스

persistenceDelegate - type 의 인스턴스의 지속적인 delegate

관련 항목:

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 의 시험치를 돌려줍니다. 지속적인 delegate은 이 값의 초기화에 의해 출력시에 등가 오브젝트를 작성하는지 혹은 새로운 오브젝트를 인스턴스화할 필요가 있는지 어떤지를,mutatesTo 메소드를 사용하고 판단합니다. 이 값이 스트림에 있어 미지의 값인 경우, 반환값은 null 가 됩니다.

파라미터:

oldInstance - 검색되는 인스턴스

반환값:

미지의 오브젝트의 경우 null

writeStatement

public void writeStatement(Statement  oldStm)

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

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

writeExpression

public void writeExpression(Expression  oldExp)

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

파라미터:

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