sop.operation.InlineDetach.kt 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

The newest version!

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

package sop.operation

import java.io.IOException
import java.io.InputStream
import sop.ReadyWithResult
import sop.Signatures
import sop.exception.SOPGPException.BadData

interface InlineDetach {

    /**
     * Do not wrap the signatures in ASCII armor.
     *
     * @return builder
     */
    fun noArmor(): InlineDetach

    /**
     * Detach the provided signed message from its signatures.
     *
     * @param messageInputStream input stream containing the signed message
     * @return result containing the detached message
     * @throws IOException in case of an IO error
     * @throws BadData if the input stream does not contain a signed message
     */
    @Throws(IOException::class, BadData::class)
    fun message(messageInputStream: InputStream): ReadyWithResult

    /**
     * Detach the provided cleartext signed message from its signatures.
     *
     * @param message byte array containing the signed message
     * @return result containing the detached message
     * @throws IOException in case of an IO error
     * @throws BadData if the byte array does not contain a signed message
     */
    @Throws(IOException::class, BadData::class)
    fun message(message: ByteArray): ReadyWithResult = message(message.inputStream())
}