JavaTM Platform
Standard Ed. 6

java.util.zip
클래스 ZipFile

java.lang.Object 
  상위를 확장 java.util.zip.ZipFile
직계의 기존의 서브 클래스:
JarFile


public class ZipFile
extends Object

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

별도 지정된 사항이 없는 경우,null 인수를 생성자 , 또는 이 클래스의 메소드에 건네주면(자) NullPointerException 가 throw 됩니다.


필드의 개요
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 인수가 무효인 경우
도입된 버젼:
1.3
관련 항목:
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()

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.