モジュール jdk.jartool
パッケージ 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-1")
         .signatureAlgorithm("SHA1withDSA")
         .build();
 try (ZipFile in = new ZipFile(inputFile);
         FileOutputStream out = new FileOutputStream(outputFile)) {
     signer.sign(in, out);
 }

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

    • メソッドの詳細

      • 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(java.lang.String, java.lang.String)を参照してください。 すべてのプロパティ名で、大文字と小文字は区別されません。
        パラメータ:
        key - プロパティの名前。
        戻り値:
        プロパティの値。
        例外:
        UnsupportedOperationException - キーがこの実装でサポートされていない場合。