Mercurial > jdk8-mips64-public > langtools / annotate
test/tools/javac/lambda/lambdaExecution/TMapper.java@c09b7234cded (annotated)
test/tools/javac/lambda/lambdaExecution/TMapper.java
Tue, 14 May 2013 11:11:09 -0700
- author
- rfield
- date
- Tue, 14 May 2013 11:11:09 -0700
- changeset 1752
- c09b7234cded
- parent 0
- 959103a6100f
- permissions
- -rw-r--r--
8012556: Implement lambda methods on interfaces as static
8006140: Javac NPE compiling Lambda expression on initialization expression of static field in interface
Summary: Lambdas occurring in static contexts or those not needing instance information should be generated into static methods. This has long been the case for classes. However, as a work-around to the lack of support for statics on interfaces, interface lambda methods have been generated into default methods. For lambdas in interface static contexts (fields and static methods) this causes an NPE in javac because there is no 'this'. MethodHandles now support static methods on interfaces. This changeset allows lambda methods to be generated as static interface methods. An existing bug in Hotspot (8013875) is exposed in a test when the "-esa" flag is used. This test and another test that already exposed this bug have been marked with @ignore.
Reviewed-by: mcimadamore
| aoqi@0 | 1 | /* |
| aoqi@0 | 2 | * Copyright (c) 2010, 2011, Oracle and/or its affiliates. All rights reserved. |
| aoqi@0 | 3 | * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
| aoqi@0 | 4 | * |
| aoqi@0 | 5 | * This code is free software; you can redistribute it and/or modify it |
| aoqi@0 | 6 | * under the terms of the GNU General Public License version 2 only, as |
| aoqi@0 | 7 | * published by the Free Software Foundation. Oracle designates this |
| aoqi@0 | 8 | * particular file as subject to the "Classpath" exception as provided |
| aoqi@0 | 9 | * by Oracle in the LICENSE file that accompanied this code. |
| aoqi@0 | 10 | * |
| aoqi@0 | 11 | * This code is distributed in the hope that it will be useful, but WITHOUT |
| aoqi@0 | 12 | * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
| aoqi@0 | 13 | * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
| aoqi@0 | 14 | * version 2 for more details (a copy is included in the LICENSE file that |
| aoqi@0 | 15 | * accompanied this code). |
| aoqi@0 | 16 | * |
| aoqi@0 | 17 | * You should have received a copy of the GNU General Public License version |
| aoqi@0 | 18 | * 2 along with this work; if not, write to the Free Software Foundation, |
| aoqi@0 | 19 | * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
| aoqi@0 | 20 | * |
| aoqi@0 | 21 | * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
| aoqi@0 | 22 | * or visit www.oracle.com if you need additional information or have any |
| aoqi@0 | 23 | * questions. |
| aoqi@0 | 24 | */ |
| aoqi@0 | 25 | |
| aoqi@0 | 26 | /** |
| aoqi@0 | 27 | * Given an input object maps to an appropriate output object. A mapper may |
| aoqi@0 | 28 | * variously provide a mapping between types, object instances or keys and |
| aoqi@0 | 29 | * values or any other form of transformation upon the input. |
| aoqi@0 | 30 | * |
| aoqi@0 | 31 | * <p/>All mapper implementations are expected to: |
| aoqi@0 | 32 | * <ul> |
| aoqi@0 | 33 | * <li>Provide stable results such that for any {@code t} the result of two |
| aoqi@0 | 34 | * {@code map} operations are always equivalent. ie.<pre> |
| aoqi@0 | 35 | * Foo one = mapper.map(a); |
| aoqi@0 | 36 | * Foo two = mapper.map(a); |
| aoqi@0 | 37 | * |
| aoqi@0 | 38 | * assert one.equals(two) && two.equals(one); |
| aoqi@0 | 39 | * </pre></li> |
| aoqi@0 | 40 | * <li>Equivalent input objects should map to equivalent output objects. ie.<pre> |
| aoqi@0 | 41 | * assert a.equals(b); // a and b are equivalent |
| aoqi@0 | 42 | * |
| aoqi@0 | 43 | * Foo x = mapper.map(a); |
| aoqi@0 | 44 | * Foo y = mapper.map(b); |
| aoqi@0 | 45 | * |
| aoqi@0 | 46 | * assert x.equals(y); // their mapped results should be as equivalent. |
| aoqi@0 | 47 | * </pre></li> |
| aoqi@0 | 48 | * <li>The mapper should not modify the input object in any way that would |
| aoqi@0 | 49 | * change the mapping.</li> |
| aoqi@0 | 50 | * <li>When used for aggregate operations upon many elements mappers |
| aoqi@0 | 51 | * should not assume that the {@code map} operation will be called upon elements |
| aoqi@0 | 52 | * in any specific order.</li> |
| aoqi@0 | 53 | * </ul> |
| aoqi@0 | 54 | * |
| aoqi@0 | 55 | * @param <R> the type of output objects from {@code map} operation. May be the |
| aoqi@0 | 56 | * @param <T> the type of input objects provided to the {@code map} operation. |
| aoqi@0 | 57 | * same type as {@code <T>}. |
| aoqi@0 | 58 | */ |
| aoqi@0 | 59 | public interface TMapper<R, T> { |
| aoqi@0 | 60 | |
| aoqi@0 | 61 | /** |
| aoqi@0 | 62 | * Map the provided input object to an appropriate output object. |
| aoqi@0 | 63 | * |
| aoqi@0 | 64 | * @param t the input object to be mapped. |
| aoqi@0 | 65 | * @return the mapped output object. |
| aoqi@0 | 66 | */ |
| aoqi@0 | 67 | R map(T t); |
| aoqi@0 | 68 | } |
