sop.operation.DetachedVerify Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of sop-java Show documentation

Stateless OpenPGP Protocol API for Java

There is a newer version: 10.0.3

// SPDX-FileCopyrightText: 2021 Paul Schaub 
//
// SPDX-License-Identifier: Apache-2.0

package sop.operation;

import sop.exception.SOPGPException;

import java.io.ByteArrayInputStream;
import java.io.IOException;
import java.io.InputStream;

/**
 * API for verifying detached signatures.
 */
public interface DetachedVerify extends AbstractVerify, VerifySignatures {

    /**
     * Provides the detached signatures.
     * @param signatures input stream containing encoded, detached signatures.
     *
     * @return builder instance
     *
     * @throws sop.exception.SOPGPException.BadData if the input stream does not contain OpenPGP signatures
     * @throws IOException in case of an IO error
     */
    VerifySignatures signatures(InputStream signatures)
            throws SOPGPException.BadData,
            IOException;

    /**
     * Provides the detached signatures.
     * @param signatures byte array containing encoded, detached signatures.
     *
     * @return builder instance
     *
     * @throws sop.exception.SOPGPException.BadData if the byte array does not contain OpenPGP signatures
     * @throws IOException in case of an IO error
     */
    default VerifySignatures signatures(byte[] signatures)
            throws SOPGPException.BadData,
            IOException {
        return signatures(new ByteArrayInputStream(signatures));
    }
}