モジュール jdk.jartool

パッケージ jdk.security.jarsigner

クラス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に署名します。

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

メソッドの詳細

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 - キーがこの実装でサポートされていない場合。