com.tinkerpop.pipes.sideeffect.OptionalPipe Maven / Gradle / Ivy

Go to download
package com.tinkerpop.pipes.sideeffect;

import com.tinkerpop.pipes.AbstractPipe;
import com.tinkerpop.pipes.Pipe;
import com.tinkerpop.pipes.util.MetaPipe;
import com.tinkerpop.pipes.util.PipeHelper;
import com.tinkerpop.pipes.util.iterators.SingleIterator;

import java.util.Arrays;
import java.util.List;
import java.util.NoSuchElementException;

/**
 * OptionalPipe will compute the incoming object within the internal pipe.
 * It is similar to BackFilterPipe, except that no filtering occurs.
 * Moreover, it is a SideEffectPipe in that it is only useful for its side-effect (internal pipe) behavior.
 * However, getSideEffect() simply returns null as there is no internal data structure.
 *
 * @author Marko A. Rodriguez (http://markorodriguez.com)
 */
public class OptionalPipe extends AbstractPipe implements SideEffectPipe, MetaPipe {

    private final Pipe pipe;

    public OptionalPipe(final Pipe pipe) {
        this.pipe = pipe;
    }

    public S processNextStart() {
        final S s = this.starts.next();
        this.pipe.setStarts(new SingleIterator(s));

        try {
            while (true) {
                pipe.next();
            }
        } catch (final NoSuchElementException e) {
        }
        return s;
    }

    /**
     * The side effect is the behavior of the internal pipe, not a gettable data structure.
     *
     * @return will return null
     */
    public Object getSideEffect() {
        return null;
    }

    public String toString() {
        return PipeHelper.makePipeString(this, this.pipe);
    }

    public List getPipes() {
        return (List) Arrays.asList(this.pipe);
    }

}