GroupDocs.Metadata for Java 21.8 Release Notes

Major Features

There are the following features, enhancements, and fixes in this release:

• Implement the ability to configure cache for heavy operations
• Replace constants with enum values in Java public API

Full List of Issues Covering all Changes in this Release

Public API and Backward Incompatible Changes

Implement the ability to configure cache for heavy operations

This improvement allows you to specify the path to the cache folder for processing large images, the maximum cache size on disk, and the maximum cache size in memory.

Public API changes

Added method String getCacheFolder() to class com.groupdocs.metadata.options.PreviewOptions. Added method void setCacheFolder(String value) to class com.groupdocs.metadata.options.PreviewOptions. Added method int getMaxDiskSpaceForCache() to class com.groupdocs.metadata.options.PreviewOptions. Added method void setMaxDiskSpaceForCache(int value) to class com.groupdocs.metadata.options.PreviewOptions. Added method int getMaxMemoryForCache() to class com.groupdocs.metadata.options.PreviewOptions. Added method void setMaxMemoryForCache(int value) to class com.groupdocs.metadata.options.PreviewOptions.

Use cases

The following example demonstrates how to set cache options in an application.

final String filePath = "C:\\Documents\\MyDocument.pdf";
final String cachePath = "C:\\Temp";
 
Metadata metadata = new Metadata(filePath);
 
PreviewOptions previewOptions = new PreviewOptions(
    new ICreatePageStream() {
        @Override
        public OutputStream createPageStream(int pageNumber) {
            try {
                String path = filePath + "_" + pageNumber + ".jpg";
                FileOutputStream stream = new FileOutputStream(path);    
                return stream;
            } catch(IOException e) {
                System.out.println(e);
            }
            return null;
        }
    },
    new IReleasePageStream() {
        @Override
        public void releasePageStream(int pageNumber, OutputStream pageStream) {
            try {
                pageStream.close();
            } catch (IOException e) {
                System.out.println(e);
            }
        }
    });
previewOptions.setCacheFolder(cachePath);
previewOptions.setPreviewFormat(PreviewOptions.PreviewFormats.JPEG);
previewOptions.setPageNumbers(new int[] { 1 });
previewOptions.setWidth(100);
previewOptions.setHeight(100);
 
metadata.generatePreview(previewOptions);
 
metadata.close();

Replace constants with enum values in Java public API

This improvement replaces classes containing integer constants with enumerations.

Public API changes

Replaced all classes containing integer constants with enumerations.

Use cases

Previous version:

ID3V1Tag tag = ...
int genre = tag.getGenreValue();

New version:

ID3V1Tag tag = ...
ID3V1Genre genre = tag.getGenreValue();