java.util.zip
클래스 ZipFile

java.lang.Object 
  java.util.zip.ZipFile

알려진 직계 서브 클래스:

JarFile

public class ZipFile
extends Object 

이 클래스는 ZIP 파일로부터 엔트리를 읽어들이기 위해서 사용합니다.

외로 지정이 없는 경우, null 인수를 생성자, 또는 이 클래스의 메서드에 건네주면 NullPointerException을 발생시킵니다.

필드 개요

static int	CENATT
static int	CENATX
static int	CENCOM
static int	CENCRC
static int	CENDSK
static int	CENEXT
static int	CENFLG
static int	CENHDR
static int	CENHOW
static int	CENLEN
static int	CENNAM
static int	CENOFF
static long	CENSIG
static int	CENSIZ
static int	CENTIM
static int	CENVEM
static int	CENVER
static int	ENDCOM
static int	ENDHDR
static int	ENDOFF
static long	ENDSIG
static int	ENDSIZ
static int	ENDSUB
static int	ENDTOT
static int	EXTCRC
static int	EXTHDR
static int	EXTLEN
static long	EXTSIG
static int	EXTSIZ
static int	LOCCRC
static int	LOCEXT
static int	LOCFLG
static int	LOCHDR
static int	LOCHOW
static int	LOCLEN
static int	LOCNAM
static long	LOCSIG
static int	LOCSIZ
static int	LOCTIM
static int	LOCVER
static int	OPEN_DELETE ZIP 파일을 열어, 삭제의 마크를 붙이는 모드 플래그입니다.
static int	OPEN_READ ZIP 파일을 읽기 용으로 여는 모드 플래그입니다.

생성자 개요

ZipFile (File file)
File 객체로 지정된 ZIP 파일을 읽기 용으로 엽니다.

ZipFile (File file, int mode)
지정된 모드로 지정의 File 객체로부터 읽어내기 위한 새로운 ZipFile를 엽니다.

ZipFile (String name)
ZIP 파일을 읽기 용으로 엽니다.

메서드 개요

void	close () ZIP 파일을 닫습니다.
Enumeration <? extends ZipEntry >	entries () ZIP 파일 엔트리의 열거를 리턴합니다.
protected void	finalize () ZIP 파일에의 참조가 존재하지 않게 되었을 때에 이 ZIP 파일의 close 메서드가 확실히 호출되도록 합니다.
ZipEntry	getEntry (String name) 지정된 이름의 ZIP 파일 엔트리를 리턴합니다.
InputStream	getInputStream (ZipEntry entry) 지정된 ZIP 파일 엔트리의 내용을 읽어들이기 위한 입력 스트림을 리턴합니다.
String	getName () ZIP 파일의 패스명을 리턴합니다.
int	size () ZIP 파일중의 엔트리의 수를 리턴합니다.

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

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

필드의 상세

OPEN_READ

public static final int OPEN_READ

ZIP 파일을 읽기 용으로 여는 모드 플래그입니다.

관련 항목:

정수 필드값

OPEN_DELETE

public static final int OPEN_DELETE

ZIP 파일을 열어, 삭제의 마크를 붙이는 모드 플래그입니다. 파일을 열고 나서 닫기까지 파일이 삭제됩니다만, close 메서드가 호출되는지, 가상 머신이 종료할 때까지, ZipFile 객체에 의해 파일의 내용에 액세스 할 수 있습니다.

관련 항목:

정수 필드값

LOCSIG

public static final long LOCSIG

관련 항목:

정수 필드값

EXTSIG

public static final long EXTSIG

관련 항목:

정수 필드값

CENSIG

public static final long CENSIG

관련 항목:

정수 필드값

ENDSIG

public static final long ENDSIG

관련 항목:

정수 필드값

LOCHDR

public static final int LOCHDR

관련 항목:

정수 필드값

EXTHDR

public static final int EXTHDR

관련 항목:

정수 필드값

CENHDR

public static final int CENHDR

관련 항목:

정수 필드값

ENDHDR

public static final int ENDHDR

관련 항목:

정수 필드값

LOCVER

public static final int LOCVER

관련 항목:

정수 필드값

LOCFLG

public static final int LOCFLG

관련 항목:

정수 필드값

LOCHOW

public static final int LOCHOW

관련 항목:

정수 필드값

LOCTIM

public static final int LOCTIM

관련 항목:

정수 필드값

LOCCRC

public static final int LOCCRC

관련 항목:

정수 필드값

LOCSIZ

public static final int LOCSIZ

관련 항목:

정수 필드값

LOCLEN

public static final int LOCLEN

관련 항목:

정수 필드값

LOCNAM

public static final int LOCNAM

관련 항목:

정수 필드값

LOCEXT

public static final int LOCEXT

관련 항목:

정수 필드값

EXTCRC

public static final int EXTCRC

관련 항목:

정수 필드값

EXTSIZ

public static final int EXTSIZ

관련 항목:

정수 필드값

EXTLEN

public static final int EXTLEN

관련 항목:

정수 필드값

CENVEM

public static final int CENVEM

관련 항목:

정수 필드값

CENVER

public static final int CENVER

관련 항목:

정수 필드값

CENFLG

public static final int CENFLG

관련 항목:

정수 필드값

CENHOW

public static final int CENHOW

관련 항목:

정수 필드값

CENTIM

public static final int CENTIM

관련 항목:

정수 필드값

CENCRC

public static final int CENCRC

관련 항목:

정수 필드값

CENSIZ

public static final int CENSIZ

관련 항목:

정수 필드값

CENLEN

public static final int CENLEN

관련 항목:

정수 필드값

CENNAM

public static final int CENNAM

관련 항목:

정수 필드값

CENEXT

public static final int CENEXT

관련 항목:

정수 필드값

CENCOM

public static final int CENCOM

관련 항목:

정수 필드값

CENDSK

public static final int CENDSK

관련 항목:

정수 필드값

CENATT

public static final int CENATT

관련 항목:

정수 필드값

CENATX

public static final int CENATX

관련 항목:

정수 필드값

CENOFF

public static final int CENOFF

관련 항목:

정수 필드값

ENDSUB

public static final int ENDSUB

관련 항목:

정수 필드값

ENDTOT

public static final int ENDTOT

관련 항목:

정수 필드값

ENDSIZ

public static final int ENDSIZ

관련 항목:

정수 필드값

ENDOFF

public static final int ENDOFF

관련 항목:

정수 필드값

ENDCOM

public static final int ENDCOM

관련 항목:

정수 필드값

생성자 상세

ZipFile

public ZipFile(String  name)
        throws IOException 

ZIP 파일을 읽기 용으로 엽니다.

시큐러티 매니저가 존재하는 경우는 우선, 시큐러티 매니저의 checkRead 메서드가 인수 name를 지정해 불려가 read가 허가될지 어떨지가 확인됩니다.

파라미터:

name - ZIP 파일의 이름

예외:

ZipException - ZIP 형식 에러가 발생했을 경우

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

SecurityException - 시큐러티 매니저가 존재하는 경우에 시큐러티 매니저의 checkRead 메서드가 파일에의 읽기 액세스를 허가하지 않을 때

관련 항목:

SecurityManager.checkRead(java.lang.String)

ZipFile

public ZipFile(File  file,
               int mode)
        throws IOException 

지정된 모드로 지정의 File 객체로부터 읽어내기 위한 새로운 ZipFile를 엽니다. 모드 인수는 OPEN_READ 또는 OPEN_READ | OPEN_DELETE 일 필요가 있습니다.

시큐러티 매니저가 존재하는 경우는 우선, 시큐러티 매니저의 checkRead 메서드가 인수 name를 지정해 불려가 read가 허가될지 어떨지가 확인됩니다.

파라미터:

file - read용으로 여는 ZIP 파일

mode - 파일이 열리는 모드

예외:

ZipException - ZIP 형식 에러가 발생했을 경우

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

SecurityException - 시큐러티 매니저가 존재하는 경우에 그 checkRead 메서드가 파일에의 읽기 액세스를 허가하지 않을 때, 또는 OPEN_DELETE 플래그가 설정되어 있는데 checkDelete 메서드가 파일의 삭제를 허가하지 않는 경우

IllegalArgumentException - mode 인수가 무효인 경우

관련 항목:

SecurityManager.checkRead(java.lang.String)

ZipFile

public ZipFile(File  file)
        throws ZipException,

               IOException 

File 객체로 지정된 ZIP 파일을 읽기 용으로 엽니다.

파라미터:

file - read용으로 여는 ZIP 파일

예외:

ZipException - ZIP 에러가 발생했을 경우

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

메서드의 상세

getEntry

public ZipEntry  getEntry(String  name)

지정된 이름의 ZIP 파일 엔트리를 리턴합니다. 발견되지 않는 경우는 null을 리턴합니다.

파라미터:

name - 엔트리의 이름

반환값:

ZIP 파일 엔트리. 발견되지 않는 경우는 null

예외:

IllegalStateException - ZIP 파일이 닫혀지고 있는 경우

getInputStream

public InputStream  getInputStream(ZipEntry  entry)
                           throws IOException 

지정된 ZIP 파일 엔트리의 내용을 읽어들이기 위한 입력 스트림을 리턴합니다.

이 ZIP 파일을 닫으면, 이 메서드의 호출에 의해 리턴된 모든 입력 스트림이 닫혀집니다.

파라미터:

entry - ZIP 파일 엔트리

반환값:

지정된 ZIP 파일 엔트리의 내용을 읽어들이기 위한 입력 스트림

예외:

ZipException - ZIP 형식 에러가 발생했을 경우

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

IllegalStateException - ZIP 파일이 닫혀지고 있는 경우

getName

public String  getName()

ZIP 파일의 패스명을 리턴합니다.

반환값:

ZIP 파일의 패스명

entries

public Enumeration <?  extends ZipEntry > entries()

ZIP 파일 엔트리의 열거를 리턴합니다.

반환값:

ZIP 파일 엔트리의 열거

예외:

IllegalStateException - ZIP 파일이 닫혀지고 있는 경우

size

public int size()

ZIP 파일중의 엔트리의 수를 리턴합니다.

반환값:

ZIP 파일중의 엔트리의 수

예외:

IllegalStateException - ZIP 파일이 닫혀지고 있는 경우

close

public void close()
           throws IOException 

ZIP 파일을 닫습니다.

이 ZIP 파일을 닫으면, getInputStream 메서드의 호출에 의해 이전에 리턴된 모든 입력 스트림이 닫혀집니다.

예외:

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

finalize

protected void finalize()
                 throws IOException 

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

GC 로 이 메서드가 호출되는 시간이 정해져 있지 않기 때문에 이 ZipFile에 의 액세스가 완료한 직후에 어플리케이션으로 close 메서드를 호출하는 것을 강하게 추천합니다. 이것에 의해 시간이 정해지지 않은 채 system resource가 보관 유지되는 것을 방지할 수 있습니다.

오버라이드(override):

클래스 Object 내의 finalize

예외:

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

관련 항목:

close()