io.micronaut.http.netty.NettyHttpRequestBuilder Maven / Gradle / Ivy
/*
* Copyright 2017-2020 original authors
*
* Licensed 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
*
* https://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.micronaut.http.netty;
import io.micronaut.core.annotation.Internal;
import io.micronaut.core.annotation.NonNull;
import io.micronaut.http.HttpRequestWrapper;
import io.micronaut.http.netty.stream.StreamedHttpRequest;
import io.netty.handler.codec.http.DefaultHttpRequest;
import io.netty.handler.codec.http.FullHttpRequest;
import io.netty.handler.codec.http.HttpMethod;
import io.netty.handler.codec.http.HttpRequest;
import io.netty.handler.codec.http.HttpVersion;
import java.util.Optional;
/**
* Common interface for client and server to implement to construct the Netty versions of the request objects.
*
* @author graemerocher
* @since 2.0.0
*/
@Internal
public interface NettyHttpRequestBuilder {
/**
* Converts this object to a full http request.
*
* @return a full http request
*/
@Deprecated
@NonNull
default FullHttpRequest toFullHttpRequest() {
throw new UnsupportedOperationException();
}
/**
* Converts this object to a streamed http request.
*
* @return The streamed request
* @deprecated Go through {@link #toHttpRequestDirect()} and {@link #toHttpRequestWithoutBody()} instead
*/
@Deprecated(since = "4.0.0", forRemoval = true)
@NonNull
default StreamedHttpRequest toStreamHttpRequest() {
throw new UnsupportedOperationException();
}
/**
* Converts this object to the most appropriate http request type.
* @return The http request
* @deprecated Go through {@link #toHttpRequestDirect()} and {@link #toHttpRequestWithoutBody()} instead
*/
@NonNull
@Deprecated(since = "4.0.0", forRemoval = true)
default HttpRequest toHttpRequest() {
throw new UnsupportedOperationException();
}
/**
* Directly convert this request to netty, including the body, if possible. If the body of this
* request has been changed, this will return an empty value.
*
* @return The request including the body
*/
@NonNull
default Optional toHttpRequestDirect() {
return Optional.empty();
}
/**
* Convert this request to a netty request without the body. The caller will handle adding the
* body.
*
* @return The request excluding the body
*/
@NonNull
HttpRequest toHttpRequestWithoutBody();
/**
* @return Is the request a stream.
* @deprecated Go through {@link #toHttpRequestDirect()} and {@link #toHttpRequestWithoutBody()} instead
*/
@Deprecated(since = "4.0.0", forRemoval = true)
default boolean isStream() {
throw new UnsupportedOperationException();
}
/**
* Convert the given request to a full http request.
* @param request The request
* @return The full request.
* @deprecated Go through {@link #toHttpRequestDirect()} and {@link #toHttpRequestWithoutBody()} instead
*/
@Deprecated(since = "4.0.0", forRemoval = true)
static @NonNull HttpRequest toHttpRequest(@NonNull io.micronaut.http.HttpRequest request) {
return asBuilder(request).toHttpRequestWithoutBody();
}
/**
* Transform the given request to an equivalent {@link NettyHttpRequestBuilder}, so that it can
* be transformed to a netty request.
*
* @param request The micronaut http request
* @return The builder for further operations
*/
static NettyHttpRequestBuilder asBuilder(@NonNull io.micronaut.http.HttpRequest request) {
boolean supportDirect = true;
while (request instanceof HttpRequestWrapper wrapper) {
supportDirect &= wrapper.getBody() == wrapper.getDelegate().getBody();
request = wrapper.getDelegate();
}
if (request instanceof NettyHttpRequestBuilder builder) {
if (supportDirect) {
return builder;
} else {
// delegate to builder, excluding toHttpRequestDirect
//noinspection Convert2Lambda
return new NettyHttpRequestBuilder() {
@Override
public HttpRequest toHttpRequestWithoutBody() {
return builder.toHttpRequestWithoutBody();
}
};
}
}
// manual conversion
HttpRequest nettyRequest = new DefaultHttpRequest(
HttpVersion.HTTP_1_1,
HttpMethod.valueOf(request.getMethodName()),
request.getUri().toString()
);
request.getHeaders()
.forEach((s, strings) -> nettyRequest.headers().add(s, strings));
return () -> nettyRequest;
}
}