- java.lang.Object
-
- jdk.security.jarsigner.JarSigner
-
public final class JarSignerextends 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
-
-
嵌套类汇总
嵌套类 变量和类型 类 描述 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
。
-
-
-
方法详细信息
-
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)
返回由指定键指示的其他特定于实现的属性的值。 如果未设置属性但具有默认值,则将返回默认值。- Implementation Note:
- 有关此实现支持的属性列表,请参阅
JarSigner.Builder.setProperty(java.lang.String, java.lang.String)
。 所有属性名称都不区分大小写。 - 参数
-
key
- 该属性的名称。 - 结果
- 财产的价值。
- 异常
-
UnsupportedOperationException
- 如果此实现不支持该密钥。
-
-