org.dmfs.rfc3986.uris.StructuredUri Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of rfc3986-uri Show documentation
RFC 3986 compliant URI implementation.
There is a newer version: 0.8.1
/*
 * Copyright 2017 dmfs GmbH
 *
 * 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.dmfs.rfc3986.uris;

import org.dmfs.rfc3986.Authority;
import org.dmfs.rfc3986.Fragment;
import org.dmfs.rfc3986.Path;
import org.dmfs.rfc3986.Query;
import org.dmfs.rfc3986.Scheme;
import org.dmfs.rfc3986.Uri;
import org.dmfs.rfc3986.paths.EmptyPath;
import org.dmfs.rfc3986.utils.Absent;
import org.dmfs.rfc3986.utils.Optional;
import org.dmfs.rfc3986.utils.Present;


/**
 * A {@link Uri} that's composed of its individual components.
 *
 * @author Marten Gajda
 */
public final class StructuredUri implements Uri
{
    private final Optional mScheme;
    private final Optional mAuthority;
    private final Path mPath;
    private final Optional mQuery;
    private final Optional mFragment;


    public StructuredUri(Scheme scheme, Authority authority)
    {
        this(new Present<>(scheme), new Present<>(authority), EmptyPath.INSTANCE, Absent.absent(), Absent.absent());
    }


    public StructuredUri(Scheme scheme, Authority authority, Path path)
    {
        this(new Present<>(scheme), new Present<>(authority), path, Absent.absent(), Absent.absent());
    }


    public StructuredUri(Scheme scheme, Authority authority, Path path, Query query)
    {
        this(new Present<>(scheme), new Present<>(authority), path, new Present<>(query), Absent.absent());
    }


    public StructuredUri(Scheme scheme, Authority authority, Path path, Query query, Fragment fragment)
    {
        this(new Present<>(scheme), new Present<>(authority), path, new Present<>(query), new Present<>(fragment));
    }


    private StructuredUri(Optional scheme, Optional authority, Path path, Optional query, Optional fragment)
    {
        mScheme = scheme;
        mAuthority = authority;
        mPath = path;
        mQuery = query;
        mFragment = fragment;
        if (authority.isPresent() && !path.isAbsolute() && !path.isEmpty())
        {
            throw new IllegalArgumentException("URIs with an authority must have an absolute or empty path.");
        }
        if (!scheme.isPresent() && !authority.isPresent() && !mPath.isAbsolute() && !path.isEmpty() && path.iterator().next().toString().contains(":"))
        {
            throw new IllegalArgumentException(
                    "URIs without scheme and authority must have not have a \":\" in the first path segment unless the path is absolute.");
        }
        // TODO: do we have more constraints?
    }


    @Override
    public Optional scheme()
    {
        return mScheme;
    }


    @Override
    public Optional authority()
    {
        return mAuthority;
    }


    @Override
    public Path path()
    {
        return mPath;
    }


    @Override
    public Optional query()
    {
        return mQuery;
    }


    @Override
    public Optional fragment()
    {
        return mFragment;
    }


    @Override
    public boolean isHierarchical()
    {
        return !mScheme.isPresent() || mAuthority.isPresent() || mPath.isAbsolute();
    }


    @Override
    public boolean isAbsolute()
    {
        return mScheme.isPresent();
    }
}