All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.amazonaws.encryptionsdk.ParsedCiphertext Maven / Gradle / Ivy

There is a newer version: 3.0.1
Show newest version
/*
 * Copyright 2016 Amazon.com, Inc. or its affiliates. All Rights Reserved.
 * 
 * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except
 * in compliance with the License. A copy of the License is located at
 * 
 * http://aws.amazon.com/apache2.0
 * 
 * or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 * specific language governing permissions and limitations under the License.
 */

package com.amazonaws.encryptionsdk;

import com.amazonaws.encryptionsdk.internal.Utils;
import com.amazonaws.encryptionsdk.model.CiphertextHeaders;

import edu.umd.cs.findbugs.annotations.SuppressFBWarnings;

/**
 * Exposes header information of ciphertexts to make it easier to inspect the algorithm, keys, and
 * encryption context prior to decryption.
 *
 * Please note that the class does not make defensive copies.
 */
public class ParsedCiphertext extends CiphertextHeaders {
    private final byte[] ciphertext_;
    private final int offset_;

    /**
     * Parses {@code ciphertext}. Please note that this does not make a defensive copy of
     * {@code ciphertext} and that any changes made to the backing array will be reflected here as
     * well.
     */
    public ParsedCiphertext(final byte[] ciphertext) {
        ciphertext_ = Utils.assertNonNull(ciphertext, "ciphertext");
        offset_ = deserialize(ciphertext_, 0);
    }

    /**
     * Returns the raw ciphertext backing this object. This is not a defensive copy and so
     * must not be modified by callers.
     */
    @SuppressFBWarnings("EI_EXPOSE_REP")
    public byte[] getCiphertext() {
        return ciphertext_;
    }

    /**
     * The offset at which the first non-header byte in {@code ciphertext} is located.
     */
    public int getOffset() {
        return offset_;
    }
}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy