javascalautils.Projection Maven / Gradle / Ivy
/**
* Copyright 2015 Peter Nerg
*
* 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 javascalautils;
import java.util.Iterator;
import java.util.NoSuchElementException;
import java.util.function.Supplier;
import java.util.stream.Stream;
/**
* Abstract base class for the projections used by {@link Either}.
*
* @author Peter Nerg
* @since 1.1
*/
abstract class Projection implements Iterable {
/**
* Returns the value of the Right/Left in {@link Some} side in case the projection matches the side, else {@link None}.
* That is:
* If this is a {@link RightProjection} with a {@link Right}
* or
* If this is a {@link LeftProjection} with a {@link Left}.
* Then then return {@link Some} containing the value of the {@link Left}/{@link Right}.
* Any other case, return {@link None}.
*
* @return The Option
* @since 1.1
*/
public Option asOption() {
return Option.apply(orNull());
}
/**
* Returns the value of the Right/Left side in case the projection matches the side, else throw {@link NoSuchElementException}.
* That is:
* If this is a {@link RightProjection} with a {@link Right}
* or
* If this is a {@link LeftProjection} with a {@link Left}.
* Then return the value of the {@link Left}/{@link Right}.
* Any other case, throw {@link NoSuchElementException}.
*
* @return The value
* @since 1.1
*/
public T get() {
return asOption().get();
}
/**
* Returns the iterator of the Right/Left side in case the projection matches the side.
* That is:
* If this is a {@link RightProjection} with a {@link Right}
* or
* If this is a {@link LeftProjection} with a {@link Left}.
* Then return an iterator with the value for the {@link Left}/{@link Right}.
* Else return an empty iterator
*
* @return The iterator
* @since 1.1
*/
@Override
public Iterator iterator() {
return stream().iterator();
}
/**
* Returns the stream of the Right/Left side in case the projection matches the side.
* That is:
* If this is a {@link RightProjection} with a {@link Right}
* or
* If this is a {@link LeftProjection} with a {@link Left}.
* Then return a stream with the value for the {@link Left}/{@link Right}.
* Else return an empty stream
*
* @return The stream
* @since 1.1
*/
public Stream stream() {
return asOption().stream();
}
/**
* Returns the value of this projection if it is of the correct type else null.
* That is:
* If this is a {@link RightProjection} with a {@link Right}
* or
* If this is a {@link LeftProjection} with a {@link Left}.
* Then return the value of the {@link Left}/{@link Right}.
* Any other case, return null.
* In an essence this is a specialized version of {@link #getOrElse(Supplier)} where the supplier returns null.
* getOrElse(() -> null)
*
* @return The value or null
* @since 1.1
*/
public T orNull() {
return getOrElse(() -> null);
}
/**
* Returns the value of this projection if it is of the correct type else else the value provided by the supplier.
* That is:
* If this is a {@link RightProjection} with a {@link Right}
* or
* If this is a {@link LeftProjection} with a {@link Left}.
* Then return the value of the {@link Left}/{@link Right}.
* Any other case, return the value provided by the supplier.
*
* @param supplier
* The supplier to use if else becomes used
* @return The value or null
* @since 1.1
*/
public abstract T getOrElse(Supplier supplier);
}