diff options
| author | Reinier Zwitserloot <reinier@tipit.to> | 2009-07-18 02:28:29 +0200 |
|---|---|---|
| committer | Reinier Zwitserloot <reinier@tipit.to> | 2009-07-18 02:28:29 +0200 |
| commit | bc35f73ae80802ab6758509481dacd66c5dc3285 (patch) | |
| tree | c33e571bf81f11b04002de5042e08d4073efabaf /website/features/Synchronized.html | |
| parent | 1e369a3aa408601a3ba23493a961acccaa5c9be2 (diff) | |
| download | lombok-bc35f73ae80802ab6758509481dacd66c5dc3285.tar.gz lombok-bc35f73ae80802ab6758509481dacd66c5dc3285.tar.bz2 lombok-bc35f73ae80802ab6758509481dacd66c5dc3285.zip | |
Added text for the Synchronized annotation to the features pages. Also did some fixes in regards to whitespacing (some fancy footwork in regards to white-space: pre).
Diffstat (limited to 'website/features/Synchronized.html')
| -rw-r--r-- | website/features/Synchronized.html | 60 |
1 files changed, 60 insertions, 0 deletions
diff --git a/website/features/Synchronized.html b/website/features/Synchronized.html new file mode 100644 index 00000000..643b0cd3 --- /dev/null +++ b/website/features/Synchronized.html @@ -0,0 +1,60 @@ +<!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>@Synchronized</title> + <!--[if lt IE 7]><script type="text/javascript" src="logi/iepngfix_tilebg.js"></script><![endif]--> +</head><body><div id="pepper"> + <div class="minimumHeight"></div> + <div class="meat"> + <div class="header"><a href="../index.html">Project Lombok</a></div> + <h1>@Synchronized</h1> + <div class="byline"><code>synchronized</code> done right: Don't expose your locks.</div> + <div class="overview"> + <h3>Overview</h3> + <p> + <code>@Synchronized</code> is a safer variant of the <code>synchronized</code> method modifier. Like <code>synchronized</code>, the + annotation can be used on static and instance methods only. It operates similarly to the <code>synchronized</code> keyword, but it locks + on different objects. The keyword locks on <code>this</code>, but the annotation locks on a field named <code>$lock</code>, which is private.<br /> + If the field does not exist, it is created for you. If you annotate a <code>static</code> method, the annotation locks on a static field + named <code>$LOCK</code> instead. + </p><p> + If you want, you can create these locks yourself. The <code>$lock</code> and <code>$LOCK</code> fields will of course not be generated if you + already created them yourself. You can also choose to lock on another field, by using specifying it as parameter to the <code>@Synchronized</code> + annotation. In this usage variant, the fields will not be created automatically, and you must explicitly create them yourself. + </p><p> + Locking on <code>this</code> or your own class object can have unfortunate side-effects, as other code not under your control can lock on these + objects as well, which can cause race conditions and other nasty threading-related bugs. + </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> + If <code>$lock</code> and/or <code>$LOCK</code> are auto-generated, the fields are initialized with an empty <code>Object[]</code> array, and not + just a <code>new Object()</code> as most snippets showing this pattern in action use. Lombok does this because a new object is <em>NOT</em> + serializable, but 0-size array is. Therefore, using <code>@Synchronized</code> will not prevent your object from being serialized. + </p> + </div> + </div> + <div class="footer"> + <a href="index.html">Back to features</a> | <a href="Cleanup.html">Previous feature (@Cleanup)</a> | <a href="SneakyThrows.html">Next feature (@SneakyThrows)</a><br /> + <span class="copyright">Copyright © 2009 Reinier Zwitserloot and Roel Spilker, licensed under the <a href="http://www.opensource.org/licenses/mit-license.php">MIT licence</a>.</span> + </div> + <div style="clear: both;"></div> + </div> +</div></body></html> |