Package net.jsign.msi

Class MSIFile

java.lang.Object

net.jsign.msi.MSIFile

All Implemented Interfaces:

Closeable, AutoCloseable, Signable

public class MSIFile
extends Object
implements Signable, Closeable

A Microsoft Installer package.

Since:

3.0

Author:

Emmanuel Bourg

Constructor Summary

Constructors

Constructor	Description
MSIFile(File file)	Create a MSIFile from the specified file.
MSIFile(SeekableByteChannel channel)	Create a MSIFile from the specified channel.

Method Summary

Modifier and Type	Method	Description
void	close()	Closes the file
byte[]	computeDigest(MessageDigest digest)	Computes the digest of the file.
ASN1Object	createIndirectData(DigestAlgorithm digestAlgorithm)	Creates the SpcIndirectDataContent structure containing the digest of the file.
List<CMSSignedData>	getSignatures()	Returns the Authenticode signatures on the file.
boolean	hasExtendedSignature()	Tells if the MSI file has an extended signature (MsiDigitalSignatureEx) containing a hash of the streams metadata (name, size, date).
static boolean	isMSIFile(File file)	Tells if the specified file is a MSI file.
void	save()	Saves the file.
void	setSignature(CMSSignedData signature)	Sets the signature of the file, overwriting the previous one.

Methods inherited from class java.lang.Object

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

Constructor Detail

MSIFile

public MSIFile(File file)
        throws IOException

Create a MSIFile from the specified file.

Parameters:

file - the file to open

Throws:

IOException - if an I/O error occurs

MSIFile

public MSIFile(SeekableByteChannel channel)
        throws IOException

Create a MSIFile from the specified channel.

Parameters:

channel - the channel to read the file from

Throws:

IOException - if an I/O error occurs

Method Detail

isMSIFile

public static boolean isMSIFile(File file)
                         throws IOException

Tells if the specified file is a MSI file.

Parameters:

file - the file to check

Returns:

true if the file is a Microsoft installer, false otherwise

Throws:

IOException - if an I/O error occurs

close

public void close()
           throws IOException

Closes the file

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Throws:

IOException - if an I/O error occurs

hasExtendedSignature

public boolean hasExtendedSignature()

Tells if the MSI file has an extended signature (MsiDigitalSignatureEx) containing a hash of the streams metadata (name, size, date).

Returns:

true if the file has a MsiDigitalSignatureEx stream, false otherwise

computeDigest

public byte[] computeDigest(MessageDigest digest)

Description copied from interface: Signable

Computes the digest of the file.

Specified by:

computeDigest in interface Signable

Parameters:

digest - the message digest to update

Returns:

the digest of the file

createIndirectData

public ASN1Object createIndirectData(DigestAlgorithm digestAlgorithm)

Description copied from interface: Signable

Creates the SpcIndirectDataContent structure containing the digest of the file.

Specified by:

createIndirectData in interface Signable

Parameters:

digestAlgorithm - the digest algorithm to use

Returns:

the SpcIndirectDataContent structure in ASN.1 format

getSignatures

public List<CMSSignedData> getSignatures()
                                  throws IOException

Description copied from interface: Signable

Returns the Authenticode signatures on the file.

Specified by:

getSignatures in interface Signable

Returns:

the signatures

Throws:

IOException - if an I/O error occurs

setSignature

public void setSignature(CMSSignedData signature)
                  throws IOException

Description copied from interface: Signable

Sets the signature of the file, overwriting the previous one.

Specified by:

setSignature in interface Signable

Parameters:

signature - the signature to put

Throws:

IOException - if an I/O error occurs

save

public void save()
          throws IOException

Description copied from interface: Signable

Saves the file.

Specified by:

save in interface Signable

Throws:

IOException - if an I/O error occurs