java.io
클래스 BufferedInputStream

java.lang.Object 
  java.io.InputStream 
      java.io.FilterInputStream 
          java.io.BufferedInputStream

모든 구현된 인터페이스:

Closeable

public class BufferedInputStream
extends FilterInputStream 

다른 입력 스트림에 몇가지 기능, 특히 입력을 버퍼에 포함하는 기능과 mark, reset메서드를 지원하는 기능을 추가합니다. BufferedInputStream이 생성되면, 내부 버퍼 배열이 작성됩니다. 스트림의 바이트를 읽거나 스킵 하면, 포함되고 있는 입력 스트림로부터 필요에 따라서 한 번에 다수의 바이트가 내부 버퍼에 보충됩니다. mark오퍼레이션은 입력 스트림의 특정 위치를 기억합니다. reset오퍼레이션은 포함되고 있는 입력 스트림의 위치를 마지막에 mark의 위치에 재설정합니다.

도입된 버전 :

JDK1. 0

필드 개요

protected byte[]	buf 데이터를 포함하는 내부 버퍼 배열입니다.
protected int	count 버퍼중의 마지막 유효 바이트 인덱스보다 1개 큰 수치를 가지는 인덱스입니다.
protected int	marklimit mark 메서드가 불려가 한편, 후속의 reset 메서드가 실패하기 전 상태로 예측 가능한 최대수입니다.
protected int	markpos 마지막에 mark 메서드가 불려 갔을 때의 pos 필드의 값입니다.
protected int	pos 버퍼의 현재 위치입니다.

클래스 java.io. FilterInputStream 로부터 상속된 필드

in

생성자 개요

BufferedInputStream (InputStream in)
BufferedInputStream를 작성해, 그 인수인 입력 스트림 in을 나중에 사용할 수 있도록 저장합니다.

BufferedInputStream (InputStream in, int size)
지정된 버퍼 사이즈를 가지는 BufferedInputStream를 작성해, 그 인수인 입력 스트림 in을 나중에 사용할 수 있도록 저장합니다.

메서드 개요

int	available () 블록 하지 않고 입력 스트림로부터 읽어들일 수 있는 바이트수를 리턴합니다.
void	close () 이 입력 스트림을 닫아, 그 스트림에 관련된 모든 system resource를 해방합니다.
void	mark (int readlimit) InputStream mark 메서드의 범용 규약을 참조하십시오.
boolean	markSupported () 입력 스트림이 mark와 reset 메서드를 지원하고 있을까 어떻게를 조사합니다.
int	read () InputStream read 메서드의 범용 규약을 참조하십시오.
int	read (byte[] b, int off, int len) 이 바이트 입력 스트림로부터 바이트를 읽어내, 지정된 바이트 배열로 지정의 오프셋(offset)로부터 삽입합니다.
void	reset () InputStream reset 메서드의 범용 규약을 참조하십시오.
long	skip (long n) InputStream skip 메서드의 범용 규약을 참조하십시오.

클래스 java.io. FilterInputStream 로부터 상속된 메서드

read

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

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

필드의 상세

buf

protected volatile byte[] buf

데이터를 포함하는 내부 버퍼 배열입니다. 필요에 따라서, 다른 사이즈외의 배열로 옮겨놓을 수 있습니다.

count

protected int count

버퍼중의 마지막 유효 바이트 인덱스보다 1개 큰 수치를 가지는 인덱스입니다. 이 값의 범위는 항상 0 ~ buf.length 입니다. 요소 buf[0] ~ buf[count-1]에는 기본이 되는 입력 스트림로부터 취득되어 버퍼에 포함되고 있는 입력 데이터가 들어갑니다.

pos

protected int pos

버퍼의 현재 위치입니다. buf 배열의, 다음에 읽히는 문자 데이터의 인덱스입니다.

이 값의 범위는 항상 0 ~ count 입니다. 이 값이 count 보다 작은 경우, 입력되는 다음의 바이트는 buf[pos] 입니다. count에 동일한 경우, 다음의 read 오퍼레이션 또는 skip 오퍼레이션은 포함되고 있는 입력 스트림로부터 이 이후의 바이트를 읽어들일 필요가 있습니다.

관련 항목:

buf

markpos

protected int markpos

마지막에 mark 메서드가 불려 갔을 때의 pos 필드의 값입니다.

이 값의 범위는 항상 -1 ~ pos 입니다. 입력 스트림에 마크 위값이 없는 경우, 이 필드는 -1 입니다. 입력 스트림에 마크 위값이 있는 경우, reset 오퍼레이션의 실행 후에 입력되는 최초의 바이트는 buf[markpos] 입니다. markpos가 -1가 아닌 경우, buf[markpos] ~ buf[pos-1] 위치에 있는 모든 바이트는 버퍼 배열에 남아 있지 않으면 안됩니다 (다만, count, pos, markpos값에 적절한 조정을 베풀면, 버퍼 배열내의 다른 위치로 이동할 수 있다). pos와 markpos 차이가 marklimit를 넘지 않는 한, 이러한 바이트는 파기되지 않습니다.

관련 항목:

mark(int), pos

marklimit

protected int marklimit

mark 메서드가 불려가 한편, 후속의 reset 메서드가 실패하기 전 상태로 예측 가능한 최대수입니다. pos와 markpos 차이가 marklimit를 넘으면, markpos가 -1로 설정되어 마크는 파기됩니다.

관련 항목:

mark(int), reset()

생성자 상세

BufferedInputStream

public BufferedInputStream(InputStream  in)

BufferedInputStream를 작성해, 그 인수인 입력 스트림 in을 나중에 사용할 수 있도록 저장합니다. 내부 버퍼 배열이 작성되어buf에 포함됩니다.

파라미터:

in - 기본이 되는 입력 스트림

BufferedInputStream

public BufferedInputStream(InputStream  in,
                           int size)

지정된 버퍼 사이즈를 가지는 BufferedInputStream를 작성해, 그 인수인 입력 스트림 in을 나중에 사용할 수 있도록 저장합니다. 길이 size 내부 버퍼 배열이 작성되어buf에 포함됩니다.

파라미터:

in - 기본이 되는 입력 스트림

size - 버퍼 사이즈

예외:

IllegalArgumentException - size가 0 아래의 경우

메서드의 상세

read

public int read()
         throws IOException 

InputStream read 메서드의 범용 규약을 참조하십시오.

오버라이드(override):

클래스 FilterInputStream 내의 read

반환값:

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

예외:

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

관련 항목:

FilterInputStream.in

read

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

이 바이트 입력 스트림로부터 바이트를 읽어내, 지정된 바이트 배열로 지정의 오프셋(offset)로부터 삽입합니다.

이 메서드는 InputStream 클래스의 대응하는 read 메서드의 범용 규약을 구현합니다. 보다 편리하게, 이 메서드는 기본이 되는 스트림의 read 메서드를 반복해 호출해, 가능한 한 많은 바이트수를 읽어들이려고 합니다. 이 read 반복은 아래의 조건의 1개가 true가 될 때까지 행해집니다.

• 지정된 바이트수가 읽혔다
• 기본이 되는 스트림의 read 메서드가 파일의 마지막을 나타내는 -1을 돌려주었다
• 기본이 되는 스트림의 available 메서드가 그 이상의 입력 요구가 블록 되는 것을 나타내는 제로를 돌려주었다

기본이 되는 스트림의 최초의 read가 파일의 마지막을 나타내는 -1을 돌려주면, 이 메서드는 -1을 리턴합니다. 그렇지 않은 경우, 이 메서드는 실제로 읽힌 바이트수를 리턴합니다.

이 클래스의 서브 클래스는 같은 방법으로 가능한 한 많은 바이트수를 읽어들이는 것이 추천 됩니다. 다만, 이것은 필수가 아닙니다.

오버라이드(override):

클래스 FilterInputStream 내의 read

파라미터:

b - 전송처 버퍼

off - 바이트의 포함 개시 오프셋(offset)

len - 읽어들이는 바이트의 최대수

반환값:

읽히는 바이트수. 스트림의 마지막에 이르렀을 경우는 -1

예외:

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

관련 항목:

FilterInputStream.in

skip

public long skip(long n)
          throws IOException 

InputStream skip 메서드의 범용 규약을 참조하십시오.

오버라이드(override):

클래스 FilterInputStream 내의 skip

파라미터:

n - 스킵 하는 바이트수

반환값:

실제로 스킵 된 바이트수

예외:

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

available

public int available()
              throws IOException 

블록 하지 않고 입력 스트림로부터 읽어들일 수 있는 바이트수를 리턴합니다.

BufferedInputStream available 메서드는 버퍼안에 남아 있는 read 가능한 바이트의 총수 (count - pos)를 돌려주고, 기본이 되는 입력 스트림의 available 메서드 호출의 결과를 리턴합니다.

오버라이드(override):

클래스 FilterInputStream 내의 available

반환값:

블록 하지 않고 입력 스트림로부터 읽어들일 수 있는 바이트수

예외:

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

관련 항목:

FilterInputStream.in

mark

public void mark(int readlimit)

InputStream mark 메서드의 범용 규약을 참조하십시오.

오버라이드(override):

클래스 FilterInputStream 내의 mark

파라미터:

readlimit - 마크 위값이 무효가 되기 전에 읽기 가능한 바이트의 최대 리밋트

관련 항목:

reset()

reset

public void reset()
           throws IOException 

InputStream reset 메서드의 범용 규약을 참조하십시오.

markpos가 -1인 (마크가 설정되어 있지 않은지, 마크가 무효로 되고 있다) 경우, IOException가 발생 됩니다. 그렇지 않은 경우, pos는 markpos에 일치하도록 설정됩니다.

오버라이드(override):

클래스 FilterInputStream 내의 reset

예외:

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

관련 항목:

mark(int)

markSupported

public boolean markSupported()

입력 스트림이 mark와 reset 메서드를 지원하고 있을까 어떻게를 조사합니다. BufferedInputStream markSupported 메서드는 true를 리턴합니다.

오버라이드(override):

클래스 FilterInputStream 내의 markSupported

반환값:

이 스트림의 형태가 mark와 reset 메서드를 지원하고 있을지 어떨지를 나타내는 boolean

관련 항목:

InputStream.mark(int), InputStream.reset()

close

public void close()
           throws IOException 

이 입력 스트림을 닫아, 그 스트림에 관련된 모든 system resource를 해방합니다.

정의:

인터페이스 Closeable 내의 close

오버라이드(override):

클래스 FilterInputStream 내의 close

예외:

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

관련 항목:

FilterInputStream.in