/*
 * Copyright 2002-2018 the original author or 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
 *
 *      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.springframework.http.server;

import java.nio.charset.Charset;
import java.nio.charset.StandardCharsets;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import java.util.stream.Collectors;

import org.springframework.lang.Nullable;
import org.springframework.util.Assert;
import org.springframework.util.CollectionUtils;
import org.springframework.util.LinkedMultiValueMap;
import org.springframework.util.MultiValueMap;
import org.springframework.util.StringUtils;

Default implementation of PathContainer.
Author:Rossen Stoyanchev
Since:5.0
/** * Default implementation of {@link PathContainer}. * * @author Rossen Stoyanchev * @since 5.0 */
final class DefaultPathContainer implements PathContainer { private static final MultiValueMap<String, String> EMPTY_MAP = new LinkedMultiValueMap<>(); private static final PathContainer EMPTY_PATH = new DefaultPathContainer("", Collections.emptyList()); private static final PathContainer.Separator SEPARATOR = () -> "/"; private final String path; private final List<Element> elements; private DefaultPathContainer(String path, List<Element> elements) { this.path = path; this.elements = Collections.unmodifiableList(elements); } @Override public String value() { return this.path; } @Override public List<Element> elements() { return this.elements; } @Override public boolean equals(@Nullable Object other) { if (this == other) { return true; } if (other == null || getClass() != other.getClass()) { return false; } return this.path.equals(((DefaultPathContainer) other).path); } @Override public int hashCode() { return this.path.hashCode(); } @Override public String toString() { return value(); } static PathContainer createFromUrlPath(String path) { if (path.equals("")) { return EMPTY_PATH; } String separator = "/"; Separator separatorElement = separator.equals(SEPARATOR.value()) ? SEPARATOR : () -> separator; List<Element> elements = new ArrayList<>(); int begin; if (path.length() > 0 && path.startsWith(separator)) { begin = separator.length(); elements.add(separatorElement); } else { begin = 0; } while (begin < path.length()) { int end = path.indexOf(separator, begin); String segment = (end != -1 ? path.substring(begin, end) : path.substring(begin)); if (!segment.equals("")) { elements.add(parsePathSegment(segment)); } if (end == -1) { break; } elements.add(separatorElement); begin = end + separator.length(); } return new DefaultPathContainer(path, elements); } private static PathSegment parsePathSegment(String segment) { Charset charset = StandardCharsets.UTF_8; int index = segment.indexOf(';'); if (index == -1) { String valueToMatch = StringUtils.uriDecode(segment, charset); return new DefaultPathSegment(segment, valueToMatch, EMPTY_MAP); } else { String valueToMatch = StringUtils.uriDecode(segment.substring(0, index), charset); String pathParameterContent = segment.substring(index); MultiValueMap<String, String> parameters = parsePathParams(pathParameterContent, charset); return new DefaultPathSegment(segment, valueToMatch, parameters); } } private static MultiValueMap<String, String> parsePathParams(String input, Charset charset) { MultiValueMap<String, String> result = new LinkedMultiValueMap<>(); int begin = 1; while (begin < input.length()) { int end = input.indexOf(';', begin); String param = (end != -1 ? input.substring(begin, end) : input.substring(begin)); parsePathParamValues(param, charset, result); if (end == -1) { break; } begin = end + 1; } return result; } private static void parsePathParamValues(String input, Charset charset, MultiValueMap<String, String> output) { if (StringUtils.hasText(input)) { int index = input.indexOf('='); if (index != -1) { String name = input.substring(0, index); String value = input.substring(index + 1); for (String v : StringUtils.commaDelimitedListToStringArray(value)) { name = StringUtils.uriDecode(name, charset); if (StringUtils.hasText(name)) { output.add(name, StringUtils.uriDecode(v, charset)); } } } else { String name = StringUtils.uriDecode(input, charset); if (StringUtils.hasText(name)) { output.add(input, ""); } } } } static PathContainer subPath(PathContainer container, int fromIndex, int toIndex) { List<Element> elements = container.elements(); if (fromIndex == 0 && toIndex == elements.size()) { return container; } if (fromIndex == toIndex) { return EMPTY_PATH; } Assert.isTrue(fromIndex >= 0 && fromIndex < elements.size(), () -> "Invalid fromIndex: " + fromIndex); Assert.isTrue(toIndex >= 0 && toIndex <= elements.size(), () -> "Invalid toIndex: " + toIndex); Assert.isTrue(fromIndex < toIndex, () -> "fromIndex: " + fromIndex + " should be < toIndex " + toIndex); List<Element> subList = elements.subList(fromIndex, toIndex); String path = subList.stream().map(Element::value).collect(Collectors.joining("")); return new DefaultPathContainer(path, subList); } private static class DefaultPathSegment implements PathSegment { private final String value; private final String valueToMatch; private final char[] valueToMatchAsChars; private final MultiValueMap<String, String> parameters; public DefaultPathSegment(String value, String valueToMatch, MultiValueMap<String, String> params) { Assert.isTrue(!value.contains("/"), () -> "Invalid path segment value: " + value); this.value = value; this.valueToMatch = valueToMatch; this.valueToMatchAsChars = valueToMatch.toCharArray(); this.parameters = CollectionUtils.unmodifiableMultiValueMap(params); } @Override public String value() { return this.value; } @Override public String valueToMatch() { return this.valueToMatch; } @Override public char[] valueToMatchAsChars() { return this.valueToMatchAsChars; } @Override public MultiValueMap<String, String> parameters() { return this.parameters; } @Override public boolean equals(@Nullable Object other) { if (this == other) { return true; } if (other == null || getClass() != other.getClass()) { return false; } return this.value.equals(((DefaultPathSegment) other).value); } @Override public int hashCode() { return this.value.hashCode(); } public String toString() { return "[value='" + this.value + "']"; } } }