Encoder (Java Platform SE 6) - xrath.com 에서 번역됨

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드

## 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` - 스트림에 기입해지는 식

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.