1 /* 2 * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"). 5 * You may not use this file except in compliance with the License. 6 * A copy of the License is located at 7 * 8 * http://aws.amazon.com/apache2.0 9 * 10 * or in the "license" file accompanying this file. This file is distributed 11 * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either 12 * express or implied. See the License for the specific language governing 13 * permissions and limitations under the License. 14 */ 15 16 package software.amazon.awssdk.http.auth.aws.internal.signer.chunkedencoding; 17 18 import java.nio.ByteBuffer; 19 import software.amazon.awssdk.annotations.SdkInternalApi; 20 import software.amazon.awssdk.utils.Pair; 21 22 /** 23 * A functional interface for defining an extension of a chunk, where the extension is a key-value pair. 24 * <p> 25 * An extension usually depends on the chunk-data itself (checksum, signature, etc.), but is not required to. Per <a 26 * href="https://datatracker.ietf.org/doc/html/rfc7230#section-4.1.1">RFC-7230</a> The chunk-extension is defined as: 27 * <pre> 28 * chunk-ext = *( ";" chunk-ext-name [ "=" chunk-ext-val ] ) 29 * chunk-ext-name = token 30 * chunk-ext-val = token / quoted-string 31 * </pre> 32 */ 33 @FunctionalInterface 34 @SdkInternalApi 35 public interface ChunkExtensionProvider extends Resettable { get(ByteBuffer chunk)36 Pair<byte[], byte[]> get(ByteBuffer chunk); 37 } 38