IPath.java

Go to the documentation of this file.

/*
 * @cond LICENSE
 * ######################################################################################
 * # LGPL License                                                                       #
 * #                                                                                    #
 * # This file is part of the LightJason AgentSpeak(L++)                                #
 * # Copyright (c) 2015-19, LightJason (info@lightjason.org)                            #
 * # This program is free software: you can redistribute it and/or modify               #
 * # it under the terms of the GNU Lesser General Public License as                     #
 * # published by the Free Software Foundation, either version 3 of the                 #
 * # License, or (at your option) any later version.                                    #
 * #                                                                                    #
 * # This program is distributed in the hope that it will be useful,                    #
 * # but WITHOUT ANY WARRANTY; without even the implied warranty of                     #
 * # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the                      #
 * # GNU Lesser General Public License for more details.                                #
 * #                                                                                    #
 * # You should have received a copy of the GNU Lesser General Public License           #
 * # along with this program. If not, see http://www.gnu.org/licenses/                  #
 * ######################################################################################
 * @endcond
 */

package org.lightjason.agentspeak.common;

import edu.umd.cs.findbugs.annotations.SuppressFBWarnings;

import javax.annotation.Nonnull;
import java.io.Serializable;
import java.util.stream.Stream;


public interface IPath extends Serializable, Comparable<IPath>
{
    String DEFAULTSEPERATOR = "/";

    IPath EMPTY = new IPath()
    {
        private static final long serialVersionUID = -8529008893337445887L;

        @Nonnull
        @Override
        public final IPath append( @Nonnull final IPath p_path )
        {
            return this;
        }

        @Nonnull
        @Override
        public final IPath append( @Nonnull final String p_path )
        {
            return this;
        }

        @Nonnull
        @Override
        public final IPath remove( final int p_index )
        {
            return this;
        }

        @Nonnull
        @Override
        public final IPath remove( final int p_start, final int p_end )
        {
            return this;
        }

        @Override
        public final boolean endswith( @Nonnull final IPath p_path )
        {
            return false;
        }

        @Override
        public final boolean empty()
        {
            return true;
        }

        @Nonnull
        @Override
        public final String get( final int p_index )
        {
            return "";
        }

        @Nonnull
        @Override
        public final String path( final String p_separator )
        {
            return "";
        }

        @Nonnull
        @Override
        public final String path()
        {
            return "";
        }

        @Nonnull
        @Override
        public final String separator()
        {
            return "";
        }

        @Nonnull
        @Override
        public final IPath separator( @Nonnull final String p_separator )
        {
            return this;
        }

        @Nonnull
        @Override
        public final IPath lower()
        {
            return this;
        }

        @Nonnull
        @Override
        public final IPath upper()
        {
            return this;
        }

        @Nonnull
        @Override
        public final IPath subpath( final int p_fromindex )
        {
            return this;
        }

        @Nonnull
        @Override
        public final IPath subpath( final int p_fromindex, final int p_toindex )
        {
            return this;
        }

        @Nonnull
        @Override
        public final String suffix()
        {
            return "";
        }

        @Nonnull
        @Override
        public final IPath pushback( @Nonnull final IPath p_path )
        {
            return this;
        }

        @Nonnull
        @Override
        public final IPath pushback( @Nonnull final String p_path )
        {
            return this;
        }

        @Nonnull
        @Override
        public final IPath pushfront( @Nonnull final String p_path )
        {
            return this;
        }

        @Nonnull
        @Override
        public final IPath pushfront( @Nonnull final IPath p_path )
        {
            return this;
        }

        @Nonnull
        @Override
        public final String removesuffix()
        {
            return "";
        }

        @Nonnull
        @Override
        public final IPath reverse()
        {
            return this;
        }

        @Override
        public final int size()
        {
            return 0;
        }

        @Override
        public final boolean startswith( final IPath p_path )
        {
            return false;
        }

        @Override
        public final boolean startswith( final String p_path )
        {
            return false;
        }

        @Nonnull
        @Override
        public final Stream<String> stream()
        {
            return Stream.empty();
        }

        @Override
        public final int compareTo( @Nonnull final IPath p_path )
        {
            return Integer.compare( p_path.hashCode(), this.hashCode() );
        }

        @Override
        public final int hashCode()
        {
            return 0;
        }

        @Override
        @SuppressFBWarnings( "EQ_CHECK_FOR_OPERAND_NOT_COMPATIBLE_WITH_THIS" )
        public final boolean equals( final Object p_object )
        {
            return ( ( p_object instanceof IPath ) && ( this.hashCode() == p_object.hashCode() ) )
                   || ( ( p_object instanceof String ) && ( this.path().hashCode() == p_object.hashCode() ) );
        }
    };

    @Nonnull
    IPath append( @Nonnull final IPath p_path );

    @Nonnull
    IPath append( @Nonnull final String p_path );

    @Nonnull
    IPath remove( final int p_index );

    @Nonnull
    IPath remove( final int p_start, final int p_end );

    boolean endswith( @Nonnull final IPath p_path );

    boolean empty();

    @Nonnull
    String get( final int p_index );

    @Nonnull
    String path( final String p_separator );

    @Nonnull
    String path();

    @Nonnull
    String separator();

    @Nonnull
    IPath separator( @Nonnull final String p_separator );

    @Nonnull
    IPath lower();

    @Nonnull
    IPath upper();

    @Nonnull
    IPath subpath( final int p_fromindex );

    @Nonnull
    IPath subpath( final int p_fromindex, final int p_toindex );

    @Nonnull
    String suffix();

    @Nonnull
    IPath pushback( @Nonnull final IPath p_path );

    @Nonnull
    IPath pushback( @Nonnull final String p_path );

    @Nonnull
    IPath pushfront( @Nonnull final String p_path );

    @Nonnull
    IPath pushfront( @Nonnull final IPath p_path );

    @Nonnull
    String removesuffix();

    @Nonnull
    IPath reverse();

    int size();

    boolean startswith( final IPath p_path );

    boolean startswith( final String p_path );

    @Nonnull
    Stream<String> stream();

}