JavaDocExamplesTest.java revision 4251:f09930d526ba
1/*
2 * Copyright (c) 2009, 2011, Oracle and/or its affiliates. All rights reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
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
7 * published by the Free Software Foundation.  Oracle designates this
8 * particular file as subject to the "Classpath" exception as provided
9 * by Oracle in the LICENSE file that accompanied this code.
10 *
11 * This code is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
14 * version 2 for more details (a copy is included in the LICENSE file that
15 * accompanied this code).
16 *
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22 * or visit www.oracle.com if you need additional information or have any
23 * questions.
24 */
25
26/* @test
27 * @summary example code used in javadoc for java.lang.invoke API
28 * @compile JavaDocExamplesTest.java
29 * @run junit/othervm test.java.lang.invoke.JavaDocExamplesTest
30 */
31
32/*
33---- To run outside jtreg:
34$ $JAVA7X_HOME/bin/javac -cp $JUNIT4_JAR -d /tmp/Classes \
35   $DAVINCI/sources/jdk/test/java/lang/invoke/JavaDocExamplesTest.java
36$ $JAVA7X_HOME/bin/java   -cp $JUNIT4_JAR:/tmp/Classes \
37   -DJavaDocExamplesTest.verbosity=1 \
38     test.java.lang.invoke.JavaDocExamplesTest
39----
40*/
41
42package test.java.lang.invoke;
43
44import java.lang.invoke.*;
45import static java.lang.invoke.MethodHandles.*;
46import static java.lang.invoke.MethodType.*;
47
48import java.util.*;
49
50import org.junit.*;
51import static org.junit.Assert.*;
52
53
54/**
55 * @author jrose
56 */
57public class JavaDocExamplesTest {
58    /** Wrapper for running the JUnit tests in this module.
59     *  Put JUnit on the classpath!
60     */
61    public static void main(String... ignore) throws Throwable {
62        System.out.println("can run this as:");
63        System.out.println("$ java org.junit.runner.JUnitCore "+JavaDocExamplesTest.class.getName());
64        new JavaDocExamplesTest().run();
65    }
66    public void run() throws Throwable {
67        testFindVirtual();
68        testPermuteArguments();
69        testDropArguments();
70        testFilterArguments();
71        testFoldArguments();
72        testMethodHandlesSummary();
73        testAsSpreader();
74        testAsCollector();
75        testAsVarargsCollector();
76        testAsFixedArity();
77        testAsTypeCornerCases();
78        testMutableCallSite();
79    }
80    // How much output?
81    static final Class<?> THIS_CLASS = JavaDocExamplesTest.class;
82    static int verbosity = Integer.getInteger(THIS_CLASS.getSimpleName()+".verbosity", 0);
83
84
85{}
86static final private Lookup LOOKUP = lookup();
87// static final private MethodHandle CONCAT_1 = LOOKUP.findVirtual(String.class,
88//     "concat", methodType(String.class, String.class));
89// static final private MethodHandle HASHCODE_1 = LOOKUP.findVirtual(Object.class,
90//     "hashCode", methodType(int.class));
91
92// form required if ReflectiveOperationException is intercepted:
93    static final private MethodHandle CONCAT_2, HASHCODE_2, ADD_2, SUB_2;
94static {
95  try {
96    Class<?> THIS_CLASS = LOOKUP.lookupClass();
97    CONCAT_2 = LOOKUP.findVirtual(String.class,
98      "concat", methodType(String.class, String.class));
99    HASHCODE_2 = LOOKUP.findVirtual(Object.class,
100      "hashCode", methodType(int.class));
101    ADD_2 = LOOKUP.findStatic(THIS_CLASS, "add", methodType(int.class, int.class, int.class));
102    SUB_2 = LOOKUP.findStatic(THIS_CLASS, "sub", methodType(int.class, int.class, int.class));
103   } catch (ReflectiveOperationException ex) {
104     throw new RuntimeException(ex);
105   }
106}
107    static int add(int x, int y) { return x + y; }
108    static int sub(int x, int y) { return x - y; }
109
110{}
111
112    @Test public void testFindVirtual() throws Throwable {
113{}
114MethodHandle CONCAT_3 = LOOKUP.findVirtual(String.class,
115  "concat", methodType(String.class, String.class));
116MethodHandle HASHCODE_3 = LOOKUP.findVirtual(Object.class,
117  "hashCode", methodType(int.class));
118//assertEquals("xy", (String) CONCAT_1.invokeExact("x", "y"));
119assertEquals("xy", (String) CONCAT_2.invokeExact("x", "y"));
120assertEquals("xy", (String) CONCAT_3.invokeExact("x", "y"));
121//assertEquals("xy".hashCode(), (int) HASHCODE_1.invokeExact((Object)"xy"));
122assertEquals("xy".hashCode(), (int) HASHCODE_2.invokeExact((Object)"xy"));
123assertEquals("xy".hashCode(), (int) HASHCODE_3.invokeExact((Object)"xy"));
124{}
125    }
126
127    @Test public void testPermuteArguments() throws Throwable {
128        {{
129{} /// JAVADOC
130MethodType intfn1 = methodType(int.class, int.class);
131MethodType intfn2 = methodType(int.class, int.class, int.class);
132MethodHandle sub = SUB_2;// ... {int x, int y => x-y} ...;
133assert(sub.type().equals(intfn2));
134MethodHandle sub1 = permuteArguments(sub, intfn2, 0, 1);
135MethodHandle rsub = permuteArguments(sub, intfn2, 1, 0);
136assert((int)rsub.invokeExact(1, 100) == 99);
137MethodHandle add = ADD_2;// ... {int x, int y => x+y} ...;
138assert(add.type().equals(intfn2));
139MethodHandle twice = permuteArguments(add, intfn1, 0, 0);
140assert(twice.type().equals(intfn1));
141assert((int)twice.invokeExact(21) == 42);
142            }}
143        {{
144{} /// JAVADOC
145MethodHandle cat = lookup().findVirtual(String.class,
146  "concat", methodType(String.class, String.class));
147assertEquals("xy", (String) cat.invokeExact("x", "y"));
148MethodHandle d0 = dropArguments(cat, 0, String.class);
149assertEquals("yz", (String) d0.invokeExact("x", "y", "z"));
150MethodHandle d1 = dropArguments(cat, 1, String.class);
151assertEquals("xz", (String) d1.invokeExact("x", "y", "z"));
152MethodHandle d2 = dropArguments(cat, 2, String.class);
153assertEquals("xy", (String) d2.invokeExact("x", "y", "z"));
154MethodHandle d12 = dropArguments(cat, 1, int.class, boolean.class);
155assertEquals("xz", (String) d12.invokeExact("x", 12, true, "z"));
156            }}
157    }
158
159    @Test public void testDropArguments() throws Throwable {
160        {{
161{} /// JAVADOC
162MethodHandle cat = lookup().findVirtual(String.class,
163  "concat", methodType(String.class, String.class));
164assertEquals("xy", (String) cat.invokeExact("x", "y"));
165MethodType bigType = cat.type().insertParameterTypes(0, int.class, String.class);
166MethodHandle d0 = dropArguments(cat, 0, bigType.parameterList().subList(0,2));
167assertEquals(bigType, d0.type());
168assertEquals("yz", (String) d0.invokeExact(123, "x", "y", "z"));
169            }}
170        {{
171{} /// JAVADOC
172MethodHandle cat = lookup().findVirtual(String.class,
173  "concat", methodType(String.class, String.class));
174assertEquals("xy", (String) cat.invokeExact("x", "y"));
175MethodHandle d0 = dropArguments(cat, 0, String.class);
176assertEquals("yz", (String) d0.invokeExact("x", "y", "z"));
177MethodHandle d1 = dropArguments(cat, 1, String.class);
178assertEquals("xz", (String) d1.invokeExact("x", "y", "z"));
179MethodHandle d2 = dropArguments(cat, 2, String.class);
180assertEquals("xy", (String) d2.invokeExact("x", "y", "z"));
181MethodHandle d12 = dropArguments(cat, 1, int.class, boolean.class);
182assertEquals("xz", (String) d12.invokeExact("x", 12, true, "z"));
183            }}
184    }
185
186    @Test public void testFilterArguments() throws Throwable {
187        {{
188{} /// JAVADOC
189MethodHandle cat = lookup().findVirtual(String.class,
190  "concat", methodType(String.class, String.class));
191MethodHandle upcase = lookup().findVirtual(String.class,
192  "toUpperCase", methodType(String.class));
193assertEquals("xy", (String) cat.invokeExact("x", "y"));
194MethodHandle f0 = filterArguments(cat, 0, upcase);
195assertEquals("Xy", (String) f0.invokeExact("x", "y")); // Xy
196MethodHandle f1 = filterArguments(cat, 1, upcase);
197assertEquals("xY", (String) f1.invokeExact("x", "y")); // xY
198MethodHandle f2 = filterArguments(cat, 0, upcase, upcase);
199assertEquals("XY", (String) f2.invokeExact("x", "y")); // XY
200            }}
201    }
202
203    @Test public void testFoldArguments() throws Throwable {
204        {{
205{} /// JAVADOC
206MethodHandle trace = publicLookup().findVirtual(java.io.PrintStream.class,
207  "println", methodType(void.class, String.class))
208    .bindTo(System.out);
209MethodHandle cat = lookup().findVirtual(String.class,
210  "concat", methodType(String.class, String.class));
211assertEquals("boojum", (String) cat.invokeExact("boo", "jum"));
212MethodHandle catTrace = foldArguments(cat, trace);
213// also prints "boo":
214assertEquals("boojum", (String) catTrace.invokeExact("boo", "jum"));
215            }}
216    }
217
218    static void assertEquals(Object exp, Object act) {
219        if (verbosity > 0)
220            System.out.println("result: "+act);
221        Assert.assertEquals(exp, act);
222    }
223
224    @Test public void testMethodHandlesSummary() throws Throwable {
225        {{
226{} /// JAVADOC
227Object x, y; String s; int i;
228MethodType mt; MethodHandle mh;
229MethodHandles.Lookup lookup = MethodHandles.lookup();
230// mt is (char,char)String
231mt = MethodType.methodType(String.class, char.class, char.class);
232mh = lookup.findVirtual(String.class, "replace", mt);
233s = (String) mh.invokeExact("daddy",'d','n');
234// invokeExact(Ljava/lang/String;CC)Ljava/lang/String;
235assertEquals(s, "nanny");
236// weakly typed invocation (using MHs.invoke)
237s = (String) mh.invokeWithArguments("sappy", 'p', 'v');
238assertEquals(s, "savvy");
239// mt is (Object[])List
240mt = MethodType.methodType(java.util.List.class, Object[].class);
241mh = lookup.findStatic(java.util.Arrays.class, "asList", mt);
242assert(mh.isVarargsCollector());
243x = mh.invoke("one", "two");
244// invoke(Ljava/lang/String;Ljava/lang/String;)Ljava/lang/Object;
245assertEquals(x, java.util.Arrays.asList("one","two"));
246// mt is (Object,Object,Object)Object
247mt = MethodType.genericMethodType(3);
248mh = mh.asType(mt);
249x = mh.invokeExact((Object)1, (Object)2, (Object)3);
250// invokeExact(Ljava/lang/Object;Ljava/lang/Object;Ljava/lang/Object;)Ljava/lang/Object;
251assertEquals(x, java.util.Arrays.asList(1,2,3));
252// mt is ()int
253mt = MethodType.methodType(int.class);
254mh = lookup.findVirtual(java.util.List.class, "size", mt);
255i = (int) mh.invokeExact(java.util.Arrays.asList(1,2,3));
256// invokeExact(Ljava/util/List;)I
257assert(i == 3);
258mt = MethodType.methodType(void.class, String.class);
259mh = lookup.findVirtual(java.io.PrintStream.class, "println", mt);
260mh.invokeExact(System.out, "Hello, world.");
261// invokeExact(Ljava/io/PrintStream;Ljava/lang/String;)V
262{}
263            }}
264    }
265
266    @Test public void testAsSpreader() throws Throwable {
267        {{
268{} /// JAVADOC
269MethodHandle equals = publicLookup()
270  .findVirtual(String.class, "equals", methodType(boolean.class, Object.class));
271assert( (boolean) equals.invokeExact("me", (Object)"me"));
272assert(!(boolean) equals.invokeExact("me", (Object)"thee"));
273// spread both arguments from a 2-array:
274MethodHandle eq2 = equals.asSpreader(Object[].class, 2);
275assert( (boolean) eq2.invokeExact(new Object[]{ "me", "me" }));
276assert(!(boolean) eq2.invokeExact(new Object[]{ "me", "thee" }));
277// spread both arguments from a String array:
278MethodHandle eq2s = equals.asSpreader(String[].class, 2);
279assert( (boolean) eq2s.invokeExact(new String[]{ "me", "me" }));
280assert(!(boolean) eq2s.invokeExact(new String[]{ "me", "thee" }));
281// spread second arguments from a 1-array:
282MethodHandle eq1 = equals.asSpreader(Object[].class, 1);
283assert( (boolean) eq1.invokeExact("me", new Object[]{ "me" }));
284assert(!(boolean) eq1.invokeExact("me", new Object[]{ "thee" }));
285// spread no arguments from a 0-array or null:
286MethodHandle eq0 = equals.asSpreader(Object[].class, 0);
287assert( (boolean) eq0.invokeExact("me", (Object)"me", new Object[0]));
288assert(!(boolean) eq0.invokeExact("me", (Object)"thee", (Object[])null));
289// asSpreader and asCollector are approximate inverses:
290for (int n = 0; n <= 2; n++) {
291    for (Class<?> a : new Class<?>[]{Object[].class, String[].class, CharSequence[].class}) {
292        MethodHandle equals2 = equals.asSpreader(a, n).asCollector(a, n);
293        assert( (boolean) equals2.invokeWithArguments("me", "me"));
294        assert(!(boolean) equals2.invokeWithArguments("me", "thee"));
295    }
296}
297MethodHandle caToString = publicLookup()
298  .findStatic(Arrays.class, "toString", methodType(String.class, char[].class));
299assertEquals("[A, B, C]", (String) caToString.invokeExact("ABC".toCharArray()));
300MethodHandle caString3 = caToString.asCollector(char[].class, 3);
301assertEquals("[A, B, C]", (String) caString3.invokeExact('A', 'B', 'C'));
302MethodHandle caToString2 = caString3.asSpreader(char[].class, 2);
303assertEquals("[A, B, C]", (String) caToString2.invokeExact('A', "BC".toCharArray()));
304            }}
305    }
306
307    @Test public void testAsCollector() throws Throwable {
308        {{
309{} /// JAVADOC
310MethodHandle deepToString = publicLookup()
311  .findStatic(Arrays.class, "deepToString", methodType(String.class, Object[].class));
312assertEquals("[won]",   (String) deepToString.invokeExact(new Object[]{"won"}));
313MethodHandle ts1 = deepToString.asCollector(Object[].class, 1);
314assertEquals(methodType(String.class, Object.class), ts1.type());
315//assertEquals("[won]", (String) ts1.invokeExact(         new Object[]{"won"})); //FAIL
316assertEquals("[[won]]", (String) ts1.invokeExact((Object) new Object[]{"won"}));
317// arrayType can be a subtype of Object[]
318MethodHandle ts2 = deepToString.asCollector(String[].class, 2);
319assertEquals(methodType(String.class, String.class, String.class), ts2.type());
320assertEquals("[two, too]", (String) ts2.invokeExact("two", "too"));
321MethodHandle ts0 = deepToString.asCollector(Object[].class, 0);
322assertEquals("[]", (String) ts0.invokeExact());
323// collectors can be nested, Lisp-style
324MethodHandle ts22 = deepToString.asCollector(Object[].class, 3).asCollector(String[].class, 2);
325assertEquals("[A, B, [C, D]]", ((String) ts22.invokeExact((Object)'A', (Object)"B", "C", "D")));
326// arrayType can be any primitive array type
327MethodHandle bytesToString = publicLookup()
328  .findStatic(Arrays.class, "toString", methodType(String.class, byte[].class))
329  .asCollector(byte[].class, 3);
330assertEquals("[1, 2, 3]", (String) bytesToString.invokeExact((byte)1, (byte)2, (byte)3));
331MethodHandle longsToString = publicLookup()
332  .findStatic(Arrays.class, "toString", methodType(String.class, long[].class))
333  .asCollector(long[].class, 1);
334assertEquals("[123]", (String) longsToString.invokeExact((long)123));
335            }}
336    }
337
338    @Test public void testAsVarargsCollector() throws Throwable {
339        {{
340{} /// JAVADOC
341MethodHandle deepToString = publicLookup()
342  .findStatic(Arrays.class, "deepToString", methodType(String.class, Object[].class));
343MethodHandle ts1 = deepToString.asVarargsCollector(Object[].class);
344assertEquals("[won]",   (String) ts1.invokeExact(    new Object[]{"won"}));
345assertEquals("[won]",   (String) ts1.invoke(         new Object[]{"won"}));
346assertEquals("[won]",   (String) ts1.invoke(                      "won" ));
347assertEquals("[[won]]", (String) ts1.invoke((Object) new Object[]{"won"}));
348// findStatic of Arrays.asList(...) produces a variable arity method handle:
349MethodHandle asList = publicLookup()
350  .findStatic(Arrays.class, "asList", methodType(List.class, Object[].class));
351assertEquals(methodType(List.class, Object[].class), asList.type());
352assert(asList.isVarargsCollector());
353assertEquals("[]", asList.invoke().toString());
354assertEquals("[1]", asList.invoke(1).toString());
355assertEquals("[two, too]", asList.invoke("two", "too").toString());
356String[] argv = { "three", "thee", "tee" };
357assertEquals("[three, thee, tee]", asList.invoke(argv).toString());
358assertEquals("[three, thee, tee]", asList.invoke((Object[])argv).toString());
359List ls = (List) asList.invoke((Object)argv);
360assertEquals(1, ls.size());
361assertEquals("[three, thee, tee]", Arrays.toString((Object[])ls.get(0)));
362            }}
363    }
364
365    @Test public void testAsFixedArity() throws Throwable {
366        {{
367{} /// JAVADOC
368MethodHandle asListVar = publicLookup()
369  .findStatic(Arrays.class, "asList", methodType(List.class, Object[].class))
370  .asVarargsCollector(Object[].class);
371MethodHandle asListFix = asListVar.asFixedArity();
372assertEquals("[1]", asListVar.invoke(1).toString());
373Exception caught = null;
374try { asListFix.invoke((Object)1); }
375catch (Exception ex) { caught = ex; }
376assert(caught instanceof ClassCastException);
377assertEquals("[two, too]", asListVar.invoke("two", "too").toString());
378try { asListFix.invoke("two", "too"); }
379catch (Exception ex) { caught = ex; }
380assert(caught instanceof WrongMethodTypeException);
381Object[] argv = { "three", "thee", "tee" };
382assertEquals("[three, thee, tee]", asListVar.invoke(argv).toString());
383assertEquals("[three, thee, tee]", asListFix.invoke(argv).toString());
384assertEquals(1, ((List) asListVar.invoke((Object)argv)).size());
385assertEquals("[three, thee, tee]", asListFix.invoke((Object)argv).toString());
386            }}
387    }
388
389    @Test public void testAsTypeCornerCases() throws Throwable {
390        {{
391{} /// JAVADOC
392MethodHandle i2s = publicLookup()
393  .findVirtual(Integer.class, "toString", methodType(String.class));
394i2s = i2s.asType(i2s.type().unwrap());
395MethodHandle l2s = publicLookup()
396  .findVirtual(Long.class, "toString", methodType(String.class));
397l2s = l2s.asType(l2s.type().unwrap());
398
399Exception caught = null;
400try { i2s.asType(methodType(String.class, String.class)); }
401catch (Exception ex) { caught = ex; }
402assert(caught instanceof WrongMethodTypeException);
403
404i2s.asType(methodType(String.class, byte.class));
405i2s.asType(methodType(String.class, Byte.class));
406i2s.asType(methodType(String.class, Character.class));
407i2s.asType(methodType(String.class, Integer.class));
408l2s.asType(methodType(String.class, byte.class));
409l2s.asType(methodType(String.class, Byte.class));
410l2s.asType(methodType(String.class, Character.class));
411l2s.asType(methodType(String.class, Integer.class));
412l2s.asType(methodType(String.class, Long.class));
413
414caught = null;
415try { i2s.asType(methodType(String.class, Long.class)); }
416catch (Exception ex) { caught = ex; }
417assert(caught instanceof WrongMethodTypeException);
418
419MethodHandle i2sGen = i2s.asType(methodType(String.class, Object.class));
420MethodHandle l2sGen = l2s.asType(methodType(String.class, Object.class));
421
422i2sGen.invoke(42);  // int -> Integer -> Object -> Integer -> int
423i2sGen.invoke((byte)4);  // byte -> Byte -> Object -> Byte -> byte -> int
424l2sGen.invoke(42);  // int -> Integer -> Object -> Integer -> int
425l2sGen.invoke((byte)4);  // byte -> Byte -> Object -> Byte -> byte -> int
426l2sGen.invoke(0x420000000L);
427
428caught = null;
429try { i2sGen.invoke(0x420000000L); } // long -> Long -> Object -> Integer CCE
430catch (Exception ex) { caught = ex; }
431assert(caught instanceof ClassCastException);
432
433caught = null;
434try { i2sGen.invoke("asdf"); } // String -> Object -> Integer CCE
435catch (Exception ex) { caught = ex; }
436assert(caught instanceof ClassCastException);
437{}
438            }}
439    }
440
441    @Test public void testMutableCallSite() throws Throwable {
442        {{
443{} /// JAVADOC
444MutableCallSite name = new MutableCallSite(MethodType.methodType(String.class));
445MethodHandle MH_name = name.dynamicInvoker();
446MethodType MT_str1 = MethodType.methodType(String.class);
447MethodHandle MH_upcase = MethodHandles.lookup()
448    .findVirtual(String.class, "toUpperCase", MT_str1);
449MethodHandle worker1 = MethodHandles.filterReturnValue(MH_name, MH_upcase);
450name.setTarget(MethodHandles.constant(String.class, "Rocky"));
451assertEquals("ROCKY", (String) worker1.invokeExact());
452name.setTarget(MethodHandles.constant(String.class, "Fred"));
453assertEquals("FRED", (String) worker1.invokeExact());
454// (mutation can be continued indefinitely)
455/*
456 * </pre></blockquote>
457 * <p>
458 * The same call site may be used in several places at once.
459 * <blockquote><pre>
460 */
461MethodType MT_str2 = MethodType.methodType(String.class, String.class);
462MethodHandle MH_cat = lookup().findVirtual(String.class,
463  "concat", methodType(String.class, String.class));
464MethodHandle MH_dear = MethodHandles.insertArguments(MH_cat, 1, ", dear?");
465MethodHandle worker2 = MethodHandles.filterReturnValue(MH_name, MH_dear);
466assertEquals("Fred, dear?", (String) worker2.invokeExact());
467name.setTarget(MethodHandles.constant(String.class, "Wilma"));
468assertEquals("WILMA", (String) worker1.invokeExact());
469assertEquals("Wilma, dear?", (String) worker2.invokeExact());
470{}
471            }}
472    }
473
474    @Test public void testSwitchPoint() throws Throwable {
475        {{
476{} /// JAVADOC
477MethodHandle MH_strcat = MethodHandles.lookup()
478    .findVirtual(String.class, "concat", MethodType.methodType(String.class, String.class));
479SwitchPoint spt = new SwitchPoint();
480assert(spt.isValid());
481// the following steps may be repeated to re-use the same switch point:
482MethodHandle worker1 = MH_strcat;
483MethodHandle worker2 = MethodHandles.permuteArguments(MH_strcat, MH_strcat.type(), 1, 0);
484MethodHandle worker = spt.guardWithTest(worker1, worker2);
485assertEquals("method", (String) worker.invokeExact("met", "hod"));
486SwitchPoint.invalidateAll(new SwitchPoint[]{ spt });
487assert(!spt.isValid());
488assertEquals("hodmet", (String) worker.invokeExact("met", "hod"));
489{}
490            }}
491    }
492
493    /* ---- TEMPLATE ----
494    @Test public void testFoo() throws Throwable {
495        {{
496{} /// JAVADOC
497{}
498            }}
499    }
500    */
501}
502