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
-
ネストされたクラスのサマリー
ネストされたクラス -
メソッドのサマリー
修飾子と型メソッド説明このJarSigner
のダイジェスト・アルゴリズムを返します。getProperty
(String key) 指定されたキーで示される追加の実装固有プロパティの値を返します。このJarSigner
のシグネチャ・アルゴリズムを返します。このJarSigner
の署名者名を返します。getTsa()
タイムスタンプ局(TSA)のURIを返します。void
sign
(ZipFile file, OutputStream os) ファイルをOutputStream
に署名します。
-
メソッドの詳細
-
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
指定されたキーで示される追加の実装固有プロパティの値を返します。 プロパティが設定されておらず、デフォルト値がある場合、デフォルト値が返されます。- 実装上のノート:
- この実装がサポートするプロパティのリストは、
JarSigner.Builder.setProperty(java.lang.String, java.lang.String)
を参照してください。 すべてのプロパティ名で、大文字と小文字は区別されません。 - パラメータ:
key
- プロパティの名前。- 戻り値:
- プロパティの値。
- 例外:
UnsupportedOperationException
- キーがこの実装でサポートされていない場合。
-