1ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin/* 2ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * Copyright (c) 2012, 2013, Oracle and/or its affiliates. All rights reserved. 3ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * 5ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * This code is free software; you can redistribute it and/or modify it 6ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * under the terms of the GNU General Public License version 2 only, as 7ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * published by the Free Software Foundation. Oracle designates this 8ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * particular file as subject to the "Classpath" exception as provided 9ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * by Oracle in the LICENSE file that accompanied this code. 10ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * 11ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * This code is distributed in the hope that it will be useful, but WITHOUT 12ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 13ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 14ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * version 2 for more details (a copy is included in the LICENSE file that 15ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * accompanied this code). 16ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * 17ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * You should have received a copy of the GNU General Public License version 18ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * 2 along with this work; if not, write to the Free Software Foundation, 19ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 20ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * 21ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 22ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * or visit www.oracle.com if you need additional information or have any 23ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * questions. 24ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin */ 25ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkinpackage java.util.stream; 26ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin 27ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin/** 28ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * An enum describing the known shape specializations for stream abstractions. 29ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * Each will correspond to a specific subinterface of {@link BaseStream} 30ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * (e.g., {@code REFERENCE} corresponds to {@code Stream}, {@code INT_VALUE} 31ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * corresponds to {@code IntStream}). Each may also correspond to 32ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * specializations of value-handling abstractions such as {@code Spliterator}, 33ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * {@code Consumer}, etc. 34ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * 35ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * @apiNote 36ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * This enum is used by implementations to determine compatibility between 37ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * streams and operations (i.e., if the output shape of a stream is compatible 38ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * with the input shape of the next operation). 39ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * 40ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * <p>Some APIs require you to specify both a generic type and a stream shape 41ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * for input or output elements, such as {@link TerminalOp} which has both 42ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * generic type parameters for its input types, and a getter for the 43ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * input shape. When representing primitive streams in this way, the 44ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * generic type parameter should correspond to the wrapper type for that 45ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * primitive type. 46ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * 47ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * @since 1.8 48289e51c2258b001f2aa6d6e67b21be7bb65d5102Igor Murashkin * @hide Visible for CTS testing only (OpenJDK8 tests). 49ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin */ 50289e51c2258b001f2aa6d6e67b21be7bb65d5102Igor Murashkinpublic enum StreamShape { 51ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin /** 52ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * The shape specialization corresponding to {@code Stream} and elements 53ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * that are object references. 54ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin */ 55ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin REFERENCE, 56ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin /** 57ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * The shape specialization corresponding to {@code IntStream} and elements 58ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * that are {@code int} values. 59ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin */ 60ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin INT_VALUE, 61ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin /** 62ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * The shape specialization corresponding to {@code LongStream} and elements 63ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * that are {@code long} values. 64ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin */ 65ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin LONG_VALUE, 66ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin /** 67ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * The shape specialization corresponding to {@code DoubleStream} and 68ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin * elements that are {@code double} values. 69ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin */ 70ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin DOUBLE_VALUE 71ff18b5f136f92154f2e05217e3953d10f459e561Igor Murashkin} 72