ecacd11b06
Motivation: The Http2FrameListener requires that the Http2FrameReader accumulate ByteBuf objects. There is currently no way to limit the amount of bytes that is accumulated. Motiviation: - DefaultHttp2FrameReader supports maxHeaderSize which will fail fast as soon as the maximum size is exceeded. - DefaultHttp2HeadersDecoder will respect the return value of endHeaderBlock() and fail if the max size is exceeded. Result: Frames which carry header data now respect a maximum number of bytes that can be accumulated.
49 lines
1.5 KiB
Java
49 lines
1.5 KiB
Java
/*
|
|
* Copyright 2014 The Netty Project
|
|
*
|
|
* The Netty Project licenses this file to you under the Apache License, version 2.0 (the
|
|
* "License"); you may not use this file except in compliance with the License. You may obtain a
|
|
* copy of the License at:
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software distributed under the License
|
|
* 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 io.netty.handler.codec.http2;
|
|
|
|
import io.netty.buffer.ByteBuf;
|
|
|
|
/**
|
|
* Decodes HPACK-encoded headers blocks into {@link Http2Headers}.
|
|
*/
|
|
public interface Http2HeadersDecoder {
|
|
/**
|
|
* Configuration related elements for the {@link Http2HeadersDecoder} interface
|
|
*/
|
|
interface Configuration {
|
|
/**
|
|
* Access the Http2HeaderTable for this {@link Http2HeadersDecoder}
|
|
*/
|
|
Http2HeaderTable headerTable();
|
|
|
|
/**
|
|
* Get the maximum number of bytes that is allowed before truncation occurs.
|
|
*/
|
|
int maxHeaderSize();
|
|
}
|
|
|
|
/**
|
|
* Decodes the given headers block and returns the headers.
|
|
*/
|
|
Http2Headers decodeHeaders(ByteBuf headerBlock) throws Http2Exception;
|
|
|
|
/**
|
|
* Get the {@link Configuration} for this {@link Http2HeadersDecoder}
|
|
*/
|
|
Configuration configuration();
|
|
}
|