org.apache.jena.atlas.lib.StreamOps Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of jena-base Show documentation
This module contains non-RDF library code and the common system runtime.
There is a newer version: 5.2.0
/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you 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.apache.jena.atlas.lib;

import java.io.PrintStream;
import java.util.*;
import java.util.stream.Collectors;
import java.util.stream.Stream;

import org.apache.jena.atlas.iterator.Iter;

/**
 * Collect some stream operations into one place.
 * Sometimes, the function form reads better.
 * @see Iter Iter - a stream-like class for iterators.
 */
public class StreamOps {
    /**
     * Iterator to Stream.
     * Call to {@linkplain Iter#asStream}.
     */
    public static  Stream stream(Iterator iter) {
        return Iter.asStream(iter);
    }

    /** Stream to {@link List} */
    public static  List toList(Stream stream) {
        return stream.collect(Collectors.toList());
    }

    /** Stream to {@link Set} */
    public static  Set toSet(Stream stream) {
        return stream.collect(Collectors.toSet());
    }

    /** First element or null */
    public static  X first(Stream stream) {
        return stream.findFirst().orElse(null);
    }

    /** An element from a {@link Collection} */
    public static  X element(Collection collection) {
        return first(collection.stream());
    }

    /** Debug : print stream.
     * This operation prints the whole stream at the point it is used,
     * and then returns a new stream of the same elements.
     */
    public static  Stream print(Stream stream) {
        return print(System.out, stream);
    }

    public static  Stream print(PrintStream out, Stream stream) {
        stream = stream.map(item -> { out.println(item); return item; });
        return toList(stream).stream();
    }

    public static  Stream print(PrintStream out, String leader, Stream stream) {
        String prefix = (leader==null) ? "" : leader;
        stream = stream.map(item -> { out.print(prefix); out.println(item); return item; });
        return toList(stream).stream();
    }


    /** Print immediate, noting empty streams */
    public static  Stream debug(Stream stream) {
        List elts = StreamOps.toList(stream);
        if ( elts.isEmpty() )
            System.out.println("[empty]");
        else {
            StringJoiner sj = new StringJoiner("\n  ", "[\n  ", "\n]");
            elts.forEach(b->sj.add(b.toString()));
            System.out.println(sj.toString());
        }
        return elts.stream();
    }

}