Skip to content
This repository has been archived by the owner on Nov 25, 2020. It is now read-only.
Petter Holmstrom edited this page Mar 1, 2013 · 14 revisions

Welcome to I18N4Vaadin 2.0

Here, you will hopefully find the information you need to start using I18N4Vaadin 2.0 in your applications.

What is I18N4Vaadin?

I18N4Vaadin is a small and simple add-on for making it easier to localize Vaadin applications. By using I18N4Vaadin, you do not have to implement a new localization system for every application and you can even change the language of your application on the fly without having to restart it.

Licensing

I18N4Vaadin is licensed under the Apache License version 2.0.

What is new in Version 2.0?

Version 2.0 is a complete rewrite that has very little in common with 1.0. Version 2.0 has been primarily designed to be used in CDI-enabled Vaadin 7 applications, even though it is also possible to use it in non-CDI applications.

The biggest new feature is an annotation processor (inspired by the NetBeans project) that automatically generates bundles for the default language. You define the default language strings using annotations directly in your code, and then access them using a special bundle-class that contains methods for each string in the bundle. Thus, you no longer have to deal with situations where a bundle resource key has been misspelled and the compiler will warn you if you change a bundle without changing your code.

What about Vaadin 6 support?

I18N4Vaadin 2.0 does not depend on any Vaadin jars, so technically it should be possible to use it in Vaadin 6 applications as well. I have not tested it, though, nor do I plan to do so.

Version 1.0 is still available in the V6 branch on GitHub.

How do I get I18N4Vaadin 2.0?

You can download I18N4Vaadin either here on GitHub or from the Vaadin Directory. Both source code and precompiled JARs are available.

How do I use I18N4Vaadin 2.0 in my applications?

You can use I18N4Vaadin in both CDI-enabled Vaadin applications and standard Vaadin applications. Instructions for both approaches are found here:

  • [Using-I18N4Vaadin-with-CDI]
  • [Using-I18N4Vaadin-without-CDI]

Where is the demo?

I have not had time to write a demo application yet. It is my intention of writing one before the 2.0.0 release.

Clone this wiki locally