javax.swing
클래스 ProgressMonitorInputStream

java.lang.Object 
  |
  +--java.io.InputStream 
        |
        +--java.io.FilterInputStream 
              |
              +--javax.swing.ProgressMonitorInputStream

public class ProgressMonitorInputStream

extends FilterInputStream

InputStream 로부터의 읽을 진척을 감시합니다. 이 ProgressMonitor 는 통상, 다음과 같은 형식에서 불려 갑니다.

InputStream in = new BufferedInputStream(
new ProgressMonitorInputStream(
parentComponent,
"Reading " + fileName,
new FileInputStream(fileName)));

이것에 의해, 입력 스트림의 읽을 진척을 감시하는 진척 모니터가 작성됩니다. 당분간 시간이 걸리는 경우에는 ProgressDialog 가 표시되어 유저에게 통지합니다. 유저가 「취소 (Cancel)」버튼을 누르면(자), 다음의 read로 InterruptedIOException 가 슬로우 됩니다. 스트림이 닫으면(자), 적절한 클린 업이 모두 실행됩니다.

예 및 자세한 것은 「The Java Tutorial」의「How to Monitor Progress」를 참조해 주세요.

관련 항목:

ProgressMonitor , JOptionPane

필드의 개요

클래스 java.io. FilterInputStream 에서 상속받은 필드

in

생성자의 개요

ProgressMonitorInputStream (Component parentComponent, Object message, InputStream in)
입력 스트림의 진척을 감시하는 오브젝트를 구축합니다.

메소드의 개요

void	close () FilterInputStream.close 를 오버라이드(override) 해, 스트림과 진척 모니터의 양쪽 모두를 닫을 수가 있게 합니다.
ProgressMonitor	getProgressMonitor () 이 스트림에 의해 사용되고 있는 ProgressMonitor 오브젝트를 돌려줍니다.
int	read () FilterInputStream.read 를 오버라이드(override) 해, 읽을 나중에 진척 모니터를 갱신할 수 있게 합니다.
int	read (byte[] b) FilterInputStream.read 를 오버라이드(override) 해, 읽을 나중에 진척 모니터를 갱신할 수 있게 합니다.
int	read (byte[] b, int off, int len) FilterInputStream.read 를 오버라이드(override) 해, 읽을 나중에 진척 모니터를 갱신할 수 있게 합니다.
void	reset () FilterInputStream.reset 를 오버라이드(override) 해, 스트림과 진척 모니터의 양쪽 모두를 리셋트 할 수 있게 합니다.
long	skip (long n) FilterInputStream.skip 를 오버라이드(override) 해, 스킵의 후에 진척 모니터를 갱신할 수 있게 합니다.

클래스 java.io. FilterInputStream 에서 상속받은 메소드

available , mark , markSupported

클래스 java.lang. Object 에서 상속받은 메소드

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

생성자의 상세

ProgressMonitorInputStream

public ProgressMonitorInputStream(Component  parentComponent,
                                  Object  message,
                                  InputStream  in)

입력 스트림의 진척을 감시하는 오브젝트를 구축합니다.

파라미터:

message - 다이알로그 박스가 표시되는 경우는 그 다이알로그 박스에 배치되는 설명적인 텍스트

parentComponent - 감시하고 있는 처리를 실행하는 컴퍼넌트

in - 감시하는 입력 스트림

메소드의 상세

getProgressMonitor

public ProgressMonitor  getProgressMonitor()

이 스트림에 의해 사용되고 있는 ProgressMonitor 오브젝트를 돌려줍니다. 파일의 읽어들여 도중에 설명 텍스트를 변경하거나 할 필요가 없는 한, 통상 이 메소드는 필요 없습니다.

반환값:

이 오브젝트에 의해 사용되는 ProgressMonitor 오브젝트

read

public int read()
         throws IOException 

FilterInputStream.read 를 오버라이드(override) 해, 읽을 나중에 진척 모니터를 갱신할 수 있게 합니다.

오버라이드(override):

클래스 FilterInputStream 내의 read

반환값:

데이터의 다음의 바이트. 스트림의 마지막에 이르렀을 경우는 -1

예외:

IOException - 입출력 에러가 발생했을 경우

관련 항목:

FilterInputStream.in

read

public int read(byte[] b)
         throws IOException 

FilterInputStream.read 를 오버라이드(override) 해, 읽을 나중에 진척 모니터를 갱신할 수 있게 합니다.

오버라이드(override):

클래스 FilterInputStream 내의 read

파라미터:

b - 데이터의 read처의 버퍼

반환값:

버퍼에 읽힌 바이트의 합계수. 스트림의 마지막에 이르러 데이터가 없는 경우는 -1

예외:

IOException - 입출력 에러가 발생했을 경우

관련 항목:

FilterInputStream.read(byte[], int, int)

read

public int read(byte[] b,
                int off,
                int len)
         throws IOException 

FilterInputStream.read 를 오버라이드(override) 해, 읽을 나중에 진척 모니터를 갱신할 수 있게 합니다.

오버라이드(override):

클래스 FilterInputStream 내의 read

파라미터:

b - 데이터의 read처의 버퍼

off - 데이터의 개시 오프셋(offset)

len - 읽히는 최대 바이트수

반환값:

버퍼에 읽힌 바이트의 합계수. 스트림의 마지막에 이르러 데이터가 없는 경우는 -1

예외:

IOException - 입출력 에러가 발생했을 경우

관련 항목:

FilterInputStream.in

skip

public long skip(long n)
          throws IOException 

FilterInputStream.skip 를 오버라이드(override) 해, 스킵의 후에 진척 모니터를 갱신할 수 있게 합니다.

오버라이드(override):

클래스 FilterInputStream 내의 skip

파라미터:

n - 스킵 하는 바이트수

반환값:

실제로 스킵 된 바이트수

예외:

IOException - 입출력 에러가 발생했을 경우

close

public void close()
           throws IOException 

FilterInputStream.close 를 오버라이드(override) 해, 스트림과 진척 모니터의 양쪽 모두를 닫을 수가 있게 합니다.

오버라이드(override):

클래스 FilterInputStream 내의 close

예외:

IOException - 입출력 에러가 발생했을 경우

관련 항목:

FilterInputStream.in

reset

public void reset()
           throws IOException 

FilterInputStream.reset 를 오버라이드(override) 해, 스트림과 진척 모니터의 양쪽 모두를 리셋트 할 수 있게 합니다.

오버라이드(override):

클래스 FilterInputStream 내의 reset

예외:

IOException - 스트림에 마크가 설정되어 있지 않았던 경우, 또는 마크가 무효가 되어 있었을 경우

관련 항목:

FilterInputStream.in , FilterInputStream.mark(int)