com.tangosol.internal.util.stream.StreamSupport Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of coherence Show documentation
Oracle Coherence Community Edition
There is a newer version: 24.03
/*
 * Copyright (c) 2000, 2021, Oracle and/or its affiliates.
 *
 * Licensed under the Universal Permissive License v 1.0 as shown at
 * http://oss.oracle.com/licenses/upl.
 */
package com.tangosol.internal.util.stream;

import com.tangosol.net.NamedCache;

import com.tangosol.util.Filter;
import com.tangosol.util.InvocableMap;
import com.tangosol.util.InvocableMap.Entry;
import com.tangosol.util.WrapperCollections;
import com.tangosol.util.function.Remote;

import com.tangosol.util.stream.RemotePipeline;
import com.tangosol.util.stream.RemoteStream;

import java.util.Collection;
import java.util.Objects;
import java.util.Set;

import java.util.stream.Stream;


/**
 * Low-level utility methods for creating and manipulating streams.
 *
 * @author as  2014.09.16
 * @since 12.2.1
 */
public abstract class StreamSupport
    {
    /**
     * Create a new sequential or parallel {@code Stream} for an {@code
     * InvocableMap} entries.
     *
     * @param map         an {@code InvocableMap} containing the stream elements
     * @param fParallel   if {@code true} then the returned stream is a parallel
     *                    stream; if {@code false} the returned stream is a
     *                    sequential stream
     * @param colKeys     an optional collection of keys
     * @param filter      an optional filter
     *
     * @return a new sequential or parallel {@code Stream}
     */
    public static  RemoteStream> entryStream(
            InvocableMap map, boolean fParallel, Collection colKeys, Filter filter)
        {
        Objects.requireNonNull(map);

        ReferencePipeline, InvocableMap.Entry, Stream>> head =
                new ReferencePipeline.Head<>(map, fParallel, colKeys, filter, Remote.Function.identity());
        return head.unordered();
        }

    /**
     * Create a builder for a {@code Pipeline} for a {@code Stream} of {@code
     * InvocableMap} entries.
     * 
     * Calling any terminal operation other than {@link RemoteStream#pipeline()} on
     * the returned stream will throw an {@code IllegalStateException}.
     *
     * @return a new parallel {@code Stream} that can be used to build a
     *         {@link RemotePipeline} of intermediate operations
     *
     * @throws IllegalStateException if any terminal operation other than
     *                               {@link RemoteStream#pipeline()} is invoked
     *                               on the returned stream
     */
    public static  RemoteStream> pipelineBuilder()
        {
        ReferencePipeline, InvocableMap.Entry, Stream>> head =
                new ReferencePipeline.Head<>(null, true, null, null, Remote.Function.identity());
        return head.unordered();
        }

    /**
     * Create an empty pipeline for a stream of {@code InvocableMap} entries.
     *
     * @param  the type of entry key
     * @param  the type of entry value
     *
     * @return an empty pipeline for a stream of entries
     */
    public static  RemotePipeline>> emptyPipeline()
        {
        return new ReferencePipeline.Head<>(null, true, null, null, Remote.Function.identity());
        }
    }