java.io
클래스 FileInputStream

java.lang.Object 
  java.io.InputStream 
      java.io.FileInputStream

모든 구현된 인터페이스:

Closeable

public class FileInputStream
extends InputStream 

FileInputStream는 파일 시스템의 파일로부터 입력 바이트를 취득합니다. 어느 파일이 유효한가는 호스트 환경에 의존합니다.

FileInputStream는 원시바이트 (이미지 데이터등)의 스트림을 읽어들일 때 사용합니다. 문자의 스트림을 읽어들일 때는 FileReader를 사용해 주세요.

도입된 버전 :

JDK1. 0

관련 항목:

File, FileDescriptor, FileOutputStream

생성자 개요

FileInputStream (File file)
파일 시스템의 실제의 파일 (File 객체 file에 의해 지정)에 접속하는 것으로써, FileInputStream를 작성합니다.

FileInputStream (FileDescriptor fdObj)
파일 시스템의 실제의 파일에의 기존의 접속을 나타내는 파일 기술자 fdObj를 사용해, FileInputStream를 작성합니다.

FileInputStream (String name)
파일 시스템의 실제의 파일 (패스명 name에 의해 지정)에 접속하는 것으로써, FileInputStream를 작성합니다.

메서드 개요

int	available () 블록 하지 않고 파일 입력 스트림로부터 읽어들일 수 있는 바이트수를 리턴합니다.
void	close () 파일 입력 스트림을 닫아 이 스트림에 관련된 system resource를 해방합니다.
protected void	finalize () 파일 입력 스트림에의 참조가 존재하지 않게 되었을 때에 이 스트림의 close 메서드가 확실히 호출되도록 합니다.
FileChannel	getChannel () 이 파일 입력 스트림에 관련된, 하나의 FileChannel 객체를 리턴합니다.
FileDescriptor	getFD () 이 FileInputStream에 사용되고 있는 파일 시스템의 실제의 파일에의 접속을 나타내는 FileDescriptor 객체를 리턴합니다.
int	read () 입력 스트림로부터 1 바이트를 읽어들입니다.
int	read (byte[] b) 입력 스트림로부터 최대 b.length 바이트를 바이트 배열에 읽어들입니다.
int	read (byte[] b, int off, int len) 입력 스트림로부터 바이트 배열에 최대 len 바이트의 데이터를 읽어들입니다.
long	skip (long n) 입력 스트림로부터 n 바이트 분의 데이터를 스킵 해, 이 데이터를 파기합니다.

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

mark, markSupported, reset

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

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

생성자 상세

FileInputStream

public FileInputStream(String  name)
                throws FileNotFoundException 

파일 시스템의 실제의 파일 (패스명 name에 의해 지정)에 접속하는 것으로써, FileInputStream를 작성합니다. 이 파일의 접속을 나타내기 위해서 새로운 FileDescriptor 객체가 생성됩니다.

우선, 시큐러티 매니저가 존재하는 경우, checkRead 메서드가 name인수를 인수로서 호출합니다.

지정된 파일이 존재하지 않는지, 보통 파일은 아니고 디렉토리인지, 또는 어떠한 이유로써 열릴 수가 없는 경우는 FileNotFoundException가 발생 됩니다.

파라미터:

name - 시스템에 존재하는 파일명

예외:

FileNotFoundException - 파일이 존재하지 않는지, 보통 파일은 아니고 디렉토리인지, 또는 어떠한 이유로써 열릴 수가 없는 경우

SecurityException - 시큐러티 매니저가 존재해, checkRead 메서드가 파일에의 읽기 액세스를 거부하는 경우

관련 항목:

SecurityManager.checkRead(java.lang.String)

FileInputStream

public FileInputStream(File  file)
                throws FileNotFoundException 

파일 시스템의 실제의 파일 (File 객체 file에 의해 지정)에 접속하는 것으로써, FileInputStream를 작성합니다. 이 파일의 접속을 나타내기 위해서 새로운 FileDescriptor 객체가 생성됩니다.

우선, 시큐러티 매니저가 존재하는 경우, checkRead 메서드가file인수에 의해 나타내지는 패스를 인수로서 호출합니다.

지정된 파일이 존재하지 않는지, 보통 파일은 아니고 디렉토리인지, 또는 어떠한 이유로써 열릴 수가 없는 경우는 FileNotFoundException가 발생 됩니다.

파라미터:

file - 읽을 위해 열리는 파일

예외:

FileNotFoundException - 파일이 존재하지 않는지, 보통 파일은 아니고 디렉토리인지, 또는 어떠한 이유로써 열릴 수가 없는 경우

SecurityException - 시큐러티 매니저가 존재해, checkRead 메서드가 파일에의 읽기 액세스를 거부하는 경우

관련 항목:

File.getPath(), SecurityManager.checkRead(java.lang.String)

FileInputStream

public FileInputStream(FileDescriptor  fdObj)

파일 시스템의 실제의 파일에의 기존의 접속을 나타내는 파일 기술자 fdObj를 사용해, FileInputStream를 작성합니다.

시큐러티 매니저가 존재하는 경우, checkRead 메서드가 파일 기술자 fdObj를 인수로서 호출합니다. 이것은 파일 기술자를 읽어들일 수 있을지 어떨지를 확인하기 때문에입니다. 파일 기술자에게로의 읽기 액세스가 거부되었을 경우, SecurityException가 발생 됩니다.

fdObj가 null인 경우는 NullPointerException가 발생 됩니다.

파라미터:

fdObj - 읽을 위해 열리는 파일 기술자

예외:

SecurityException - 시큐러티 매니저가 존재해, checkRead 메서드가 파일 기술자에게로의 읽기 액세스를 거부하는 경우

관련 항목:

SecurityManager.checkRead(java.io.FileDescriptor)

메서드의 상세

read

public int read()
         throws IOException 

입력 스트림로부터 1 바이트를 읽어들입니다. 이 메서드는 유효한 입력이 아직 없는 경우는 블록 합니다.

정의:

클래스 InputStream 내의 read

반환값:

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

예외:

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

read

public int read(byte[] b)
         throws IOException 

입력 스트림로부터 최대 b.length 바이트를 바이트 배열에 읽어들입니다. 이 메서드는 어떠한 입력이 가능하게 될 때까지 블록 합니다.

오버라이드(override):

클래스 InputStream 내의 read

파라미터:

b - 데이터의 read처의 버퍼

반환값:

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

예외:

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

관련 항목:

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

read

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

입력 스트림로부터 바이트 배열에 최대 len 바이트의 데이터를 읽어들입니다. 이 메서드는 입력이 가능하게 될 때까지 블록 합니다.

오버라이드(override):

클래스 InputStream 내의 read

파라미터:

b - 데이터의 read처의 버퍼

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

len - 읽히는 최대 바이트수

반환값:

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

예외:

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

관련 항목:

InputStream.read()

skip

public long skip(long n)
          throws IOException 

입력 스트림로부터 n 바이트 분의 데이터를 스킵 해, 이 데이터를 파기합니다.

skip 메서드는 다양한 이유로써, 소수의 바이트 (0인 경우도 있다)를 스킵 합니다. n가 부의 경우는 InputStream 슈퍼 클래스의 skip 메서드가 아무것도 실시하지 않는 경우에서도, IOException가 발생 됩니다. 실제로 스킵 된 바이트수가 리턴됩니다 .

이 메서드에 의해 스킵 되는 바이트수가 배킹 파일에 남은 바이트수보다 많은 경우가 있습니다. 이 경우 예외는 생성되지 않고, 배킹 파일의 EOF 보다 뒤에 스킵 하는 결과가 됩니다. 이 상태로 스트림로부터 읽어내려고 하면, 파일의 마지막을 나타내는 -1 이 리턴됩니다 .

오버라이드(override):

클래스 InputStream 내의 skip

파라미터:

n - 스킵 하는 바이트수

반환값:

실제로 스킵 된 바이트수

예외:

IOException - n가 부의 경우, 또는 입출력 에러가 발생했을 경우

available

public int available()
              throws IOException 

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

오버라이드(override):

클래스 InputStream 내의 available

반환값:

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

예외:

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

close

public void close()
           throws IOException 

파일 입력 스트림을 닫아 이 스트림에 관련된 system resource를 해방합니다.

이 스트림에 채널을 관련된 인 경우는 그 채널도 닫습니다.

정의:

인터페이스 Closeable 내의 close

오버라이드(override):

클래스 InputStream 내의 close

예외:

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

getFD

public final FileDescriptor  getFD()
                           throws IOException 

이 FileInputStream에 사용되고 있는 파일 시스템의 실제의 파일에의 접속을 나타내는 FileDescriptor 객체를 리턴합니다.

반환값:

이 스트림에 관련된 파일 기술자 객체

예외:

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

관련 항목:

FileDescriptor

getChannel

public FileChannel  getChannel()

이 파일 입력 스트림에 관련된, 하나의 FileChannel 객체를 리턴합니다.

리턴된 채널의 position 초기값 는 그때까지 파일로부터 읽힌 바이트수로 설정됩니다. 이 스트림로부터 바이트를 읽어들일 때마다, 채널의 위값이 증가됩니다. 채널의 위치를 명시적으로 변경했을 경우 또는 바이트의 read에 의해 변경되었을 경우는 이 스트림의 파일 위치도 변경됩니다.

반환값:

이 파일 입력 스트림에 관련된 파일 채널

도입된 버전 :

1.4

finalize

protected void finalize()
                 throws IOException 

파일 입력 스트림에의 참조가 존재하지 않게 되었을 때에 이 스트림의 close 메서드가 확실히 호출되도록 합니다.

오버라이드(override):

클래스 Object 내의 finalize

예외:

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

관련 항목:

close()