クラスJarSigner

java.lang.Object
jdk.security.jarsigner.JarSigner
public final class JarSigner extends Object
jarファイルに署名するための不変ユーティリティ・クラス。

呼出し側はJarSigner.Builderオブジェクトを作成し、(optionally)は一部のパラメータを設定し、buildをコールしてJarSignerオブジェクトを作成します。 その後、このJarSignerオブジェクトを使用してjarファイルに署名できます。

特に明記されていないかぎり、null引数でJarSignerまたはJarSigner.Builderのメソッドをコールすると、NullPointerExceptionがスローされます。

例: 

    JarSigner signer = new JarSigner.Builder(key, certPath)
            .digestAlgorithm("SHA-256")
            .signatureAlgorithm("SHA256withRSA")
            .build();
    try (ZipFile  in = new ZipFile(inputFile);
            FileOutputStream out = new FileOutputStream(outputFile)) {
        signer.sign(in, out);
    }

導入されたバージョン:
9

  • ネストされたクラスのサマリー

    ネストされたクラス
    修飾子と型
    クラス
    説明
    static class 
    JarSigner.Builder
    様々な署名関連のパラメータから不変のJarSignerを作成できる可変ビルダー・クラス。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    String
    getDigestAlgorithm()
    このJarSignerのダイジェスト・アルゴリズムを返します。
    String
    getProperty(String key)
    指定されたキーで示される追加の実装固有プロパティの値を返します。
    String
    getSignatureAlgorithm()
    このJarSignerのシグネチャ・アルゴリズムを返します。
    String
    getSignerName()
    このJarSignerの署名者名を返します。
    URI
    getTsa()
    タイムスタンプ局(TSA)のURIを返します。
    void
    sign(ZipFile file, OutputStream os)
    ファイルをOutputStreamに署名します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    String
    toString()
    オブジェクトの文字列表現を返します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • メソッドの詳細

    • sign

      public void sign(ZipFile file, OutputStream os)
      ファイルをOutputStreamに署名します。 このメソッドはfileまたはosを閉じません。

      署名中にI/Oエラーまたは署名エラーが発生した場合、一部のバイトが書き込まれた後にエラーが発生することがあります。 その結果、出力ストリームが一貫性のない状態になる可能性があります。 この場合はすぐにクローズすることを強くお薦めします。

      パラメータ:
      file - 署名するファイル。
      os - 出力ストリーム。
      スロー:
      JarSignerException - 署名に失敗した場合。

    • getDigestAlgorithm

      public String getDigestAlgorithm()
      このJarSignerのダイジェスト・アルゴリズムを返します。

      戻り値はnullにできません。

      戻り値:
      ダイジェスト・アルゴリズム。

    • getSignatureAlgorithm

      public String getSignatureAlgorithm()
      このJarSignerのシグネチャ・アルゴリズムを返します。

      戻り値はnullにできません。

      戻り値:
      シグネチャ・アルゴリズム。

    • getTsa

      public URI getTsa()
      タイムスタンプ局(TSA)のURIを返します。
      戻り値:
      TSAのURI。

    • getSignerName

      public String getSignerName()
      このJarSignerの署名者名を返します。

      戻り値はnullにできません。

      戻り値:
      署名者の名前。

    • getProperty

      public String getProperty(String key)
      指定されたキーで示される追加の実装固有プロパティの値を返します。 プロパティが設定されておらず、デフォルト値がある場合、デフォルト値が返されます。
      実装上のノート:
      この実装がサポートするプロパティのリストは、JarSigner.Builder.setProperty(String, String)を参照してください。 すべてのプロパティ名で、大文字と小文字は区別されません。
      パラメータ:
      key - プロパティの名前。
      戻り値:
      プロパティの値。
      スロー:
      UnsupportedOperationException - キーがこの実装でサポートされていない場合。