User`s guide
IBM Lotus Notes, Domino, Domino Designer 8 Release Notes
It is suggested that organizations use a consistent setting across machines. Developers who will not
be using JDK 1.5-specific language features are encouraged to keep
the default Notes/Domino
behavior
as it will maximize backward compatibility.
INI Setting
Effects on Notes /Domino Agents
z
Notes/Domino will compile agents using the following compiler flags:
j
avac
No INI Setting
-source 1.3 -target 1.2
(default)
z
Agents will run on JREs from 1.2.x onward
z
The user loses the ability to compile with JDK 5.0 functionality (cannot create or
edit any Java agent that uses JDK 5.0 features)
z
The user keeps
backward compatibility (any agent that is created or edited during
the session can still be still run on Domino 6.0 or later)
z
Notes/Domino will compile agents using
j
avac -source 1.5 -target 1.5
z
Compiled agents can only be run with JDK 5.0 (Notes/Domino 8.0 and later).
JavaCompiler
Target=1.5
z
The user gains JDK 5.0 functionality with any agent created or edited during that
session (such agents will run with new JDK 5.0 features)
z
The user loses
backward compatibility with any agent created or edited during that
session (such agents will not run on a server with any earlier Domino version,
even if they don't use any 5.0 features)
JDK 1.5 Language Features that Require "JavaCompilerTarget=1.5":
The following JDK 1.5 agents will require the JavaCompilerTarget=1.5 INI setting to compile and run:
New Java 5 Language Features
Generics
Allows a type or method to operate on objects of various types while providing compile-time type safety.
z
Enhanced for Loops
Facilitates iterating over collections and arrays.
z
Autoboxing/Unboxing
Facilitates conversion between primitive types (such as int) and wrapper types (such as Integer).
z
Typesafe Enums
Allows creation of enumerated types with arbitrary methods and fields.
z
Varargs
Simplifies invoking methods that accept variable-length argument lists.
z
Static Import
Lets you avoid qualifying static members with class names.
z
Annotations (Metadata)
Allows tools to generate boilerplate code from annotations in the source code.
z
76