モジュール java.base
パッケージ java.util.zip

クラスZipEntry

java.lang.Object
java.util.zip.ZipEntry
すべての実装されたインタフェース:
Cloneable
直系の既知のサブクラス:
JarEntry
public class ZipEntry
extends Object
implements Cloneable
このクラスは、ZIPファイル・エントリを表すために使用されます。
導入されたバージョン:
1.1

  • フィールドのサマリー

    フィールド
    修飾子と型 フィールド 説明
    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 DEFLATED
    圧縮された(デフレート)エントリのための圧縮メソッドです。
    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 STORED
    圧縮解除されたデータの圧縮メソッドです。

  • コンストラクタのサマリー

    コンストラクタ
    コンストラクタ 説明
    ZipEntry​(String name)
    指定された名前の新しいzipエントリを作成します。
    ZipEntry​(ZipEntry e)
    指定されたzipエントリのフィールドを継承する、新しいzipエントリを作成します。

  • メソッドのサマリー

    修飾子と型 メソッド 説明
    Object clone()
    このエントリのコピーを返します。
    String getComment()
    エントリのコメント文字列を返します。
    long getCompressedSize()
    圧縮されたエントリ・データのサイズを返します。
    long getCrc()
    圧縮解除されたエントリ・データのCRC-32チェックサムを返します。
    FileTime getCreationTime()
    エントリの作成時間を返します。
    byte[] getExtra()
    エントリのエクストラ・フィールド・データを返します。
    FileTime getLastAccessTime()
    エントリの最終アクセス時間を返します。
    FileTime getLastModifiedTime()
    エントリの最終変更時間を返します。
    int getMethod()
    エントリの圧縮メソッドを返します。
    String getName()
    エントリの名前を返します。
    long getSize()
    エントリ・データの圧縮解除時のサイズを返します。
    long getTime()
    エントリの最終変更時間を返します。
    LocalDateTime getTimeLocal()
    ローカル日時のエントリの最終更新時間を返します。
    int hashCode()
    このエントリのハッシュ・コード値を返します。
    boolean isDirectory()
    これがディレクトリ・エントリである場合に、trueを返します。
    void setComment​(String comment)
    エントリにオプションのコメント文字列を設定します。
    void setCompressedSize​(long csize)
    圧縮されたエントリ・データのサイズを設定します。
    void setCrc​(long crc)
    圧縮解除されたエントリ・データのCRC-32チェックサムを設定します。
    ZipEntry setCreationTime​(FileTime time)
    エントリの作成時間を設定します。
    void setExtra​(byte[] extra)
    エントリにオプションのエクストラ・フィールド・データを設定します。
    ZipEntry setLastAccessTime​(FileTime time)
    エントリの最終アクセス時間を設定します。
    ZipEntry setLastModifiedTime​(FileTime time)
    エントリの最終変更時間を設定します。
    void setMethod​(int method)
    エントリの圧縮メソッドを設定します。
    void setSize​(long size)
    エントリ・データの圧縮解除時のサイズを設定します。
    void setTime​(long time)
    エントリの最終変更時間を設定します。
    void setTimeLocal​(LocalDateTime time)
    エントリの最終更新時間をローカルの日時に設定します。
    String toString()
    ZIPエントリの文字列表現を返します。

    クラス java.lang.Objectで宣言されたメソッド

    equals, finalize, getClass, notify, notifyAll, wait, wait, wait

  • フィールド詳細

  • コンストラクタの詳細

    • ZipEntry

      public ZipEntry​(String name)
      指定された名前の新しいzipエントリを作成します。
      パラメータ:
      name - エントリ名
      例外:
      NullPointerException - エントリの名前がnullである場合
      IllegalArgumentException - エントリの名前が0xFFFFバイトよりも長い場合

    • ZipEntry

      public ZipEntry​(ZipEntry e)
      指定されたzipエントリのフィールドを継承する、新しいzipエントリを作成します。
      パラメータ:
      e - zipエントリ・オブジェクト
      例外:
      NullPointerException - エントリ・オブジェクトがnullの場合

  • メソッドの詳細

    • getName

      public String getName()
      エントリの名前を返します。
      戻り値:
      エントリの名前

    • setTime

      public void setTime​(long time)
      エントリの最終変更時間を設定します。

      エントリがZIPファイルへの出力か、またはZIPファイル形式の出力ストリームである場合、このメソッドによって設定された最終変更時間がzipファイル・エントリの日付および時間フィールドに格納され、標準MS-DOSの日付および時間形式でエンコードされます。 default TimeZoneはエポック時間をMS-DOSの日付と時間に変換するために使用します。

      パラメータ:
      time - エポックからのミリ秒でのエントリの最終変更時間
      関連項目:
      getTime(), getLastModifiedTime()

    • getTime

      public long getTime()
      エントリの最終変更時間を返します。

      エントリがZIPファイルから読み取られるか、またはZIPファイル形式の入力ストリームである場合、これはzipファイル・エントリの 日付および時間フィールドからの最終変更時間です。 default TimeZoneは標準MS-DOS形式の日付および時間をエポック時間に変換するために使用します。

      戻り値:
      エポックからのミリ秒でのエントリの最終変更時間、または指定されていない場合-1
      関連項目:
      setTime(long), setLastModifiedTime(FileTime)

    • setTimeLocal

      public void setTimeLocal​(LocalDateTime time)
      エントリの最終更新時間をローカルの日時に設定します。

      エントリがZIPファイルへの出力か、またはZIPファイル形式の出力ストリームである場合、このメソッドによって設定された最終変更時間がzipファイル・エントリの日付および時間フィールドに格納され、標準MS-DOSの日付および時間形式でエンコードされます。 日付時間セットが標準 MS-DOS date and time formatの範囲外の場合、時間は、optional extra data内のzipファイル・エントリの拡張タイムスタンプ・フィールドにもUTC時間で格納されます。 system default TimeZoneは、ローカル日時をUTC時間に変換するために使用されます。

      LocalDateTimeはナノ秒の精度を使用しますが、このクラスでは精度はミリ秒です。 変換では超過分の精度情報は、ナノ秒単位で100万分の1の整数除算が行われたかのように切り捨てられます。

      パラメータ:
      time - ローカル日時のエントリの最終更新時間
      導入されたバージョン:
      9
      関連項目:
      getTimeLocal()

    • getTimeLocal

      public LocalDateTime getTimeLocal()
      ローカル日時のエントリの最終更新時間を返します。

      エントリがZIPファイルから読み取られるか、またはZIPファイル形式の入力ストリームである場合、これは、拡張タイムスタンプ・フィールドが存在する場合のzipファイル・エントリのオプションのエクストラ・データからの最終変更時間です。 それ以外の場合は、最後の変更時間がdate and time fields形式のエントリ標準MS-DOSから読み込まれます。

      system default TimeZoneは、UTC時間を現地の日時に変換するために使用されます。

      戻り値:
      ローカル日時のエントリの最終更新時間
      導入されたバージョン:
      9
      関連項目:
      setTimeLocal(LocalDateTime)

    • setLastModifiedTime

      public ZipEntry setLastModifiedTime​(FileTime time)
      エントリの最終変更時間を設定します。

      ZIPファイルへの出力か、またはZIPファイル形式の出力ストリームである場合、このメソッドによって設定された最終変更時間が、標準MS-DOS日付および時間形式で、zipファイル・エントリの日付および時間フィールドおよびUTC時間のオプションのエクストラ・データの拡張タイムスタンプ・フィールドに格納されます。

      パラメータ:
      time - エントリの最終変更時間
      戻り値:
      このzipエントリ
      例外:
      NullPointerException - timeがnullの場合
      導入されたバージョン:
      1.8
      関連項目:
      getLastModifiedTime()

    • getLastModifiedTime

      public FileTime getLastModifiedTime()
      エントリの最終変更時間を返します。

      エントリがZIPファイルから読み取られるか、またはZIPファイル形式の入力ストリームである場合、これは、拡張タイムスタンプ・フィールドが存在する場合のzipファイル・エントリのオプションのエクストラ・データからの最終変更時間です。 そうでない場合、最終変更時間はエントリの日付および時間フィールドから読み取られ、default TimeZoneが標準MS-DOS形式の日付および時間をエポック時間に変換するために使用されます。

      戻り値:
      エントリの最終変更時間。指定されていない場合はnull
      導入されたバージョン:
      1.8
      関連項目:
      setLastModifiedTime(FileTime)

    • setLastAccessTime

      public ZipEntry setLastAccessTime​(FileTime time)
      エントリの最終アクセス時間を設定します。

      設定されている場合、ZIPファイルまたはZIPファイル形式のストリームへの出力時に、最終アクセス時間がエントリのオプションのエクストラ・データの拡張タイムスタンプ・フィールドに格納されます。

      パラメータ:
      time - エントリの最終アクセス時間
      戻り値:
      このzipエントリ
      例外:
      NullPointerException - timeがnullの場合
      導入されたバージョン:
      1.8
      関連項目:
      getLastAccessTime()

    • getLastAccessTime

      public FileTime getLastAccessTime()
      エントリの最終アクセス時間を返します。

      ZIPファイルまたはZIPファイル形式のストリームからの読み取り時、最終アクセス時間は、エントリのオプションのエクストラ・データの拡張タイムスタンプ・フィールドからの時間になります。

      戻り値:
      エントリの最終アクセス時間。指定されていない場合はnull
      導入されたバージョン:
      1.8
      関連項目:
      setLastAccessTime(FileTime)

    • setCreationTime

      public ZipEntry setCreationTime​(FileTime time)
      エントリの作成時間を設定します。

      設定されている場合、ZIPファイルまたはZIPファイル形式のストリームへの出力時に、作成時間がエントリのオプションのエクストラ・データの拡張タイムスタンプ・フィールドに格納されます。

      パラメータ:
      time - エントリの作成時間
      戻り値:
      このzipエントリ
      例外:
      NullPointerException - timeがnullの場合
      導入されたバージョン:
      1.8
      関連項目:
      getCreationTime()

    • getCreationTime

      public FileTime getCreationTime()
      エントリの作成時間を返します。

      ZIPファイルまたはZIPファイル形式のストリームからの読み取り時、作成時間は、エントリのオプションのエクストラ・データの拡張タイムスタンプ・フィールドからの時間になります。

      戻り値:
      エントリの作成時間。指定されていない場合はnull
      導入されたバージョン:
      1.8
      関連項目:
      setCreationTime(FileTime)

    • setSize

      public void setSize​(long size)
      エントリ・データの圧縮解除時のサイズを設定します。
      パラメータ:
      size - 圧縮解除時のサイズ(バイト)
      例外:
      IllegalArgumentException - 指定されたサイズが0未満の場合、ZIP64形式がサポートされておらず0xFFFFFFFFより大きい場合、ZIP64がサポートされていて0未満の場合
      関連項目:
      getSize()

    • getSize

      public long getSize()
      エントリ・データの圧縮解除時のサイズを返します。
      戻り値:
      エントリ・データの圧縮解除時のサイズ。不明の場合は -1
      関連項目:
      setSize(long)

    • getCompressedSize

      public long getCompressedSize()
      圧縮されたエントリ・データのサイズを返します。

      格納されたエントリの場合、圧縮時のサイズは圧縮解除時のサイズと同じになります。

      戻り値:
      エントリ・データの圧縮時のサイズ。不明の場合は -1
      関連項目:
      setCompressedSize(long)

    • setCompressedSize

      public void setCompressedSize​(long csize)
      圧縮されたエントリ・データのサイズを設定します。
      パラメータ:
      csize - 設定する圧縮サイズ
      関連項目:
      getCompressedSize()

    • setCrc

      public void setCrc​(long crc)
      圧縮解除されたエントリ・データのCRC-32チェックサムを設定します。
      パラメータ:
      crc - CRC-32値
      例外:
      IllegalArgumentException - 指定されたCRC-32値が0より小さいか、0xFFFFFFFFより大きい場合
      関連項目:
      getCrc()

    • getCrc

      public long getCrc()
      圧縮解除されたエントリ・データのCRC-32チェックサムを返します。
      戻り値:
      圧縮解除されたエントリ・データのCRC-32チェックサム。不明の場合は -1
      関連項目:
      setCrc(long)

    • setMethod

      public void setMethod​(int method)
      エントリの圧縮メソッドを設定します。
      パラメータ:
      method - 圧縮メソッドSTOREDまたはDEFLATED
      例外:
      IllegalArgumentException - 指定された圧縮メソッドが無効な場合
      関連項目:
      getMethod()

    • getMethod

      public int getMethod()
      エントリの圧縮メソッドを返します。
      戻り値:
      エントリの圧縮メソッド。指定されていない場合は -1
      関連項目:
      setMethod(int)

    • setExtra

      public void setExtra​(byte[] extra)
      エントリにオプションのエクストラ・フィールド・データを設定します。

      extraフィールドのデータに、Info-ZIP Application ノート970311に指定されているように、NTFS tag 0x0001またはInfo-ZIP Extended Timestampなどの拡張可能なタイムスタンプ・フィールドが含まれる場合、このメソッドを呼び出すと、このエントリの最終変更時間、最終アクセス時間、および作成時間が変更されることがあります。

      パラメータ:
      extra - エクストラ・フィールド・データ・バイト
      例外:
      IllegalArgumentException - 指定された補足フィールド・データの長さが0xFFFFバイトより大きい場合
      関連項目:
      getExtra()

    • getExtra

      public byte[] getExtra()
      エントリのエクストラ・フィールド・データを返します。
      戻り値:
      エントリのエクストラ・フィールド・データ。存在しない場合はnull
      関連項目:
      setExtra(byte[])

    • setComment

      public void setComment​(String comment)
      エントリにオプションのコメント文字列を設定します。

      ZIPエントリ・コメントの最大長は0xffffです。 エンコーディング後に、指定されたコメント文字列の長さが0xFFFFより大きい場合、先頭の0xFFFFバイトのみがZIPファイル・エントリに出力されます。

      パラメータ:
      comment - コメント文字列
      関連項目:
      getComment()

    • getComment

      public String getComment()
      エントリのコメント文字列を返します。
      戻り値:
      エントリのコメント文字列。コメント文字列がない場合は、null
      関連項目:
      setComment(String)

    • isDirectory

      public boolean isDirectory()
      これがディレクトリ・エントリである場合に、trueを返します。 ディレクトリ・エントリは、その名前の最後に「/」を付けて定義されています。
      戻り値:
      ディレクトリ・エントリの場合はtrue

    • toString

      public String toString()
      ZIPエントリの文字列表現を返します。
      オーバーライド:
      toString 、クラス:  Object
      戻り値:
      このオブジェクトの文字列表現

    • hashCode

      public int hashCode()
      このエントリのハッシュ・コード値を返します。
      オーバーライド:
      hashCode 、クラス:  Object
      戻り値:
      このオブジェクトのハッシュ・コード値。
      関連項目:
      Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

    • clone

      public Object clone()
      このエントリのコピーを返します。
      オーバーライド:
      clone、クラス: Object
      戻り値:
      このインスタンスの複製。
      関連項目:
      Cloneable