javax.activation
인터페이스 DataContentHandler

public interface DataContentHandler

DataContentHandler 인터페이스는, Transferable 인터페이스의 DataHandler 의 구현의 기능을 확장하기 위한 객체에 의해 구현됩니다. DataContentHandlers 를 개입시켜, 스트림이 객체에 변환되거나 객체가 스트림에 기입해지거나 하도록(듯이), 시스템를 확장할 수 있습니다.

어플리케이션에서는 일반적으로, DataContentHandler 의 메소드를 직접 호출하는 것이 아니라, DataHandler 내에 있는 동등의 메소드를 호출합니다. DataHandler 는, 현재의 DataContentHandlerFactory 를 사용해 그 MIME 타입에 대응하는 적절한 DataContentHandler 를 찾아 내려고 합니다. 그리고, DataContentHandler 의 메소드를 호출합니다.

도입된 버젼:

1.6

메소드의 개요

Object	getContent (DataSource ds) 가장 적합한 형식의 데이터를 나타내는 객체를 돌려줍니다.
Object	getTransferData (DataFlavor df, DataSource ds) 전송 되는 데이터를 나타내는 객체를 돌려줍니다.
DataFlavor []	getTransferDataFlavors () 데이터를 제공할 수가 있는 후레이바를 나타내는 DataFlavor 객체의 배열을 돌려줍니다.
void	writeTo (Object obj, String mimeType, OutputStream os) 지정된 MIME 타입의 바이트 스트림에 객체를 변환해, 출력 스트림에 써냅니다.

메소드의 상세

getTransferDataFlavors

DataFlavor [] getTransferDataFlavors()

데이터를 제공할 수가 있는 후레이바를 나타내는 DataFlavor 객체의 배열을 돌려줍니다. 배열은, 데이터 제공을 위한 우선 설정에 따라 (가장 자세하게 기술되고 있는 것으로부터, 그렇지 않은 것에) 순서 붙이고 되지 않으면 안됩니다.

반환값:

DataFlavor

getTransferData

Object  getTransferData(DataFlavor  df,
                       DataSource  ds)
                       throws UnsupportedFlavorException ,
                              IOException 

전송 되는 데이터를 나타내는 객체를 돌려줍니다. 반환되는 객체의 클래스는, 후레이바의 표현 클래스에서 정의됩니다.

파라미터:

df - 요구된 타입을 나타내는 DataFlavor

ds - 변환되는 데이터를 나타내는 DataSource

반환값:

구축된 Object

예외:

UnsupportedFlavorException - 요구된 후레이바를 핸들러가 지원하지 않는 경우

IOException - 데이터에 액세스 할 수 없는 경우

getContent

Object  getContent(DataSource  ds)
                  throws IOException 

무엇보다 적합한 형식의 데이터를 나타내는 객체를 돌려줍니다. 일반적으로, 이것은 getTransferDataFlavors 메소드에 의해 반환된 최초의 DataFlavor 로 기술된 형식이 됩니다.

파라미터:

ds - 변환되는 데이터를 나타내는 DataSource

반환값:

구축된 Object

예외:

IOException - 데이터에 액세스 할 수 없는 경우

writeTo

void writeTo(Object  obj,
             String  mimeType,
             OutputStream  os)
             throws IOException 

지정된 MIME 타입의 바이트 스트림에 객체를 변환해, 출력 스트림에 써냅니다.

파라미터:

obj - 변환되는 객체

mimeType - 생성되는 바이트 스트림의 MIME 타입

os - 변환된 바이트 스트림을 기입하는 출력 스트림

예외:

IOException - 스트림에의 기입해 때에 발생한 에러