net.sourceforge.urin.AbsolutePath Maven / Gradle / Ivy

Go to download
/*
 * Copyright 2024 Mark Slater
 *
 * 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 net.sourceforge.urin;

import java.util.*;

import static java.util.Collections.emptyList;
import static net.sourceforge.urin.PathHelper.appendSegmentsTo;
import static net.sourceforge.urin.Segment.dot;
import static net.sourceforge.urin.Segment.dotDot;

/**
 * A path that begins with a '/' - typically representing a path relative to root.
 * 
 * To create instances, see {@link Path}.
 */
public final class AbsolutePath extends Path {

    private final Collection> segments;

    AbsolutePath(final Iterable> segments) {
        final Deque> normalisedSegments = normaliseRootless(segments);
        while (!normalisedSegments.isEmpty() && (dot().equals(normalisedSegments.getFirst()) || dotDot().equals(normalisedSegments.getFirst()))) {
            normalisedSegments.removeFirst();
        }
        this.segments = normalisedSegments.size() == 1 && normalisedSegments.getFirst().isEmpty() ? emptyList() : normalisedSegments;
    }

    @Override
    boolean firstPartIsSuppliedButIsEmpty() {
        return !segments.isEmpty() && segments.iterator().next().isEmpty();
    }

    @Override
    boolean firstPartIsSuppliedButContainsColon() {
        return !segments.isEmpty() && segments.iterator().next().containsColon();
    }

    @Override
    AbsolutePath resolveRelativeTo(final Path basePath) {
        return this;
    }

    @Override
    Path replaceLastSegmentWith(final Iterable> segments) {
        return new AbsolutePath<>(appendSegmentsTo(this.segments, segments));
    }

    @Override
    public boolean isAbsolute() {
        return true;
    }

    @Override
    public List> segments() {
        return new ArrayList<>(segments);
    }

    @Override
    String asString(final PrefixWithDotSegmentCriteria prefixWithDotSegmentCriteria) {
        final StringBuilder result = new StringBuilder("/");
        if (prefixWithDotSegmentCriteria.matches(this)) {
            result.append("./");
        }
        final Iterator> segmentIterator = segments.iterator();
        while (segmentIterator.hasNext()) {
            result.append(segmentIterator.next().asString());
            if (segmentIterator.hasNext()) {
                result.append('/');
            }
        }
        return result.toString();
    }

    @Override
    public boolean equals(final Object object) {
        if (this == object) {
            return true;
        } else if (object == null || getClass() != object.getClass()) {
            return false;
        }

        final AbsolutePath that = (AbsolutePath) object;
        return segments.equals(that.segments);
    }

    @Override
    public int hashCode() {
        return segments.hashCode();
    }

    @Override
    boolean isEmpty() {
        return segments.isEmpty();
    }

    @Override
    public String toString() {
        return segments.toString();
    }

    @Override
    @SuppressWarnings("NullableProblems")
    public Iterator> iterator() {
        return segments.iterator();
    }
}