diff options
| author | Robbert Jan Grootjans <grootjans@gmail.com> | 2012-05-22 00:24:59 +0200 |
|---|---|---|
| committer | Robbert Jan Grootjans <grootjans@gmail.com> | 2012-05-22 00:24:59 +0200 |
| commit | a6a8e4c5554ff000bbac43f4f7f530f661e036d2 (patch) | |
| tree | 49d516b6e6e5a2478841b8465341e31572b6ed0a /src/core/lombok/experimental | |
| parent | 68ca15986728c4d0fdf10a98761693ff6623f18f (diff) | |
| download | lombok-a6a8e4c5554ff000bbac43f4f7f530f661e036d2.tar.gz lombok-a6a8e4c5554ff000bbac43f4f7f530f661e036d2.tar.bz2 lombok-a6a8e4c5554ff000bbac43f4f7f530f661e036d2.zip | |
Javac implementation of @ExtensionMethod.
Casual tests show that it is working. Taken from lombok-pg.
Diffstat (limited to 'src/core/lombok/experimental')
| -rw-r--r-- | src/core/lombok/experimental/ExtensionMethod.java | 64 |
1 files changed, 64 insertions, 0 deletions
diff --git a/src/core/lombok/experimental/ExtensionMethod.java b/src/core/lombok/experimental/ExtensionMethod.java new file mode 100644 index 00000000..b25e535e --- /dev/null +++ b/src/core/lombok/experimental/ExtensionMethod.java @@ -0,0 +1,64 @@ +/* + * Copyright (C) 2012 The Project Lombok Authors. + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to deal + * in the Software without restriction, including without limitation the rights + * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + * copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in + * all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN + * THE SOFTWARE. + */ +package lombok.experimental; + +import static java.lang.annotation.ElementType.*; +import static java.lang.annotation.RetentionPolicy.SOURCE; + +import java.lang.annotation.*; + +/** + * Extension methods enable you to "add" methods to existing types without creating a new derived type, recompiling, or + * otherwise modifying the original type. Extension methods are a special kind of static method, but they are called as + * if they were instance methods on the extended type. + * <p> + * Before: + * + * <pre> + * @ExtensionMethod(java.util.Arrays.class) + * class Example { + * private void example() { + * long[] values = new long[] { 2, 5, 7, 9 }; + * values.copyOf(3).sort(); + * } + * } + * </pre> + * + * After: + * + * <pre> + * class Example { + * private void example() { + * long[] values = new long[] { 2, 5, 7, 9 }; + * java.util.Arrays.sort(java.util.Arrays.copyOf(values, 3)); + * } + * } + * </pre> + */ +@Target(TYPE) +@Retention(SOURCE) +public @interface ExtensionMethod { + /** All types whose static methods will be exposed as extension methods. */ + Class<?>[] value(); + + boolean suppressBaseMethods() default true; +} |