1 /* |
1 /* |
2 * Copyright (c) 2010, 2012, Oracle and/or its affiliates. All rights reserved. |
2 * Copyright (c) 2010, 2013, Oracle and/or its affiliates. All rights reserved. |
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
4 * |
4 * |
5 * This code is free software; you can redistribute it and/or modify it |
5 * This code is free software; you can redistribute it and/or modify it |
6 * under the terms of the GNU General Public License version 2 only, as |
6 * under the terms of the GNU General Public License version 2 only, as |
7 * published by the Free Software Foundation. Oracle designates this |
7 * published by the Free Software Foundation. Oracle designates this |
50 * class will also be introduced to correspond to the new language |
50 * class will also be introduced to correspond to the new language |
51 * level; this visitor will have different default behavior for the |
51 * level; this visitor will have different default behavior for the |
52 * visit method in question. When the new visitor is introduced, all |
52 * visit method in question. When the new visitor is introduced, all |
53 * or portions of this visitor may be deprecated. |
53 * or portions of this visitor may be deprecated. |
54 * |
54 * |
|
55 * <p>Note that adding a default implementation of a new visit method |
|
56 * in a visitor class will occur instead of adding a <em>default |
|
57 * method</em> directly in the visitor interface since a Java SE 8 |
|
58 * language feature cannot be used to this version of the API since |
|
59 * this version is required to be runnable on Java SE 7 |
|
60 * implementations. Future versions of the API that are only required |
|
61 * to run on Java SE 8 and later may take advantage of default methods |
|
62 * in this situation. |
|
63 * |
55 * @param <R> the return type of this visitor's methods. Use {@link |
64 * @param <R> the return type of this visitor's methods. Use {@link |
56 * Void} for visitors that do not need to return results. |
65 * Void} for visitors that do not need to return results. |
57 * @param <P> the type of the additional parameter to this visitor's |
66 * @param <P> the type of the additional parameter to this visitor's |
58 * methods. Use {@code Void} for visitors that do not need an |
67 * methods. Use {@code Void} for visitors that do not need an |
59 * additional parameter. |
68 * additional parameter. |