aboutsummaryrefslogtreecommitdiff
path: root/website/features/Delegate.html
diff options
context:
space:
mode:
authorReinier Zwitserloot <reinier@zwitserloot.com>2014-05-08 06:25:38 +0200
committerReinier Zwitserloot <reinier@zwitserloot.com>2014-05-20 23:43:08 +0200
commit4996428ea12be7e381d76614e34a15ad1cc6d275 (patch)
treeca5067b7b8f63eff6adeed83f8ff9339128d8ca7 /website/features/Delegate.html
parent05ca21b75e5c20e1e731d9141857f346bb3eca9f (diff)
downloadlombok-4996428ea12be7e381d76614e34a15ad1cc6d275.tar.gz
lombok-4996428ea12be7e381d76614e34a15ad1cc6d275.tar.bz2
lombok-4996428ea12be7e381d76614e34a15ad1cc6d275.zip
@Delegate has moved to lombok.experimental.
Some work on the aliasing system to make that go smoothly.
Diffstat (limited to 'website/features/Delegate.html')
-rw-r--r--website/features/Delegate.html82
1 files changed, 0 insertions, 82 deletions
diff --git a/website/features/Delegate.html b/website/features/Delegate.html
deleted file mode 100644
index 02cdf290..00000000
--- a/website/features/Delegate.html
+++ /dev/null
@@ -1,82 +0,0 @@
-<!DOCTYPE html>
-<html><head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
- <link rel="stylesheet" type="text/css" href="../logi/reset.css" />
- <link rel="stylesheet" type="text/css" href="features.css" />
- <link rel="shortcut icon" href="../favicon.ico" type="image/x-icon" />
- <meta name="description" content="Spice up your java" />
- <title>@Delegate</title>
-</head><body><div id="pepper">
- <div class="minimumHeight"></div>
- <div class="meat">
- <div class="header"><a href="../index.html">Project Lombok</a></div>
- <h1>@Delegate</h1>
- <div class="byline">Don't lose your composition.</div>
- <div class="overview">
- <h3>Overview</h3>
- <p>
- <em> NEW IN Lombok 0.10: </em> Any field or no-argument method can be annotated with <code>@Delegate</code> to let lombok generate delegate methods
- that forward the call to this field (or the result of invoking this method).
- </p>
- <p>
- Lombok delegates all <code>public</code> methods of the field's type (or method's return type), as well as those of its supertype except for all
- methods declared in <code>java.lang.Object</code>.
- </p>
- <p>
- You can pass any number of classes into the <code>@Delegate</code> annotation's <code>types</code> parameter.
- If you do that, then lombok will delegate all <code>public</code> methods in those types (and their supertypes, except
- <code>java.lang.Object</code>) instead of looking at the field/method's type.
- </p>
- <p>
- All public non-<code>Object</code> methods that are part of the calculated type(s) are
- copied, whether or not you also wrote implementations for those methods. That would thus result in duplicate method errors. You can avoid these
- by using the <code>@Delegate(excludes=SomeType.class)</code> parameter to exclude all public methods in the excluded type(s), and their supertypes.
- </p>
- <p>
- To have very precise control over what is delegated and what isn't, write private inner interfaces with method signatures, then specify these
- private inner interfaces as types in <code>@Delegate(types=PrivateInnerInterfaceWithIncludesList.class, excludes=SameForExcludes.class)</code>.
- </p>
- </div>
- <div class="snippets">
- <div class="pre">
- <h3>With Lombok</h3>
- <div class="snippet">@HTML_PRE@</div>
- </div>
- <div class="sep"></div>
- <div class="post">
- <h3>Vanilla Java</h3>
- <div class="snippet">@HTML_POST@</div>
- </div>
- </div>
- <div style="clear: left;"></div>
- <div class="overview">
- <h3>Small print</h3><div class="smallprint">
- <p>
- When passing classes to the annotation's <code>types</code> or <code>excludes</code> parameter, you cannot include generics.
- This is a limitation of java. Use private inner interfaces or classes that extend the intended type including the
- generics parameter to work around this problem.
- </p><p>
- When passing classes to the annotation, these classes do not need to be supertypes of the field. See the example.
- </p><p>
- <code>@Delegate</code> cannot be used on static fields or methods.
- </p>
- </div>
- </div>
- <div class="footer">
- <a href="index.html">Back to features</a> | <a href="Log.html">Previous feature (@Log)</a> | <span class="disabled">Next feature</span><br />
- <a href="../credits.html" class="creditsLink">credits</a> | <span class="copyright">Copyright &copy; 2010-2013 The Project Lombok Authors, licensed under the <a href="http://www.opensource.org/licenses/mit-license.php">MIT license</a>.</span>
- </div>
- <div style="clear: both;"></div>
- </div>
-</div>
-<script type="text/javascript">
- var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
- document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
-</script>
-<script type="text/javascript">
- try {
- var pageTracker = _gat._getTracker("UA-9884254-1");
- pageTracker._trackPageview();
- } catch(err) {}
-</script>
-</body></html>