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

クラスZipEntry

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

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

      コンストラクタ 
      コンストラクタ 説明
      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エントリの文字列表現を返します。

    • コンストラクタの詳細

      • 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 Note 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
        戻り値:
        このオブジェクトの文字列表現。

      • clone

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