org.thymeleaf.spring5.linkbuilder.reactive.SpringWebReactiveLinkBuilder Maven / Gradle / Ivy
Show all versions of thymeleaf-spring5 Show documentation
/*
* =============================================================================
*
* Copyright (c) 2011-2016, The THYMELEAF team (http://www.thymeleaf.org)
*
* 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
*
* 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 org.thymeleaf.spring5.linkbuilder.reactive;
import java.util.Map;
import org.springframework.http.server.reactive.ServerHttpRequest;
import org.springframework.http.server.reactive.ServerHttpResponse;
import org.thymeleaf.context.IExpressionContext;
import org.thymeleaf.exceptions.TemplateProcessingException;
import org.thymeleaf.linkbuilder.ILinkBuilder;
import org.thymeleaf.linkbuilder.StandardLinkBuilder;
import org.thymeleaf.spring5.context.reactive.ISpringWebReactiveContext;
/**
*
* Spring Web Reactive-based implementation of {@link ILinkBuilder}.
*
*
* This class will build link URLs using the Spring Web Reactive API and adapting to the needs of this
* type of application.
*
*
* This implementation will only return null at {@link #buildLink(IExpressionContext, String, Map)}
* if the specified base argument is null.
*
*
* @author Daniel Fernández
*
* @since 3.0.3
*/
public class SpringWebReactiveLinkBuilder extends StandardLinkBuilder {
public SpringWebReactiveLinkBuilder() {
super();
}
/**
*
* Compute the context path to be applied to URLs that have been determined to be context-relative (and therefore
* might need a context path to be inserted at their beginning).
*
*
* This method will obtain the context path from ServerHttpRequest.getContextPath(),
* throwing an exception if context is not an instance of ISpringWebReactiveContext given
* context-relative URLs are (by default) only allowed in Spring Web Reactive contexts.
*
*
* This method can be overridden by any subclasses that want to change this behaviour.
*
*
* @param context the execution context.
* @param base the URL base specified.
* @param parameters the URL parameters specified.
* @return the context path.
*/
@Override
protected String computeContextPath(
final IExpressionContext context, final String base, final Map parameters) {
if (!(context instanceof ISpringWebReactiveContext)) {
throw new TemplateProcessingException(
"Link base \"" + base + "\" cannot be context relative (/...) unless the context " +
"used for executing the engine implements the " + ISpringWebReactiveContext.class.getName() + " interface");
}
// If it is context-relative, it has to be a Spring Web Reactive-based context
final ServerHttpRequest request = ((ISpringWebReactiveContext)context).getRequest();
return request.getContextPath();
}
/**
*
* Process an already-built URL just before returning it.
*
*
* This method can be overridden by any subclasses that want to change this behaviour.
*
*
* @param context the execution context.
* @param link the already-built URL.
* @return the processed URL, ready to be used.
*/
@Override
protected String processLink(final IExpressionContext context, final String link) {
if (!(context instanceof ISpringWebReactiveContext)) {
return link;
}
final ServerHttpResponse response = ((ISpringWebReactiveContext)context).getResponse();
return response.encodeUrl(link);
}
}