Fix OPENDJ-525: Remove compiler warnings when building using JDK7

Fix for 3259: No messages support in example plugin Changes by file: . resource/admin/example-plugin/ExamplePlugin.java - support for messages - fix for PluginResult.Startup refactoring . resource/admin/example-plugin/example_plugin.properties - 3 messages used in the example plugin (english/default) . resource/admin/example-plugin/example_plugin_fr.properties - 3 messages used in the example plugin (french) . resource/admin/example-plugin/build.xml - automatic generation of messages from properties files located in resource/messages while keeping package name. (eg. resource/messages/my/example/example_plugin.properties will generate a message class with package name "my.example") . resource/Messages.java.stub - forced underlying properties files to be located in /messages within jars file (eg MY_JAR_FILE:/messages/example_plugin.properties) - support for messages available from extensions' classloaders . src/messages/src/org/opends/messages/Message.java - typo in javadoc . build.xml - added message template used by generator in the build-tools.jar - added the "resource/messages" directory at the root of the example plugin - added example properties files in the example plugin zipfile . src/build-tools/org/opends/build/tools/GenerateMessageFile.java - stopped assuming messages are targeted in package name org.opends.messages - template for message class generation now retrieved from the build-tools.jar when generating messages for extensions - for user messages, set destination files automatically based on the source full filename and apply basic pattern (eg. source=resource/messages/my/example/example_plugin.properties sets destination to src-generated/my/example/ExamplePluginMessage.java)

Updated the copyright statement to reflect that Sun owns the full copyright on the project files.

This relates to issue 2661 "public APIs must not reference private classes". The classes in org.opends.messages need to be made public so that they can be referenced from other public APIs. This change adds the PublicAPI annotation to the classes defined in this package as follows: * the org.opends.messages package is VOLATILE * the org.opends.messages core classes (Message, MessageDescriptor, MessageBuilder, Category, and Severity) are all UNCOMMITTED * the class org.opends.messages.MessageDescriptorRegistry is PRIVATE (it's only used in unit tests) * generated message classes are PRIVATE In addition minor cleanup was made to the classes where appropriate to make them suitable for public APIs: * used "final" where possible * reduced visibility of classes, methods, and members where appropriate * fixed some potential bugs spotted during this clean-up: class members not being initialized (the "final" keyword is useful for spotting this!) * added missing javadoc * I've removed the third-party and user-defined message generation since we could see know way in which they could be easily used without impacting core OpenDS source

Fix for issue 2112. A new global property has been added to be able to specify to use a ClassLoader that limits the search of the bundles to the jar containint the Messages class i f we are running WebStart setup/upgrader. This property is only set in the quic ksetup.properties file, so the current behavior is preserved for all the other m essages files. The MessageDescriptor constructors have also been modified and n ow require a ClassLoader as parameter. With this modifications we have a ClassL oader defined in QuickSetupMessages.java that will only be used if we are runnin g QuickSetup. The JnlpProperties have been moved to SetupUtils so that the mess ages classes only depend on classes on the org.opends.server classes that can be compiled independently.

This commit is a step toward getting OpenDS internationalized. There are still issues to be resolved before we can declare that we are internationalized but this commit covers the bulk of changes needed at this time. In general this commit converts any string values that might potentially be shown to an end user (client or administrator) to a new class called Message. This includes exception messages, error log messages, alert and email text, labels, and CLI output. Message's main interface includes methods for rendering itself as a string in the default locale using toString() or a specified locale toString(Locale). In addition to addressing localization, this would allow us to potentially support controls allowing clients to set a preferred locale for server communication or output log messages in different languages. Message extends CharSequence so it can be used in some places where strings are currently used with not code change (e.g. writing to a buffer) as well as allowing messages to be composed of one another. In order to create localized messages, instead of adding them to the *Messages.java class, you define them in the corresponding properties files. In general the property file keys are used to derive the new messages severity, category, and ordinal. There are directives that can be used in the properties file in order to avoid doing this however. For instance all the properties files used internally include the 'global.category' directive at the top of the file that instructs the generator to make all the following message belong to a single category. So for internal messages the property value key will be as follows: [SEVERITY]_[DESCRIPTION]_[ORDINAL] See the properties files themselves for more information. Once your messages are in the properties file you can use the ant target 'generatemessages' to create create MessageDescriptor objects that are referred to in the Java code. In the code you might think of these objects as replacing the int-valued message IDs. To create messages you call MessageDescriptor.get() which replaces MessageHandler.getMessage(). It might be helpful then to try to define your messages before referring to them in your code since until you run 'generatemessages' you won't have any Java-code with with to create your message objects. In order to support non-localizable text in messages (host names, DN's, etc.) Message's can be created from String values by calling Message.raw(String). In this way it is also possible to circumvent the intention of changing the APIs to use Message objects instead of Strings which is to support writing of localizable messages. This method is currently used in the code as a crutch for areas of the code that need internationalization (tagged with a 'TODO: i18n' comment). It might also be used by 3rd party developers that don't intend to localize their products. However for internal use we should not be using this method to create Messages for text that is locale sensitive. Additionally this code includes a MessageBuilder that can be used in much the same way that a StringBuilder can be used. It has a method toMessage() that can be used to generate a message object when needed. At this time this method just converts the buffer contents to a raw, unlocalizable message so this will need to addressed in the future. Some other issues: - While all of the unit tests pass after this commit, there may be issues in the code where we have no or minimal test coverage. This includes much of the setup and GUI tools packages for which I have not done any testing but will begin after this commit. - The new message related Java sources are contained in package org.opends.messages and organized in a new module src/module modeled somewhat after the admin module: src/messages/src (non-generated Java source files) src/messages/generated (generated source files) src/messages/messages (properties files for messages) If you run the code from within your IDE you will have to mark all messages/src, messages/generated and messages as source directories. - To generated the MessageDescriptor files you invoke the 'generatemessages' target. - If you run the code from within your IDE you will probably ne - This commit would change the plugin API. Here are the changes caught by DirectoryServerPluginTestCase: doShutdown(String)->doShutdown(Message) doPostDisconnect(PostDisconnectPluginResult,ClientConnection,DisconnectReason,int,String) -> doPostDisconnect(PostDisconnectPluginResult,ClientConnection,DisconnectReason,Message); - This commit aligns the entire code-base behind the new Formatter class (printf style formattings like %s) as opposed to the older MessageFormat style (using curly braces for message arguments). This allows us to provide more type safety for message arguments. So for instance you can include a %c argument specifier in your format string and the MessageDescriptor will enforce specification of a Character as message creation time. - Not all of the config framework has not been converted to use Messages. Perhaps as some point we might have a 'message' syntax for locale-sensitive textural data. I'm sure Matt will have ideas about this. - In addition to Message, MessageDescriptor and MessageBuilder, the org.opends.server.message package includes enums for Category and Severity that replace the definitions formerly found in MessageHandler. - The interface for the ErrorLogger has been simplified to allow logging of messages using a single Message parameter. The severity and category of the message will be derived from the Message itself instead of specified as arguments when a message is logged. - I will provide more documentation about this plumbing on the Wiki shortly. - I will expand on the included tests soon.