Documenten cachen in Java met Redis & GroupDocs

Wanneer je documenten efficiënt wilt cachen, vooral tijdens het renderen van een groot aantal documenten, kan een goed ontworpen cache de verwerkingstijd drastisch verkorten. In deze tutorial lopen weert met GroupDocs.Conversion, zodat je de renderprestaties voor PDF, DOC‑afhankelijk8+).

What is caching documents with Redis?

Caching slaat de output van een documentconversie (bijv. een gegenereerde PDF) op in Redis zodat vervolgverzoeken voor hetzelfde bronbestand direct kunnen worden bediend zonder opnieuw te verwerken. Dit vermindert CPU‑belasting, netwerkverkeer en verbetert de gebruikerservaring.

Why implement Redis cache in Java?

  • Verbeter renderprestaties door dubbele conversies te vermijden.
  • Lagere infrastructuurkosten – minder CPU‑cycli en minder geheugenbelasting.
  • Schaalbaar over meerdere applicatie‑instances omdat Redis een centrale opslag is.
  • Fijne controle over expiratie‑beleid, waardoor je versheid en snelheid kunt balanceren.

Prerequisites

  • GroupDocs.Conversion – versie 25.2 of nieuwer.
  • Jedis (Redis‑client voor Java).
  • Een draaiende Redis‑server (localhost is prima voor ontwikkeling).
  • Maven voor afhankelijkheidsbeheer.
  • Basiskennis van Java en vertrouwdheid met documentconversieconcepten.

Setting Up GroupDocs.Conversion for Java

Voeg de GroupDocs‑repository en afhankelijkheid toe aan je pom.xml:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/conversion/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-conversion</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

License acquisition

Je kunt beginnen met een Free Trial, een Temporary License aanvragen voor evaluatie, of een volledige License aanschaffen voor productie.

Initialiseer GroupDocs.Conversion in je Java‑code:

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;

public class DocumentConversion {
    public static void main(String[] args) {
        // Initialize the Converter with a document path
        Converter converter = new Converter("input.docx");
        
        // Set up conversion options for PDF
        PdfConvertOptions options = new PdfConvertOptions();
        converter.convert("output.pdf", options);
    }
}

Implementation Guide

Creating a Custom Cache Using Redis

Overview

Een aangepaste Redis‑cache bewaart de bytes van gerenderde documenten, waardoor directe ophalen bij herhaalde verzoeken mogelijk is.

Setting Up JedisPool

Maak eerst een verbindingspool om Redis‑verbindingen efficiënt te beheren:

import redis.clients.jedis.JedisPool;

public class CacheManager {
    private static JedisPool jedisPool = new JedisPool("localhost", 6379);
    
    public static void main(String[] args) {
        // Additional cache setup code here
    }
}

Storing and Retrieving Cached Data

Gebruik eenvoudige helper‑methoden om documenten in Redis te plaatsen en op te halen:

import redis.clients.jedis.Jedis;

public class CacheManager {

    public static void storeDocument(String key, String documentContent) {
        try (Jedis jedis = jedisPool.getResource()) {
            // Set the content in Redis cache with an expiration time of one hour
            jedis.setex(key, 3600, documentContent);
        }
    }

    public static String retrieveDocument(String key) {
        try (Jedis jedis = jedisPool.getResource()) {
            return jedis.get(key); // Retrieve cached content if available
        }
    }
}

Integration with GroupDocs.Conversion

Koppel nu de cache aan de conversieworkflow:

public class DocumentConversion {

    public static void convertWithCache(String inputPath, String outputPath) {
        Converter converter = new Converter(inputPath);
        PdfConvertOptions options = new PdfConvertOptions();

        // Generate a cache key based on the document path and conversion settings
        String cacheKey = "doc:" + inputPath;

        // Check if the converted document is already cached
        String cachedDocument = CacheManager.retrieveDocument(cacheKey);

        if (cachedDocument != null) {
            System.out.println("Using cached version of the document.");
            // Save cached content to output file
            Files.write(Paths.get(outputPath), cachedDocument.getBytes());
        } else {
            // Perform conversion and cache the result
            converter.convert(output -> {
                String documentContent = new String(output.toByteArray());
                CacheManager.storeDocument(cacheKey, documentContent);
                Files.write(Paths.get(outputPath), output.toByteArray());
            }, options);
        }
    }

    public static void main(String[] args) {
        convertWithCache("input.docx", "output.pdf");
    }
}

Troubleshooting Tips

  • Controleer of de Redis‑server (ping vanaf de host).
  • Bevestig dat host/poort van JedisPool overeenkomen met je Redis‑instantie.
  • Omring cache‑aanroepen met try‑catch‑blokken om verbindingsproblemen netjes af te handelen.
  • Monitor het geheugenverbruik van Redis; overweeg maxmemory‑beleid voor productie.

Practical Applications

  1. Portalen met veel verkeer – Serveer vaak opgevraagde PDF’s direct.
  2. Enterprise DMS – Verminder de belasting op conversieservers wanneer gebruikers herhaaldelijk dezelfde contracten bekijken.
  3. E‑commerce – Cache gegenereerde facturen of productcatalogi.
  4. Leerplatformen – Versnel de levering van college‑notities en opslagkosten laag blijven.

##stemmen** – Pas ` dat de heap de conversiebibliotheek plus eventuele in‑process buffers kan bevatten.

Frequently Asked Questions

Q: Kan ik deze aanpak gebruiken met andere GroupDocs‑outputformaten?
A: Absoluut. Hetzelfde cache‑patroon werkt voor DOCX, HTML, afbeeldingen en meer – wijzig gewoon het type ConvertOptions.

Q: Hoe kies ik een goede cache‑sleutel?
A: Combineer het pad van het bronbestand, de conversie‑opties en eventuele versie‑identifiers. Dit garandeert uniciteit per configuratie.

Q: Wat gebeurt er als een document verandert nadat het is gecached?
A: Invalideer de cache handmatig (bijv. verwijder de sleutel) of gebruik een kortere TTL zodat verouderde data snel verloopt.

Q: Is Redis de enige optie voor caching?
A: Nee, maar Redis biedt lage latentie, ingebouwde TTL en brede Java‑ is zware werk wordt gedaan door Redis; de applicatie houdt alleen kort‑ lever je. Experimenteer met verschillende TTL‑waarden, monitor cache‑statistieken en breid het patroon uit naar andere documentformaten indien nodig.

Last Updated: 2026-01-23
Tested With: GroupDocs.Conversion 25.2, Jedis 4.2
Author: GroupDocs