Active development of Seam International has been halted by Red Hat. This project has been migrated over to Apache DeltaSpike .

Seam International

A unified approach to configuring your application for the right language and locale, propagating them to all parts of the application.

Key links

• Bookmark: http://sfwk.org/Seam3/International
  
• Git repository: http://github.com/seam/international
  
• Issue tracker: https://issues.jboss.org/browse/SEAMINTL (SEAMINTL)
• Download: Distribution
• Documentation: Reference guide | API
• Maven artifacts: seam-international (or seam-international-api)*

To get started, add the following dependency groups below to your pom.xml:

<dependency>
   <groupId>org.jboss.seam.international</groupId>
   <artifactId>seam-international-api</artifactId>
   <version>3.1.0.Final</version>
</dependency>

<dependency>
   <groupId>org.jboss.seam.international</groupId>
   <artifactId>seam-international</artifactId>
   <version>3.1.0.Final</version>
   <scope>runtime</scope>
</dependency>

Module team

Name	Module role	Commit username (Git)	Hometown (Time zone)
Ken Finnigan	Lead	kenfinnigan	Boston, MA, USA (UTC-05)
Lincoln Baxter III	Contributor	lincolnthree	Charlotte, NC, USA (UTC-05)
José Freitas	Contributor	joserodolfofreitas	Brazil (UTC-03)

Description

Internationalization and localization are very important for those of us who develop applications for non-English speakers, but is unfortunately poorly supported in various places in Java. It certainly isn't seamless to configure.

Seam aims to provide a unified approach to configuring your application for the right locale, propagating the locale to all aspects of the application.

Release plan

Design notes

Below are the design notes for the Internationalization module.

Objectives of this module for Seam 3:

• Removal of hard dependencies to JSF, ensuring this module is view framework agnostic
• Support messages being sent to multiple view frameworks within a single application
• Improved message handling

ResourceBundle

Possibly provide a way to produce/inject ResourceBundle instances, or an aggregate ResourceBundle

See Dynamic ResourceBundles in CDI as one possible idea

Help text

Consider providing foundation infrastructure for a help text system (or at least a basic implementation). The idea is to be able to associate formatted help text, perhaps in the form of Facelets fragments, and a URL with keyed elements on the screen. The resources would need to be localized.

Messages

org.jboss.seam.faces.status.MessagesAdapter delegates to org.jboss.seam.international.status.Messages within the Request scope, and is dependent on RenderContext being installed. It also interpolates EL expressions in the message string. Contains convenience methods for creating a Message. convert() handles the transfer of messages to JSF before rendering the response.

: Potentially provide support for tagging messages to be displayed in a specific region of the page.

TimeZone

We have provided User and Application timezones for the JDK TimeZone and JODA DateTimeZone implementations. It's up to your personal preference as to which you utilize.

User and Application TimeZones are set to the default JDK TimeZone or JODA DateTimeZone unless overridden by specifying a String associated with @DefaultTimeZone. User TimeZone is updated by triggering a TimeZone or DateTimeZone event with @Alter and @Client qualifiers on the event.

org.jboss.seam.international.timezone.AvailableTimeZones is an Application Scoped Bean that provides a List of supported ForwardingTimeZone instances for either the JDK or JODA TimeZone implementations.

Consolidated time zone list

• (GMT-12:00) Eniwetok, Kwajalein
• (GMT-11:00) Midway Island, Samoa
• (GMT-10:00) Hawaii
• (GMT-09:00) Alaska
• (GMT-08:00) PST (Pacific Standard Time) (US & Canada)
• (GMT-07:00) MST (Mountain Standard Time) (US & Canada)
• (GMT-06:00) CST (Central Standard Time) (US & Canada), Mexico City
• (GMT-05:00) EST (Eastern Standard Time) (US & Canada), Bogota, Lima, Quito
• (GMT-04:00) Atlantic Time (Canada), Caracas, La Paz
• (GMT-03:30) Newfoundland
• (GMT-03:00) Brazil, Buenos Aires, Georgetown
• (GMT-02:00) Mid-Atlantic
• (GMT-01:00) Azores, Cape Verde Islands
• (GMT+00:00) GMT (Greenwich Mean Time), London, Lisbon, Casablanca, Monrovia
• (GMT+01:00) CET (Central Europe Time), Brussels, Copenhagen, Madrid, Paris
• (GMT+02:00) EET (Eastern Europe Time), Kaliningrad, South Africa
• (GMT+03:00) Baghdad, Kuwait, Riyadh, Moscow, St Petersburg
• (GMT+03:30) Tehran
• (GMT+04:00) Abu Dhabi, Muscat, Baku, Tbilisi
• (GMT+04:30) Kabul
• (GMT+05:00) Ekaterinburg, Islamabad, Karachi, Tashkent
• (GMT+05:30) Bombay, Calcutta, Madras, New Delhi
• (GMT+06:00) Almaty, Dhaka, Colombo
• (GMT+07:00) Bangkok, Hanoi, Jakarta
• (GMT+08:00) Beijing, Perth, Singapore, Hong Kong, Chongqing, Urumqi, Taipei
• (GMT+09:00) Tokyo, Seoul, Osaka, Sapporo, Yakutsk
• (GMT+09:30) Adelaide, Darwin
• (GMT+10:00) EAST (East Australian Standard)
• (GMT+11:00) Magadan, Solomon Islands, New Caledonia
• (GMT+12:00) Auckland, Wellington, Fiji, Kamchatka, Marshall Island

Locale

User and Application Locales are set to the default JDK Locale unless overridden by specifying a String associated with @DefaultLocale. User Locale is updated by triggering a Locale event with @Alter and @Client qualifiers on the event.

org.jboss.seam.international.locale.AvailableLocales is an Application Scoped Bean that provides a List of supported Locales through a Producer field which is initialised through overriding supportedLocaleKeys with Seam Config.