モジュール jdk.jartool
パッケージ jdk.security.jarsigner

クラスJarSigner

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

    呼出し側は、JarSigner.Builderオブジェクトを作成し(オプションで)一部のパラメータを設定し、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()
        Time Stamping Authority (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 - この実装でキーがサポートされていない場合。