warning

There is a pending German patent application with the application number 10 2023 125 012.4. In order to use the TREND watermarker Software in the form published here, a patent license is required in addition to the license for the Software. See LICENSE for more information. In case of any questions or uncertainties, please contact us at trend@isst.fraunhofer.de.

Java

If you want to use watermarking inside your Java project, this page gives you the necessary information.

Compile the Library

See Installation.

Example: Watermarking Text with Text

Below you can see an example project that inserts a text as watermark into a cover text and then extracts the watermark from the watermarked text.

1. Add Library as Dependency

Line 11 is the important line that adds our library as a dependency into the project. Currently, we are working with local deployment, so you will have to add mavenLocal() as repo (line 8) and publish the library to mavenLocal (see Installation).

build.gradle.kts

plugins {
    application
}

repositories {
    mavenCentral()
    mavenLocal()
}

dependencies {
    implementation("de.fraunhofer.isst.trend:watermarker:0.1.0-SNAPSHOT")
}

java {
    toolchain {
        languageVersion.set(JavaLanguageVersion.of(17))
    }
}

application {
    mainClass.set("Main")
}

2. Use the Library

The static functions handle(...) and unwrap(...) are optional for easy error handling with our custom return types (see Concepts for more details).

Watermark extraction can be customized for different use cases using optional Boolean parameters (see Watermarker for more details)

src/main/java/Main.java

import de.fraunhofer.isst.trend.watermarker.Watermarker;
import de.fraunhofer.isst.trend.watermarker.returnTypes.Result;
import de.fraunhofer.isst.trend.watermarker.returnTypes.Status;
import de.fraunhofer.isst.trend.watermarker.watermarks.TextWatermark;

import java.util.List;


public class Main {
    public static void main(String[] args) {
        // *********************
        // ***** INSERTION *****
        // *********************
        
        // the coverText to be enhanced with a watermark
        String coverText =
                "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor " +
                        "incididunt ut labore et dolore magna aliqua. Blandit volutpat maecenas " +
                        "volutpat blandit aliquam etiam erat velit.";
        // the watermark text that will be included in the coverText above
        String watermarkText = "Test";

        // prepare watermarker
        Watermarker watermarker = new Watermarker();

        // creating a watermark with watermarkText as content
        TextWatermark watermark = TextWatermark.Companion.create(watermarkText);

        // inserting the watermark into the cover text and handling potential errors and warnings
        String watermarkedText = unwrap(watermarker.textAddWatermark(coverText, watermark));

        // print the watermarked text
        System.out.println("watermarked text:");
        System.out.println(watermarkedText);
        System.out.println();
        
        // **********************
        // ***** Extraction *****
        // **********************

        // extract the watermark from the watermarked text
        List<TextWatermark> extractedWatermarks =
                unwrap(watermarker.textGetTextWatermarks(watermarkedText, true, true, false));
        assert(extractedWatermarks.size() == 1);
        TextWatermark extractedWatermark = extractedWatermarks.get(0);

        // print the watermark text
        System.out.println("Found a watermark in the text:");
        System.out.println(extractedWatermark.getText());
    
        // *******************************
        // ***** Multiple watermarks *****
        // *******************************

        // for multiple watermarks in a single text the parameter 'singleWatermark' must be set 
        // to 'false' when passed to the extraction function alongside the watermarked text, 
        // details are linked above this code block 

        // a second Watermark to illustrate multiple watermark extraction
        String secondWatermarkText = "Okay";

        // creating the second watermark
        TextWatermark secondWatermark = TextWatermark.Companion.create(secondWatermarkText);

        // inserting the second watermark into the coverText
        String secondWatermarkedText = unwrap(watermarker.textAddWatermark(coverText, secondWatermark));

        // combining the watermarked texts to get two different watermarks in one Text
        String combinedText = watermarkedText + secondWatermarkedText;

        // extract the watermarks from the watermarked text
        List<TextWatermark> extractedMultipleWatermarks =
                unwrap(watermarker.textGetTextWatermarks(combinedText, true, false, false));

        // print the watermarks found
        extractedMultipleWatermarks.forEach(System.out::println);
    
    }

    /**
     * Handles a status depending on its variant:
     * Variant Error:
     *  - print error and exit with code -1
     * Variant Warning:
     *  - print warning
     * Variant Success:
     *  - nop
     */
    public static void handle(Status status) {
        if (status.isSuccess() && !status.hasCustomMessage()) {
            return;
        }

        System.out.println(status);

        if (status.isError()) {
            System.exit(-1);
        }
    }

    /**
     * Unwraps a Result depending on its variant:
     * Variant Error:
     *  - print error and exit with code -1
     * Variant Warning:
     *  - print warning
     *  - return non-null value
     * Variant Success:
     *  - return non-null value
     */
    public static <T> T unwrap(Result<T> result) {
        handle(result.getStatus());
        assert result.hasValue() :
                "A Result with a Status of type Success or Warning is expected to have a value";

        return result.getValue();
    }
}