From 9488c1c248569d91fa74ed9358baba7f175f02fa Mon Sep 17 00:00:00 2001 From: Reinier Zwitserloot Date: Mon, 12 Jun 2017 22:29:24 +0200 Subject: Removed old website; we no longer use it. --- website-old/all-versions.html | 88 ---------- website-old/buttonbar.jpg | Bin 13350 -> 0 bytes website-old/buttonbar.psd | Bin 1127163 -> 0 bytes website-old/buttonbar_unmodified.png | Bin 351877 -> 0 bytes website-old/changelog.html | 15 -- website-old/clear.gif | Bin 43 -> 0 bytes website-old/credits.html | 132 --------------- website-old/disableCheckedExceptions.html | 61 ------- website-old/download-edge-none.html | 54 ------ website-old/download-edge.html | 63 ------- website-old/download.html | 97 ----------- website-old/downloadButton.png | Bin 1273 -> 0 bytes website-old/downloadButton.svg | 16 -- website-old/favicon.ico | Bin 4286 -> 0 bytes website-old/features/Builder.html | 187 --------------------- website-old/features/Cleanup.html | 86 ---------- website-old/features/Constructor.html | 109 ------------ website-old/features/Data.html | 84 --------- website-old/features/EqualsAndHashCode.html | 97 ----------- website-old/features/GetterLazy.html | 66 -------- website-old/features/GetterSetter.html | 105 ------------ website-old/features/Log.html | 105 ------------ website-old/features/NonNull.html | 86 ---------- website-old/features/Singular-snippet.html | 43 ----- website-old/features/SneakyThrows.html | 96 ----------- website-old/features/Synchronized.html | 85 ---------- website-old/features/ToString.html | 92 ---------- website-old/features/Value.html | 87 ---------- website-old/features/clear.gif | Bin 43 -> 0 bytes website-old/features/configuration.html | 115 ------------- website-old/features/delombok.html | 80 --------- website-old/features/experimental/Accessors.html | 116 ------------- website-old/features/experimental/Builder.html | 36 ---- website-old/features/experimental/Delegate.html | 100 ----------- .../features/experimental/ExtensionMethod.html | 116 ------------- .../features/experimental/FieldDefaults.html | 95 ----------- website-old/features/experimental/Value.html | 36 ---- website-old/features/experimental/Wither.html | 113 ------------- website-old/features/experimental/index.html | 77 --------- website-old/features/experimental/onX.html | 92 ---------- website-old/features/experimental/var.html | 83 --------- website-old/features/features.css | 179 -------------------- website-old/features/gradient.png | Bin 82 -> 0 bytes website-old/features/index.html | 90 ---------- website-old/features/lombok-background.png | Bin 34208 -> 0 bytes website-old/features/val.html | 76 --------- website-old/icon_brush_unused.png | Bin 4350 -> 0 bytes website-old/icon_bugs.png | Bin 6662 -> 0 bytes website-old/icon_contribute.png | Bin 5353 -> 0 bytes website-old/icon_discussion.png | Bin 5889 -> 0 bytes website-old/icon_download.png | Bin 3233 -> 0 bytes website-old/icon_overview.png | Bin 6741 -> 0 bytes website-old/index.css | 182 -------------------- website-old/index.html | 96 ----------- website-old/logi/iepngfix.htc | 187 --------------------- website-old/logi/iepngfix_tilebg.js | 178 -------------------- website-old/logi/jQuery-all.js | 143 ---------------- website-old/logi/reset.css | 67 -------- website-old/lombokBullet.png | Bin 863 -> 0 bytes website-old/mavenrepo/index.html | 99 ----------- website-old/novideo.html | 57 ------- website-old/peppery_background_large.jpg | Bin 294799 -> 0 bytes website-old/poster.png | Bin 114022 -> 0 bytes website-old/reinier.jpg | Bin 6550 -> 0 bytes website-old/robbertjan.jpg | Bin 11605 -> 0 bytes website-old/roel.jpg | Bin 5477 -> 0 bytes website-old/sander.jpg | Bin 53317 -> 0 bytes website-old/setup/android.html | 131 --------------- website-old/setup/ecj.html | 89 ---------- website-old/setup/gwt.html | 68 -------- ...eans-enable-annotation-processing-in-editor.png | Bin 130876 -> 0 bytes website-old/setup/netbeans.html | 65 ------- website-old/setup/pom.xml | 78 --------- website-old/unknown_person.gif | Bin 412 -> 0 bytes website-old/videos/expressInstall.swf | Bin 727 -> 0 bytes website-old/videos/lombok-iPhone.m4v | Bin 8527861 -> 0 bytes website-old/videos/lombok.mp4 | Bin 5657272 -> 0 bytes website-old/videos/lombok.ogv | Bin 6320302 -> 0 bytes website-old/videos/player.swf | Bin 51669 -> 0 bytes website-old/videos/poster.png | Bin 114022 -> 0 bytes website-old/videos/swfobject.js | 4 - 81 files changed, 4702 deletions(-) delete mode 100644 website-old/all-versions.html delete mode 100644 website-old/buttonbar.jpg delete mode 100644 website-old/buttonbar.psd delete mode 100644 website-old/buttonbar_unmodified.png delete mode 100644 website-old/changelog.html delete mode 100644 website-old/clear.gif delete mode 100644 website-old/credits.html delete mode 100644 website-old/disableCheckedExceptions.html delete mode 100644 website-old/download-edge-none.html delete mode 100644 website-old/download-edge.html delete mode 100644 website-old/download.html delete mode 100644 website-old/downloadButton.png delete mode 100644 website-old/downloadButton.svg delete mode 100644 website-old/favicon.ico delete mode 100644 website-old/features/Builder.html delete mode 100644 website-old/features/Cleanup.html delete mode 100644 website-old/features/Constructor.html delete mode 100644 website-old/features/Data.html delete mode 100644 website-old/features/EqualsAndHashCode.html delete mode 100644 website-old/features/GetterLazy.html delete mode 100644 website-old/features/GetterSetter.html delete mode 100644 website-old/features/Log.html delete mode 100644 website-old/features/NonNull.html delete mode 100644 website-old/features/Singular-snippet.html delete mode 100644 website-old/features/SneakyThrows.html delete mode 100644 website-old/features/Synchronized.html delete mode 100644 website-old/features/ToString.html delete mode 100644 website-old/features/Value.html delete mode 100644 website-old/features/clear.gif delete mode 100644 website-old/features/configuration.html delete mode 100644 website-old/features/delombok.html delete mode 100644 website-old/features/experimental/Accessors.html delete mode 100644 website-old/features/experimental/Builder.html delete mode 100644 website-old/features/experimental/Delegate.html delete mode 100644 website-old/features/experimental/ExtensionMethod.html delete mode 100644 website-old/features/experimental/FieldDefaults.html delete mode 100644 website-old/features/experimental/Value.html delete mode 100644 website-old/features/experimental/Wither.html delete mode 100644 website-old/features/experimental/index.html delete mode 100644 website-old/features/experimental/onX.html delete mode 100644 website-old/features/experimental/var.html delete mode 100644 website-old/features/features.css delete mode 100644 website-old/features/gradient.png delete mode 100644 website-old/features/index.html delete mode 100644 website-old/features/lombok-background.png delete mode 100644 website-old/features/val.html delete mode 100644 website-old/icon_brush_unused.png delete mode 100644 website-old/icon_bugs.png delete mode 100644 website-old/icon_contribute.png delete mode 100644 website-old/icon_discussion.png delete mode 100644 website-old/icon_download.png delete mode 100644 website-old/icon_overview.png delete mode 100644 website-old/index.css delete mode 100644 website-old/index.html delete mode 100755 website-old/logi/iepngfix.htc delete mode 100755 website-old/logi/iepngfix_tilebg.js delete mode 100644 website-old/logi/jQuery-all.js delete mode 100644 website-old/logi/reset.css delete mode 100644 website-old/lombokBullet.png delete mode 100644 website-old/mavenrepo/index.html delete mode 100644 website-old/novideo.html delete mode 100644 website-old/peppery_background_large.jpg delete mode 100644 website-old/poster.png delete mode 100644 website-old/reinier.jpg delete mode 100644 website-old/robbertjan.jpg delete mode 100644 website-old/roel.jpg delete mode 100644 website-old/sander.jpg delete mode 100644 website-old/setup/android.html delete mode 100644 website-old/setup/ecj.html delete mode 100644 website-old/setup/gwt.html delete mode 100644 website-old/setup/netbeans-enable-annotation-processing-in-editor.png delete mode 100644 website-old/setup/netbeans.html delete mode 100644 website-old/setup/pom.xml delete mode 100644 website-old/unknown_person.gif delete mode 100644 website-old/videos/expressInstall.swf delete mode 100644 website-old/videos/lombok-iPhone.m4v delete mode 100644 website-old/videos/lombok.mp4 delete mode 100644 website-old/videos/lombok.ogv delete mode 100644 website-old/videos/player.swf delete mode 100644 website-old/videos/poster.png delete mode 100644 website-old/videos/swfobject.js diff --git a/website-old/all-versions.html b/website-old/all-versions.html deleted file mode 100644 index c597d619..00000000 --- a/website-old/all-versions.html +++ /dev/null @@ -1,88 +0,0 @@ - - - - - - - Project Lombok - Historic versions - - -
-

Download older versions of lombok

-
See the changelog for dates and modifications.
- -
- back to the project homepage -
-
- - - diff --git a/website-old/buttonbar.jpg b/website-old/buttonbar.jpg deleted file mode 100644 index 6eb10e71..00000000 Binary files a/website-old/buttonbar.jpg and /dev/null differ diff --git a/website-old/buttonbar.psd b/website-old/buttonbar.psd deleted file mode 100644 index b8335cbb..00000000 Binary files a/website-old/buttonbar.psd and /dev/null differ diff --git a/website-old/buttonbar_unmodified.png b/website-old/buttonbar_unmodified.png deleted file mode 100644 index 6a3121af..00000000 Binary files a/website-old/buttonbar_unmodified.png and /dev/null differ diff --git a/website-old/changelog.html b/website-old/changelog.html deleted file mode 100644 index df09e661..00000000 --- a/website-old/changelog.html +++ /dev/null @@ -1,15 +0,0 @@ - - - - - - - Project Lombok - Changelog - - - @CHANGELOG@ - diff --git a/website-old/clear.gif b/website-old/clear.gif deleted file mode 100644 index 35d42e80..00000000 Binary files a/website-old/clear.gif and /dev/null differ diff --git a/website-old/credits.html b/website-old/credits.html deleted file mode 100644 index de83981e..00000000 --- a/website-old/credits.html +++ /dev/null @@ -1,132 +0,0 @@ - - - - - - - Project Lombok - Credits - - -
-

Project Lombok - About the authors and everyone that's helped us create Project Lombok.

-
-
-

Regular contributors to Project Lombok:

-
-
- Jappe van der Hel -
-
-
- Philipp Eichhorn -
-
-
- Reinier Zwitserloot -
-
-
- Robbert Jan Grootjans -
-
-
- Roel Spilker -
-
-
- Sander Koning -
-
-
- We'd like to thank:
    -
  • Perry Nguyen (pfn on ##java on freenode) for creating the inspiration for project lombok.
    • -
  • Tor Norbye, Jan Lahoda, and Petr Jiricka for helping out with Netbeans internals and/or javac.
    • -
  • The Java Posse for making the java community awesome. Listen to their podcast!
    • -
  • all contributors who submitted patches or helped answering questions!
    • -
- as well as the authors of the following tools that we use:
    -
  • Github for hosting lombok's repository and issue tracker.
    • -
  • The ASM team at ObjectWeb for creating an excellent class file editing tool. - Lombok uses ASM to interact with Eclipse.
    • -
  • Markus Gebhard for creating java2html which we use for the example code snippets on the - features pages.
    • -
  • Kroc Camen's video for everbody. The lombok demo video - runs on just about every system imaginable because of it.
    • -
  • Longtail Video's JWPlayer, which is bringing the video to - those of you who have an aging browser.
    • -
  • The spi project, which makes it very easy to extend lombok with your own transformations.
    • -
  • Apache Ivy - Dependency management
    • -
  • Cobertura which we use to ensure our tests cover as much as possible.
    • -
-
-
-
Back to the home page. -
- - - diff --git a/website-old/disableCheckedExceptions.html b/website-old/disableCheckedExceptions.html deleted file mode 100644 index 64ad1cd8..00000000 --- a/website-old/disableCheckedExceptions.html +++ /dev/null @@ -1,61 +0,0 @@ - - - - - - - Project Lombok side projects - Disable checked Exceptions - - -
-

Tired of checked exceptions?

-

- This lombok spinoff project consists of a hack that only works in javac - not eclipse or any other IDE.
- It will completely disable the notion of checked exceptions. You may throw any exception anywhere, and you may - also catch any exception anywhere. In standard javac, you may not catch a checked exception that is not declared - as thrown by at least 1 statement in your try block, unless it is Exception or Throwable.
- This restriction is lifted as well. -

-

Usage

-

- Just make sure disableCheckedExceptions-alpha.jar is on the classpath as you compile. For example:
- javac -cp disableCheckedExceptions-alpha.jar MySource.java -

-

- Ready to try it out? download it here: disableCheckedExceptions-alpha.jar -

-

- Want to know how its done? Grab the lombok repository here on github, - and look in the experimental directory. -

-
- back to the project homepage -
-
- - - diff --git a/website-old/download-edge-none.html b/website-old/download-edge-none.html deleted file mode 100644 index 07091b90..00000000 --- a/website-old/download-edge-none.html +++ /dev/null @@ -1,54 +0,0 @@ - - - - - - - Project Lombok - Cutting Edge build - - -
-

Download Lombok Cutting Edge build

-
- No edge build as been released since the last stable release of lombok. -
-
- back to the project homepage -
-
- - - diff --git a/website-old/download-edge.html b/website-old/download-edge.html deleted file mode 100644 index 4cf794a6..00000000 --- a/website-old/download-edge.html +++ /dev/null @@ -1,63 +0,0 @@ - - - - - - - Project Lombok - Cutting Edge build - - -
-

Download Lombok Cutting Edge build

-
- version: @VERSION-EDGE@ -
-

- @CHANGELOG-EDGE@ -

- - Download now! - -

- Cutting edge a bit too gutsy for you? You can grab the stable release instead. -

-
- back to the project homepage -
-
- - - diff --git a/website-old/download.html b/website-old/download.html deleted file mode 100644 index f2e85976..00000000 --- a/website-old/download.html +++ /dev/null @@ -1,97 +0,0 @@ - - - - - - - - - Project Lombok - - - Fork me on GitHub -
-

Project Lombok - Download

- -
-
Download lombok.jar @VERSION@.
-
Feeling adventurous? Download the latest snapshot release.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Maven, Ivy or GradleLombok is in maven central. More…
JavacJust put lombok.jar on the classpath.
NetBeansJust put lombok.jar on the classpath and enable annotation processing. More…
Eclipse and variantsRun lombok.jar as a java app (i.e. doubleclick it, usually) to install. Also add lombok.jar to your project. Supported variants: Springsource Tool Suite, JBoss Developer Studio
IDEA IntelliJA plugin developed by Michael Plushnikov adds support for most features.
JavadocFirst delombok your code then run javadoc on the result. More…
AndroidThe proper way to use lombok with android is somewhat complicated but possible. More…
GWTLombok works with GWT. More…
Play! FrameworkUse Aaron Freeman's lombok play plugin.
ecjLombok works on ecj and ecj-based tools. More…
-

- Or, download a previous version of lombok. -

-
-
-
-
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
- - - diff --git a/website-old/downloadButton.png b/website-old/downloadButton.png deleted file mode 100644 index 8a0c73b8..00000000 Binary files a/website-old/downloadButton.png and /dev/null differ diff --git a/website-old/downloadButton.svg b/website-old/downloadButton.svg deleted file mode 100644 index ce5e33a8..00000000 --- a/website-old/downloadButton.svg +++ /dev/null @@ -1,16 +0,0 @@ - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/website-old/favicon.ico b/website-old/favicon.ico deleted file mode 100644 index bf83a474..00000000 Binary files a/website-old/favicon.ico and /dev/null differ diff --git a/website-old/features/Builder.html b/website-old/features/Builder.html deleted file mode 100644 index d7453c5b..00000000 --- a/website-old/features/Builder.html +++ /dev/null @@ -1,187 +0,0 @@ - - - - - - - - @Builder -
-
-
-
Project Lombok
-

@Builder

-
... and Bob's your uncle: No-hassle fancy-pants APIs for object creation!
-
-

Since

-

- @Builder was introduced as experimental feature in lombok v0.12.0. -

- @Builder gained @Singular support and was promoted to the main lombok package since lombok v1.16.0. -

- @Builder with @Singular adds a clear method since lombok v1.16.8. -

- @Builder.Default functionality was added in lombok v1.16.16. -

-
-

Overview

-

- The @Builder annotation produces complex builder APIs for your classes. -

- @Builder lets you automatically produce the code required to have your class be instantiable with code such as:
- Person.builder().name("Adam Savage").city("San Francisco").job("Mythbusters").job("Unchained Reaction").build(); -

- @Builder can be placed on a class, or on a constructor, or on a method. While the "on a class" and "on a constructor" - mode are the most common use-case, @Builder is most easily explained with the "method" use-case. -

- A method annotated with @Builder (from now on called the target) causes the following 7 things to be generated:

    -
  • An inner class named FooBuilder, with the same type arguments as the method (called the builder).
    • -
  • In the builder: One private non-static non-final field for each parameter of the target.
    • -
  • In the builder: A package private no-args empty constructor.
    • -
  • In the builder: A 'setter'-like method for each parameter of the target: It has the same type as that parameter and the same name. - It returns the builder itself, so that the setter calls can be chained, as in the above example.
    • -
  • In the builder: A build() method which calls the method, passing in each field. It returns the same type that the - target returns.
    • -
  • In the builder: A sensible toString() implementation.
    • -
  • In the class containing the target: A static builder() method, which creates a new instance of the builder.
    • -
- Each listed generated element will be silently skipped if that element already exists (disregarding parameter counts and looking only at names). This - includes the builder itself: If that class already exists, lombok will simply start injecting fields and methods inside this already existing - class, unless of course the fields / methods to be injected already exist. You may not put any other method (or constructor) generating lombok annotation - on a builder class though; for example, you can not put @EqualsAndHashCode on the builder class. -

- @Builder can generate so-called 'singular' methods for collection parameters/fields. These take 1 element instead of an entire list, and add the - element to the list. For example: Person.builder().job("Mythbusters").job("Unchained Reaction").build(); would result in the List<String> jobs - field to have 2 strings in it. To get this behaviour, the field/parameter needs to be annotated with @Singular. The feature has its own documentation. -

- Now that the "method" mode is clear, putting a @Builder annotation on a constructor functions similarly; effectively, - constructors are just static methods that have a special syntax to invoke them: Their 'return type' is the class they construct, and their - type parameters are the same as the type parameters of the class itself. -

- Finally, applying @Builder to a class is as if you added @AllArgsConstructor(access = AccessLevel.PACKAGE) to the class and applied the - @Builder annotation to this all-args-constructor. This only works if you haven't written any explicit constructors yourself. If you do have an - explicit constructor, put the @Builder annotation on the constructor instead of on the class. -

- If using @Builder to generate builders to produce instances of your own class (this is always the case unless adding @Builder to a static method that doesn't return your own type), you can use @Builder(toBuilder = true) to also generate an instance method in your class called toBuilder(); it creates a new builder that starts out with all the values of this instance. You can put the @Builder.ObtainVia annotation on the parameters (in case of a constructor or static method) or fields (in case of @Builder on a type) to indicate alternative means by which the value for that field/parameter is obtained from the instance. For example, you can specify a method to be invoked: @Builder.ObtainVia(method = "calculateFoo"). -

- The name of the builder class is FoobarBuilder, where Foobar is the simplified, title-cased form of the return type of the - target - that is, the name of your type for @Builder on constructors and types, and the name of the return type for @Builder - on methods. For example, if @Builder is applied to a class named com.yoyodyne.FancyList<T>, then the builder name will be - FancyListBuilder<T>. If @Builder is applied to a method that returns void, the builder will be named - VoidBuilder. -

- The configurable aspects of builder are:

    -
  • The builder's class name (default: return type + 'Builder')
    • -
  • The build() method's name (default: "build")
    • -
  • The builder() method's name (default: "builder")
    • -
  • If you want toBuilder() (default: no)
    • -
- Example usage where all options are changed from their defaults:
- @Builder(builderClassName = "HelloWorldBuilder", buildMethodName = "execute", builderMethodName = "helloWorld", toBuilder = true)
-

-
-
-

@Builder.Default

-

- If a certain field/parameter is never set during a build session, then it always gets 0 / null / false. If you've put @Builder on a class - (and not a method or constructor) you can instead specify the default directly on the field, and annotate the field with @Builder.Default:
- @Builder.Default private final long created = System.currentTimeMillis(); -

-
-
-

@Singular

-

- By annotating one of the parameters (if annotating a method or constructor with @Builder) or fields (if annotating a class with @Builder) with the - @Singular annotation, lombok will treat that builder node as a collection, and it generates 2 'adder' methods instead of a 'setter' method. One which adds a single element to the collection, and one - which adds all elements of another collection to the collection. No setter to just set the collection (replacing whatever was already added) will be generated. A 'clear' method is also generated. These 'singular' builders - are very complicated in order to guarantee the following properties: -

    -
  • When invoking build(), the produced collection will be immutable.
    • -
  • Calling one of the 'adder' methods, or the 'clear' method, after invoking build() does not modify any already generated objects, and, if build() is later called again, another collection with all the elements added since the creation of the builder is generated.
    • -
  • The produced collection will be compacted to the smallest feasible format while remaining efficient.
    • -
-

- @Singular can only be applied to collection types known to lombok. Currently, the supported types are: -

    -
  • java.util:
      -
    • Iterable, Collection, and List (backed by a compacted unmodifiable ArrayList in the general case).
      • -
    • Set, SortedSet, and NavigableSet (backed by a smartly sized unmodifiable HashSet or TreeSet in the general case).
      • -
    • Map, SortedMap, and NavigableMap (backed by a smartly sized unmodifiable HashMap or TreeMap in the general case).
      • -
    • -
  • Guava's com.google.common.collect:
      -
    • ImmutableCollection and ImmutableList (backed by the builder feature of ImmutableList).
      • -
    • ImmutableSet and ImmutableSortedSet (backed by the builder feature of those types).
      • -
    • ImmutableMap, ImmutableBiMap, and ImmutableSortedMap (backed by the builder feature of those types).
      • -
    • ImmutableTable (backed by the builder feature of ImmutableTable).
      • -
    • -
-

- If your identifiers are written in common english, lombok assumes that the name of any collection with @Singular on it is an english plural and will attempt to automatically - singularize that name. If this is possible, the add-one method will use this name. For example, if your collection is called statuses, then the add-one method will automatically - be called status. You can also specify the singular form of your identifier explictly by passing the singular form as argument to the annotation like so: @Singular("axis") List<Line> axes;.
- If lombok cannot singularize your identifier, or it is ambiguous, lombok will generate an error and force you to explicitly specify the singular name. -

- The snippet below does not show what lombok generates for a @Singular field/parameter because it is rather complicated. - You can view a snippet here. -

-
-
-
-

With Lombok

-
@HTML_PRE@
-
-
-
-

Vanilla Java

-
@HTML_POST@
-
-
-
-
-

Supported configuration keys:

-
-
lombok.builder.flagUsage = [warning | error] (default: not set)
-
Lombok will flag any usage of @Builder as a warning or error if configured.
-
lombok.singular.useGuava = [true | false] (default: false)
-
If true, lombok will use guava's ImmutableXxx builders and types to implement java.util collection interfaces, instead of creating - implementations based on Collections.unmodifiableXxx. You must ensure that guava is actually available on the classpath and buildpath if you use this setting. - Guava is used automatically if your field/parameter has one of the guava ImmutableXxx types. -
lombok.singular.auto = [true | false] (default: true)
-
If true (which is the default), lombok automatically tries to singularize your identifier name by assuming that it is a common english plural. - If false, you must always explicitly specify the singular name, and lombok will generate an error if you don't (useful if you write your code in a language other than english). -
-
-
-

Small print

-

- @Singular support for java.util.NavigableMap/Set only works if you are compiling with JDK1.8 or higher. -

- You cannot manually provide some or all parts of a @Singular node; the code lombok generates is too complex for this. If you want to - manually control (part of) the builder code associated with some field or parameter, don't use @Singular and add everything you need manually. -

- The sorted collections (java.util: SortedSet, NavigableSet, SortedMap, NavigableMap and guava: ImmutableSortedSet, ImmutableSortedMap) require that the type argument of the collection has natural order (implements java.util.Comparable). There is no way to pass an explicit Comparator to use in the builder. -

- An ArrayList is used to store added elements as call methods of a @Singular marked field, if the target collection is from the java.util package, even if the collection is a set or map. Because lombok ensures that generated collections are compacted, a new backing instance of a set or map must be constructed anyway, and storing the data as an ArrayList during the build process is more efficient that storing it as a map or set. This behaviour is not externally visible, an an implementation detail of the current implementation of the java.util recipes for @Singular @Builder. -

- With toBuilder = true applied to static methods, any type parameter on the annotated static method must show up in the returntype. -

-
-
-
- Back to features | Previous feature (@Value) | Next feature (@SneakyThrows)
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
-
-
- - - diff --git a/website-old/features/Cleanup.html b/website-old/features/Cleanup.html deleted file mode 100644 index 37e53c18..00000000 --- a/website-old/features/Cleanup.html +++ /dev/null @@ -1,86 +0,0 @@ - - - - - - - - @Cleanup -
-
-
-
Project Lombok
-

@Cleanup

-
Automatic resource management: Call your close() methods safely with no hassle.
-
-

Overview

-

- You can use @Cleanup to ensure a given resource is automatically cleaned up before the code execution path exits your - current scope. You do this by annotating any local variable declaration with the @Cleanup annotation like so:
- @Cleanup InputStream in = new FileInputStream("some/file");
- As a result, at the end of the scope you're in, in.close() is called. This call is guaranteed to run by way of a - try/finally construct. Look at the example below to see how this works. -

- If the type of object you'd like to cleanup does not have a close() method, but some other no-argument method, you can - specify the name of this method like so:
- @Cleanup("dispose") org.eclipse.swt.widgets.CoolBar bar = new CoolBar(parent, 0);
- By default, the cleanup method is presumed to be close(). A cleanup method that takes 1 or more arguments cannot be called via - @Cleanup. -

-
-
-
-

With Lombok

-
@HTML_PRE@
-
-
-
-

Vanilla Java

-
@HTML_POST@
-
-
-
-
-

Supported configuration keys:

-
-
lombok.cleanup.flagUsage = [warning | error] (default: not set)
-
Lombok will flag any usage of @Cleanup as a warning or error if configured.
-
-
-
-

Small print

-

- In the finally block, the cleanup method is only called if the given resource is not null. However, if you use delombok - on the code, a call to lombok.Lombok.preventNullAnalysis(Object o) is inserted to prevent warnings if static code analysis could - determine that a null-check would not be needed. Compilation with lombok.jar on the classpath removes that method call, - so there is no runtime dependency. -

-

- If your code throws an exception, and the cleanup method call that is then triggered also throws an exception, then the original exception - is hidden by the exception thrown by the cleanup call. You should not rely on this 'feature'. Preferably, lombok would like to generate - code so that, if the main body has thrown an exception, any exception thrown by the close call is silently swallowed (but if the main body - exited in any other way, exceptions by the close call will not be swallowed). The authors of lombok do not currently know of a feasible way - to implement this scheme, but if java updates allow it, or we find a way, we'll fix it. -

- You do still need to handle any exception that the cleanup method can generate! -

-
-
-
- Back to features | Previous feature (@NonNull) | Next feature (@Getter / @Setter)
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
-
-
- - - diff --git a/website-old/features/Constructor.html b/website-old/features/Constructor.html deleted file mode 100644 index 407f54ad..00000000 --- a/website-old/features/Constructor.html +++ /dev/null @@ -1,109 +0,0 @@ - - - - - - - - @XArgsConstructor -
-
-
-
Project Lombok
-

@NoArgsConstructor, @RequiredArgsConstructor, @AllArgsConstructor

-
Constructors made to order: Generates constructors that take no arguments, one argument per final / non-null field, or one argument for every field.
-
-

Overview

-

- This set of 3 annotations generate a constructor that will accept 1 parameter for certain fields, and simply assigns this parameter to the field. -

- @NoArgsConstructor will generate a constructor with no parameters. If this is not possible (because of final fields), a compiler error will result instead, unless @NoArgsConstructor(force = true) is used, then all final fields are initialized with 0 / false / null. For fields with constraints, such as @NonNull fields, no check or assignment is generated, so be aware that these constraints may then not be - fulfilled until those fields are properly initialized later. Certain java constructs, such as hibernate and the Service Provider Interface require a no-args constructor. - This annotation is useful primarily in combination with either @Data or one of the other constructor generating annotations. -

- @RequiredArgsConstructor generates a constructor with 1 parameter for each field that requires special handling. All non-initialized final fields get a parameter, - as well as any fields that are marked as @NonNull that aren't initialized where they are declared. For those fields marked with @NonNull, an explicit - null check is also generated. The constructor will throw a NullPointerException if any of the parameters intended for the fields marked with @NonNull - contain null. The order of the parameters match the order in which the fields appear in your class. -

- @AllArgsConstructor generates a constructor with 1 parameter for each field in your class. Fields marked with @NonNull result in null checks on - those parameters. -

- Each of these annotations allows an alternate form, where the generated constructor is always private, and an additional static factory method that wraps around the - private constructor is generated. This mode is enabled by supplying the staticName value for the annotation, like so: @RequiredArgsConstructor(staticName="of"). - Such a static factory method will infer generics, unlike a normal constructor. This means your API users get write MapEntry.of("foo", 5) instead of the much longer - new MapEntry<String, Integer>("foo", 5). -

- To put annotations on the generated constructor, you can use onConstructor=@__({@AnnotationsHere}), but be careful; this is an experimental feature. For more details see the documentation on the onX feature. -

- Static fields are skipped by these annotations. Also, a @java.beans.ConstructorProperties annotation is added for all constructors with at least 1 argument, - which allows bean editor tools to call the generated constructors. @ConstructorProperties is new in Java 1.6, which means that if your code is intended for - compilation on Java 1.5, a compiler error will occur. Running on a JVM 1.5 should be no problem (the annotation will be ignored). To suppress the generation of - the @ConstructorProperties annotation, add a parameter to your annotation: @AllArgsConstructor(suppressConstructorProperties=true). However, - as java 1.5, which has already been end-of-lifed, fades into obscurity, this parameter will eventually be removed. It has also been marked deprecated for this reason. -

- Unlike most other lombok annotations, the existence of an explicit constructor does not stop these annotations from generating their own constructor. This means you can write your own specialized constructor, and let lombok generate the boilerplate ones as well. If a conflict arises (one of your constructors ends up with the same signature as one that lombok generates), a compiler error will occur. -

-
-
-
-

With Lombok

-
@HTML_PRE@
-
-
-
-

Vanilla Java

-
@HTML_POST@
-
-
-
-
-

Supported configuration keys:

-
-
lombok.anyConstructor.suppressConstructorProperties = [true | false] (default: false)
-
If set to true, then lombok will skip adding a @java.beans.ConstructorProperties to generated constructors. This is useful in android and GWT development where that annotation is not usually available.
-
lombok.[allArgsConstructor|requiredArgsConstructor|noArgsConstructor].flagUsage = [warning | error] (default: not set)
-
Lombok will flag any usage of the relevant annotation (@AllArgsConstructor, @RequiredArgsConstructor or @NoArgsConstructor) as a warning or error if configured.
-
lombok.anyConstructor.flagUsage = [warning | error] (default: not set)
-
Lombok will flag any usage of any of the 3 constructor-generating annotations as a warning or error if configured.
-
-
-
-

Small print

-

- Even if a field is explicitly initialized with null, lombok will consider the requirement to avoid null as fulfilled, and will NOT consider - the field as a 'required' argument. The assumption is that if you explicitly assign null to a field that you've also marked as @NonNull - signals you must know what you're doing. -

- The @java.beans.ConstructorProperties annotation is never generated for a constructor with no arguments. This also explains why @NoArgsConstructor - lacks the suppressConstructorProperties annotation method. The generated static factory methods also do not get @ConstructorProperties, as this annotation can only be added to real constructors. -

- @XArgsConstructor can also be used on an enum definition. The generated constructor will always be - private, because non-private constructors aren't legal in enums. You don't have to specify AccessLevel.PRIVATE. -

- While suppressConstructorProperties has been marked deprecated in anticipation of a world where all java environments have the - @ConstructorProperties annotation available, first GWT 2.2 and Android 2.3.3, which do not (yet) have this annotation, will have - to be ancient history before this annotation parameter will be removed. -

- The flagUsage configuration keys do not trigger when a constructor is generated by @Data, @Value or any other lombok annotation. -

-
-
-
- Back to features | Previous feature (@EqualsAndHashCode) | Next feature (@Data)
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
-
-
- - - diff --git a/website-old/features/Data.html b/website-old/features/Data.html deleted file mode 100644 index d69cfac3..00000000 --- a/website-old/features/Data.html +++ /dev/null @@ -1,84 +0,0 @@ - - - - - - - - @Data -
-
-
-
Project Lombok
-

@Data

-
All together now: A shortcut for @ToString, @EqualsAndHashCode, - @Getter on all fields, @Setter on all non-final fields, and @RequiredArgsConstructor!
-
-

Overview

-

- @Data is a convenient shortcut annotation that bundles the features of @ToString, @EqualsAndHashCode, @Getter / @Setter and @RequiredArgsConstructor together: In other words, @Data generates all the boilerplate that is normally associated with simple POJOs (Plain Old Java Objects) and beans: getters for all fields, setters for all non-final fields, and appropriate toString, equals and hashCode implementations that involve the fields of the class, and a constructor that initializes all final fields, as well as all non-final fields with no initializer that have been marked with @NonNull, in order to ensure the field is never null. -

- @Data is like having implicit @Getter, @Setter, @ToString, @EqualsAndHashCode and @RequiredArgsConstructor annotations on the class (except that no constructor will be generated if any explicitly written constructor exists). However, the parameters of these annotations (such as callSuper, includeFieldNames and exclude) cannot be set with @Data. If you need to set non-default values for any of these parameters, just add those annotations explicitly; @Data is smart enough to defer to those annotations. -

- All generated getters and setters will be public. To override the access level, annotate the field or class with an explicit @Setter and/or @Getter annotation. You can also use this annotation (by combining it with AccessLevel.NONE) to suppress generating a getter and/or setter altogether. -

- All fields marked as transient will not be considered for hashCode and equals. All static fields will be skipped entirely (not considered for any of the generated methods, and no setter/getter will be made for them). -

- If the class already contains a method with the same name and parameter count as any method that would normally be generated, that method is not generated, and no warning or error is emitted. For example, if you already have a method with signature equals(AnyType param), no equals method will be generated, even though technically it might be an entirely different method due to having different parameter types. The same rule applies to the constructor (any explicit constructor will prevent @Data from generating one), as well as toString, equals, and all getters and setters. You can mark any constructor or method with @lombok.experimental.Tolerate to hide them from lombok. -

- @Data can handle generics parameters for fields just fine. In order to reduce the boilerplate when constructing objects for classes with - generics, you can use the staticConstructor parameter to generate a private constructor, as well as a static method that returns a new instance. This way, javac will infer the variable name. Thus, by declaring like so: @Data(staticConstructor="of") class Foo<T> { private T x;} you can create new instances of Foo by writing: Foo.of(5); instead of having to write: new Foo<Integer>(5);. -

-
-
-
-

With Lombok

-
@HTML_PRE@
-
-
-
-

Vanilla Java

-
@HTML_POST@
-
-
-
-
-

Supported configuration keys:

-
-
lombok.data.flagUsage = [warning | error] (default: not set)
-
Lombok will flag any usage of @Data as a warning or error if configured.
-
-
-
-

Small print

-

See the small print of @ToString, @EqualsAndHashCode, - @Getter / @Setter and @RequiredArgsConstructor. -

- Any annotations named @NonNull (case insensitive) on a field are interpreted as: This field must not ever hold - null. Therefore, these annotations result in an explicit null check in the generated constructor for the provided field. Also, these - annotations (as well as any annotation named @Nullable) are copied to the constructor parameter, in both the true constructor and - any static constructor. The same principle applies to generated getters and setters (see the documentation for @Getter / @Setter) -

- By default, any variables that start with a $ symbol are excluded automatically. - You can include them by specifying an explicit annotation (@Getter or @ToString, for example) and using the 'of' parameter. -

-
-
-
- Back to features | Previous feature (@XConstructor) | Next feature (@Value)
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
-
-
- - - diff --git a/website-old/features/EqualsAndHashCode.html b/website-old/features/EqualsAndHashCode.html deleted file mode 100644 index d0298a7b..00000000 --- a/website-old/features/EqualsAndHashCode.html +++ /dev/null @@ -1,97 +0,0 @@ - - - - - - - - @EqualsAndHashCode -
-
-
-
Project Lombok
-

@EqualsAndHashCode

-
Equality made easy: Generates hashCode and equals implementations from the fields of your object.
-
-

Overview

-

- Any class definition may be annotated with @EqualsAndHashCode to let lombok generate implementations of the equals(Object other) and hashCode() methods. By default, it'll use all non-static, non-transient fields, but you can exclude more fields by naming them in the optional exclude parameter to the annotation. Alternatively, you can specify exactly which fields you wish to be used by naming them in the of parameter. -

- If applying @EqualsAndHashCode to a class that extends another, this feature gets a bit trickier. Normally, auto-generating an equals and hashCode method for such classes is a bad idea, as the superclass also defines fields, which also need equals/hashCode code but - this code will not be generated. By setting callSuper to true, you can include the equals and hashCode methods of your superclass in the generated methods. For hashCode, the result of super.hashCode() is included in the hash algorithm, and for equals, the generated method will return false if the super implementation thinks it is not equal to the passed in object. Be aware that not all equals implementations handle this situation properly. However, lombok-generated equals implementations do handle this situation properly, so you can safely call your superclass equals if it, too, has a lombok-generated equals method. If you have an explicit superclass you are forced to supply some value for callSuper to acknowledge that you've considered it; failure to do so results in a warning.
-

- Setting callSuper to true when you don't extend anything (you extend java.lang.Object) is a compile-time error, because it would turn the generated equals() and hashCode() implementations into having the same behaviour as simply inheriting these methods from java.lang.Object: only the same object will be equal to each other and will have the same hashCode. Not setting callSuper to true when you extend another class generates a warning, because unless the superclass has no (equality-important) fields, lombok cannot generate an implementation for you that takes into account the fields declared by your superclasses. You'll need to write your own implementations, or rely on the - callSuper chaining facility. You can also use the lombok.equalsAndHashCode.callSuper config key. -

- NEW in Lombok 0.10: Unless your class is final and extends java.lang.Object, lombok generates a canEqual method - which means JPA proxies can still be equal to their base class, but subclasses that add new state don't break the equals contract. The complicated reasons for - why such a method is necessary are explained in this paper: How to Write an Equality Method in Java. - If all classes in a hierarchy are a mix of scala case classes and classes with lombok-generated equals methods, all equality will 'just work'. - If you need to write your own equals methods, you should always override canEqual if you change equals and hashCode. -

- NEW in Lombok 1.14.0: To put annotations on the other parameter of the equals (and, if relevant, canEqual) method, you can use onParam=@__({@AnnotationsHere}). Be careful though! This is an experimental feature. For more details see the documentation on the onX feature. - -

-
-
-

With Lombok

-
@HTML_PRE@
-
-
-
-

Vanilla Java

-
@HTML_POST@
-
-
-
-
-

Supported configuration keys:

-
-
lombok.equalsAndHashCode.doNotUseGetters = [true | false] (default: false)
-
If set to true, lombok will access fields directly instead of using getters (if available) when generating equals and hashCode methods. The annotation parameter 'doNotUseGetters', if explicitly specified, takes precedence over this setting.
-
lombok.equalsAndHashCode.callSuper = [call | skip | warn] (default: warn)
-
If set to call, lombok will generate calls to the superclass implementation of hashCode and equals if your class extends something. If set to skip no such calls are generated. The default behaviour is like skip, with an additional warning.
-
lombok.equalsAndHashCode.flagUsage = [warning | error] (default: not set)
-
Lombok will flag any usage of @EqualsAndHashCode as a warning or error if configured.
-
-
-
-

Small print

-

- Arrays are 'deep' compared/hashCoded, which means that arrays that contain themselves will result in StackOverflowErrors. However, this behaviour is no different from e.g. ArrayList. -

- You may safely presume that the hashCode implementation used will not change between versions of lombok, however this guarantee is not set in stone; if there's a significant performance improvement to be gained from using an alternate hash algorithm, that will be substituted in a future version. -

- For the purposes of equality, 2 NaN (not a number) values for floats and doubles are considered equal, eventhough 'NaN == NaN' would return false. This is analogous to java.lang.Double's equals method, and is in fact required to ensure that comparing an object to an exact copy of itself returns true for equality. -

- If there is any method named either hashCode or equals, regardless of return type, no methods will be generated, and a warning is emitted instead. These 2 methods need to be in sync with each other, which lombok cannot guarantee unless it generates all the methods, hence you always get a warning if one or both of the methods already exist. You can mark any method with @lombok.experimental.Tolerate to hide them from lombok. -

- Attempting to exclude fields that don't exist or would have been excluded anyway (because they are static or transient) results in warnings on the named fields. You therefore don't have to worry about typos. -

- Having both exclude and of generates a warning; the exclude parameter will be ignored in that case. -

- By default, any variables that start with a $ symbol are excluded automatically. You can only include them by using the 'of' parameter. -

- If a getter exists for a field to be included, it is called instead of using a direct field reference. This behaviour can be suppressed:
- @EqualsAndHashCode(doNotUseGetters = true) -

-
-
-
- Back to features | Previous feature (@ToString) | Next feature (@XConstructor)
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
-
-
- - - diff --git a/website-old/features/GetterLazy.html b/website-old/features/GetterLazy.html deleted file mode 100644 index 01a11c55..00000000 --- a/website-old/features/GetterLazy.html +++ /dev/null @@ -1,66 +0,0 @@ - - - - - - - - @Getter(lazy=true) -
-
-
-
Project Lombok
-

@Getter(lazy=true)

-
Laziness is a virtue!
-
-

Overview

-

- NEW IN Lombok 0.10: You can let lombok generate a getter which will calculate a value once, the first time this getter is called, and cache it from then on. This can be useful if calculating the value takes a lot of CPU, or the value takes a lot of memory. To use this feature, create a private final variable, initialize it with the expression that's expensive to run, and annotate your field with @Getter(lazy=true). The field will be hidden from the rest of your code, and the expression will be evaluated no more than once, when the getter is first called. There are no magic marker values (i.e. even if the result of your expensive calculation is null, the result is cached) and your expensive calculation need not be thread-safe, as lombok takes care of locking. -

-
-
-
-

With Lombok

-
@HTML_PRE@
-
-
-
-

Vanilla Java

-
@HTML_POST@
-
-
-
-
-

Supported configuration keys (in addition to those listed on @Getter's main page):

-
-
lombok.getter.lazy.flagUsage = [warning | error] (default: not set)
-
Lombok will flag any usage of @Getter(lazy=true) as a warning or error if configured.
-
-
-
-

Small print

-

- You should never refer to the field directly, always use the getter generated by lombok, because the type of the field will be mangled into an AtomicReference. Do not try to directly access this AtomicReference; if it points to itself, the value has been calculated, and it is null. If the reference points to null, then the value has not been calculated. This behaviour may change in future versions. Therefore, always use the generated getter to access your field! -

- Other Lombok annotations such as @ToString always call the getter even if you use doNotUseGetters=true. -

-
-
-
- Back to features | Previous feature (@Synchronized) | Next feature (@Log)
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
-
-
- - - diff --git a/website-old/features/GetterSetter.html b/website-old/features/GetterSetter.html deleted file mode 100644 index f26d24d9..00000000 --- a/website-old/features/GetterSetter.html +++ /dev/null @@ -1,105 +0,0 @@ - - - - - - - - @Getter and @Setter -
-
-
-
Project Lombok
-

@Getter and @Setter

-
Never write public int getFoo() {return foo;} again.
-
-

Overview

-

- You can annotate any field with @Getter and/or @Setter, to let lombok generate the default getter/setter automatically.
- A default getter simply returns the field, and is named getFoo if the field is called foo (or isFoo if the field's type is boolean). A default setter is named setFoo if the field is called foo, returns void, and takes 1 parameter of the same type as the field. It simply sets the field to this value. -

- The generated getter/setter method will be public unless you explicitly specify an AccessLevel, as shown in the example below. Legal access levels are PUBLIC, PROTECTED, PACKAGE, and PRIVATE. -

- You can also put a @Getter and/or @Setter annotation on a class. In that case, it's as if you annotate all the non-static fields in that class with the annotation. -

- You can always manually disable getter/setter generation for any field by using the special AccessLevel.NONE access level. This lets you override the behaviour of a @Getter, @Setter or @Data annotation on a class. -

- To put annotations on the generated method, you can use onMethod=@__({@AnnotationsHere}); to put annotations on the only parameter of a generated setter method, you can use onParam=@__({@AnnotationsHere}). Be careful though! This is an experimental feature. For more details see the documentation on the onX feature. -

- NEW in lombok v1.12.0: javadoc on the field will now be copied to generated getters and setters. Normally, all text is copied, and @return is moved to the getter, whilst @param lines are moved to the setter. Moved means: Deleted from the field's javadoc. It is also possible to define unique text for each getter/setter. To do that, you create a 'section' named GETTER and/or SETTER. A section is a line in your javadoc containing 2 or more dashes, then the text 'GETTER' or 'SETTER', followed by 2 or more dashes, and nothing else on the line. If you use sections, @return and @param stripping for that section is no longer done (move the @return or @param line into the section). -

-
-
-
-

With Lombok

-
@HTML_PRE@
-
-
-
-

Vanilla Java

-
@HTML_POST@
-
-
-
-
-

Supported configuration keys:

-
-
lombok.accessors.chain = [true | false] (default: false)
-
If set to true, generated setters will return this (instead of void). An explicitly configured chain parameter of an @Accessors annotation takes precedence over this setting.
-
lombok.accessors.fluent = [true | false] (default: false)
-
If set to true, generated getters and setters will not be prefixed with the bean-standard 'get, is or set; instead, the methods will use the same name as the field (minus prefixes). An explicitly configured chain parameter of an @Accessors annotation takes precedence over this setting.
-
lombok.accessors.prefix += a field prefix (default: empty list)
-
This is a list property; entries can be added with the += operator. Inherited prefixes from parent config files can be removed with the -= operator. Lombok will strip any matching field prefix from the name of a field in order to determine the name of the getter/setter to generate. For example, if m is one of the prefixes listed in this setting, then a field named mFoobar will result in a getter named getFoobar(), not getMFoobar(). An explicitly configured prefix parameter of an @Accessors annotation takes precedence over this setting.
-
lombok.getter.noIsPrefix = [true | false] (default: false)
-
If set to true, getters generated for boolean fields will use the get prefix instead of the defaultis prefix, and any generated code that calls getters, such as @ToString, will also use get instead of is -
lombok.setter.flagUsage = [warning | error] (default: not set)
-
Lombok will flag any usage of @Setter as a warning or error if configured.
-
lombok.getter.flagUsage = [warning | error] (default: not set)
-
Lombok will flag any usage of @Getter as a warning or error if configured.
-
-
-
-

Small print

-

- For generating the method names, the first character of the field, if it is a lowercase character, is title-cased, otherwise, it is left unmodified. Then, get/set/is is prefixed. -

- No method is generated if any method already exists with the same name (case insensitive) and same parameter count. For example, getFoo() will not be generated if there's already a method getFoo(String... x) even though it is technically possible to make the method. This caveat exists to prevent confusion. If the generation of a method is skipped for this reason, a warning is emitted instead. Varargs count as 0 to N parameters. You can mark any method with @lombok.experimental.Tolerate to hide them from lombok. -

- For boolean fields that start with is immediately followed by a title-case letter, nothing is prefixed to generate the getter name. -

- Any variation on boolean will not result in using the is prefix instead of the get prefix; for example, - returning java.lang.Boolean results in a get prefix, not an is prefix. -

- Any annotations named @NonNull (case insensitive) on the field are interpreted as: This field must not ever hold - null. Therefore, these annotations result in an explicit null check in the generated setter. Also, these - annotations (as well as any annotation named @Nullable or @CheckForNull) are copied to setter parameter and getter method. -

- You can annotate a class with a @Getter or @Setter annotation. Doing so is equivalent to annotating all non-static fields - in that class with that annotation. @Getter/@Setter annotations on fields take precedence over the ones on classes. -

- Using the AccessLevel.NONE access level simply generates nothing. It's useful only in combination with - @Data or a class-wide @Getter or @Setter. -

- @Getter can also be used on enums. @Setter can't, not for a technical reason, but - for a pragmatic one: Setters on enums are an extremely bad idea. -

-
-
-
- Back to features | Previous feature (@Cleanup) | Next feature (@ToString)
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
-
-
- - - diff --git a/website-old/features/Log.html b/website-old/features/Log.html deleted file mode 100644 index 9415ddd9..00000000 --- a/website-old/features/Log.html +++ /dev/null @@ -1,105 +0,0 @@ - - - - - - - - @Log (and friends) -
-
-
-
Project Lombok
-

@Log (and friends)

-
Captain's Log, stardate 24435.7: "What was that line again?"
-
-

Overview

-

- NEW in lombok 0.10: You can annotate any class with a log annotation to let lombok generate a logger field.
- The logger is named log and the field's type depends on which logger you have selected. -

- There are several choices available:
-

-
@CommonsLog
-
Creates private static final org.apache.commons.logging.Log log = org.apache.commons.logging.LogFactory.getLog(LogExample.class);
-
@JBossLog
-
Creates private static final org.jboss.logging.Logger log = org.jboss.logging.Logger.getLogger(LogExample.class);
-
@Log
-
Creates private static final java.util.logging.Logger log = java.util.logging.Logger.getLogger(LogExample.class.getName());
-
@Log4j
-
Creates private static final org.apache.log4j.Logger log = org.apache.log4j.Logger.getLogger(LogExample.class);
-
@Log4j2
-
Creates private static final org.apache.logging.log4j.Logger log = org.apache.logging.log4j.LogManager.getLogger(LogExample.class);
-
@Slf4j
-
Creates private static final org.slf4j.Logger log = org.slf4j.LoggerFactory.getLogger(LogExample.class);
-
@XSlf4j
-
Creates private static final org.slf4j.ext.XLogger log = org.slf4j.ext.XLoggerFactory.getXLogger(LogExample.class);
-
-

- By default, the topic (or name) of the logger will be the class name of the class annotated with the @Log annotation. This can be customised by specifying the topic parameter. For example: @XSlf4j(topic="reporting"). -

-
-
-
-

With Lombok

-
@HTML_PRE@
-
-
-
-

Vanilla Java

-
@HTML_POST@
-
-
-
-
-

Supported configuration keys:

-
-
lombok.log.fieldName = an identifier (default: log)
-
The generated logger fieldname is by default 'log', but you can change it to a different name with this setting.
-
lombok.log.fieldIsStatic = [true | false] (default: true)
-
Normally the generated logger is a static field. By setting this key to false, the generated field will be an instance field instead.
-
lombok.log.flagUsage = [warning | error] (default: not set)
-
Lombok will flag any usage of any of the various log annotations as a warning or error if configured.
-
lombok.log.apacheCommons.flagUsage = [warning | error] (default: not set)
-
Lombok will flag any usage of @lombok.extern.apachecommons.CommonsLog as a warning or error if configured.
-
lombok.log.javaUtilLogging.flagUsage = [warning | error] (default: not set)
-
Lombok will flag any usage of @lombok.extern.java.Log as a warning or error if configured.
-
lombok.log.jbosslog.flagUsage = [warning | error] (default: not set)
-
Lombok will flag any usage of @lombok.extern.jbosslog.JBossLog as a warning or error if configured.
-
lombok.log.log4j.flagUsage = [warning | error] (default: not set)
-
Lombok will flag any usage of @lombok.extern.log4j.Log4j as a warning or error if configured.
-
lombok.log.log4j2.flagUsage = [warning | error] (default: not set)
-
Lombok will flag any usage of @lombok.extern.log4j.Log4j2 as a warning or error if configured.
-
lombok.log.slf4j.flagUsage = [warning | error] (default: not set)
-
Lombok will flag any usage of @lombok.extern.slf4j.Slf4j as a warning or error if configured.
-
lombok.log.xslf4j.flagUsage = [warning | error] (default: not set)
-
Lombok will flag any usage of @lombok.extern.slf4j.XSlf4j as a warning or error if configured.
-
-
-
-

Small print

-

- If a field called log already exists, a warning will be emitted and no code will be generated. -

- A future feature of lombok's diverse log annotations is to find calls to the logger field and, if the chosen logging framework supports it and the log level can be compile-time determined from the log call, guard it with an if statement. This way if the log statement ends up being ignored, the potentially expensive calculation of the log string is avoided entirely. This does mean that you should NOT put any side-effects in the expression that you log. -

-
-
-
- Back to features | Previous feature (@Getter(lazy=true)) | Next feature (configuration)
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
-
-
- - - diff --git a/website-old/features/NonNull.html b/website-old/features/NonNull.html deleted file mode 100644 index c322309e..00000000 --- a/website-old/features/NonNull.html +++ /dev/null @@ -1,86 +0,0 @@ - - - - - - - - @NonNull -
-
-
-
Project Lombok
-

@NonNull

-
or: How I learned to stop worrying and love the NullPointerException.
-
-

Overview

-

- NEW in Lombok 0.11.10: You can use @NonNull on the parameter of a method or constructor to have lombok generate a null-check statement for you.
-

- Lombok has always treated any annotation named @NonNull on a field as a signal to generate a null-check if lombok generates an entire method or constructor for you, via - for example @Data. Now, however, using lombok's own @lombok.NonNull on a parameter results in the insertion of just the null-check - statement inside your own method or constructor. -

- The null-check looks like if (param == null) throw new NullPointerException("param"); and will be inserted at the very top of your method. For constructors, the null-check - will be inserted immediately following any explicit this() or super() calls. -

- If a null-check is already present at the top, no additional null-check will be generated. -

-
-
-
-

With Lombok

-
@HTML_PRE@
-
-
-
-

Vanilla Java

-
@HTML_POST@
-
-
-
-
-

Supported configuration keys:

-
-
lombok.nonNull.exceptionType = [NullPointerException | IllegalArgumentException] (default: NullPointerException). -
When lombok generates a null-check if statement, by default, a java.lang.NullPointerException will be thrown with the field name as the exception message. - However, you can use IllegalArgumentException in this configuration key to have lombok throw that exception, with 'fieldName is null' as exception message.
-
lombok.nonNull.flagUsage = [warning | error] (default: not set)
-
Lombok will flag any usage of @NonNull as a warning or error if configured.
-
-
-
-

Small print

-

- Lombok's detection scheme for already existing null-checks consists of scanning for if statements that look just like lombok's own. Any 'throws' statement as - the 'then' part of the if statement, whether in braces or not, counts. The conditional of the if statement must look exactly like PARAMNAME == null. - The first statement in your method that is not such a null-check stops the process of inspecting for null-checks. -

- While @Data and other method-generating lombok annotations will trigger on any annotation named @NonNull regardless of casing or package name, - this feature only triggers on lombok's own @NonNull annotation from the lombok package. -

- A @NonNull on a primitive parameter results in a warning. No null-check will be generated. -

- A @NonNull on a parameter of an abstract method used to generate a warning; starting with version 1.16.8, this is no longer the case, to acknowledge the notion that @NonNull also has a - documentary role. For the same reason, you can annotate a method as @NonNull; this is allowed, generates no warning, and does not generate any code. -

-
-
-
- Back to features | Previous feature (val) | Next feature (@Cleanup)
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
-
-
- - - diff --git a/website-old/features/Singular-snippet.html b/website-old/features/Singular-snippet.html deleted file mode 100644 index 8933ef47..00000000 --- a/website-old/features/Singular-snippet.html +++ /dev/null @@ -1,43 +0,0 @@ - - - - - - - - @Builder's @Singular (snippet) -
-
-
-
Project Lombok
-

@Singular snippet

-
-
-

With Lombok

-
@HTML_PRE@
-
-
-
-

Vanilla Java

-
@HTML_POST@
-
-
-
-
- Back to @Builder
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
-
-
- - - diff --git a/website-old/features/SneakyThrows.html b/website-old/features/SneakyThrows.html deleted file mode 100644 index 11937e63..00000000 --- a/website-old/features/SneakyThrows.html +++ /dev/null @@ -1,96 +0,0 @@ - - - - - - - - @SneakyThrows -
-
-
-
Project Lombok
-

@SneakyThrows

-
To boldly throw checked exceptions where no one has thrown them before!
-
-

Overview

-

- @SneakyThrows can be used to sneakily throw checked exceptions without actually declaring this in your method's throws - clause. This somewhat contentious ability should be used carefully, of course. The code generated by lombok will not ignore, wrap, replace, - or otherwise modify the thrown checked exception; it simply fakes out the compiler. On the JVM (class file) level, all exceptions, checked or not, - can be thrown regardless of the throws clause of your methods, which is why this works. -

- Common use cases for when you want to opt out of the checked exception mechanism center around 2 situations:

    -
  • A needlessly strict interface, such as Runnable - whatever exception propagates out of your run() method, - checked or not, it will be passed to the Thread's unhandled exception handler. Catching a checked exception and wrapping it - in some sort of RuntimeException is only obscuring the real cause of the issue.
    • -
  • An 'impossible' exception. For example, new String(someByteArray, "UTF-8"); declares that it can throw an - UnsupportedEncodingException but according to the JVM specification, UTF-8 must always be available. An - UnsupportedEncodingException here is about as likely as a ClassNotFoundError when you use a String object, - and you don't catch those either!
-

- Be aware that it is impossible to catch sneakily thrown checked types directly, as javac will not let you write a catch block - for an exception type that no method call in the try body declares as thrown. This problem is not relevant in either of the use cases listed - above, so let this serve as a warning that you should not use the @SneakyThrows mechanism without some deliberation! -

- You can pass any number of exceptions to the @SneakyThrows annotation. If you pass no exceptions, you may throw any - exception sneakily. -

- NOTE: with lombok versions older than 0.10, unlike other lombok transformations, you need to put lombok.jar on your - classpath when you run your program. -

-
-
-

With Lombok

-
@HTML_PRE@
-
-
-
-

Vanilla Java

-
@HTML_POST@
-
-
-
-
-

Supported configuration keys:

-
-
lombok.sneakyThrows.flagUsage = [warning | error] (default: not set)
-
Lombok will flag any usage of @SneakyThrows as a warning or error if configured.
-
-
-
-

Small print

-

- Because @SneakyThrows is an implementation detail and not part of your method signature, it is an error if you try to - declare a checked exception as sneakily thrown when you don't call any methods that throw this exception. (Doing so is perfectly legal - for throws statements to accommodate subclasses). Similarly, @SneakyThrows does not inherit. -

- For the nay-sayers in the crowd: Out of the box, Eclipse will offer a 'quick-fix' for uncaught exceptions that wraps the offending - statement in a try/catch block with just e.printStackTrace() in the catch block. This is so spectacularly non-productive - compared to just sneakily throwing the exception onwards, that Roel and Reinier feel more than justified in claiming that the - checked exception system is far from perfect, and thus an opt-out mechanism is warranted. -

- If you put @SneakyThrows on a constructor, any call to a sibling or super constructor is excluded from the @SneakyThrows treatment. This is a - java restriction we cannot work around: Calls to sibling/super constructors MUST be the first statement in the constructor; they cannot be placed inside try/catch blocks. -

- @SneakyThrows on an empty method, or a constructor that is empty or only has a call to a sibling / super constructor results in no try/catch block and a warning. -

-
-
- Back to features | Previous feature (@Builder) | Next feature (@Synchronized)
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
-
-
- - - diff --git a/website-old/features/Synchronized.html b/website-old/features/Synchronized.html deleted file mode 100644 index b575e47c..00000000 --- a/website-old/features/Synchronized.html +++ /dev/null @@ -1,85 +0,0 @@ - - - - - - - - @Synchronized -
-
-
-
Project Lombok
-

@Synchronized

-
synchronized done right: Don't expose your locks.
-
-

Overview

-

- @Synchronized is a safer variant of the synchronized method modifier. Like synchronized, the - annotation can be used on static and instance methods only. It operates similarly to the synchronized keyword, but it locks - on different objects. The keyword locks on this, but the annotation locks on a field named $lock, which is private.
- If the field does not exist, it is created for you. If you annotate a static method, the annotation locks on a static field - named $LOCK instead. -

- If you want, you can create these locks yourself. The $lock and $LOCK fields will of course not be generated if you - already created them yourself. You can also choose to lock on another field, by specifying it as parameter to the @Synchronized - annotation. In this usage variant, the fields will not be created automatically, and you must explicitly create them yourself, or an error will be emitted. -

- Locking on this 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. -

-
-
-
-

With Lombok

-
@HTML_PRE@
-
-
-
-

Vanilla Java

-
@HTML_POST@
-
-
-
-
-

Supported configuration keys:

-
-
lombok.synchronized.flagUsage = [warning | error] (default: not set)
-
Lombok will flag any usage of @Synchronized as a warning or error if configured.
-
-
-
-

Small print

-

- If $lock and/or $LOCK are auto-generated, the fields are initialized with an empty Object[] array, and not - just a new Object() as most snippets showing this pattern in action use. Lombok does this because a new object is NOT - serializable, but 0-size array is. Therefore, using @Synchronized will not prevent your object from being serialized. -

- Having at least one @Synchronized method in your class means there will be a lock field, but if you later remove all such methods, - there will no longer be a lock field. That means your predetermined serialVersionUID changes. We suggest you always add - a serialVersionUID to your classes if you intend to store them long-term via java's serialization mechanism. If you do so, removing - all @Synchronized annotations from your method will not break serialization. -

- If you'd like to know why a field is not automatically generated when you choose your own name for the lock object: Because otherwise making a typo - in the field name will result in a very hard to find bug! -

-
-
-
- Back to features | Previous feature (@SneakyThrows) | Next feature (@Getter(lazy=true))
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
-
-
- - - diff --git a/website-old/features/ToString.html b/website-old/features/ToString.html deleted file mode 100644 index 6571714d..00000000 --- a/website-old/features/ToString.html +++ /dev/null @@ -1,92 +0,0 @@ - - - - - - - - @ToString -
-
-
-
Project Lombok
-

@ToString

-
No need to start a debugger to see your fields: Just let lombok generate a toString for you!
-
-

Overview

-

- Any class definition may be annotated with @ToString to let lombok generate an implementation of the toString() method. By default, it'll print your class name, along with each field, in order, separated by commas. -

- By setting the includeFieldNames parameter to true you can add some clarity (but also quite some length) to the output of the toString() method. -

- By default, all non-static fields will be printed. If you want to skip some fields, you can name them in the exclude parameter; each named field will not be printed at all. Alternatively, you can specify exactly which fields you wish to be used by naming them in the of parameter. -

- By setting callSuper to true, you can include the output of the superclass implementation of toString to the output. Be aware that the default implementation of toString() in java.lang.Object is pretty much meaningless, so you probably don't want to do this unless you are extending another class. -

-
-
-
-

With Lombok

-
@HTML_PRE@
-
-
-
-

Vanilla Java

-
@HTML_POST@
-
-
-
-
-

Supported configuration keys:

-
-
lombok.toString.includeFieldNames = [true | false] (default: true)
-
Normally lombok generates a fragment of the toString response for each field in the form of fieldName = fieldValue. If this setting is set to false, lombok will omit the name of the field and simply deploy a comma-separated list of all the field values. The annotation parameter 'includeFieldNames', if explicitly specified, takes precedence over this setting.
-
lombok.toString.doNotUseGetters = [true | false] (default: false)
-
If set to true, lombok will access fields directly instead of using getters (if available) when generating toString methods. The annotation parameter 'doNotUseGetters', if explicitly specified, takes precedence over this setting.
-
lombok.toString.flagUsage = [warning | error] (default: not set)
-
Lombok will flag any usage of @ToString as a warning or error if configured.
-
-
-
-

Small print

-

- If there is any method named toString with no arguments, regardless of return type, no method will be generated, and instead a warning is emitted explaining that your @ToString annotation is doing nothing. You can mark any method with @lombok.experimental.Tolerate to hide them from lombok. -

- Arrays are printed via Arrays.deepToString, which means that arrays that contain themselves will result in StackOverflowErrors. However, - this behaviour is no different from e.g. ArrayList. -

- Attempting to exclude fields that don't exist or would have been excluded anyway (because they are static) results in warnings on the named fields. - You therefore don't have to worry about typos. -

- Having both exclude and of generates a warning; the exclude parameter will be ignored in that case. -

- We don't promise to keep the output of the generated toString() methods the same between lombok versions. You should never design your API so that - other code is forced to parse your toString() output anyway! -

- By default, any variables that start with a $ symbol are excluded automatically. You can only include them by using the 'of' parameter. -

- If a getter exists for a field to be included, it is called instead of using a direct field reference. This behaviour can be suppressed:
- @ToString(doNotUseGetters = true) -

- @ToString can also be used on an enum definition. -

-
-
-
- Back to features | Previous feature (@Getter / @Setter) | Next feature (@EqualsAndHashCode)
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
-
-
- - - diff --git a/website-old/features/Value.html b/website-old/features/Value.html deleted file mode 100644 index 6c86a77b..00000000 --- a/website-old/features/Value.html +++ /dev/null @@ -1,87 +0,0 @@ - - - - - - - - @Value -
-
-
-
Project Lombok
-

@Value

-
Immutable classes made very easy.
-
-

Since

-

- @Value was introduced as experimental feature in lombok v0.11.4. -

- @Value no longer implies @Wither since lombok v0.11.8. -

- @Value promoted to the main lombok package since lombok v0.12.0. -

-
-
-

Overview

-

- @Value is the immutable variant of @Data; all fields are made private and final by default, and setters are not generated. The class itself is also made final by default, because immutability is not something that can be forced onto a subclass. Like @Data, useful toString(), equals() and hashCode() methods are also generated, each field gets a getter method, and a constructor that covers every - argument (except final fields that are initialized in the field declaration) is also generated. -

- In practice, @Value is shorthand for: final @ToString @EqualsAndHashCode @AllArgsConstructor @FieldDefaults(makeFinal = true, level = AccessLevel.PRIVATE) @Getter, except that explicitly including an implementation of any of the relevant methods simply means that part won't be generated and no warning will be emitted. For example, if you write your own toString, no error occurs, and lombok will not generate a toString. Also, any explicit constructor, no matter the arguments list, implies lombok will not generate a constructor. If you do want lombok to generate the all-args constructor, add @AllArgsConstructor to the class. You can mark any constructor or method with @lombok.experimental.Tolerate to hide them from lombok. -

- It is possible to override the final-by-default and private-by-default behavior using either an explicit access level on a field, or by using the @NonFinal or @PackagePrivate annotations.
- It is possible to override any default behavior for any of the 'parts' that make up @Value by explicitly using that annotation. -

-
-
-
-

With Lombok

-
@HTML_PRE@
-
-
-
-

Vanilla Java

-
@HTML_POST@
-
-
-
-
-

Supported configuration keys:

-
-
lombok.value.flagUsage = [warning | error] (default: not set)
-
Lombok will flag any usage of @Value as a warning or error if configured.
-
-
-
-

Small print

-

- Look for the documentation on the 'parts' of @Value: @ToString, @EqualsAndHashCode, @AllArgsConstructor, @FieldDefaults, and @Getter. -

- For classes with generics, it's useful to have a static method which serves as a constructor, because inference of generic parameters via static methods works in java6 and avoids having to use the diamond operator. While you can force this by applying an explicit @AllArgsConstructor(staticConstructor="of") annotation, there's also the @Value(staticConstructor="of") feature, which will make the generated all-arguments constructor private, and generates a public static method named of which is a wrapper around this private constructor. -

- @Value was an experimental feature from v0.11.4 to v0.11.9 (as @lombok.experimental.Value). It has since been moved into the core package. The old annotation is still - around (and is an alias). It will eventually be removed in a future version, though. -

- It is not possible to use @FieldDefaults to 'undo' the private-by-default and final-by-default aspect of fields in the annotated class. Use @NonFinal and @PackagePrivate on the fields in the class to override this behaviour. -

-
-
-
- Back to features | Previous feature (@Data) | Next feature (@Builder)
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
-
-
- - - diff --git a/website-old/features/clear.gif b/website-old/features/clear.gif deleted file mode 100644 index 35d42e80..00000000 Binary files a/website-old/features/clear.gif and /dev/null differ diff --git a/website-old/features/configuration.html b/website-old/features/configuration.html deleted file mode 100644 index ee7dabd5..00000000 --- a/website-old/features/configuration.html +++ /dev/null @@ -1,115 +0,0 @@ - - - - - - - - Configuration system -
-
-
-
Project Lombok
-

Configuration system

-
Lombok, made to order: Configure lombok features in one place for your entire project or even your workspace.
-
-

Overview

-

- NEW in lombok 1.14: You can create lombok.config files in any directory and put configuration directives in it. These apply to all source files in this directory and all child directories.
- The configuration system is particularly useful for configurable aspects of lombok which tend to be the same across an entire project, such as the name of your log variable. The configuration system can also be used to tell lombok to flag any usage of some lombok feature you don't like as a warning or even an error. -

- Usually, a user of lombok puts a lombok.config file with their preferences in a workspace or project root directory, with the special config.stopBubbling = true key to tell lombok this is your root directory. You can then create lombok.config files in any subdirectories (generally representing projects or source packages) with different settings. -

- An up to date list of all configuration keys supported by your version of lombok can be generated by running: -

- java -jar lombok.jar config -g --verbose -
- The output of the config tool is itself a valid lombok.config file.
- The config tool can also be used to display the complete lombok configuration used for any given directory or source file by supplying these as arguments. -

- A sample of available configuration options (see the feature pages of the lombok features for their related config keys, as well as java -jar lombok.jar config -g for the complete list): -

-
lombok.accessors.chain
-
If set to true, generated setters will 'chain' by default (They will return this instead of having a void return type).
-
lombok.accessors.fluent
-
If set to true, generated setters and getters will simply be named the same as the field name, without a get or set prefix.
-
lombok.anyConstructor.suppressConstructorProperties
-
If true, lombok will not generate a @java.beans.ConstructorProperties annotation when generating constructors. This is particularly useful for GWT and Android development.
-
lombok.log.fieldName
-
The name of the generated log field (default: log).
-
lombok.(featureName).flagUsage
-
Allows you to forcibly stop or discourage use of a lombok feature. Legal values for this key are warning or error. Some examples of values for (featureName) are: "experimental" (flags use of any of the experimental features), "builder", "sneakyThrows", or "extensionMethod".
-
-

- Configuration files are hierarchical: Any configuration setting applies to all source files in that directory, and all source files in subdirectories, but configuration settings closer to the source file take precedence. For example, if you have in /Users/me/projects/lombok.config the following: -

- lombok.log.fieldName = foobar -
- and in /Users/me/projects/MyProject/lombok.config you have: -
- lombok.log.fieldName = xyzzy -
- - Then the various @Log annotations will use foobar instead of the default log as a field name to generate in all your projects, - except for your project in /Users/me/projects/MyProject, where xyzzy is used instead. -

- To restore a configuration key set by a parent config file back to the default, the clear option can be used. For example, if a parent configuration file has configured all use of val to emit a warning, you can turn off the warnings for a subdirectory by including in it a lombok.config file with: -

- clear lombok.val.flagUsage -
-

- Some configuration keys take lists. For lists, use += to add an entry. You can remove a single item from the list (useful to undo a parent configuration file's setting) with -=. For example: -

- lombok.accessors.prefix += m_ -
-

- Comments can be included in lombok.config files; any line that starts with # is considered a comment. -

-
-
-

Global config keys

-

- To stop lombok from looking at parent directories for more configuration files, the special key: -

- config.stopBubbling = true -
- can be included. We suggest you put this in the root of your workspace directory. -

- Lombok normally adds @javax.annotation.Generated annotations to all generated nodes where possible. You can stop this with: -

- lombok.addGeneratedAnnotation = false -
-

- Lombok can add the @SuppressFBWarnings annotation which is useful if you want to run FindBugs on your class files. To enable this feature, make sure findbugs is on the classpath when you compile, and add the following config key: -

- lombok.extern.findbugs.addSuppressFBWarnings = true -
-
-
-

Config keys that can even affect source files with 0 lombok annotations

-

-

- lombok.fieldDefaults.defaultPrivate = true
- lombok.fieldDefaults.defaultFinal = true -
- Turning either of these options on means lombok will make every field in every source file final and/or private unless it has an explicit access modifier or annotation to suppress this. See the @FieldDefaults documentation for more. -
-
-
- Back to features | Previous feature (@Log) | Next feature
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
-
-
- - - diff --git a/website-old/features/delombok.html b/website-old/features/delombok.html deleted file mode 100644 index f321db45..00000000 --- a/website-old/features/delombok.html +++ /dev/null @@ -1,80 +0,0 @@ - - - - - - - - delombok -
-
-
-
Project Lombok
-

delombok

-
-

Overview

-

- Normally, lombok adds support for all the lombok features directly to your IDE and compiler by plugging into them.
- However, lombok doesn't cover all tools. For example, lombok cannot plug into javadoc, nor can it plug into the Google Widget Toolkit, both of which - run on java sources. Delombok still allows you to use lombok with these tools by preprocessing your java code into java code with all of lombok's - transformations already applied. -

- Delombok can of course also help understand what's happening with your source by letting you look at exactly what lombok is doing 'under the hood'. -

- Delombok's standard mode of operation is that it copies an entire directory into another directory, recursively, skipping class files, and applying - lombok transformations to any java source files it encounters. -

- Delombok's output format can be configured with command line options (use --format-help for a complete list). A few such options are automatically scanned from input if possible (such as indent). If delombok's formatting is not conforming to your preferred code style, have a look! -

-

Running delombok on the command line

-

- Delombok is included in lombok.jar. To use it, all you need to run on the command line is: - 

java -jar lombok.jar delombok src -d src-delomboked
-
- Which will duplicate the contents of the src directory into the src-delomboked directory, which will be created if it - doesn't already exist, but delomboked of course. Delombok on the command line has a few more options; use the --help parameter to see more options. -

- To let delombok print the transformation result of a single java file directly to standard output, you can use: - 

java -jar lombok.jar delombok -p MyJavaFile.java
-

-

Running delombok in ant

- lombok.jar includes an ant task which can apply delombok for you. For example, to create javadoc for your project, your build.xml file - would look something like: - 
<target name="javadoc">
-	<taskdef classname="lombok.delombok.ant.Tasks$Delombok" classpath="lib/lombok.jar" name="delombok" />
-	<mkdir dir="build/src-delomboked" />
-	<delombok verbose="true" encoding="UTF-8" to="build/src-delomboked" from="src">
-		<format value="suppressWarnings:skip" />
-	</delombok>
-	<mkdir dir="build/api" />
-	<javadoc sourcepath="build/src-delomboked" defaultexcludes="yes" destdir="build/api" />
-</target>
-
- Instead of a from attribute, you can also nest <fileset> nodes. -

Running delombok in maven

- Anthony Whitford has written a maven plugin for delomboking your source code. -

Limitations

- Delombok tries to preserve your code as much as it can, but comments may move around a little bit, especially comments that are in the middle of - a syntax node. For example, any comments appearing in the middle of a list of method modifiers, such as public /*comment*/ static ... will - move towards the front of the list of modifiers. In practice, any java source parsing tool will not be affected.
- To keep any changes to your code style to a minimum, delombok just copies a source file directly without changing any of it if the source file contains - no lombok transformations. -
-
- Back to features
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
-
-
- - - diff --git a/website-old/features/experimental/Accessors.html b/website-old/features/experimental/Accessors.html deleted file mode 100644 index 909c0873..00000000 --- a/website-old/features/experimental/Accessors.html +++ /dev/null @@ -1,116 +0,0 @@ - - - - - - - - EXPERIMENTAL – @Accessors -
-
-
-
Project Lombok
-

@Accessors

-
A more fluent API for getters and setters.
-
-

Since

-

- @Accessors was introduced as experimental feature in lombok v0.11.0. -

-
-
-

Experimental

-

- Experimental because: -

    -
  • We may want to roll these features into a more complete property support concept.
    • -
  • New feature - community feedback requested.
    • -
- Current status: positive - Currently we feel this feature may move out of experimental status with no or minor changes soon. -
-
-

Overview

-

- The @Accessors annotation is used to configure how lombok generates and looks for getters and setters. -

- By default, lombok follows the bean specification for getters and setters: The getter for a field named pepper - is getPepper for example. However, some might like to break with the bean specification in order to end up with - nicer looking APIs. @Accessors lets you do this. -

- Some programmers like to use a prefix for their fields, i.e. they write fPepper instead of pepper. - We strongly discourage doing this, as you can't unit test the validity of your prefixes, and refactor scripts may turn fields - into local variables or method names. Furthermore, your tools (such as your editor) can take care of rendering the identifier in a - certain way if you want this information to be instantly visible. Nevertheless, you can list the prefixes that your project uses via - @Accessors as well. -

- @Accessors therefore has 3 options:

    -
  • fluent - A boolean. If true, the getter for pepper is just pepper(), and the - setter is pepper(T newValue). Furthermore, unless specified, chain defaults to true.
    - Default: false.
    • -
  • chain - A boolean. If true, generated setters return this instead of void.
    - Default: false, unless fluent=true, then Default: true.
    • -
  • prefix - A list of strings. If present, fields must be prefixed with any of these prefixes. Each field name is - compared to each prefix in the list in turn, and if a match is found, the prefix is stripped out to create the base name for - the field. It is legal to include an empty string in the list, which will always match. For characters which are letters, the - character following the prefix must not be a lowercase letter, i.e. pepper is not a match even to prefix p, - but pEpper would be (and would mean the base name of this field is epper).
    • -

    - The @Accessors annotation is legal on types and fields; the annotation that applies is the one on the field if present, - otherwise the one on the class. When a @Accessors annotation on a field is present, any @Accessors annotation - also present on that field's type is ignored. -

    -
-
-
-

With Lombok

-
@HTML_PRE@
-
-
-
-

Vanilla Java

-
@HTML_POST@
-
-
-
-
-

Supported configuration keys:

-
-
lombok.accessors.chain = [true | false] (default: false)
-
If set to true, any class that either doesn't have an @Accessors annotation, or it does, but that annotation does not have an explicit value for the chain parameter, will act as if @Accessors(chain = true) is present.
-
lombok.accessors.fluent = [true | false] (default: false)
-
If set to true, any class that either doesn't have an @Accessors annotation, or it does, but that annotation does not have an explicit value for the fluent parameter, will act as if @Accessors(fluent = true) is present.
-
lombok.accessors.prefix += a field prefix (default: empty list)
-
This is a list property; entries can be added with the += operator. Inherited prefixes from parent config files can be removed with the -= operator. Any class that either doesn't have an @Accessors annotation, or it does, but that annotation does not have an explicit value for the prefix parameter, will act as if @Accessors(prefix = {prefixes listed in configuration}) is present.
-
lombok.accessors.flagUsage = [warning | error] (default: not set)
-
Lombok will flag any usage of @Accessors as a warning or error if configured.
-
-
-
-

Small print

-

- The nearest @Accessors annotation is also used for the various methods in lombok that look for getters, such as - @EqualsAndHashCode. -

- If a prefix list is provided and a field does not start with one of them, that field is skipped entirely by lombok, and - a warning will be generated. -

-
-
-
- Back to experimental features | Previous feature (var) | Next feature (@ExtensionMethod)
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
-
-
- - - diff --git a/website-old/features/experimental/Builder.html b/website-old/features/experimental/Builder.html deleted file mode 100644 index e1c545fc..00000000 --- a/website-old/features/experimental/Builder.html +++ /dev/null @@ -1,36 +0,0 @@ - - - - - - - - @Builder -
-
-
-
Project Lombok
-

@Builder

-
... and Bob's your uncle: No-hassle fancy-pants APIs for object creation!
-
- @Builder has been promoted to the core package in lombok release v1.16.0.
- The documentation has been moved here: @lombok.Builder. -
-
- Back to experimental features
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
-
-
- - - diff --git a/website-old/features/experimental/Delegate.html b/website-old/features/experimental/Delegate.html deleted file mode 100644 index 5173376d..00000000 --- a/website-old/features/experimental/Delegate.html +++ /dev/null @@ -1,100 +0,0 @@ - - - - - - - - EXPERIMENTAL – @Delegate -
-
-
-
Project Lombok
-

@Delegate

-
Don't lose your composition.
-
-

Since

-

- @Delegate was introduced as feature in lombok v0.10. It was moved to the experimental package in lombok v1.14; the old version from the main lombok package is now deprecated. -

-
-
-

Experimental

-

- Experimental because: -

    -
  • Not used that much
    • -
  • Difficult to support for edge cases, such as recursive delegation.
    • -
  • API is rather unfriendly; it would be a lot nicer if you can simply implement some methods and let @Delegate generate delegates for whatever you didn't manually implement, but due to issues with generics erasure this also can't be made to work without caveats. -
- Current status: negative - Currently we feel this feature will not move out of experimental status anytime soon, and support for this feature may be dropped if future versions of javac or ecj make it difficult to continue to maintain the feature. -
-
-

Overview

-

- Any field or no-argument method can be annotated with @Delegate to let lombok generate delegate methods that forward the call to this field (or the result of invoking this method). -

- Lombok delegates all public methods of the field's type (or method's return type), as well as those of its supertypes except for all - methods declared in java.lang.Object. -

- You can pass any number of classes into the @Delegate annotation's types parameter. - If you do that, then lombok will delegate all public methods in those types (and their supertypes, except java.lang.Object) instead of looking at the field/method's type. -

- All public non-Object 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 @Delegate(excludes=SomeType.class) parameter to exclude all public methods in the excluded type(s), and their supertypes. -

- 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 @Delegate(types=PrivateInnerInterfaceWithIncludesList.class, excludes=SameForExcludes.class). -

-
-
-
-

With Lombok

-
@HTML_PRE@
-
-
-
-

Vanilla Java

-
@HTML_POST@
-
-
-
-
-

Supported configuration keys:

-
-
lombok.delegate.flagUsage = [warning | error] (default: not set)
-
Lombok will flag any usage of @Delegate as a warning or error if configured.
-
-
-
-

Small print

-

- When passing classes to the annotation's types or excludes 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. -

- When passing classes to the annotation, these classes do not need to be supertypes of the field. See the example. -

- @Delegate cannot be used on static fields or methods. -

- @Delegate cannot be used when the calculated type(s) to delegate / exclude themselves contain @Delegate annotations; in other words, @Delegate will error if you attempt to use it recursively. -

-
-
- Back to experimental features | Previous feature (@FieldDefaults) | Next feature (@Wither)
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
-
-
- - - diff --git a/website-old/features/experimental/ExtensionMethod.html b/website-old/features/experimental/ExtensionMethod.html deleted file mode 100644 index 7090fd19..00000000 --- a/website-old/features/experimental/ExtensionMethod.html +++ /dev/null @@ -1,116 +0,0 @@ - - - - - - - - EXPERIMENTAL – @ExtensionMethod -
-
-
-
Project Lombok
-

@ExtensionMethod

-
Annoying API? Fix it yourself: Add new methods to existing types!
-
-

Since

-

- @ExtensionMethod was introduced as experimental feature in lombok v0.11.2. -

-
-
-

Experimental

-

- Experimental because: -

    -
  • High-impact on code style
    • -
  • Really would like to ship with utility methods to expand common classes, but so far lombok doesn't have a good distribution method for such runtime dependencies
    • -
  • Affects quite a bit of eclipse, and auto-complete e.d. do not work yet in netbeans
    • -
  • Should @ExtensionMethod be legal on methods? Should it be legal on packages?
    • -
- Current status: positive - Currently we feel this feature may move out of experimental status with no or minor changes soon. -
-
-

Overview

-

- You can make a class containing a bunch of public, static methods which all take at least 1 - parameter. These methods will extend the type of the first parameter, as if they were instance methods, using the - @ExtensionMethod feature. -

-

- For example, if you create public static String toTitleCase(String in) { ... }, you can use the - @ExtensionMethod feature to make it look like the java.lang.String class has a method named - toTitleCase, which has no arguments. The first argument of the static method fills the role of this - in instance methods. -

- All methods that are public, static, and have at least 1 argument whose type is not primitive, are - considered extension methods, and each will be injected into the namespace of the type of the first parameter as if they were - instance methods. As in the above example, a call that looks like: foo.toTitleCase() is replaced with - ClassContainingYourExtensionMethod.toTitleCase(foo);. Note that it is actually not an instant - NullPointerException if foo is null - it is passed like any other parameter. -

- You can pass any number of classes to the @ExtensionMethod annotation; they will all be searched for - extension methods. These extension methods apply for any code that is in the annotated class. -

- Lombok does not (currently) have any runtime dependencies which means lombok does not (currently) ship with any useful - extension methods so you'll have to make your own. However, here's one that might spark your imagination: - 

public class ObjectExtensions {
-	public static <T> or(T object, T ifNull) {
-		return object != null ? object : ifNull;
-	}
-}
- With the above class, if you add @ExtensionMethod(ObjectExtensions.class) to your class definition, you can write: - 
String x = null;
-System.out.println(x.or("Hello, World!"));
- The above code will not fail with a NullPointerException; it will actually output Hello, World! -

-
-
-
-

With Lombok

-
@HTML_PRE@
-
-
-
-

Vanilla Java

-
@HTML_POST@
-
-
-
-
-

Supported configuration keys:

-
-
lombok.extensionMethod.flagUsage = [warning | error] (default: not set)
-
Lombok will flag any usage of @ExtensionMethod as a warning or error if configured.
-
-
-
-

Small print

-

- Calls are rewritten to a call to the extension method; the static method itself is not inlined. Therefore, the - extension method must be present both at compile and at runtime. -

- Generics is fully applied to figure out extension methods. i.e. if the first parameter of your extension method is - List<? extends String>, then any expression that is compatible with that will have your extension method, - but other kinds of lists won't. So, a List<Object> won't get it, but a List<String> will. -

-
-
-
- Back to experimental features | Previous feature (@Accessors) | Next feature (@FieldDefaults)
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
-
-
- - - diff --git a/website-old/features/experimental/FieldDefaults.html b/website-old/features/experimental/FieldDefaults.html deleted file mode 100644 index a253198b..00000000 --- a/website-old/features/experimental/FieldDefaults.html +++ /dev/null @@ -1,95 +0,0 @@ - - - - - - - - EXPERIMENTAL – @FieldDefaults -
-
-
-
Project Lombok
-

@FieldDefaults

-
New default field modifiers for the 21st century.
-
-

Since

-

- @FieldDefaults was introduced as experimental feature in lombok v0.11.4. -

-
-
-

Experimental

-

- Experimental because: -

    -
  • New feature; unsure if this busts enough boilerplate
    • -
  • Would be nice if you could stick this on the package-info.java package to set the default for all classes in that package
    • -
  • Part of the work on @Value, which is experimental
    • -
- Current status: positive - Currently we feel this feature may move out of experimental status with no or minor changes soon. -
-
-

Overview

-

- The @FieldDefaults annotation can add an access modifier (public, private, or protected) - to each field in the annotated class or enum. It can also add final to each field in the annotated class or enum. -

-

- To add final to each (instance) field, use @FieldDefaults(makeFinal=true). Any non-final field which must remain nonfinal - can be annotated with @NonFinal (also in the lombok.experimental package). -

- To add an access modifier to each (instance) field, use @FieldDefaults(level=AccessLevel.PRIVATE). Any field that does not already have an - access modifier (i.e. any field that looks like package private access) is changed to have the appropriate access modifier. Any package private - field which must remain package private can be annotated with @PackagePrivate (also in the lombok.experimental package). -

-
-
-
-

With Lombok

-
@HTML_PRE@
-
-
-
-

Vanilla Java

-
@HTML_POST@
-
-
-
-
-

Supported configuration keys:

-
-
lombok.fieldDefaults.flagUsage = [warning | error] (default: not set)
-
Lombok will flag any usage of @FieldDefaults as a warning or error if configured.
-
lombok.fieldDefaults.defaultPrivate = [true | false] (default: false)
-
(Since 1.16.8) If set to true, every field in every class or enum anywhere in the sources being compiled will be marked as private unless it has an explicit access modifier or the @PackagePrivate annotation, or an explicit @FieldDefaults annotation is present to override this config key.
-
lombok.fieldDefaults.defaultFinal = [true | false] (default: false)
-
(Since 1.16.8) If set to true, every field in every class or enum anywhere in the sources being compiled will be marked as final unless it has the @NonFinal annotation, or an explicit @FieldDefaults annotation is present to override this config key.
-
-
-
-

Small print

-

- Like other lombok handlers that touch fields, any field whose name starts with a dollar ($) symbol is skipped entirely. - Such a field will not be modified at all. -

-
-
-
- Back to experimental features | Previous feature (@ExtensionMethod) | Next feature (@Delegate)
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
-
-
- - - diff --git a/website-old/features/experimental/Value.html b/website-old/features/experimental/Value.html deleted file mode 100644 index ec0ff9e4..00000000 --- a/website-old/features/experimental/Value.html +++ /dev/null @@ -1,36 +0,0 @@ - - - - - - - - EXPERIMENTAL – @Value -
-
-
-
Project Lombok
-

@Value

-
Immutable classes made very easy.
-
- @Value has been promoted to the core package in lombok release v1.12.0.
- The documentation has been moved here: @lombok.Value. -
-
- Back to experimental features
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
-
-
- - - diff --git a/website-old/features/experimental/Wither.html b/website-old/features/experimental/Wither.html deleted file mode 100644 index c8030bd9..00000000 --- a/website-old/features/experimental/Wither.html +++ /dev/null @@ -1,113 +0,0 @@ - - - - - - - - EXPERIMENTAL – @Wither -
-
-
-
Project Lombok
-

@Wither

-
Immutable 'setters' - methods that create a clone but with one changed field.
-
-

Since

-

- @Wither was introduced as experimental feature in lombok v0.11.4. -

-
-
-

Experimental

-

- Experimental because: -

    -
  • Still not sure that @Wither is an appropriate name for this feature.
    • -
  • Should there be an option to supply a way of cloning the input somehow?
    • -
  • Should the way that the clone is created by configurable?
    • -
  • Should we replace @Wither entirely with a builder class?
    • -
- Current status: neutral - More feedback requires on the items in the above list before promotion to the main package is warranted. -
-
-

Overview

-

- The next best alternative to a setter for an immutable property is to construct a clone of the object, but with a new value for this one field. - A method to generate this clone is precisely what @Wither generates: a withFieldName(newValue) method which produces a clone - except for the new value for the associated field. -

- For example, if you create public class Point { private final int x, y; }, setters make no sense because the fields - are final. @Wither can generate a withX(int newXValue) method for you which will return a new point with the supplied - value for x and the same value for y. -

- Like @Setter, you can specify an access level in case you want the generated wither to be something other than public:
- @Wither(level = AccessLevel.PROTECTED). Also like @Setter, you can also put a @Wither annotation on a type, which means - a 'wither' is generated for each field (even non-final fields). -

- To put annotations on the generated method, you can use onMethod=@__({@AnnotationsHere}); to put annotations on the only parameter of a generated wither method, you can use onParam=@__({@AnnotationsHere}). Be careful though! This is an experimental feature. For more details see the documentation on the onX feature. -

- NEW in lombok v1.12.0: javadoc on the field will now be copied to generated withers. Normally, all text is copied, and @param is moved to the wither, whilst @return lines are stripped from the wither's javadoc. Moved means: Deleted from the field's javadoc. It is also possible to define unique text for the wither's javadoc. To do that, you create a 'section' named WITHER. A section is a line in your javadoc containing 2 or more dashes, then the text 'WITHER', followed by 2 or more dashes, and nothing else on the line. If you use sections, @return and @param stripping / copying for that section is no longer done (move the @param line into the section). -

-
-
-
-

With Lombok

-
@HTML_PRE@
-
-
-
-

Vanilla Java

-
@HTML_POST@
-
-
-
-
-

Supported configuration keys:

-
-
lombok.wither.flagUsage = [warning | error] (default: not set)
-
Lombok will flag any usage of @Wither as a warning or error if configured.
-
-
-
-

Small print

-

- Withers cannot be generated for static fields because that makes no sense. -

- Withers can be generated for abstract classes, but this generates an abstract method with the appropriate signature. -

- When applying @Wither to a type, static fields and fields whose name start with a $ are skipped. -

- For generating the method names, the first character of the field, if it is a lowercase character, is title-cased, otherwise, it is left unmodified. - Then, with is prefixed. -

- No method is generated if any method already exists with the same name (case insensitive) and same parameter count. For example, withX(int x) - will not be generated if there's already a method withX(String... x) even though it is technically possible to make the method. This caveat - exists to prevent confusion. If the generation of a method is skipped for this reason, a warning is emitted instead. Varargs count as 0 to N parameters. -

- For boolean fields that start with is immediately followed by a title-case letter, nothing is prefixed to generate the wither name. -

- Any annotations named @NonNull (case insensitive) on the field are interpreted as: This field must not ever hold - null. Therefore, these annotations result in an explicit null check in the generated wither. Also, these - annotations (as well as any annotation named @Nullable or @CheckForNull) are copied to wither parameter. -

-
-
-
- Back to experimental features | Previous feature (@Delegate) | Next feature (onX)
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
-
-
- - - diff --git a/website-old/features/experimental/index.html b/website-old/features/experimental/index.html deleted file mode 100644 index 4a6d12bb..00000000 --- a/website-old/features/experimental/index.html +++ /dev/null @@ -1,77 +0,0 @@ - - - - - - - - Lombok feature overview -
-
-
-
Project Lombok
-

Lombok experimental features

-
- Experimental features are available in your normal lombok installation, but are not as robustly supported as lombok's main features. - In particular, experimental features:
    -
  • Are not tested as well as the core features.
    • -
  • Do not get bugs fixed as quickly as core features.
    • -
  • May have APIs that will change, possibly drastically if we find a different, better way to solve the same problem.
    • -
  • May disappear entirely if the feature is too difficult to support or does bust enough boilerplate.
    • -
- Features that receive positive community feedback and which seem to produce clean, flexible code will eventually become accepted - as a core feature and move out of the experimental package. -
-
@var
-
The same as @val but modifiable.
-
@Accessors
-
A more fluent API for getters and setters.
-
@ExtensionMethod
-
Annoying API? Fix it yourself: Add new methods to existing types!
-
@FieldDefaults
-
New default field modifiers for the 21st century.
-
@Delegate
-
Don't lose your composition.
-
@Wither
-
Immutable 'setters' - methods that create a clone but with one changed field.
-
onMethod= / onConstructor= / onParam=
-
Sup dawg, we heard you like annotations, so we put annotations in your annotations so you can annotate while you're annotating.
-
@UtilityClass
-
Utility, metility, wetility! Utility classes for the masses.
-
@Helper
-
With a little help from my friends... Helper methods for java.
-
-
-
-

Supported configuration keys:

-
-
lombok.experimental.flagUsage = [warning | error] (default: not set)
-
Lombok will flag any usage of any of the features listed here as a warning or error if configured.
-
-
-
-

Putting the "Ex" in "Experimental": promoted or deleted experimental features.

-
-
@Value: Promoted
-
@Value has proven its value and has been moved to the main package. -
@Builder: Promoted
-
@Builder is a solid base to build APIs on, and has been moved to the main package. -
-
-
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
-
-
- - - diff --git a/website-old/features/experimental/onX.html b/website-old/features/experimental/onX.html deleted file mode 100644 index 39faa1bf..00000000 --- a/website-old/features/experimental/onX.html +++ /dev/null @@ -1,92 +0,0 @@ - - - - - - - - EXPERIMENTAL – onX -
-
-
-
Project Lombok
-

onX

-
Sup dawg, we heard you like annotations, so we put annotations in your annotations so you can annotate while you're annotating.
-
-

Since

-

- onX was introduced as experimental feature in lombok v0.11.8. -

-
-
-

Experimental

-

- Experimental because: -

    -
  • Ugly syntax. The syntax of this feature is not optimal, but it is the least convoluted syntax that could possibly work (for now!)
    • -
  • Possibly java 9 will offer (much) better ways of supporting this feature.
    • -
  • Uncertainty: Future versions of javac may break this feature, and we may not be able to restore it.
    • -
- Current status: uncertain - Currently we feel this feature cannot move out of experimental status. -
-
-

Overview

-

- This feature is considered 'workaround status' - it exists in order to allow users of lombok that cannot work without this feature to have access to it anyway. If we find a better way to implement this feature, or some future java version introduces an alternative strategy, this feature can disappear without a reasonable deprecation period. Also, this feature may not work in future versions of javac. Use at your own discretion. -

- Most annotations that make lombok generate methods or constructors can be configured to also make lombok put custom annotations on elements in the generated code. -

- @Getter, @Setter, and @Wither support the onMethod option, which will put the listed annotations on the generated method. -

- @AllArgsConstructor, @NoArgsConstructor, and @RequiredArgsConstructor support the onConstructor option which will put the listed annotations on the generated constructor. -

- @Setter and @Wither support onParam in addition to onMethod; annotations listed will be put on the only parameter that the generated method has. @EqualsAndHashCode also supports onParam; the listed annotation(s) will be placed on the single parameter of the generated equals method, as well as any generated canEqual method. -

- The syntax is a little strange and depends on the javac you are using.
- On javac7, to use any of the 3 onX features, you must wrap the annotations to be applied to the constructor / method / parameter in @__(@AnnotationGoesHere). To apply multiple annotations, use @__({@Annotation1, @Annotation2}). The annotations can themselves obviously have parameters as well.
- On javac8 and up, you add an underscore after onMethod, onParam, or onConstructor. -

-
-
-
-

With Lombok

-
@HTML_PRE@
-
-
-
-

Vanilla Java

-
@HTML_POST@
-
-
-
-
-

Small print

-

- The reason of the weird syntax is to make this feature work in javac 7 compilers; the @__ type is an annotation reference to the annotation type __ (double underscore) which doesn't actually exist; this makes javac 7 delay aborting the compilation process due to an error because it is possible an annotation processor will later create the __ type. Instead, lombok applies the annotations and removes the references so that the error will never actually occur. The point is: The __ type must not exist, otherwise the feature does not work. In the rare case that the __ type does exist (and is imported or in the package), you can simply add more underscores. Technically any non-existent type would work, but to maintain consistency and readability and catch erroneous use, lombok considers it an error if the 'wrapper' annotation is anything but a series of underscores. -

- In javac8, the above feature should work but due to a bug in javac8 it does not. However, starting in javac8, if the parameter name does not exist in the annotation type, compilation proceeds to a phase where lombok can fix it. -

- To reiterate: This feature can disappear at any time; if you use this feature, be prepared to adjust your code when we find a nicer way of implementing this feature, or, if a future version of javac forces us to remove this feature entirely with no alternative. -

- The onX parameter is not legal on any type-wide variant. For example, a @Getter annotation on a class does not support onMethod. -

-
-
-
- Back to experimental features | Previous feature (@Wither) | Next feature (@UtilityClass)
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
-
-
- - - diff --git a/website-old/features/experimental/var.html b/website-old/features/experimental/var.html deleted file mode 100644 index dde9c35e..00000000 --- a/website-old/features/experimental/var.html +++ /dev/null @@ -1,83 +0,0 @@ - - - - - - - - EXPERIMENTAL – @var -
-
-
-
Project Lombok
-

@var

-
Modifiable local variables with a type inferred by assigning value.
-
-

Since

-

- @var was introduced as experimental feature in lombok v1.16.12. -

-
-
-

Experimental

-

- Experimental because: -

    -
  • This feature is very controversial.
    • -
  • There is JEP 286 that should make the @var obsolete.
    • -
Current status: uncertain - Currently we feel this feature cannot move out of experimental status. -
-
-

Overview

-

- The @var has the same mission as the @val annotation but modifable. -

-
-
-
-

With Lombok

-
@HTML_PRE@
-
-
-
-

Vanilla Java

-
@HTML_POST@
-
-
-
-
-

Supported configuration keys:

-
-
lombok.val.flagUsage = [allow] (default: not set)
-
Lombok will flag any usage of var as an error if not configured.
-
-
-
-

Small print

-

- For compound types, the most common superclass is inferred, not any shared interfaces. For example, bool ? new HashSet() : new ArrayList() - is an expression with a compound type: The result is both AbstractCollection as well as Serializable. The type inferred will be - AbstractCollection, as that is a class, whereas Serializable is an interface. -

- In ambiguous cases, java.lang.Object is inferred. -

-
-
-
- Back to experimental features | Previous feature | Next feature (@Accessors)
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
-
-
- - - diff --git a/website-old/features/features.css b/website-old/features/features.css deleted file mode 100644 index 58897ccd..00000000 --- a/website-old/features/features.css +++ /dev/null @@ -1,179 +0,0 @@ -.confType { - font-weight: bold; -} - -body { - font-family: Verdana; - background-image: url(gradient.png); - background-repeat: repeat-x; - background-attachment: fixed; -} - -#pepper { - background-image: url(lombok-background.png); - background-repeat: no-repeat; - background-attachment: fixed; - background-position: 50px 20px; -} - -* html #pepper { - background: none; -} - -.meat { - padding: 0px 48px; -} - -.meat .header { - position: absolute; - top: 10px; - left: 30px; -} - -.minimumHeight { - height: 700px; - width: 1px; - float: right; -} - -* html .minimumHeight { - height: 0px; -} - -h1 { - padding: 8px 0 10px 0; - font-size: 20px; - width: 100%; - text-align: center; -} - -.byline { - width: 100%; - text-align: center; - font-style: italic; - font-size: 1.3em; -} - -.index { - font-size: 1.2em; - margin: 48px 0px 32px 64px; -} - -.index dt { - margin-top: 8px; - font-size: 1.2em; -} - -.index dd { - margin-left: 32px; -} - -dt { - margin-top: 4px; - font-size: 1.2em; -} - -dd { - margin-left: 16px; -} - -.overview code { - font-size: 1.1em; - white-space: nowrap; -} - -.smallprint { - font-size: 0.8em; - color: #444; -} - -.smallprint code { - font-size: 1em; - white-space: nowrap; -} - -.snippets, .singleColumnSnippets { - margin-top: 0px; -} - -.snippets .pre { - float: left; - width: 45%; -} - -.snippet { - overflow: auto; - padding: 4px; - border: 1px dotted #888; -} - -.snippet font { - white-space: pre; -} - -.snippets .sep { - display: block; - width: 5%; - height: 1px; - float: left; -} - -.snippets .post { - float: left; - width: 45%; -} - -.snippets .end { - clear: both; -} - -.snippet code { - font-size: 14px; -} - -.snippet.example { - margin: 8px 16px 8px 16px; -} - -.footer { - clear: left; - margin: 0 auto 0 auto; - padding: 16px 0 16px 0; - display: block; - text-align: center; -} - -.footer .disabled { - color: #aaa; -} - -.footer .copyright { - color: #555; - font-size: 11px; - font-style: italic; -} - -.creditsLink { - font-style: normal; - font-weight: bold; -} - -code a { - color: black; - text-decoration: none; -} - -code a:hover { - color: black; - text-decoration: underline; -} - -code .keyword { - color: #7f0055; - font-weight: bold; -} - -code .staticfield { - color: #2a00ff; - font-style: italic; -} \ No newline at end of file diff --git a/website-old/features/gradient.png b/website-old/features/gradient.png deleted file mode 100644 index 3ffcde2c..00000000 Binary files a/website-old/features/gradient.png and /dev/null differ diff --git a/website-old/features/index.html b/website-old/features/index.html deleted file mode 100644 index bfa33217..00000000 --- a/website-old/features/index.html +++ /dev/null @@ -1,90 +0,0 @@ - - - - - - - - Lombok feature overview -
-
-
-
Project Lombok
-

Lombok features

-
-
-
val
-
Finally! Hassle-free final local variables.
-
@NonNull
-
or: How I learned to stop worrying and love the NullPointerException.
-
@Cleanup
-
Automatic resource management: Call your close() methods safely with no hassle.
-
@Getter / @Setter
-
Never write public int getFoo() {return foo;} again.
-
@ToString
-
No need to start a debugger to see your fields: Just let lombok generate a toString for you!
-
@EqualsAndHashCode
-
Equality made easy: Generates hashCode and equals implementations from the fields of your object.
-
@NoArgsConstructor, @RequiredArgsConstructor and @AllArgsConstructor
-
Constructors made to order: Generates constructors that take no arguments, one argument per final / non-null field, or one argument for every field.
-
@Data
-
All together now: A shortcut for @ToString, @EqualsAndHashCode, - @Getter on all fields, and @Setter on all non-final fields, and @RequiredArgsConstructor!
-
@Value
-
Immutable classes made very easy.
-
@Builder
-
... and Bob's your uncle: No-hassle fancy-pants APIs for object creation!
-
@SneakyThrows
-
To boldly throw checked exceptions where no one has thrown them before!
-
@Synchronized
-
synchronized done right: Don't expose your locks.
-
@Getter(lazy=true)
-
Laziness is a virtue!
-
@Log
-
Captain's Log, stardate 24435.7: "What was that line again?"
-
Configuration system
-
Lombok, made to order: Configure lombok features in one place for your entire project or even your workspace.
-
Experimental features
-
Here be dragons: Extra features which aren't quite ready for prime time yet.
-
-
-
- If you'd rather read a longer tutorial, here is a great tutorial (including a walkthrough through some of the above features) written by Michael Kimberlin. -
-
- The documentation above is a lot easier to follow, but if you want to build your own transformations, - or you want to add javadoc to lombok.jar in your IDE, you can also check out the javadoc. -
-

Running Lombok

-

On eclipse

- Execute lombok.jar (doubleclick it, or run java -jar lombok.jar). Follow instructions. -

On javac (and maven, ant, and other build tools)

- Include lombok.jar on the classpath as you compile. That's all there is to it!
- Lombok hosts its own maven repository, so adding lombok to maven is very simple. full instructions are here. -

On GWT (Google Widget Toolkit)

- See gwt setup. -

On javadoc, and other source-based tools

- Use delombok first, then run javadoc or GWT on the delombok-ed code. -

Running delombok

-
Delombok copies your source files to another directory, replacing all lombok annotations with their desugared form. So, it'll turn @Getter - back into the actual getter. It then removes the annotation. This is useful for all sorts of reasons; you can check out what's happening under the hood, - if the unthinkable happens and you want to stop using lombok, you can easily remove all traces of it in your source, and you can use delombok to preprocess - your source files for source-level tools such as javadoc and GWT. More information about how to run delombok, including instructions for build tools - can be found at the delombok page.
-
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
-
-
- - - diff --git a/website-old/features/lombok-background.png b/website-old/features/lombok-background.png deleted file mode 100644 index aac3195a..00000000 Binary files a/website-old/features/lombok-background.png and /dev/null differ diff --git a/website-old/features/val.html b/website-old/features/val.html deleted file mode 100644 index 82c96b39..00000000 --- a/website-old/features/val.html +++ /dev/null @@ -1,76 +0,0 @@ - - - - - - - - val -
-
-
-
Project Lombok
-

val

-
Finally! Hassle-free final local variables.
-
-

Overview

-

- NEW in Lombok 0.10: You can use val as the type of a local variable declaration instead of actually writing the type. When you do this, - the type will be inferred from the initializer expression. The local variable will also be made final. This feature works - on local variables and on foreach loops only, not on fields. The initializer expression is required. -

- val is actually a 'type' of sorts, and exists as a real class in the lombok package. You must import it for val to work (or use lombok.val as the type). - The existence of this type on a local variable declaration triggers both the adding of the final keyword as well as copying the type of the initializing expression which overwrites - the 'fake' val type. -

- WARNING: This feature does not currently work in NetBeans. We're working on fixing that. -

-
-
-
-

With Lombok

-
@HTML_PRE@
-
-
-
-

Vanilla Java

-
@HTML_POST@
-
-
-
-
-

Supported configuration keys:

-
-
lombok.val.flagUsage = [warning | error] (default: not set)
-
Lombok will flag any usage of val as a warning or error if configured.
-
-
-
-

Small print

-

- For compound types, the most common superclass is inferred, not any shared interfaces. For example, bool ? new HashSet() : new ArrayList() - is an expression with a compound type: The result is both AbstractCollection as well as Serializable. The type inferred will be - AbstractCollection, as that is a class, whereas Serializable is an interface. -

- In ambiguous cases, such as when the initializer expression is null, java.lang.Object is inferred. -

-
-
-
- Back to features | Previous feature | Next feature (@NonNull)
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
-
-
- - - diff --git a/website-old/icon_brush_unused.png b/website-old/icon_brush_unused.png deleted file mode 100644 index 7ebf2f06..00000000 Binary files a/website-old/icon_brush_unused.png and /dev/null differ diff --git a/website-old/icon_bugs.png b/website-old/icon_bugs.png deleted file mode 100644 index 713b6fe8..00000000 Binary files a/website-old/icon_bugs.png and /dev/null differ diff --git a/website-old/icon_contribute.png b/website-old/icon_contribute.png deleted file mode 100644 index a7f630a5..00000000 Binary files a/website-old/icon_contribute.png and /dev/null differ diff --git a/website-old/icon_discussion.png b/website-old/icon_discussion.png deleted file mode 100644 index d1e3fd5e..00000000 Binary files a/website-old/icon_discussion.png and /dev/null differ diff --git a/website-old/icon_download.png b/website-old/icon_download.png deleted file mode 100644 index bfe07288..00000000 Binary files a/website-old/icon_download.png and /dev/null differ diff --git a/website-old/icon_overview.png b/website-old/icon_overview.png deleted file mode 100644 index 806b4421..00000000 Binary files a/website-old/icon_overview.png and /dev/null differ diff --git a/website-old/index.css b/website-old/index.css deleted file mode 100644 index eeb330ce..00000000 --- a/website-old/index.css +++ /dev/null @@ -1,182 +0,0 @@ -img,div,a,input,button,.pngfix { - behavior: url(logi/iepngfix.htc); -} - -body { - font-family: Verdana; -} - -.meat { - width: 800px; - margin: 0 auto 0 auto; -} - -h1 { - padding: 8px 0 10px 0; - font-size: 20px; - width: 100%; - text-align: center; -} - -#buttonBar a.button, a.downloadLink { - text-decoration: none; - color: black; -} - -#buttonBar a.button:hover, a.downloadLink:hover { - text-decoration: underline; - color: blue; -} - -.buttonBar { - -webkit-border-top-right-radius: 15px 15px; - -webkit-border-top-left-radius: 15px 15px; - -moz-border-radius-topright: 15px; - -moz-border-radius-topleft: 15px; - border-top-right-radius: 15px 15px; - border-top-left-radius: 15px 15px; - background-image: url(buttonbar.jpg); - width: 800px; - height: 170px; -} - -.separator { - background-image: url(buttonbar.jpg); - width: 800px; - height: 8px; - line-height: 8px; - font-size: 14px; - text-align: center; - clear: both; -} - -.endBar { - -webkit-border-bottom-right-radius: 15px 15px; - -webkit-border-bottom-left-radius: 15px 15px; - -moz-border-radius-bottomright: 15px; - -moz-border-radius-bottomleft: 15px; - border-bottom-right-radius: 15px 15px; - border-bottom-left-radius: 15px 15px; - background-image: url(buttonbar.jpg); - width: 800px; - height: 30px; - line-height: 30px; - font-size: 14px; - text-align: center; - clear: both; -} - -.button { - margin: 30px 16px auto 16px; - float: left; - width: 80px; - height: 100px; -} - -.button:first-child { - margin-left: 64px; -} - -.button img { - padding: 0 8px 0 8px; - display: block; -} - -.button span { - display: block; - width: 80px; - text-align: center; - font-size: 14px; -} - -.downloadContainer { - float: left; - margin: 34px 8px 57px 40px; -} - -code { - font-weight: bold; -} - -.attribution { - font-size: 0.6em; -} - -.downloadLink { - background-image: url(downloadButton.png); - display: block; - line-height: 56px; - width: 225px; - height: 56px; -} - -.downloadLink img { - margin: 4px 20px 4px 16px; - float: left; - width: 48px; -} - -.downloadLink span { - display: block; - font-size: 16px; - font-weight: bold; -} - -.versionInfo { - font-size: 12px; - margin-top: 4px; - font-weight: normal; - width: 100%; - text-align: center; -} - -#downloadInfo { - font-size: 14px; -} - -#downloadInfo p { - padding: 8px; -} - -.downloadActions { - margin-top: 8px; - margin-left: 32px; -} - -.note { - color: grey; -} - -.footer { - margin-top: 8px; - display: block; - color: #555; - font-style: italic; - font-size: 11px; - width: 100%; - text-align: center; -} - -.creditsLink { - font-style: normal; - font-weight: bold; -} - -.downloadHelp { - margin: 32px 16px 32px 0px; -} - -.downloadHelp .platform { - font-size: 1.2em; - font-weight: bold; - padding-right: 32px; -} - -.stableLink { - font-size: 1.5em; - margin-bottom: 16px; -} - -.edgeLink { - margin-bottom: 16px; -} diff --git a/website-old/index.html b/website-old/index.html deleted file mode 100644 index bc89941c..00000000 --- a/website-old/index.html +++ /dev/null @@ -1,96 +0,0 @@ - - - - - - - - - - Project Lombok - - - - - Fork me on GitHub -
-

Project Lombok

- -
- -
-
- I can't see the video | Show me a text and images based explanation and tutorial instead! -
-
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
- - - diff --git a/website-old/logi/iepngfix.htc b/website-old/logi/iepngfix.htc deleted file mode 100755 index bbfb23c5..00000000 --- a/website-old/logi/iepngfix.htc +++ /dev/null @@ -1,187 +0,0 @@ - - - diff --git a/website-old/logi/iepngfix_tilebg.js b/website-old/logi/iepngfix_tilebg.js deleted file mode 100755 index 48795631..00000000 --- a/website-old/logi/iepngfix_tilebg.js +++ /dev/null @@ -1,178 +0,0 @@ -// IE5.5+ PNG Alpha Fix v2.0 Alpha: Background Tiling Support -// (c) 2008 Angus Turnbull http://www.twinhelix.com - -// This is licensed under the GNU LGPL, version 2.1 or later. -// For details, see: http://creativecommons.org/licenses/LGPL/2.1/ - -var IEPNGFix = window.IEPNGFix || {}; - -IEPNGFix.tileBG = function(elm, pngSrc, ready) { - // Params: A reference to a DOM element, the PNG src file pathname, and a - // hidden "ready-to-run" passed when called back after image preloading. - - var data; - try { - data = this.data[elm.uniqueID], - elmW = Math.max(elm.clientWidth, elm.scrollWidth), - elmH = Math.max(elm.clientHeight, elm.scrollHeight), - bgX = elm.currentStyle.backgroundPositionX, - bgY = elm.currentStyle.backgroundPositionY, - bgR = elm.currentStyle.backgroundRepeat; - } catch ( e ) { - return; - } - - // Cache of DIVs created per element, and image preloader/data. - if (!data.tiles) { - data.tiles = { - elm: elm, - src: '', - cache: [], - img: new Image(), - old: {} - }; - } - var tiles = data.tiles, - pngW = tiles.img.width, - pngH = tiles.img.height; - - if (pngSrc) { - if (!ready && pngSrc != tiles.src) { - // New image? Preload it with a callback to detect dimensions. - tiles.img.onload = function() { - this.onload = null; - IEPNGFix.tileBG(elm, pngSrc, 1); - }; - return tiles.img.src = pngSrc; - } - } else { - // No image? - if (tiles.src) ready = 1; - pngW = pngH = 0; - } - tiles.src = pngSrc; - - if (!ready && elmW == tiles.old.w && elmH == tiles.old.h && - bgX == tiles.old.x && bgY == tiles.old.y && bgR == tiles.old.r) { - return; - } - - // Convert English and percentage positions to pixels. - var pos = { - top: '0%', - left: '0%', - center: '50%', - bottom: '100%', - right: '100%' - }, - x, - y, - pc; - x = pos[bgX] || bgX; - y = pos[bgY] || bgY; - if (pc = x.match(/(\d+)%/)) { - x = Math.round((elmW - pngW) * (parseInt(pc[1]) / 100)); - } - if (pc = y.match(/(\d+)%/)) { - y = Math.round((elmH - pngH) * (parseInt(pc[1]) / 100)); - } - x = parseInt(x); - y = parseInt(y); - - // Handle backgroundRepeat. - var repeatX = { 'repeat': 1, 'repeat-x': 1 }[bgR], - repeatY = { 'repeat': 1, 'repeat-y': 1 }[bgR]; - if (repeatX) { - x %= pngW; - if (x > 0) x -= pngW; - } - if (repeatY) { - y %= pngH; - if (y > 0) y -= pngH; - } - - // Go! - this.hook.enabled = 0; - if (!({ relative: 1, absolute: 1 }[elm.currentStyle.position])) { - elm.style.position = 'relative'; - } - var count = 0, - xPos, - maxX = repeatX ? elmW : x + 0.1, - yPos, - maxY = repeatY ? elmH : y + 0.1, - d, - s, - isNew; - if (pngW && pngH) { - for (xPos = x; xPos < maxX; xPos += pngW) { - for (yPos = y; yPos < maxY; yPos += pngH) { - isNew = 0; - if (!tiles.cache[count]) { - tiles.cache[count] = document.createElement('div'); - isNew = 1; - } - var clipR = (xPos + pngW > elmW ? elmW - xPos : pngW), - clipB = (yPos + pngH > elmH ? elmH - yPos : pngH); - d = tiles.cache[count]; - s = d.style; - s.behavior = 'none'; - s.left = xPos + 'px'; - s.top = yPos + 'px'; - s.width = clipR + 'px'; - s.height = clipB + 'px'; - s.clip = 'rect(' + - (yPos < 0 ? 0 - yPos : 0) + 'px,' + - clipR + 'px,' + - clipB + 'px,' + - (xPos < 0 ? 0 - xPos : 0) + 'px)'; - s.display = 'block'; - if (isNew) { - s.position = 'absolute'; - s.zIndex = -999; - if (elm.firstChild) { - elm.insertBefore(d, elm.firstChild); - } else { - elm.appendChild(d); - } - } - this.fix(d, pngSrc, 0); - count++; - } - } - } - while (count < tiles.cache.length) { - this.fix(tiles.cache[count], '', 0); - tiles.cache[count++].style.display = 'none'; - } - - this.hook.enabled = 1; - - // Cache so updates are infrequent. - tiles.old = { - w: elmW, - h: elmH, - x: bgX, - y: bgY, - r: bgR - }; -}; - - -IEPNGFix.update = function() { - // Update all PNG backgrounds. - for (var i in IEPNGFix.data) { - var t = IEPNGFix.data[i].tiles; - if (t && t.elm && t.src) { - IEPNGFix.tileBG(t.elm, t.src); - } - } -}; -IEPNGFix.update.timer = 0; - -if (window.attachEvent && !window.opera) { - window.attachEvent('onresize', function() { - clearTimeout(IEPNGFix.update.timer); - IEPNGFix.update.timer = setTimeout(IEPNGFix.update, 100); - }); -} diff --git a/website-old/logi/jQuery-all.js b/website-old/logi/jQuery-all.js deleted file mode 100644 index 9f8ffce7..00000000 --- a/website-old/logi/jQuery-all.js +++ /dev/null @@ -1,143 +0,0 @@ -/* - * jQuery JavaScript Library v1.3.2 - * http://jquery.com/ - * - * Copyright (c) 2009 John Resig - * Dual licensed under the MIT and GPL licenses. - * http://docs.jquery.com/License - * - * Date: 2009-02-19 17:34:21 -0500 (Thu, 19 Feb 2009) - * Revision: 6246 - */ -(function(){var l=this,g,y=l.jQuery,p=l.$,o=l.jQuery=l.$=function(E,F){return new o.fn.init(E,F)},D=/^[^<]*(<(.|\s)+>)[^>]*$|^#([\w-]+)$/,f=/^.[^:#\[\.,]*$/;o.fn=o.prototype={init:function(E,H){E=E||document;if(E.nodeType){this[0]=E;this.length=1;this.context=E;return this}if(typeof E==="string"){var G=D.exec(E);if(G&&(G[1]||!H)){if(G[1]){E=o.clean([G[1]],H)}else{var I=document.getElementById(G[3]);if(I&&I.id!=G[3]){return o().find(E)}var F=o(I||[]);F.context=document;F.selector=E;return F}}else{return o(H).find(E)}}else{if(o.isFunction(E)){return o(document).ready(E)}}if(E.selector&&E.context){this.selector=E.selector;this.context=E.context}return this.setArray(o.isArray(E)?E:o.makeArray(E))},selector:"",jquery:"1.3.2",size:function(){return this.length},get:function(E){return E===g?Array.prototype.slice.call(this):this[E]},pushStack:function(F,H,E){var G=o(F);G.prevObject=this;G.context=this.context;if(H==="find"){G.selector=this.selector+(this.selector?" ":"")+E}else{if(H){G.selector=this.selector+"."+H+"("+E+")"}}return G},setArray:function(E){this.length=0;Array.prototype.push.apply(this,E);return this},each:function(F,E){return o.each(this,F,E)},index:function(E){return o.inArray(E&&E.jquery?E[0]:E,this)},attr:function(F,H,G){var E=F;if(typeof F==="string"){if(H===g){return this[0]&&o[G||"attr"](this[0],F)}else{E={};E[F]=H}}return this.each(function(I){for(F in E){o.attr(G?this.style:this,F,o.prop(this,E[F],G,I,F))}})},css:function(E,F){if((E=="width"||E=="height")&&parseFloat(F)<0){F=g}return this.attr(E,F,"curCSS")},text:function(F){if(typeof F!=="object"&&F!=null){return this.empty().append((this[0]&&this[0].ownerDocument||document).createTextNode(F))}var E="";o.each(F||this,function(){o.each(this.childNodes,function(){if(this.nodeType!=8){E+=this.nodeType!=1?this.nodeValue:o.fn.text([this])}})});return E},wrapAll:function(E){if(this[0]){var F=o(E,this[0].ownerDocument).clone();if(this[0].parentNode){F.insertBefore(this[0])}F.map(function(){var G=this;while(G.firstChild){G=G.firstChild}return G}).append(this)}return this},wrapInner:function(E){return this.each(function(){o(this).contents().wrapAll(E)})},wrap:function(E){return this.each(function(){o(this).wrapAll(E)})},append:function(){return this.domManip(arguments,true,function(E){if(this.nodeType==1){this.appendChild(E)}})},prepend:function(){return this.domManip(arguments,true,function(E){if(this.nodeType==1){this.insertBefore(E,this.firstChild)}})},before:function(){return this.domManip(arguments,false,function(E){this.parentNode.insertBefore(E,this)})},after:function(){return this.domManip(arguments,false,function(E){this.parentNode.insertBefore(E,this.nextSibling)})},end:function(){return this.prevObject||o([])},push:[].push,sort:[].sort,splice:[].splice,find:function(E){if(this.length===1){var F=this.pushStack([],"find",E);F.length=0;o.find(E,this[0],F);return F}else{return this.pushStack(o.unique(o.map(this,function(G){return o.find(E,G)})),"find",E)}},clone:function(G){var E=this.map(function(){if(!o.support.noCloneEvent&&!o.isXMLDoc(this)){var I=this.outerHTML;if(!I){var J=this.ownerDocument.createElement("div");J.appendChild(this.cloneNode(true));I=J.innerHTML}return o.clean([I.replace(/ jQuery\d+="(?:\d+|null)"/g,"").replace(/^\s*/,"")])[0]}else{return this.cloneNode(true)}});if(G===true){var H=this.find("*").andSelf(),F=0;E.find("*").andSelf().each(function(){if(this.nodeName!==H[F].nodeName){return}var I=o.data(H[F],"events");for(var K in I){for(var J in I[K]){o.event.add(this,K,I[K][J],I[K][J].data)}}F++})}return E},filter:function(E){return this.pushStack(o.isFunction(E)&&o.grep(this,function(G,F){return E.call(G,F)})||o.multiFilter(E,o.grep(this,function(F){return F.nodeType===1})),"filter",E)},closest:function(E){var G=o.expr.match.POS.test(E)?o(E):null,F=0;return this.map(function(){var H=this;while(H&&H.ownerDocument){if(G?G.index(H)>-1:o(H).is(E)){o.data(H,"closest",F);return H}H=H.parentNode;F++}})},not:function(E){if(typeof E==="string"){if(f.test(E)){return this.pushStack(o.multiFilter(E,this,true),"not",E)}else{E=o.multiFilter(E,this)}}var F=E.length&&E[E.length-1]!==g&&!E.nodeType;return this.filter(function(){return F?o.inArray(this,E)<0:this!=E})},add:function(E){return this.pushStack(o.unique(o.merge(this.get(),typeof E==="string"?o(E):o.makeArray(E))))},is:function(E){return !!E&&o.multiFilter(E,this).length>0},hasClass:function(E){return !!E&&this.is("."+E)},val:function(K){if(K===g){var E=this[0];if(E){if(o.nodeName(E,"option")){return(E.attributes.value||{}).specified?E.value:E.text}if(o.nodeName(E,"select")){var I=E.selectedIndex,L=[],M=E.options,H=E.type=="select-one";if(I<0){return null}for(var F=H?I:0,J=H?I+1:M.length;F=0||o.inArray(this.name,K)>=0)}else{if(o.nodeName(this,"select")){var N=o.makeArray(K);o("option",this).each(function(){this.selected=(o.inArray(this.value,N)>=0||o.inArray(this.text,N)>=0)});if(!N.length){this.selectedIndex=-1}}else{this.value=K}}})},html:function(E){return E===g?(this[0]?this[0].innerHTML.replace(/ jQuery\d+="(?:\d+|null)"/g,""):null):this.empty().append(E)},replaceWith:function(E){return this.after(E).remove()},eq:function(E){return this.slice(E,+E+1)},slice:function(){return this.pushStack(Array.prototype.slice.apply(this,arguments),"slice",Array.prototype.slice.call(arguments).join(","))},map:function(E){return this.pushStack(o.map(this,function(G,F){return E.call(G,F,G)}))},andSelf:function(){return this.add(this.prevObject)},domManip:function(J,M,L){if(this[0]){var I=(this[0].ownerDocument||this[0]).createDocumentFragment(),F=o.clean(J,(this[0].ownerDocument||this[0]),I),H=I.firstChild;if(H){for(var G=0,E=this.length;G1||G>0?I.cloneNode(true):I)}}if(F){o.each(F,z)}}return this;function K(N,O){return M&&o.nodeName(N,"table")&&o.nodeName(O,"tr")?(N.getElementsByTagName("tbody")[0]||N.appendChild(N.ownerDocument.createElement("tbody"))):N}}};o.fn.init.prototype=o.fn;function z(E,F){if(F.src){o.ajax({url:F.src,async:false,dataType:"script"})}else{o.globalEval(F.text||F.textContent||F.innerHTML||"")}if(F.parentNode){F.parentNode.removeChild(F)}}function e(){return +new Date}o.extend=o.fn.extend=function(){var J=arguments[0]||{},H=1,I=arguments.length,E=false,G;if(typeof J==="boolean"){E=J;J=arguments[1]||{};H=2}if(typeof J!=="object"&&!o.isFunction(J)){J={}}if(I==H){J=this;--H}for(;H-1}},swap:function(H,G,I){var E={};for(var F in G){E[F]=H.style[F];H.style[F]=G[F]}I.call(H);for(var F in G){H.style[F]=E[F]}},css:function(H,F,J,E){if(F=="width"||F=="height"){var L,G={position:"absolute",visibility:"hidden",display:"block"},K=F=="width"?["Left","Right"]:["Top","Bottom"];function I(){L=F=="width"?H.offsetWidth:H.offsetHeight;if(E==="border"){return}o.each(K,function(){if(!E){L-=parseFloat(o.curCSS(H,"padding"+this,true))||0}if(E==="margin"){L+=parseFloat(o.curCSS(H,"margin"+this,true))||0}else{L-=parseFloat(o.curCSS(H,"border"+this+"Width",true))||0}})}if(H.offsetWidth!==0){I()}else{o.swap(H,G,I)}return Math.max(0,Math.round(L))}return o.curCSS(H,F,J)},curCSS:function(I,F,G){var L,E=I.style;if(F=="opacity"&&!o.support.opacity){L=o.attr(E,"opacity");return L==""?"1":L}if(F.match(/float/i)){F=w}if(!G&&E&&E[F]){L=E[F]}else{if(q.getComputedStyle){if(F.match(/float/i)){F="float"}F=F.replace(/([A-Z])/g,"-$1").toLowerCase();var M=q.getComputedStyle(I,null);if(M){L=M.getPropertyValue(F)}if(F=="opacity"&&L==""){L="1"}}else{if(I.currentStyle){var J=F.replace(/\-(\w)/g,function(N,O){return O.toUpperCase()});L=I.currentStyle[F]||I.currentStyle[J];if(!/^\d+(px)?$/i.test(L)&&/^\d/.test(L)){var H=E.left,K=I.runtimeStyle.left;I.runtimeStyle.left=I.currentStyle.left;E.left=L||0;L=E.pixelLeft+"px";E.left=H;I.runtimeStyle.left=K}}}}return L},clean:function(F,K,I){K=K||document;if(typeof K.createElement==="undefined"){K=K.ownerDocument||K[0]&&K[0].ownerDocument||document}if(!I&&F.length===1&&typeof F[0]==="string"){var H=/^<(\w+)\s*\/?>$/.exec(F[0]);if(H){return[K.createElement(H[1])]}}var G=[],E=[],L=K.createElement("div");o.each(F,function(P,S){if(typeof S==="number"){S+=""}if(!S){return}if(typeof S==="string"){S=S.replace(/(<(\w+)[^>]*?)\/>/g,function(U,V,T){return T.match(/^(abbr|br|col|img|input|link|meta|param|hr|area|embed)$/i)?U:V+">"});var O=S.replace(/^\s+/,"").substring(0,10).toLowerCase();var Q=!O.indexOf("",""]||!O.indexOf("",""]||O.match(/^<(thead|tbody|tfoot|colg|cap)/)&&[1,"","
"]||!O.indexOf("",""]||(!O.indexOf("",""]||!O.indexOf("",""]||!o.support.htmlSerialize&&[1,"div
","
"]||[0,"",""];L.innerHTML=Q[1]+S+Q[2];while(Q[0]--){L=L.lastChild}if(!o.support.tbody){var R=/"&&!R?L.childNodes:[];for(var M=N.length-1;M>=0;--M){if(o.nodeName(N[M],"tbody")&&!N[M].childNodes.length){N[M].parentNode.removeChild(N[M])}}}if(!o.support.leadingWhitespace&&/^\s/.test(S)){L.insertBefore(K.createTextNode(S.match(/^\s*/)[0]),L.firstChild)}S=o.makeArray(L.childNodes)}if(S.nodeType){G.push(S)}else{G=o.merge(G,S)}});if(I){for(var J=0;G[J];J++){if(o.nodeName(G[J],"script")&&(!G[J].type||G[J].type.toLowerCase()==="text/javascript")){E.push(G[J].parentNode?G[J].parentNode.removeChild(G[J]):G[J])}else{if(G[J].nodeType===1){G.splice.apply(G,[J+1,0].concat(o.makeArray(G[J].getElementsByTagName("script"))))}I.appendChild(G[J])}}return E}return G},attr:function(J,G,K){if(!J||J.nodeType==3||J.nodeType==8){return g}var H=!o.isXMLDoc(J),L=K!==g;G=H&&o.props[G]||G;if(J.tagName){var F=/href|src|style/.test(G);if(G=="selected"&&J.parentNode){J.parentNode.selectedIndex}if(G in J&&H&&!F){if(L){if(G=="type"&&o.nodeName(J,"input")&&J.parentNode){throw"type property can't be changed"}J[G]=K}if(o.nodeName(J,"form")&&J.getAttributeNode(G)){return J.getAttributeNode(G).nodeValue}if(G=="tabIndex"){var I=J.getAttributeNode("tabIndex");return I&&I.specified?I.value:J.nodeName.match(/(button|input|object|select|textarea)/i)?0:J.nodeName.match(/^(a|area)$/i)&&J.href?0:g}return J[G]}if(!o.support.style&&H&&G=="style"){return o.attr(J.style,"cssText",K)}if(L){J.setAttribute(G,""+K)}var E=!o.support.hrefNormalized&&H&&F?J.getAttribute(G,2):J.getAttribute(G);return E===null?g:E}if(!o.support.opacity&&G=="opacity"){if(L){J.zoom=1;J.filter=(J.filter||"").replace(/alpha\([^)]*\)/,"")+(parseInt(K)+""=="NaN"?"":"alpha(opacity="+K*100+")")}return J.filter&&J.filter.indexOf("opacity=")>=0?(parseFloat(J.filter.match(/opacity=([^)]*)/)[1])/100)+"":""}G=G.replace(/-([a-z])/ig,function(M,N){return N.toUpperCase()});if(L){J[G]=K}return J[G]},trim:function(E){return(E||"").replace(/^\s+|\s+$/g,"")},makeArray:function(G){var E=[];if(G!=null){var F=G.length;if(F==null||typeof G==="string"||o.isFunction(G)||G.setInterval){E[0]=G}else{while(F){E[--F]=G[F]}}}return E},inArray:function(G,H){for(var E=0,F=H.length;E0?this.clone(true):this).get();o.fn[F].apply(o(L[K]),I);J=J.concat(I)}return this.pushStack(J,E,G)}});o.each({removeAttr:function(E){o.attr(this,E,"");if(this.nodeType==1){this.removeAttribute(E)}},addClass:function(E){o.className.add(this,E)},removeClass:function(E){o.className.remove(this,E)},toggleClass:function(F,E){if(typeof E!=="boolean"){E=!o.className.has(this,F)}o.className[E?"add":"remove"](this,F)},remove:function(E){if(!E||o.filter(E,[this]).length){o("*",this).add([this]).each(function(){o.event.remove(this);o.removeData(this)});if(this.parentNode){this.parentNode.removeChild(this)}}},empty:function(){o(this).children().remove();while(this.firstChild){this.removeChild(this.firstChild)}}},function(E,F){o.fn[E]=function(){return this.each(F,arguments)}});function j(E,F){return E[0]&&parseInt(o.curCSS(E[0],F,true),10)||0}var h="jQuery"+e(),v=0,A={};o.extend({cache:{},data:function(F,E,G){F=F==l?A:F;var H=F[h];if(!H){H=F[h]=++v}if(E&&!o.cache[H]){o.cache[H]={}}if(G!==g){o.cache[H][E]=G}return E?o.cache[H][E]:H},removeData:function(F,E){F=F==l?A:F;var H=F[h];if(E){if(o.cache[H]){delete o.cache[H][E];E="";for(E in o.cache[H]){break}if(!E){o.removeData(F)}}}else{try{delete F[h]}catch(G){if(F.removeAttribute){F.removeAttribute(h)}}delete o.cache[H]}},queue:function(F,E,H){if(F){E=(E||"fx")+"queue";var G=o.data(F,E);if(!G||o.isArray(H)){G=o.data(F,E,o.makeArray(H))}else{if(H){G.push(H)}}}return G},dequeue:function(H,G){var E=o.queue(H,G),F=E.shift();if(!G||G==="fx"){F=E[0]}if(F!==g){F.call(H)}}});o.fn.extend({data:function(E,G){var H=E.split(".");H[1]=H[1]?"."+H[1]:"";if(G===g){var F=this.triggerHandler("getData"+H[1]+"!",[H[0]]);if(F===g&&this.length){F=o.data(this[0],E)}return F===g&&H[1]?this.data(H[0]):F}else{return this.trigger("setData"+H[1]+"!",[H[0],G]).each(function(){o.data(this,E,G)})}},removeData:function(E){return this.each(function(){o.removeData(this,E)})},queue:function(E,F){if(typeof E!=="string"){F=E;E="fx"}if(F===g){return o.queue(this[0],E)}return this.each(function(){var G=o.queue(this,E,F);if(E=="fx"&&G.length==1){G[0].call(this)}})},dequeue:function(E){return this.each(function(){o.dequeue(this,E)})}}); -/* - * Sizzle CSS Selector Engine - v0.9.3 - * Copyright 2009, The Dojo Foundation - * Released under the MIT, BSD, and GPL Licenses. - * More information: http://sizzlejs.com/ - */ -(function(){var R=/((?:\((?:\([^()]+\)|[^()]+)+\)|\[(?:\[[^[\]]*\]|['"][^'"]*['"]|[^[\]'"]+)+\]|\\.|[^ >+~,(\[\\]+)+|[>+~])(\s*,\s*)?/g,L=0,H=Object.prototype.toString;var F=function(Y,U,ab,ac){ab=ab||[];U=U||document;if(U.nodeType!==1&&U.nodeType!==9){return[]}if(!Y||typeof Y!=="string"){return ab}var Z=[],W,af,ai,T,ad,V,X=true;R.lastIndex=0;while((W=R.exec(Y))!==null){Z.push(W[1]);if(W[2]){V=RegExp.rightContext;break}}if(Z.length>1&&M.exec(Y)){if(Z.length===2&&I.relative[Z[0]]){af=J(Z[0]+Z[1],U)}else{af=I.relative[Z[0]]?[U]:F(Z.shift(),U);while(Z.length){Y=Z.shift();if(I.relative[Y]){Y+=Z.shift()}af=J(Y,af)}}}else{var ae=ac?{expr:Z.pop(),set:E(ac)}:F.find(Z.pop(),Z.length===1&&U.parentNode?U.parentNode:U,Q(U));af=F.filter(ae.expr,ae.set);if(Z.length>0){ai=E(af)}else{X=false}while(Z.length){var ah=Z.pop(),ag=ah;if(!I.relative[ah]){ah=""}else{ag=Z.pop()}if(ag==null){ag=U}I.relative[ah](ai,ag,Q(U))}}if(!ai){ai=af}if(!ai){throw"Syntax error, unrecognized expression: "+(ah||Y)}if(H.call(ai)==="[object Array]"){if(!X){ab.push.apply(ab,ai)}else{if(U.nodeType===1){for(var aa=0;ai[aa]!=null;aa++){if(ai[aa]&&(ai[aa]===true||ai[aa].nodeType===1&&K(U,ai[aa]))){ab.push(af[aa])}}}else{for(var aa=0;ai[aa]!=null;aa++){if(ai[aa]&&ai[aa].nodeType===1){ab.push(af[aa])}}}}}else{E(ai,ab)}if(V){F(V,U,ab,ac);if(G){hasDuplicate=false;ab.sort(G);if(hasDuplicate){for(var aa=1;aa":function(Z,U,aa){var X=typeof U==="string";if(X&&!/\W/.test(U)){U=aa?U:U.toUpperCase();for(var V=0,T=Z.length;V=0)){if(!V){T.push(Y)}}else{if(V){U[X]=false}}}}return false},ID:function(T){return T[1].replace(/\\/g,"")},TAG:function(U,T){for(var V=0;T[V]===false;V++){}return T[V]&&Q(T[V])?U[1]:U[1].toUpperCase()},CHILD:function(T){if(T[1]=="nth"){var U=/(-?)(\d*)n((?:\+|-)?\d*)/.exec(T[2]=="even"&&"2n"||T[2]=="odd"&&"2n+1"||!/\D/.test(T[2])&&"0n+"+T[2]||T[2]);T[2]=(U[1]+(U[2]||1))-0;T[3]=U[3]-0}T[0]=L++;return T},ATTR:function(X,U,V,T,Y,Z){var W=X[1].replace(/\\/g,"");if(!Z&&I.attrMap[W]){X[1]=I.attrMap[W]}if(X[2]==="~="){X[4]=" "+X[4]+" "}return X},PSEUDO:function(X,U,V,T,Y){if(X[1]==="not"){if(X[3].match(R).length>1||/^\w/.test(X[3])){X[3]=F(X[3],null,null,U)}else{var W=F.filter(X[3],U,V,true^Y);if(!V){T.push.apply(T,W)}return false}}else{if(I.match.POS.test(X[0])||I.match.CHILD.test(X[0])){return true}}return X},POS:function(T){T.unshift(true);return T}},filters:{enabled:function(T){return T.disabled===false&&T.type!=="hidden"},disabled:function(T){return T.disabled===true},checked:function(T){return T.checked===true},selected:function(T){T.parentNode.selectedIndex;return T.selected===true},parent:function(T){return !!T.firstChild},empty:function(T){return !T.firstChild},has:function(V,U,T){return !!F(T[3],V).length},header:function(T){return/h\d/i.test(T.nodeName)},text:function(T){return"text"===T.type},radio:function(T){return"radio"===T.type},checkbox:function(T){return"checkbox"===T.type},file:function(T){return"file"===T.type},password:function(T){return"password"===T.type},submit:function(T){return"submit"===T.type},image:function(T){return"image"===T.type},reset:function(T){return"reset"===T.type},button:function(T){return"button"===T.type||T.nodeName.toUpperCase()==="BUTTON"},input:function(T){return/input|select|textarea|button/i.test(T.nodeName)}},setFilters:{first:function(U,T){return T===0},last:function(V,U,T,W){return U===W.length-1},even:function(U,T){return T%2===0},odd:function(U,T){return T%2===1},lt:function(V,U,T){return UT[3]-0},nth:function(V,U,T){return T[3]-0==U},eq:function(V,U,T){return T[3]-0==U}},filter:{PSEUDO:function(Z,V,W,aa){var U=V[1],X=I.filters[U];if(X){return X(Z,W,V,aa)}else{if(U==="contains"){return(Z.textContent||Z.innerText||"").indexOf(V[3])>=0}else{if(U==="not"){var Y=V[3];for(var W=0,T=Y.length;W=0)}}},ID:function(U,T){return U.nodeType===1&&U.getAttribute("id")===T},TAG:function(U,T){return(T==="*"&&U.nodeType===1)||U.nodeName===T},CLASS:function(U,T){return(" "+(U.className||U.getAttribute("class"))+" ").indexOf(T)>-1},ATTR:function(Y,W){var V=W[1],T=I.attrHandle[V]?I.attrHandle[V](Y):Y[V]!=null?Y[V]:Y.getAttribute(V),Z=T+"",X=W[2],U=W[4];return T==null?X==="!=":X==="="?Z===U:X==="*="?Z.indexOf(U)>=0:X==="~="?(" "+Z+" ").indexOf(U)>=0:!U?Z&&T!==false:X==="!="?Z!=U:X==="^="?Z.indexOf(U)===0:X==="$="?Z.substr(Z.length-U.length)===U:X==="|="?Z===U||Z.substr(0,U.length+1)===U+"-":false},POS:function(X,U,V,Y){var T=U[2],W=I.setFilters[T];if(W){return W(X,V,U,Y)}}}};var M=I.match.POS;for(var O in I.match){I.match[O]=RegExp(I.match[O].source+/(?![^\[]*\])(?![^\(]*\))/.source)}var E=function(U,T){U=Array.prototype.slice.call(U);if(T){T.push.apply(T,U);return T}return U};try{Array.prototype.slice.call(document.documentElement.childNodes)}catch(N){E=function(X,W){var U=W||[];if(H.call(X)==="[object Array]"){Array.prototype.push.apply(U,X)}else{if(typeof X.length==="number"){for(var V=0,T=X.length;V";var T=document.documentElement;T.insertBefore(U,T.firstChild);if(!!document.getElementById(V)){I.find.ID=function(X,Y,Z){if(typeof Y.getElementById!=="undefined"&&!Z){var W=Y.getElementById(X[1]);return W?W.id===X[1]||typeof W.getAttributeNode!=="undefined"&&W.getAttributeNode("id").nodeValue===X[1]?[W]:g:[]}};I.filter.ID=function(Y,W){var X=typeof Y.getAttributeNode!=="undefined"&&Y.getAttributeNode("id");return Y.nodeType===1&&X&&X.nodeValue===W}}T.removeChild(U)})();(function(){var T=document.createElement("div");T.appendChild(document.createComment(""));if(T.getElementsByTagName("*").length>0){I.find.TAG=function(U,Y){var X=Y.getElementsByTagName(U[1]);if(U[1]==="*"){var W=[];for(var V=0;X[V];V++){if(X[V].nodeType===1){W.push(X[V])}}X=W}return X}}T.innerHTML="";if(T.firstChild&&typeof T.firstChild.getAttribute!=="undefined"&&T.firstChild.getAttribute("href")!=="#"){I.attrHandle.href=function(U){return U.getAttribute("href",2)}}})();if(document.querySelectorAll){(function(){var T=F,U=document.createElement("div");U.innerHTML="

";if(U.querySelectorAll&&U.querySelectorAll(".TEST").length===0){return}F=function(Y,X,V,W){X=X||document;if(!W&&X.nodeType===9&&!Q(X)){try{return E(X.querySelectorAll(Y),V)}catch(Z){}}return T(Y,X,V,W)};F.find=T.find;F.filter=T.filter;F.selectors=T.selectors;F.matches=T.matches})()}if(document.getElementsByClassName&&document.documentElement.getElementsByClassName){(function(){var T=document.createElement("div");T.innerHTML="
";if(T.getElementsByClassName("e").length===0){return}T.lastChild.className="e";if(T.getElementsByClassName("e").length===1){return}I.order.splice(1,0,"CLASS");I.find.CLASS=function(U,V,W){if(typeof V.getElementsByClassName!=="undefined"&&!W){return V.getElementsByClassName(U[1])}}})()}function P(U,Z,Y,ad,aa,ac){var ab=U=="previousSibling"&&!ac;for(var W=0,V=ad.length;W0){X=T;break}}}T=T[U]}ad[W]=X}}}var K=document.compareDocumentPosition?function(U,T){return U.compareDocumentPosition(T)&16}:function(U,T){return U!==T&&(U.contains?U.contains(T):true)};var Q=function(T){return T.nodeType===9&&T.documentElement.nodeName!=="HTML"||!!T.ownerDocument&&Q(T.ownerDocument)};var J=function(T,aa){var W=[],X="",Y,V=aa.nodeType?[aa]:aa;while((Y=I.match.PSEUDO.exec(T))){X+=Y[0];T=T.replace(I.match.PSEUDO,"")}T=I.relative[T]?T+"*":T;for(var Z=0,U=V.length;Z0||T.offsetHeight>0};F.selectors.filters.animated=function(T){return o.grep(o.timers,function(U){return T===U.elem}).length};o.multiFilter=function(V,T,U){if(U){V=":not("+V+")"}return F.matches(V,T)};o.dir=function(V,U){var T=[],W=V[U];while(W&&W!=document){if(W.nodeType==1){T.push(W)}W=W[U]}return T};o.nth=function(X,T,V,W){T=T||1;var U=0;for(;X;X=X[V]){if(X.nodeType==1&&++U==T){break}}return X};o.sibling=function(V,U){var T=[];for(;V;V=V.nextSibling){if(V.nodeType==1&&V!=U){T.push(V)}}return T};return;l.Sizzle=F})();o.event={add:function(I,F,H,K){if(I.nodeType==3||I.nodeType==8){return}if(I.setInterval&&I!=l){I=l}if(!H.guid){H.guid=this.guid++}if(K!==g){var G=H;H=this.proxy(G);H.data=K}var E=o.data(I,"events")||o.data(I,"events",{}),J=o.data(I,"handle")||o.data(I,"handle",function(){return typeof o!=="undefined"&&!o.event.triggered?o.event.handle.apply(arguments.callee.elem,arguments):g});J.elem=I;o.each(F.split(/\s+/),function(M,N){var O=N.split(".");N=O.shift();H.type=O.slice().sort().join(".");var L=E[N];if(o.event.specialAll[N]){o.event.specialAll[N].setup.call(I,K,O)}if(!L){L=E[N]={};if(!o.event.special[N]||o.event.special[N].setup.call(I,K,O)===false){if(I.addEventListener){I.addEventListener(N,J,false)}else{if(I.attachEvent){I.attachEvent("on"+N,J)}}}}L[H.guid]=H;o.event.global[N]=true});I=null},guid:1,global:{},remove:function(K,H,J){if(K.nodeType==3||K.nodeType==8){return}var G=o.data(K,"events"),F,E;if(G){if(H===g||(typeof H==="string"&&H.charAt(0)==".")){for(var I in G){this.remove(K,I+(H||""))}}else{if(H.type){J=H.handler;H=H.type}o.each(H.split(/\s+/),function(M,O){var Q=O.split(".");O=Q.shift();var N=RegExp("(^|\\.)"+Q.slice().sort().join(".*\\.")+"(\\.|$)");if(G[O]){if(J){delete G[O][J.guid]}else{for(var P in G[O]){if(N.test(G[O][P].type)){delete G[O][P]}}}if(o.event.specialAll[O]){o.event.specialAll[O].teardown.call(K,Q)}for(F in G[O]){break}if(!F){if(!o.event.special[O]||o.event.special[O].teardown.call(K,Q)===false){if(K.removeEventListener){K.removeEventListener(O,o.data(K,"handle"),false)}else{if(K.detachEvent){K.detachEvent("on"+O,o.data(K,"handle"))}}}F=null;delete G[O]}}})}for(F in G){break}if(!F){var L=o.data(K,"handle");if(L){L.elem=null}o.removeData(K,"events");o.removeData(K,"handle")}}},trigger:function(I,K,H,E){var G=I.type||I;if(!E){I=typeof I==="object"?I[h]?I:o.extend(o.Event(G),I):o.Event(G);if(G.indexOf("!")>=0){I.type=G=G.slice(0,-1);I.exclusive=true}if(!H){I.stopPropagation();if(this.global[G]){o.each(o.cache,function(){if(this.events&&this.events[G]){o.event.trigger(I,K,this.handle.elem)}})}}if(!H||H.nodeType==3||H.nodeType==8){return g}I.result=g;I.target=H;K=o.makeArray(K);K.unshift(I)}I.currentTarget=H;var J=o.data(H,"handle");if(J){J.apply(H,K)}if((!H[G]||(o.nodeName(H,"a")&&G=="click"))&&H["on"+G]&&H["on"+G].apply(H,K)===false){I.result=false}if(!E&&H[G]&&!I.isDefaultPrevented()&&!(o.nodeName(H,"a")&&G=="click")){this.triggered=true;try{H[G]()}catch(L){}}this.triggered=false;if(!I.isPropagationStopped()){var F=H.parentNode||H.ownerDocument;if(F){o.event.trigger(I,K,F,true)}}},handle:function(K){var J,E;K=arguments[0]=o.event.fix(K||l.event);K.currentTarget=this;var L=K.type.split(".");K.type=L.shift();J=!L.length&&!K.exclusive;var I=RegExp("(^|\\.)"+L.slice().sort().join(".*\\.")+"(\\.|$)");E=(o.data(this,"events")||{})[K.type];for(var G in E){var H=E[G];if(J||I.test(H.type)){K.handler=H;K.data=H.data;var F=H.apply(this,arguments);if(F!==g){K.result=F;if(F===false){K.preventDefault();K.stopPropagation()}}if(K.isImmediatePropagationStopped()){break}}}},props:"altKey attrChange attrName bubbles button cancelable charCode clientX clientY ctrlKey currentTarget data detail eventPhase fromElement handler keyCode metaKey newValue originalTarget pageX pageY prevValue relatedNode relatedTarget screenX screenY shiftKey srcElement target toElement view wheelDelta which".split(" "),fix:function(H){if(H[h]){return H}var F=H;H=o.Event(F);for(var G=this.props.length,J;G;){J=this.props[--G];H[J]=F[J]}if(!H.target){H.target=H.srcElement||document}if(H.target.nodeType==3){H.target=H.target.parentNode}if(!H.relatedTarget&&H.fromElement){H.relatedTarget=H.fromElement==H.target?H.toElement:H.fromElement}if(H.pageX==null&&H.clientX!=null){var I=document.documentElement,E=document.body;H.pageX=H.clientX+(I&&I.scrollLeft||E&&E.scrollLeft||0)-(I.clientLeft||0);H.pageY=H.clientY+(I&&I.scrollTop||E&&E.scrollTop||0)-(I.clientTop||0)}if(!H.which&&((H.charCode||H.charCode===0)?H.charCode:H.keyCode)){H.which=H.charCode||H.keyCode}if(!H.metaKey&&H.ctrlKey){H.metaKey=H.ctrlKey}if(!H.which&&H.button){H.which=(H.button&1?1:(H.button&2?3:(H.button&4?2:0)))}return H},proxy:function(F,E){E=E||function(){return F.apply(this,arguments)};E.guid=F.guid=F.guid||E.guid||this.guid++;return E},special:{ready:{setup:B,teardown:function(){}}},specialAll:{live:{setup:function(E,F){o.event.add(this,F[0],c)},teardown:function(G){if(G.length){var E=0,F=RegExp("(^|\\.)"+G[0]+"(\\.|$)");o.each((o.data(this,"events").live||{}),function(){if(F.test(this.type)){E++}});if(E<1){o.event.remove(this,G[0],c)}}}}}};o.Event=function(E){if(!this.preventDefault){return new o.Event(E)}if(E&&E.type){this.originalEvent=E;this.type=E.type}else{this.type=E}this.timeStamp=e();this[h]=true};function k(){return false}function u(){return true}o.Event.prototype={preventDefault:function(){this.isDefaultPrevented=u;var E=this.originalEvent;if(!E){return}if(E.preventDefault){E.preventDefault()}E.returnValue=false},stopPropagation:function(){this.isPropagationStopped=u;var E=this.originalEvent;if(!E){return}if(E.stopPropagation){E.stopPropagation()}E.cancelBubble=true},stopImmediatePropagation:function(){this.isImmediatePropagationStopped=u;this.stopPropagation()},isDefaultPrevented:k,isPropagationStopped:k,isImmediatePropagationStopped:k};var a=function(F){var E=F.relatedTarget;while(E&&E!=this){try{E=E.parentNode}catch(G){E=this}}if(E!=this){F.type=F.data;o.event.handle.apply(this,arguments)}};o.each({mouseover:"mouseenter",mouseout:"mouseleave"},function(F,E){o.event.special[E]={setup:function(){o.event.add(this,F,a,E)},teardown:function(){o.event.remove(this,F,a)}}});o.fn.extend({bind:function(F,G,E){return F=="unload"?this.one(F,G,E):this.each(function(){o.event.add(this,F,E||G,E&&G)})},one:function(G,H,F){var E=o.event.proxy(F||H,function(I){o(this).unbind(I,E);return(F||H).apply(this,arguments)});return this.each(function(){o.event.add(this,G,E,F&&H)})},unbind:function(F,E){return this.each(function(){o.event.remove(this,F,E)})},trigger:function(E,F){return this.each(function(){o.event.trigger(E,F,this)})},triggerHandler:function(E,G){if(this[0]){var F=o.Event(E);F.preventDefault();F.stopPropagation();o.event.trigger(F,G,this[0]);return F.result}},toggle:function(G){var E=arguments,F=1;while(F=0){var E=G.slice(I,G.length);G=G.slice(0,I)}var H="GET";if(J){if(o.isFunction(J)){K=J;J=null}else{if(typeof J==="object"){J=o.param(J);H="POST"}}}var F=this;o.ajax({url:G,type:H,dataType:"html",data:J,complete:function(M,L){if(L=="success"||L=="notmodified"){F.html(E?o("
").append(M.responseText.replace(//g,"")).find(E):M.responseText)}if(K){F.each(K,[M.responseText,L,M])}}});return this},serialize:function(){return o.param(this.serializeArray())},serializeArray:function(){return this.map(function(){return this.elements?o.makeArray(this.elements):this}).filter(function(){return this.name&&!this.disabled&&(this.checked||/select|textarea/i.test(this.nodeName)||/text|hidden|password|search/i.test(this.type))}).map(function(E,F){var G=o(this).val();return G==null?null:o.isArray(G)?o.map(G,function(I,H){return{name:F.name,value:I}}):{name:F.name,value:G}}).get()}});o.each("ajaxStart,ajaxStop,ajaxComplete,ajaxError,ajaxSuccess,ajaxSend".split(","),function(E,F){o.fn[F]=function(G){return this.bind(F,G)}});var r=e();o.extend({get:function(E,G,H,F){if(o.isFunction(G)){H=G;G=null}return o.ajax({type:"GET",url:E,data:G,success:H,dataType:F})},getScript:function(E,F){return o.get(E,null,F,"script")},getJSON:function(E,F,G){return o.get(E,F,G,"json")},post:function(E,G,H,F){if(o.isFunction(G)){H=G;G={}}return o.ajax({type:"POST",url:E,data:G,success:H,dataType:F})},ajaxSetup:function(E){o.extend(o.ajaxSettings,E)},ajaxSettings:{url:location.href,global:true,type:"GET",contentType:"application/x-www-form-urlencoded",processData:true,async:true,xhr:function(){return l.ActiveXObject?new ActiveXObject("Microsoft.XMLHTTP"):new XMLHttpRequest()},accepts:{xml:"application/xml, text/xml",html:"text/html",script:"text/javascript, application/javascript",json:"application/json, text/javascript",text:"text/plain",_default:"*/*"}},lastModified:{},ajax:function(M){M=o.extend(true,M,o.extend(true,{},o.ajaxSettings,M));var W,F=/=\?(&|$)/g,R,V,G=M.type.toUpperCase();if(M.data&&M.processData&&typeof M.data!=="string"){M.data=o.param(M.data)}if(M.dataType=="jsonp"){if(G=="GET"){if(!M.url.match(F)){M.url+=(M.url.match(/\?/)?"&":"?")+(M.jsonp||"callback")+"=?"}}else{if(!M.data||!M.data.match(F)){M.data=(M.data?M.data+"&":"")+(M.jsonp||"callback")+"=?"}}M.dataType="json"}if(M.dataType=="json"&&(M.data&&M.data.match(F)||M.url.match(F))){W="jsonp"+r++;if(M.data){M.data=(M.data+"").replace(F,"="+W+"$1")}M.url=M.url.replace(F,"="+W+"$1");M.dataType="script";l[W]=function(X){V=X;I();L();l[W]=g;try{delete l[W]}catch(Y){}if(H){H.removeChild(T)}}}if(M.dataType=="script"&&M.cache==null){M.cache=false}if(M.cache===false&&G=="GET"){var E=e();var U=M.url.replace(/(\?|&)_=.*?(&|$)/,"$1_="+E+"$2");M.url=U+((U==M.url)?(M.url.match(/\?/)?"&":"?")+"_="+E:"")}if(M.data&&G=="GET"){M.url+=(M.url.match(/\?/)?"&":"?")+M.data;M.data=null}if(M.global&&!o.active++){o.event.trigger("ajaxStart")}var Q=/^(\w+:)?\/\/([^\/?#]+)/.exec(M.url);if(M.dataType=="script"&&G=="GET"&&Q&&(Q[1]&&Q[1]!=location.protocol||Q[2]!=location.host)){var H=document.getElementsByTagName("head")[0];var T=document.createElement("script");T.src=M.url;if(M.scriptCharset){T.charset=M.scriptCharset}if(!W){var O=false;T.onload=T.onreadystatechange=function(){if(!O&&(!this.readyState||this.readyState=="loaded"||this.readyState=="complete")){O=true;I();L();T.onload=T.onreadystatechange=null;H.removeChild(T)}}}H.appendChild(T);return g}var K=false;var J=M.xhr();if(M.username){J.open(G,M.url,M.async,M.username,M.password)}else{J.open(G,M.url,M.async)}try{if(M.data){J.setRequestHeader("Content-Type",M.contentType)}if(M.ifModified){J.setRequestHeader("If-Modified-Since",o.lastModified[M.url]||"Thu, 01 Jan 1970 00:00:00 GMT")}J.setRequestHeader("X-Requested-With","XMLHttpRequest");J.setRequestHeader("Accept",M.dataType&&M.accepts[M.dataType]?M.accepts[M.dataType]+", */*":M.accepts._default)}catch(S){}if(M.beforeSend&&M.beforeSend(J,M)===false){if(M.global&&!--o.active){o.event.trigger("ajaxStop")}J.abort();return false}if(M.global){o.event.trigger("ajaxSend",[J,M])}var N=function(X){if(J.readyState==0){if(P){clearInterval(P);P=null;if(M.global&&!--o.active){o.event.trigger("ajaxStop")}}}else{if(!K&&J&&(J.readyState==4||X=="timeout")){K=true;if(P){clearInterval(P);P=null}R=X=="timeout"?"timeout":!o.httpSuccess(J)?"error":M.ifModified&&o.httpNotModified(J,M.url)?"notmodified":"success";if(R=="success"){try{V=o.httpData(J,M.dataType,M)}catch(Z){R="parsererror"}}if(R=="success"){var Y;try{Y=J.getResponseHeader("Last-Modified")}catch(Z){}if(M.ifModified&&Y){o.lastModified[M.url]=Y}if(!W){I()}}else{o.handleError(M,J,R)}L();if(X){J.abort()}if(M.async){J=null}}}};if(M.async){var P=setInterval(N,13);if(M.timeout>0){setTimeout(function(){if(J&&!K){N("timeout")}},M.timeout)}}try{J.send(M.data)}catch(S){o.handleError(M,J,null,S)}if(!M.async){N()}function I(){if(M.success){M.success(V,R)}if(M.global){o.event.trigger("ajaxSuccess",[J,M])}}function L(){if(M.complete){M.complete(J,R)}if(M.global){o.event.trigger("ajaxComplete",[J,M])}if(M.global&&!--o.active){o.event.trigger("ajaxStop")}}return J},handleError:function(F,H,E,G){if(F.error){F.error(H,E,G)}if(F.global){o.event.trigger("ajaxError",[H,F,G])}},active:0,httpSuccess:function(F){try{return !F.status&&location.protocol=="file:"||(F.status>=200&&F.status<300)||F.status==304||F.status==1223}catch(E){}return false},httpNotModified:function(G,E){try{var H=G.getResponseHeader("Last-Modified");return G.status==304||H==o.lastModified[E]}catch(F){}return false},httpData:function(J,H,G){var F=J.getResponseHeader("content-type"),E=H=="xml"||!H&&F&&F.indexOf("xml")>=0,I=E?J.responseXML:J.responseText;if(E&&I.documentElement.tagName=="parsererror"){throw"parsererror"}if(G&&G.dataFilter){I=G.dataFilter(I,H)}if(typeof I==="string"){if(H=="script"){o.globalEval(I)}if(H=="json"){I=l["eval"]("("+I+")")}}return I},param:function(E){var G=[];function H(I,J){G[G.length]=encodeURIComponent(I)+"="+encodeURIComponent(J)}if(o.isArray(E)||E.jquery){o.each(E,function(){H(this.name,this.value)})}else{for(var F in E){if(o.isArray(E[F])){o.each(E[F],function(){H(F,this)})}else{H(F,o.isFunction(E[F])?E[F]():E[F])}}}return G.join("&").replace(/%20/g,"+")}});var m={},n,d=[["height","marginTop","marginBottom","paddingTop","paddingBottom"],["width","marginLeft","marginRight","paddingLeft","paddingRight"],["opacity"]];function t(F,E){var G={};o.each(d.concat.apply([],d.slice(0,E)),function(){G[this]=F});return G}o.fn.extend({show:function(J,L){if(J){return this.animate(t("show",3),J,L)}else{for(var H=0,F=this.length;H").appendTo("body");K=I.css("display");if(K==="none"){K="block"}I.remove();m[G]=K}o.data(this[H],"olddisplay",K)}}for(var H=0,F=this.length;H=0;H--){if(G[H].elem==this){if(E){G[H](true)}G.splice(H,1)}}});if(!E){this.dequeue()}return this}});o.each({slideDown:t("show",1),slideUp:t("hide",1),slideToggle:t("toggle",1),fadeIn:{opacity:"show"},fadeOut:{opacity:"hide"}},function(E,F){o.fn[E]=function(G,H){return this.animate(F,G,H)}});o.extend({speed:function(G,H,F){var E=typeof G==="object"?G:{complete:F||!F&&H||o.isFunction(G)&&G,duration:G,easing:F&&H||H&&!o.isFunction(H)&&H};E.duration=o.fx.off?0:typeof E.duration==="number"?E.duration:o.fx.speeds[E.duration]||o.fx.speeds._default;E.old=E.complete;E.complete=function(){if(E.queue!==false){o(this).dequeue()}if(o.isFunction(E.old)){E.old.call(this)}};return E},easing:{linear:function(G,H,E,F){return E+F*G},swing:function(G,H,E,F){return((-Math.cos(G*Math.PI)/2)+0.5)*F+E}},timers:[],fx:function(F,E,G){this.options=E;this.elem=F;this.prop=G;if(!E.orig){E.orig={}}}});o.fx.prototype={update:function(){if(this.options.step){this.options.step.call(this.elem,this.now,this)}(o.fx.step[this.prop]||o.fx.step._default)(this);if((this.prop=="height"||this.prop=="width")&&this.elem.style){this.elem.style.display="block"}},cur:function(F){if(this.elem[this.prop]!=null&&(!this.elem.style||this.elem.style[this.prop]==null)){return this.elem[this.prop]}var E=parseFloat(o.css(this.elem,this.prop,F));return E&&E>-10000?E:parseFloat(o.curCSS(this.elem,this.prop))||0},custom:function(I,H,G){this.startTime=e();this.start=I;this.end=H;this.unit=G||this.unit||"px";this.now=this.start;this.pos=this.state=0;var E=this;function F(J){return E.step(J)}F.elem=this.elem;if(F()&&o.timers.push(F)&&!n){n=setInterval(function(){var K=o.timers;for(var J=0;J=this.options.duration+this.startTime){this.now=this.end;this.pos=this.state=1;this.update();this.options.curAnim[this.prop]=true;var E=true;for(var F in this.options.curAnim){if(this.options.curAnim[F]!==true){E=false}}if(E){if(this.options.display!=null){this.elem.style.overflow=this.options.overflow;this.elem.style.display=this.options.display;if(o.css(this.elem,"display")=="none"){this.elem.style.display="block"}}if(this.options.hide){o(this.elem).hide()}if(this.options.hide||this.options.show){for(var I in this.options.curAnim){o.attr(this.elem.style,I,this.options.orig[I])}}this.options.complete.call(this.elem)}return false}else{var J=G-this.startTime;this.state=J/this.options.duration;this.pos=o.easing[this.options.easing||(o.easing.swing?"swing":"linear")](this.state,J,0,1,this.options.duration);this.now=this.start+((this.end-this.start)*this.pos);this.update()}return true}};o.extend(o.fx,{speeds:{slow:600,fast:200,_default:400},step:{opacity:function(E){o.attr(E.elem.style,"opacity",E.now)},_default:function(E){if(E.elem.style&&E.elem.style[E.prop]!=null){E.elem.style[E.prop]=E.now+E.unit}else{E.elem[E.prop]=E.now}}}});if(document.documentElement.getBoundingClientRect){o.fn.offset=function(){if(!this[0]){return{top:0,left:0}}if(this[0]===this[0].ownerDocument.body){return o.offset.bodyOffset(this[0])}var G=this[0].getBoundingClientRect(),J=this[0].ownerDocument,F=J.body,E=J.documentElement,L=E.clientTop||F.clientTop||0,K=E.clientLeft||F.clientLeft||0,I=G.top+(self.pageYOffset||o.boxModel&&E.scrollTop||F.scrollTop)-L,H=G.left+(self.pageXOffset||o.boxModel&&E.scrollLeft||F.scrollLeft)-K;return{top:I,left:H}}}else{o.fn.offset=function(){if(!this[0]){return{top:0,left:0}}if(this[0]===this[0].ownerDocument.body){return o.offset.bodyOffset(this[0])}o.offset.initialized||o.offset.initialize();var J=this[0],G=J.offsetParent,F=J,O=J.ownerDocument,M,H=O.documentElement,K=O.body,L=O.defaultView,E=L.getComputedStyle(J,null),N=J.offsetTop,I=J.offsetLeft;while((J=J.parentNode)&&J!==K&&J!==H){M=L.getComputedStyle(J,null);N-=J.scrollTop,I-=J.scrollLeft;if(J===G){N+=J.offsetTop,I+=J.offsetLeft;if(o.offset.doesNotAddBorder&&!(o.offset.doesAddBorderForTableAndCells&&/^t(able|d|h)$/i.test(J.tagName))){N+=parseInt(M.borderTopWidth,10)||0,I+=parseInt(M.borderLeftWidth,10)||0}F=G,G=J.offsetParent}if(o.offset.subtractsBorderForOverflowNotVisible&&M.overflow!=="visible"){N+=parseInt(M.borderTopWidth,10)||0,I+=parseInt(M.borderLeftWidth,10)||0}E=M}if(E.position==="relative"||E.position==="static"){N+=K.offsetTop,I+=K.offsetLeft}if(E.position==="fixed"){N+=Math.max(H.scrollTop,K.scrollTop),I+=Math.max(H.scrollLeft,K.scrollLeft)}return{top:N,left:I}}}o.offset={initialize:function(){if(this.initialized){return}var L=document.body,F=document.createElement("div"),H,G,N,I,M,E,J=L.style.marginTop,K='
';M={position:"absolute",top:0,left:0,margin:0,border:0,width:"1px",height:"1px",visibility:"hidden"};for(E in M){F.style[E]=M[E]}F.innerHTML=K;L.insertBefore(F,L.firstChild);H=F.firstChild,G=H.firstChild,I=H.nextSibling.firstChild.firstChild;this.doesNotAddBorder=(G.offsetTop!==5);this.doesAddBorderForTableAndCells=(I.offsetTop===5);H.style.overflow="hidden",H.style.position="relative";this.subtractsBorderForOverflowNotVisible=(G.offsetTop===-5);L.style.marginTop="1px";this.doesNotIncludeMarginInBodyOffset=(L.offsetTop===0);L.style.marginTop=J;L.removeChild(F);this.initialized=true},bodyOffset:function(E){o.offset.initialized||o.offset.initialize();var G=E.offsetTop,F=E.offsetLeft;if(o.offset.doesNotIncludeMarginInBodyOffset){G+=parseInt(o.curCSS(E,"marginTop",true),10)||0,F+=parseInt(o.curCSS(E,"marginLeft",true),10)||0}return{top:G,left:F}}};o.fn.extend({position:function(){var I=0,H=0,F;if(this[0]){var G=this.offsetParent(),J=this.offset(),E=/^body|html$/i.test(G[0].tagName)?{top:0,left:0}:G.offset();J.top-=j(this,"marginTop");J.left-=j(this,"marginLeft");E.top+=j(G,"borderTopWidth");E.left+=j(G,"borderLeftWidth");F={top:J.top-E.top,left:J.left-E.left}}return F},offsetParent:function(){var E=this[0].offsetParent||document.body;while(E&&(!/^body|html$/i.test(E.tagName)&&o.css(E,"position")=="static")){E=E.offsetParent}return o(E)}});o.each(["Left","Top"],function(F,E){var G="scroll"+E;o.fn[G]=function(H){if(!this[0]){return null}return H!==g?this.each(function(){this==l||this==document?l.scrollTo(!F?H:o(l).scrollLeft(),F?H:o(l).scrollTop()):this[G]=H}):this[0]==l||this[0]==document?self[F?"pageYOffset":"pageXOffset"]||o.boxModel&&document.documentElement[G]||document.body[G]:this[0][G]}});o.each(["Height","Width"],function(I,G){var E=I?"Left":"Top",H=I?"Right":"Bottom",F=G.toLowerCase();o.fn["inner"+G]=function(){return this[0]?o.css(this[0],F,false,"padding"):null};o.fn["outer"+G]=function(K){return this[0]?o.css(this[0],F,false,K?"margin":"border"):null};var J=G.toLowerCase();o.fn[J]=function(K){return this[0]==l?document.compatMode=="CSS1Compat"&&document.documentElement["client"+G]||document.body["client"+G]:this[0]==document?Math.max(document.documentElement["client"+G],document.body["scroll"+G],document.documentElement["scroll"+G],document.body["offset"+G],document.documentElement["offset"+G]):K===g?(this.length?o.css(this[0],J):null):this.css(J,typeof K==="string"?K:K+"px")}})})(); - -/* - * jQuery Color Animations - * Copyright 2007 John Resig - * Released under the MIT and GPL licenses. - */ - -(function(jQuery){ - - // We override the animation for all of these color styles - jQuery.each(['backgroundColor', 'borderBottomColor', 'borderLeftColor', 'borderRightColor', 'borderTopColor', 'color', 'outlineColor'], function(i,attr){ - jQuery.fx.step[attr] = function(fx){ - if ( fx.state == 0 ) { - fx.start = getColor( fx.elem, attr ); - fx.end = getRGB( fx.end ); - } - - fx.elem.style[attr] = "rgb(" + [ - Math.max(Math.min( parseInt((fx.pos * (fx.end[0] - fx.start[0])) + fx.start[0]), 255), 0), - Math.max(Math.min( parseInt((fx.pos * (fx.end[1] - fx.start[1])) + fx.start[1]), 255), 0), - Math.max(Math.min( parseInt((fx.pos * (fx.end[2] - fx.start[2])) + fx.start[2]), 255), 0) - ].join(",") + ")"; - } - }); - - // Color Conversion functions from highlightFade - // By Blair Mitchelmore - // http://jquery.offput.ca/highlightFade/ - - // Parse strings looking for color tuples [255,255,255] - function getRGB(color) { - var result; - - // Check if we're already dealing with an array of colors - if ( color && color.constructor == Array && color.length == 3 ) - return color; - - // Look for rgb(num,num,num) - if (result = /rgb\(\s*([0-9]{1,3})\s*,\s*([0-9]{1,3})\s*,\s*([0-9]{1,3})\s*\)/.exec(color)) - return [parseInt(result[1]), parseInt(result[2]), parseInt(result[3])]; - - // Look for rgb(num%,num%,num%) - if (result = /rgb\(\s*([0-9]+(?:\.[0-9]+)?)\%\s*,\s*([0-9]+(?:\.[0-9]+)?)\%\s*,\s*([0-9]+(?:\.[0-9]+)?)\%\s*\)/.exec(color)) - return [parseFloat(result[1])*2.55, parseFloat(result[2])*2.55, parseFloat(result[3])*2.55]; - - // Look for #a0b1c2 - if (result = /#([a-fA-F0-9]{2})([a-fA-F0-9]{2})([a-fA-F0-9]{2})/.exec(color)) - return [parseInt(result[1],16), parseInt(result[2],16), parseInt(result[3],16)]; - - // Look for #fff - if (result = /#([a-fA-F0-9])([a-fA-F0-9])([a-fA-F0-9])/.exec(color)) - return [parseInt(result[1]+result[1],16), parseInt(result[2]+result[2],16), parseInt(result[3]+result[3],16)]; - - // Otherwise, we're most likely dealing with a named color - return colors[jQuery.trim(color).toLowerCase()]; - } - - function getColor(elem, attr) { - var color; - - do { - color = jQuery.curCSS(elem, attr); - - // Keep going until we find an element that has color, or we hit the body - if ( color != '' && color != 'transparent' || jQuery.nodeName(elem, "body") ) - break; - - attr = "backgroundColor"; - } while ( elem = elem.parentNode ); - - return getRGB(color); - }; - - // Some named colors to work with - // From Interface by Stefan Petre - // http://interface.eyecon.ro/ - - var colors = { - aqua:[0,255,255], - azure:[240,255,255], - beige:[245,245,220], - black:[0,0,0], - blue:[0,0,255], - brown:[165,42,42], - cyan:[0,255,255], - darkblue:[0,0,139], - darkcyan:[0,139,139], - darkgrey:[169,169,169], - darkgreen:[0,100,0], - darkkhaki:[189,183,107], - darkmagenta:[139,0,139], - darkolivegreen:[85,107,47], - darkorange:[255,140,0], - darkorchid:[153,50,204], - darkred:[139,0,0], - darksalmon:[233,150,122], - darkviolet:[148,0,211], - fuchsia:[255,0,255], - gold:[255,215,0], - green:[0,128,0], - indigo:[75,0,130], - khaki:[240,230,140], - lightblue:[173,216,230], - lightcyan:[224,255,255], - lightgreen:[144,238,144], - lightgrey:[211,211,211], - lightpink:[255,182,193], - lightyellow:[255,255,224], - lime:[0,255,0], - magenta:[255,0,255], - maroon:[128,0,0], - navy:[0,0,128], - olive:[128,128,0], - orange:[255,165,0], - pink:[255,192,203], - purple:[128,0,128], - violet:[128,0,128], - red:[255,0,0], - silver:[192,192,192], - white:[255,255,255], - yellow:[255,255,0] - }; - -})(jQuery); diff --git a/website-old/logi/reset.css b/website-old/logi/reset.css deleted file mode 100644 index 91c616e9..00000000 --- a/website-old/logi/reset.css +++ /dev/null @@ -1,67 +0,0 @@ -html,body,div,span,applet,object,iframe, -pre,abbr,address,cite,code,del,dfn,em,img, -ins,kbd,q,strong,tt,var,dl,dt,dd,blockquote, -fieldset,form,i,b,caption,tbody,tfoot,thead,tr,th,td{ - margin:0; - padding:0; - vertical-align:baseline; -} - -body{ - background:#fff; - color:#000; - font:75%/1.5em Verdana, Helvetica, Arial, sans-serif; -} - -:focus{ - outline:0; -} - -code,kbd,tt{ - font-family: "Courier new", Courier; - line-height:1; - *line-height:1.5; -} - -del{ - text-decoration:line-through; -} - -*::-moz-focus-inner { - border: 0; -} - -img{ - border: 0; - display:inline-block; - vertical-align:bottom; -} - -ol{ - list-style:inside decimal; -} - -ul{ - list-style:inside disc; -} - -pre{ - font-family:"Courier New", Courier; - margin:0 0 1.5em; -} - -sub{ - top:0.4em; - font-size:0.85em; - line-height:1; - position:relative; - vertical-align:baseline; -} - -sup{ - font-size:0.85em; - line-height:1; - position:relative; - bottom:0.5em; - vertical-align:baseline; -} diff --git a/website-old/lombokBullet.png b/website-old/lombokBullet.png deleted file mode 100644 index b19beee2..00000000 Binary files a/website-old/lombokBullet.png and /dev/null differ diff --git a/website-old/mavenrepo/index.html b/website-old/mavenrepo/index.html deleted file mode 100644 index a51a5a20..00000000 --- a/website-old/mavenrepo/index.html +++ /dev/null @@ -1,99 +0,0 @@ - - - - - - - Project Lombok - - -
-

Maven

-
- You can use lombok with maven by adding the following to your pom.xml: -
<dependencies> - <dependency> - <groupId>org.projectlombok</groupId> - <artifactId>lombok</artifactId> - <version>@VERSION@</version> - <scope>provided</scope> - </dependency> -</dependencies>
-
-

Ivy

-
- You can use lombok with ivy by adding the following to your ivy.xml: -
<dependency org="org.projectlombok" name="lombok" rev="@VERSION@" conf="build" />
-
-

SBT

-
- You can use lombok with SBT by adding the following to your build.sbt: -
libraryDependencies += "org.projectlombok" % "lombok" % "@VERSION@"
-
-

Gradle

- -
- If your gradle version is >= 2.12 you can use lombok by adding the following to your build.gradle in the dependencies block: -
compileOnly "org.projectlombok:lombok:@VERSION@"
-
-
- If you use an older version you can still use the following: -
provided "org.projectlombok:lombok:@VERSION@"
- as long as your gradle build include a war task (otherwise the "provided" scope is not available and you have to create your own configuration as explained here ) -
-
-
- NOTE: You'll still need to download lombok, or doubleclick on the lombok.jar file downloaded by maven / ivy / gradle, to install lombok into your eclipse installation. -
- Download lombok.jar -
-
- back to the project homepage -
-
- - - diff --git a/website-old/novideo.html b/website-old/novideo.html deleted file mode 100644 index 10a6f701..00000000 --- a/website-old/novideo.html +++ /dev/null @@ -1,57 +0,0 @@ - - - - - - - Project Lombok - - -
-

Can't see the video?

-

See it on Youtube: - https://www.youtube.com/watch?v=y6zMyM-YTgg -

- Or why not download it instead?
- MPEG4 / H.264 (Windows / Mac) | - Ogg Theora & Vorbis ".ogv" (Linux) -

- If the video won't play on the webpage and you want it to, please do one of the following: -

-
- back to the project homepage -
-
- - - diff --git a/website-old/peppery_background_large.jpg b/website-old/peppery_background_large.jpg deleted file mode 100644 index 6524dc6f..00000000 Binary files a/website-old/peppery_background_large.jpg and /dev/null differ diff --git a/website-old/poster.png b/website-old/poster.png deleted file mode 100644 index 4911408f..00000000 Binary files a/website-old/poster.png and /dev/null differ diff --git a/website-old/reinier.jpg b/website-old/reinier.jpg deleted file mode 100644 index dcb09700..00000000 Binary files a/website-old/reinier.jpg and /dev/null differ diff --git a/website-old/robbertjan.jpg b/website-old/robbertjan.jpg deleted file mode 100644 index a0839e6c..00000000 Binary files a/website-old/robbertjan.jpg and /dev/null differ diff --git a/website-old/roel.jpg b/website-old/roel.jpg deleted file mode 100644 index e5ce02ce..00000000 Binary files a/website-old/roel.jpg and /dev/null differ diff --git a/website-old/sander.jpg b/website-old/sander.jpg deleted file mode 100644 index f3be1b28..00000000 Binary files a/website-old/sander.jpg and /dev/null differ diff --git a/website-old/setup/android.html b/website-old/setup/android.html deleted file mode 100644 index 9edb9c95..00000000 --- a/website-old/setup/android.html +++ /dev/null @@ -1,131 +0,0 @@ - - - - - - - - - Project Lombok - - - Fork me on GitHub -
-

Project Lombok - android instructions

- -
-

- Android development with lombok is possible. Lombok should be a compile-time only dependency, as otherwise - the entirety of lombok will end up in your DEX files, wasting precious space on android devices. Also, errors will occur due - to the native libraries present in lombok.jar itself. Unfortunately, android does not (yet) understand the concept of a - compile-time-only dependency, so you need to mess with your build files to make it work. -

- Android also does not have a complete JRE library stack; in particular, it does not have the @java.beans.ConstructorProperties annotation, therefore you have to stop lombok from generating these: -

    -
  • The suppressConstructorProperties property can be set to false when using @XArgsConstructor Annotations.
    • -
  • Starting with Lombok >= 1.14.0 you can instead a lombok.config file to the root of your project to disable ConstructorProperties project wide. Add the following line to lombok.config:
    - 
    lombok.anyConstructor.suppressConstructorProperties = true

    - See the configuration documentation for more information on how to set up your project with a lombok config file. -
-

- The instructions listed below are excerpts from The - AndroidAnnotations project cookbook. You may wish to refer to that documentation for complete instructions; lombok is just - the equivalent to androidannotations-VERSION.jar; there is no -api aspect. -

-

Eclipse

-
- In eclipse, create a 'lightweight' lombok jar that contains only the annotations by running:

- 
-java -jar lombok.jar publicApi
- Then, add the lombok-api.jar file created by running this command - to your android project instead of the complete lombok.jar, and, - as usual, install lombok into eclipse by double-clicking lombok.jar. -
-

Ant

-
-
    -
  • Find build.xml in ${ANDROID_SDK_ROOT}/tools/ant/build.xml and copy the -compile target into the paste buffer. -
  • Copy this to the build.xml of your own project, right before the <import file="${sdk.dir}/tools/ant/build.xml"> line. -
  • Create a compile-libs directory in your own project and copy the complete lombok.jar to it. -
  • Now modify the <classpath> entry inside the <javac> task in the -compile target you just copied:
    - add <fileset dir="compile-libs" includes="*.jar" /> to it. -
-
-

Maven

-
- You should be able to just follow the normal lombok with maven instructions.
- Note that if you use android, eclipse, and maven together you may have to replace lombok.jar in your eclipse android project's build path - (which you can modify in that project's properties page) with lombok-api.jar, as produced in the procedure explained for Eclipse, - above. -
-

Gradle

-
-
    -
  • Make sure that the version of your android plugin is >= 0.4.3
    • -
  • Add Lombok to your application's dependencies block:

    -
    -	provided "org.projectlombok:lombok:1.12.6"
-
    -
    • -
  • When using android-apt, you also have to specify Lombok as an annotation processor (with the apt directive) in the dependencies block:

    -
    -	provided "org.projectlombok:lombok:1.12.6"
-	apt "org.projectlombok:lombok:1.12.6"
-
    -
    • -
-
-

Android Studio

-
- Follow the previous instructions (Gradle). In addition to setting up your gradle project correctly, you need to add the Lombok IntelliJ plugin to add lombok support to Android Studio: -
    -
  • Go to File > Settings > Plugins
    • -
  • Click on Browse repositories...
    • -
  • Search for Lombok Plugin
    • -
  • Click on Install plugin
    • -
  • Restart Android Studio
    • -
-
-
-
-
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
- - - diff --git a/website-old/setup/ecj.html b/website-old/setup/ecj.html deleted file mode 100644 index cc70c566..00000000 --- a/website-old/setup/ecj.html +++ /dev/null @@ -1,89 +0,0 @@ - - - - - - - - - Project Lombok - - - Fork me on GitHub -
-

Project Lombok - ecj instructions

- -
- ecj (the eclipse standalone compiler) is compatible with lombok. Use the following command line to enable lombok with ecj: -

- 

java -javaagent:lombok.jar=ECJ -jar ecj.jar -cp lombok.jar -source 1.8 (rest of arguments)
-

- You may have to add the following VM argument, if you're using an older version of lombok or java: - 

-Xbootclasspath/p:lombok.jar
-

- If you're using a tool based on ecj, adding these VM arguments and adding lombok.jar to the classpath should work. -

-
-
-
-

Using ecj with Maven

-

- It is possible to configure maven-compiler-plugin with maven-dependency-plugin and plexus-compiler-eclipse. -

-

- Before the compile phase, you will have to set your MAVEN_OPTS environment variable to include the javaagent argument. - In the example below, target is your ${project.build.directory}. -

-

- Use the following commands in sequence to enable lombok with ecj in your Maven build: -

-mvn clean dependency:copy@get-lombok
-set MAVEN_OPTS=-javaagent:target/lombok.jar=ECJ (or your OS's equivalent)
-mvn install
-set MAVEN_OPTS= (or your OS's equivalent)
-
-

-
-
-
-
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
- - - diff --git a/website-old/setup/gwt.html b/website-old/setup/gwt.html deleted file mode 100644 index d7bcad56..00000000 --- a/website-old/setup/gwt.html +++ /dev/null @@ -1,68 +0,0 @@ - - - - - - - - - Project Lombok - - - Fork me on GitHub -
-

Project Lombok - gwt instructions

- -
- gwt (Google Web Toolkit) is compatible with lombok. -

- Edit your proj-debug and proj-compile batch scripts to add the following VM arguments: - 

-java -javaagent:lombok.jar=ECJ (rest of arguments)
-
-

- Thanks to Stephen Haberman for figuring this out. -

-
-
-
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
- - - diff --git a/website-old/setup/netbeans-enable-annotation-processing-in-editor.png b/website-old/setup/netbeans-enable-annotation-processing-in-editor.png deleted file mode 100644 index d8a6b4c3..00000000 Binary files a/website-old/setup/netbeans-enable-annotation-processing-in-editor.png and /dev/null differ diff --git a/website-old/setup/netbeans.html b/website-old/setup/netbeans.html deleted file mode 100644 index 4ef1d392..00000000 --- a/website-old/setup/netbeans.html +++ /dev/null @@ -1,65 +0,0 @@ - - - - - - - - - Project Lombok - - - Fork me on GitHub -
-

Project Lombok - NetBeans instructions

- -
-
    -
  1. Add lombok.jar to the project Libraries.
    2. -
  2. In the project Properties, in the section Build – Compiling, check the 'Enable Annotation Processing in Editor' checkbox.
    3. -
- -
-
-
-
- credits | Copyright © 2009-2016 The Project Lombok Authors, licensed under the MIT license. -
-
- - - diff --git a/website-old/setup/pom.xml b/website-old/setup/pom.xml deleted file mode 100644 index 6562afe8..00000000 --- a/website-old/setup/pom.xml +++ /dev/null @@ -1,78 +0,0 @@ - - - 4.0.0 - - org.projectlombok - eclipse-compiler-test - 1.0-SNAPSHOT - - - UTF-8 - 1.16.8 - - - - - org.projectlombok - lombok - ${lombok.version} - provided - - - - - - - - org.apache.maven.plugins - maven-compiler-plugin - 3.5.1 - - eclipse - 1.8 - 1.8 - - - - org.codehaus.plexus - plexus-compiler-eclipse - 2.7 - - - org.projectlombok - lombok - ${lombok.version} - - - - - org.apache.maven.plugins - maven-dependency-plugin - 2.10 - - - get-lombok - - copy - - - - - org.projectlombok - lombok - ${lombok.version} - jar - ${project.build.directory} - lombok.jar - - - - - - - - - - diff --git a/website-old/unknown_person.gif b/website-old/unknown_person.gif deleted file mode 100644 index c5ec6b89..00000000 Binary files a/website-old/unknown_person.gif and /dev/null differ diff --git a/website-old/videos/expressInstall.swf b/website-old/videos/expressInstall.swf deleted file mode 100644 index 0fbf8fca..00000000 Binary files a/website-old/videos/expressInstall.swf and /dev/null differ diff --git a/website-old/videos/lombok-iPhone.m4v b/website-old/videos/lombok-iPhone.m4v deleted file mode 100644 index 19487ebd..00000000 Binary files a/website-old/videos/lombok-iPhone.m4v and /dev/null differ diff --git a/website-old/videos/lombok.mp4 b/website-old/videos/lombok.mp4 deleted file mode 100644 index b6f2107b..00000000 Binary files a/website-old/videos/lombok.mp4 and /dev/null differ diff --git a/website-old/videos/lombok.ogv b/website-old/videos/lombok.ogv deleted file mode 100644 index 70e20225..00000000 Binary files a/website-old/videos/lombok.ogv and /dev/null differ diff --git a/website-old/videos/player.swf b/website-old/videos/player.swf deleted file mode 100644 index 1f655a26..00000000 Binary files a/website-old/videos/player.swf and /dev/null differ diff --git a/website-old/videos/poster.png b/website-old/videos/poster.png deleted file mode 100644 index 4911408f..00000000 Binary files a/website-old/videos/poster.png and /dev/null differ diff --git a/website-old/videos/swfobject.js b/website-old/videos/swfobject.js deleted file mode 100644 index 8eafe9dd..00000000 --- a/website-old/videos/swfobject.js +++ /dev/null @@ -1,4 +0,0 @@ -/* SWFObject v2.2 - is released under the MIT License -*/ -var swfobject=function(){var D="undefined",r="object",S="Shockwave Flash",W="ShockwaveFlash.ShockwaveFlash",q="application/x-shockwave-flash",R="SWFObjectExprInst",x="onreadystatechange",O=window,j=document,t=navigator,T=false,U=[h],o=[],N=[],I=[],l,Q,E,B,J=false,a=false,n,G,m=true,M=function(){var aa=typeof j.getElementById!=D&&typeof j.getElementsByTagName!=D&&typeof j.createElement!=D,ah=t.userAgent.toLowerCase(),Y=t.platform.toLowerCase(),ae=Y?/win/.test(Y):/win/.test(ah),ac=Y?/mac/.test(Y):/mac/.test(ah),af=/webkit/.test(ah)?parseFloat(ah.replace(/^.*webkit\/(\d+(\.\d+)?).*$/,"$1")):false,X=!+"\v1",ag=[0,0,0],ab=null;if(typeof t.plugins!=D&&typeof t.plugins[S]==r){ab=t.plugins[S].description;if(ab&&!(typeof t.mimeTypes!=D&&t.mimeTypes[q]&&!t.mimeTypes[q].enabledPlugin)){T=true;X=false;ab=ab.replace(/^.*\s+(\S+\s+\S+$)/,"$1");ag[0]=parseInt(ab.replace(/^(.*)\..*$/,"$1"),10);ag[1]=parseInt(ab.replace(/^.*\.(.*)\s.*$/,"$1"),10);ag[2]=/[a-zA-Z]/.test(ab)?parseInt(ab.replace(/^.*[a-zA-Z]+(.*)$/,"$1"),10):0}}else{if(typeof O.ActiveXObject!=D){try{var ad=new ActiveXObject(W);if(ad){ab=ad.GetVariable("$version");if(ab){X=true;ab=ab.split(" ")[1].split(",");ag=[parseInt(ab[0],10),parseInt(ab[1],10),parseInt(ab[2],10)]}}}catch(Z){}}}return{w3:aa,pv:ag,wk:af,ie:X,win:ae,mac:ac}}(),k=function(){if(!M.w3){return}if((typeof j.readyState!=D&&j.readyState=="complete")||(typeof j.readyState==D&&(j.getElementsByTagName("body")[0]||j.body))){f()}if(!J){if(typeof j.addEventListener!=D){j.addEventListener("DOMContentLoaded",f,false)}if(M.ie&&M.win){j.attachEvent(x,function(){if(j.readyState=="complete"){j.detachEvent(x,arguments.callee);f()}});if(O==top){(function(){if(J){return}try{j.documentElement.doScroll("left")}catch(X){setTimeout(arguments.callee,0);return}f()})()}}if(M.wk){(function(){if(J){return}if(!/loaded|complete/.test(j.readyState)){setTimeout(arguments.callee,0);return}f()})()}s(f)}}();function f(){if(J){return}try{var Z=j.getElementsByTagName("body")[0].appendChild(C("span"));Z.parentNode.removeChild(Z)}catch(aa){return}J=true;var X=U.length;for(var Y=0;Y0){for(var af=0;af0){var ae=c(Y);if(ae){if(F(o[af].swfVersion)&&!(M.wk&&M.wk<312)){w(Y,true);if(ab){aa.success=true;aa.ref=z(Y);ab(aa)}}else{if(o[af].expressInstall&&A()){var ai={};ai.data=o[af].expressInstall;ai.width=ae.getAttribute("width")||"0";ai.height=ae.getAttribute("height")||"0";if(ae.getAttribute("class")){ai.styleclass=ae.getAttribute("class")}if(ae.getAttribute("align")){ai.align=ae.getAttribute("align")}var ah={};var X=ae.getElementsByTagName("param");var ac=X.length;for(var ad=0;ad'}}aa.outerHTML='"+af+"";N[N.length]=ai.id;X=c(ai.id)}else{var Z=C(r);Z.setAttribute("type",q);for(var ac in ai){if(ai[ac]!=Object.prototype[ac]){if(ac.toLowerCase()=="styleclass"){Z.setAttribute("class",ai[ac])}else{if(ac.toLowerCase()!="classid"){Z.setAttribute(ac,ai[ac])}}}}for(var ab in ag){if(ag[ab]!=Object.prototype[ab]&&ab.toLowerCase()!="movie"){e(Z,ab,ag[ab])}}aa.parentNode.replaceChild(Z,aa);X=Z}}return X}function e(Z,X,Y){var aa=C("param");aa.setAttribute("name",X);aa.setAttribute("value",Y);Z.appendChild(aa)}function y(Y){var X=c(Y);if(X&&X.nodeName=="OBJECT"){if(M.ie&&M.win){X.style.display="none";(function(){if(X.readyState==4){b(Y)}else{setTimeout(arguments.callee,10)}})()}else{X.parentNode.removeChild(X)}}}function b(Z){var Y=c(Z);if(Y){for(var X in Y){if(typeof Y[X]=="function"){Y[X]=null}}Y.parentNode.removeChild(Y)}}function c(Z){var X=null;try{X=j.getElementById(Z)}catch(Y){}return X}function C(X){return j.createElement(X)}function i(Z,X,Y){Z.attachEvent(X,Y);I[I.length]=[Z,X,Y]}function F(Z){var Y=M.pv,X=Z.split(".");X[0]=parseInt(X[0],10);X[1]=parseInt(X[1],10)||0;X[2]=parseInt(X[2],10)||0;return(Y[0]>X[0]||(Y[0]==X[0]&&Y[1]>X[1])||(Y[0]==X[0]&&Y[1]==X[1]&&Y[2]>=X[2]))?true:false}function v(ac,Y,ad,ab){if(M.ie&&M.mac){return}var aa=j.getElementsByTagName("head")[0];if(!aa){return}var X=(ad&&typeof ad=="string")?ad:"screen";if(ab){n=null;G=null}if(!n||G!=X){var Z=C("style");Z.setAttribute("type","text/css");Z.setAttribute("media",X);n=aa.appendChild(Z);if(M.ie&&M.win&&typeof j.styleSheets!=D&&j.styleSheets.length>0){n=j.styleSheets[j.styleSheets.length-1]}G=X}if(M.ie&&M.win){if(n&&typeof n.addRule==r){n.addRule(ac,Y)}}else{if(n&&typeof j.createTextNode!=D){n.appendChild(j.createTextNode(ac+" {"+Y+"}"))}}}function w(Z,X){if(!m){return}var Y=X?"visible":"hidden";if(J&&c(Z)){c(Z).style.visibility=Y}else{v("#"+Z,"visibility:"+Y)}}function L(Y){var Z=/[\\\"<>\.;]/;var X=Z.exec(Y)!=null;return X&&typeof encodeURIComponent!=D?encodeURIComponent(Y):Y}var d=function(){if(M.ie&&M.win){window.attachEvent("onunload",function(){var ac=I.length;for(var ab=0;ab