Document

Inheritance: java.lang.Object

All Implemented Interfaces: java.io.Closeable

public class Document implements Closeable

Represents a document for comparison process.

The Document class provides methods to load, generate preview images, and manipulate documents during the comparison process.

Example usage:


 try (Comparer comparer = new Comparer(sourceFile)) {
     try (IDocumentInfo info = comparer.getSource().getDocumentInfo()) {
         System.out.println("File type: " + info.getFileType());
         System.out.println("Number of pages: " + info.getPageCount());
         System.out.println("Document size: " + info.getSize());
     }
 }
 

Constructors

Constructor Description
Document(InputStream stream) Initializes new instance of Document class with the specified document stream.
Document(String filePath) Initializes new instance of Document class with the specified document path.
Document(Path filePath) Initializes new instance of Document class with the specified document path.
Document(Path filePath, String password) Initializes new instance of Document class with the specified document path and a password.
Document(Path filePath, LoadOptions loadOptions) Initializes new instance of Document class with the specified document path and load options.
Document(String filePath, String password) Initializes new instance of Document class with the specified document path and a password.
Document(String filePath, LoadOptions loadOptions) Initializes new instance of Document class with the specified document path and load options.
Document(InputStream stream, String password) Initializes new instance of Document class with the specified document stream and a password.
Document(String filePathOrTextContent, boolean isLoadText) Initializes new instance of Document class with the specified document path or text content and a flag that indicates what was passed.
Document(InputStream inputStream, LoadOptions loadOptions) Initializes new instance of Document class with the specified document stream and load options.

Methods

Method Description
getChanges() Gets a list of ChangeInfo objects representing the changes detected during the comparison process.
setChanges(List value) Sets a list of ChangeInfo objects representing the changes detected during the comparison process.
getName() Gets the name of the document.
setName(String value) Sets the name of the document.
getFileType() Gets the type of the document.
setFileType(FileType fileType) Sets the type of the document.
createStream() Creates new stream with document content.
getStreamLength() Gets the size of the document
getPassword() Gets the password of the document
generatePreview(PreviewOptions previewOptions) Generates document previews based on the provided PreviewOptions.
getDocumentInfo() Gets information about the document, including document type, page count, page sizes, and more.
close()

Document(InputStream stream)

public Document(InputStream stream)

Initializes new instance of Document class with the specified document stream.

Parameters:

Parameter Type Description
stream java.io.InputStream Document stream

Document(String filePath)

public Document(String filePath)

Initializes new instance of Document class with the specified document path.

Parameters:

Parameter Type Description
filePath java.lang.String Document path

Document(Path filePath)

public Document(Path filePath)

Initializes new instance of Document class with the specified document path.

Parameters:

Parameter Type Description
filePath java.nio.file.Path Document path

Document(Path filePath, String password)

public Document(Path filePath, String password)

Initializes new instance of Document class with the specified document path and a password.

Parameters:

Parameter Type Description
filePath java.nio.file.Path Document path
password java.lang.String Document password

Document(Path filePath, LoadOptions loadOptions)

public Document(Path filePath, LoadOptions loadOptions)

Initializes new instance of Document class with the specified document path and load options.

Parameters:

Parameter Type Description
filePath java.nio.file.Path Document path
loadOptions LoadOptions Load options

Document(String filePath, String password)

public Document(String filePath, String password)

Initializes new instance of Document class with the specified document path and a password.

Parameters:

Parameter Type Description
filePath java.lang.String Document path
password java.lang.String Document password

Document(String filePath, LoadOptions loadOptions)

public Document(String filePath, LoadOptions loadOptions)

Initializes new instance of Document class with the specified document path and load options.

Parameters:

Parameter Type Description
filePath java.lang.String Document path
loadOptions LoadOptions Load options

Document(InputStream stream, String password)

public Document(InputStream stream, String password)

Initializes new instance of Document class with the specified document stream and a password.

Parameters:

Parameter Type Description
stream java.io.InputStream Document stream
password java.lang.String Document password

Document(String filePathOrTextContent, boolean isLoadText)

public Document(String filePathOrTextContent, boolean isLoadText)

Initializes new instance of Document class with the specified document path or text content and a flag that indicates what was passed.

Parameters:

Parameter Type Description
filePathOrTextContent java.lang.String the file path
isLoadText boolean the is load text

Document(InputStream inputStream, LoadOptions loadOptions)

public Document(InputStream inputStream, LoadOptions loadOptions)

Initializes new instance of Document class with the specified document stream and load options.

Parameters:

Parameter Type Description
inputStream java.io.InputStream Document stream
loadOptions LoadOptions Load options

getChanges()

public final List<ChangeInfo> getChanges()

Gets a list of ChangeInfo objects representing the changes detected during the comparison process.

Use this method to get detailed information about the changes between the source document and the target document(s). Each ChangeInfo object contains information such as the type of change, the affected area, and the content before and after the change.

Returns: java.util.List<com.groupdocs.comparison.result.ChangeInfo> - a list of ChangeInfo objects representing the changes detected during the comparison process

setChanges(List value)

public final void setChanges(List<ChangeInfo> value)

Sets a list of ChangeInfo objects representing the changes detected during the comparison process.

Use this method to get detailed information about the changes between the source document and the target document(s). Each ChangeInfo object contains information such as the type of change, the affected area, and the content before and after the change.

Parameters:

Parameter Type Description
value java.util.List<com.groupdocs.comparison.result.ChangeInfo> a list of ChangeInfo objects representing the changes detected during the comparison process

getName()

public final String getName()

Gets the name of the document.

Returns: java.lang.String - the name of the document

setName(String value)

public final void setName(String value)

Sets the name of the document.

Parameters:

Parameter Type Description
value java.lang.String the name of the document

getFileType()

public FileType getFileType()

Gets the type of the document.

Returns: FileType - the type of the document

setFileType(FileType fileType)

public void setFileType(FileType fileType)

Sets the type of the document.

Parameters:

Parameter Type Description
fileType FileType the type of the document

createStream()

public InputStream createStream()

Creates new stream with document content.

Returns: java.io.InputStream - the stream with document content

getStreamLength()

public long getStreamLength()

Gets the size of the document

Returns: long - the size of the document

getPassword()

public String getPassword()

Gets the password of the document

Returns: java.lang.String - the password of the document

generatePreview(PreviewOptions previewOptions)

public final void generatePreview(PreviewOptions previewOptions)

Generates document previews based on the provided PreviewOptions.

This method generates previews of the document pages according to the specified options, such as preview format, page numbers, and output stream provider. The generated previews can be saved or further processed as needed.

Example usage:


 try (Comparer comparer = new Comparer(sourceFile)) {
     PreviewOptions previewOptions = new PreviewOptions(
             pageNumber -> Files.newOutputStream(Paths.get("preview-image-page-" + pageNumber + ".png"))
     );
     previewOptions.setPreviewFormat(PreviewFormats.PNG);
     previewOptions.setPageNumbers(new int[]{1, 2});
     comparer.getSource().generatePreview(previewOptions);
 }
 

Parameters:

Parameter Type Description
previewOptions PreviewOptions The preview options specifying the format, page numbers and so on

getDocumentInfo()

public final IDocumentInfo getDocumentInfo()

Gets information about the document, including document type, page count, page sizes, and more.

Returns: IDocumentInfo - the document information

close()

public void close()