javax.crypto
클래스 CipherInputStream

java.lang.Object 
  java.io.InputStream 
      java.io.FilterInputStream 
          javax.crypto.CipherInputStream

모든 구현된 인터페이스:

Closeable

public class CipherInputStream
extends FilterInputStream 

CipherInputStream는 InputStream와 Cipher 로 구성되어 있으므로 read() 메서드는 기본이 되는 InputStream 로부터 읽힌 데이터를 리턴합니다만, Cipher에 의해 추가의 처리를 하고 있습니다. Cipher는 완전하게 초기화하지 않으면, CipherInputStream 로 사용할 수 없습니다.

예를 들어 Cipher가 복호화용으로 초기화되고 있으면, CipherInputStream는 복호화 된 데이터를 돌려주기 전에 데이터를 읽기 복호화 하려고 합니다.

이 클래스는 상위 클래스 java.io.FilterInputStream 및 java.io.InputStream 시멘틱스, 특히 실패 시멘틱스에 엄밀하게 따릅니다. 이 클래스에서는 그러한 메서드는 상위 클래스에서 엄밀하게 지정되고 있어 모두 오버라이드(override) 됩니다. 게다가 이 클래스는 상위 클래스에서 Throw 되지 않는 모든 예외를 캐치 합니다. 특히, skip 메서드는 스킵을 실시해, available 메서드는 캡슐화된 Cipher에 의해 처리된 데이터만을 카운트 합니다.

이 클래스를 사용하는 프로그래머는 이 클래스에서 정의되어 있지 않은 메서드, 또는 오버라이드(override)되어 있지 않은 메서드 (새로운 메서드나, 나중에 슈퍼 클래스의 1개에 추가되는 생성자 등)를 절대로 사용하지 말아 주세요. 그러한 메서드의 설계와 구현에서는 CipherInputStream에 관한 보안상의 영향이 고려되어 있지 않을 가능성이 있기 때문에입니다.

도입된 버전 :

1.4

관련 항목:

InputStream, FilterInputStream, Cipher, CipherOutputStream

필드 개요

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

in

생성자 개요

protected	CipherInputStream (InputStream is) InputStream 로부터 Cipher를 지정하지 않고 CipherInputStream를 구축합니다.
	CipherInputStream (InputStream is, Cipher c) InputStream 및 Cipher 로부터 CipherInputStream를 구축합니다.

메서드 개요

int	available () 블록 하지 않고 이 입력 스트림로부터 읽어들일 수 있는 바이트수를 리턴합니다.
void	close () 이 입력 스트림을 닫아, 그 스트림에 관련된 모든 system resource를 해방합니다.
boolean	markSupported () 이 입력 스트림이, mark 메서드와 reset 메서드를 지원 하고 있을지 어떨지를 판정합니다.
int	read () 이 입력 스트림로부터, 데이터의 다음의 바이트를 읽어들입니다.
int	read (byte[] b) 최대 b.length 바이트까지의 데이터를, 이 입력 스트림로부터 바이트 배열에 읽어들입니다.
int	read (byte[] b, int off, int len) 이 입력 스트림로부터 len 바이트까지의 데이터를 바이트의 배열에 읽어들입니다.
long	skip (long n) 블록 하지 않고 이 입력 스트림로부터 읽어들일 수 있는 바이트로부터 n 바이트의 입력을 스킵 합니다.

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

mark, reset

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

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

생성자 상세

CipherInputStream

public CipherInputStream(InputStream  is,
                         Cipher  c)

InputStream 및 Cipher 로부터 CipherInputStream를 구축합니다.
주: 지정된 입력 스트림 또는 암호가 null인 경우, 나중에 이것들을 사용할 경우에 NullPointerException가 발생되는 일이 있습니다.

파라미터:

is - 처리되는 입력 스트림

c - 초기화된 Cipher 객체

CipherInputStream

protected CipherInputStream(InputStream  is)

InputStream 로부터 Cipher를 지정하지 않고 CipherInputStream를 구축합니다. 이것은 NullCipher를 사용해 CipherInputStream를 구축하는 효과를 가집니다.
주: 지정된 입력 스트림이 null인 경우, 나중에 그것을 사용할 경우에 NullPointerException가 발생되는 일이 있습니다.

파라미터:

is - 처리되는 입력 스트림

메서드의 상세

read

public int read()
         throws IOException 

이 입력 스트림로부터, 데이터의 다음의 바이트를 읽어들입니다. 그 바이트는 0 ~ 255 범위의 int로 서 리턴됩니다 . 스트림의 마지막에 이르러 바이트가 없는 경우는 값 -1 이 리턴됩니다 . 이 메서드는 입력 데이터가 읽히게 되는지, 스트림의 마지막이 검출되는지, 또는 예외가 Throw 될 때까지 블록 합니다.

오버라이드(override):

클래스 FilterInputStream 내의 read

반환값:

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

예외:

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

도입된 버전 :

JCE1. 2

관련 항목:

FilterInputStream.in

read

public int read(byte[] b)
         throws IOException 

최대 b.length 바이트까지의 데이터를, 이 입력 스트림로부터 바이트 배열에 읽어들입니다.

InputStream read 메서드는 인수 b, 0 및 b.length를 지정해 3개의 인수를 취하는 read 메서드를 호출합니다.

오버라이드(override):

클래스 FilterInputStream 내의 read

파라미터:

b - 데이터의 read처의 버퍼

반환값:

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

예외:

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

도입된 버전 :

JCE1. 2

관련 항목:

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

read

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

이 입력 스트림로부터 len 바이트까지의 데이터를 바이트의 배열에 읽어들입니다. 이 메서드는 일부의 입력 데이터를 얻을 수 있게 될 때까지 블록 합니다. 최초의 인수가 null인 경우는 len 까지의 바이트가 읽힌 뒤 폐기됩니다.

오버라이드(override):

클래스 FilterInputStream 내의 read

파라미터:

b - 데이터의 read처의 버퍼

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

len - 읽히는 최대 바이트수

반환값:

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

예외:

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

도입된 버전 :

JCE1. 2

관련 항목:

InputStream.read()

skip

public long skip(long n)
          throws IOException 

블록 하지 않고 이 입력 스트림로부터 읽어들일 수 있는 바이트로부터 n 바이트의 입력을 스킵 합니다.

스킵 되는 바이트가 요구된 바이트보다 적은 경우가 있습니다. 실제로 스킵 된 바이트수는 n 또는 available를 호출한 결과의 쳐 작은 (분)빌트인니다. n가 제로보다 작은 경우, 바이트는 스킵 되지 않습니다.

실제로 스킵 된 바이트수가 리턴됩니다 .

오버라이드(override):

클래스 FilterInputStream 내의 skip

파라미터:

n - 스킵 하는 바이트수

반환값:

실제로 스킵 된 바이트수

예외:

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

도입된 버전 :

JCE1. 2

available

public int available()
              throws IOException 

블록 하지 않고 이 입력 스트림로부터 읽어들일 수 있는 바이트수를 리턴합니다. InputStream available 메서드는 0을 리턴합니다. 이 메서드는 서브 클래스에서 오버라이드(override) 할필요가 있습니다.

오버라이드(override):

클래스 FilterInputStream 내의 available

반환값:

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

예외:

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

도입된 버전 :

JCE1. 2

관련 항목:

FilterInputStream.in

close

public void close()
           throws IOException 

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

CipherInputStream close 메서드가 기본이 되는 입력 스트림의 close 메서드를 호출합니다.

정의:

인터페이스 Closeable 내의 close

오버라이드(override):

클래스 FilterInputStream 내의 close

예외:

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

도입된 버전 :

JCE1. 2

관련 항목:

FilterInputStream.in

markSupported

public boolean markSupported()

이 입력 스트림이, mark 메서드와 reset 메서드를 지원 하고 있을지 어떨지를 판정합니다. 이러한 메서드는 지원 되지 않습니다.

오버라이드(override):

클래스 FilterInputStream 내의 markSupported

반환값:

이 클래스는 mark 메서드와 reset 메서드를 지원 하고 있지 않았기 때문에 false

도입된 버전 :

JCE1. 2

관련 항목:

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