You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@pivot.apache.org by sm...@apache.org on 2012/01/19 01:51:42 UTC
svn commit: r1233143 [24/47] - in /pivot/site/trunk/deploy: ./ 2.0.1/
2.0.1/docs/ 2.0.1/docs/api/ demos/ tutorials/
Modified: pivot/site/trunk/deploy/tutorials/localization.html
URL: http://svn.apache.org/viewvc/pivot/site/trunk/deploy/tutorials/localization.html?rev=1233143&r1=1233142&r2=1233143&view=diff
==============================================================================
--- pivot/site/trunk/deploy/tutorials/localization.html (original)
+++ pivot/site/trunk/deploy/tutorials/localization.html Thu Jan 19 00:51:39 2012
@@ -1,4 +1,4 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
@@ -14,282 +14,284 @@ distributed under the License is distrib
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
---><html xmlns="http://www.w3.org/1999/xhtml"><head><meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /><title>Localization | Apache Pivot</title><link xmlns="" type="text/css" rel="stylesheet" href="/styles/pivot.css"><script xmlns="http://www.w3.org/1999/xhtml" type="text/javascript">
- var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
- document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
- </script><script type="text/javascript">
- try {
- var pageTracker = _gat._getTracker("UA-7977275-3");
- pageTracker._trackPageview();
- } catch(err) {}</script></head><body><div xmlns="" id="wrapper"><div id="main"><div id="header"><div class="logo"><a href="/index.html"><img title="Apache Pivot Homepage" alt="Apache Pivot" src="/images/logo.png"></a></div><div class="tagline"><img style="visibility:hidden" alt="Rich Internet Applications in Java" src="/images/tagline.png"></div><ul class="navi"><li><a href="/demos/">Demos</a></li><li><a href="/download.cgi#2.0">Download</a></li><li><a href="/tutorials/">Tutorial</a></li><li><a href="/get-involved.html">Get Involved</a></li><li><a href="/about.html">About</a></li></ul></div><div class="group" id="contentBase"><h1>Localization</h1><ul class="naviLeft"><li><a href="/tutorials/sample-application.html">Sample Application</a></li><li><a href="/tutorials/platform-overview.html">Platform Overview</a></li><li><a href="/tutorials/hello-world.html">Hello, World!</a></li><li><a href="/tutorials/hello-bxml.html">Hello, BXML!</a></li><li><a href="/tutoria
ls/component-and-container.html">Component & Container</a></li><li><a href="/tutorials/labels-and-image-views.html">Labels & Image Views</a></li><li><a href="/tutorials/svg-images.html">SVG Images</a></li><li><a href="/tutorials/buttons.html">Buttons</a></li><li><a href="/tutorials/push-buttons.html">Push Buttons</a></li><li><a href="/tutorials/toggle-buttons.html">Toggle Buttons</a></li><li><a href="/tutorials/radio-buttons.html">Radio Buttons</a></li><li><a href="/tutorials/checkboxes.html">Checkboxes</a></li><li><a href="/tutorials/link-buttons.html">Link Buttons</a></li><li><a href="/tutorials/lists.html">Lists</a></li><li><a href="/tutorials/list-buttons.html">List Buttons</a></li><li><a href="/tutorials/repeatable-list-buttons.html">Repeatable List Buttons</a></li><li><a href="/tutorials/text.html">Text</a></li><li><a href="/tutorials/suggestion-popups.html">Suggestion Popups</a></li><li><a href="/tutorials/text-areas.html">Text Areas</a></li><li><a href="/tuto
rials/separators.html">Separators</a></li><li><a href="/tutorials/layout-containers.html">Layout Containers</a></li><li><a href="/tutorials/flow-panes.html">Flow Panes</a></li><li><a href="/tutorials/box-panes.html">Box Panes</a></li><li><a href="/tutorials/grid-panes.html">Grid Panes</a></li><li><a href="/tutorials/table-panes.html">Table Panes</a></li><li><a href="/tutorials/borders.html">Borders</a></li><li><a href="/tutorials/stack-panes.html">Stack Panes</a></li><li><a href="/tutorials/split-panes.html">Split Panes</a></li><li><a href="/tutorials/forms.html">Forms</a></li><li><a href="/tutorials/panels.html">Panels</a></li><li><a href="/tutorials/navigation-containers.html">Navigation Containers</a></li><li><a href="/tutorials/card-panes.html">Card Panes</a></li><li><a href="/tutorials/tab-panes.html">Tab Panes</a></li><li><a href="/tutorials/accordions.html">Accordions</a></li><li><a href="/tutorials/expanders.html">Expanders</a></li><li><a href="/tutorials/rollups.htm
l">Rollups</a></li><li><a href="/tutorials/viewports.html">Viewports</a></li><li><a href="/tutorials/scroll-panes.html">Scroll Panes</a></li><li><a href="/tutorials/panoramas.html">Panoramas</a></li><li><a href="/tutorials/progress-indicators.html">Progress Indicators</a></li><li><a href="/tutorials/meters.html">Meters</a></li><li><a href="/tutorials/activity-indicators.html">Activity Indicators</a></li><li><a href="/tutorials/bounded-range-components.html">Bounded Range Components</a></li><li><a href="/tutorials/sliders.html">Sliders</a></li><li><a href="/tutorials/scroll-bars.html">Scroll Bars</a></li><li><a href="/tutorials/spinners.html">Spinners</a></li><li><a href="/tutorials/calendars.html">Calendars</a></li><li><a href="/tutorials/menus.html">Menus</a></li><li><a href="/tutorials/context-menus.html">Context Menus</a></li><li><a href="/tutorials/menu-bars.html">Menu Bars</a></li><li><a href="/tutorials/menu-buttons.html">Menu Buttons</a></li><li><a href="/tutorials/co
lor-choosers.html">Color Choosers</a></li><li><a href="/tutorials/table-views.html">Table Views</a></li><li><a href="/tutorials/table-views.json.html">JSON-based TableView</a></li><li><a href="/tutorials/table-views.custom.html">Custom TableView</a></li><li><a href="/tutorials/tree-views.html">Tree Views</a></li><li><a href="/tutorials/file-browsing.html">File Browsing</a></li><li><a href="/tutorials/windows.html">Windows</a></li><li><a href="/tutorials/clipboard.html">Clipboard</a></li><li><a href="/tutorials/drag-and-drop.html">Drag and Drop</a></li><li><a href="/tutorials/effects.html">Effects</a></li><li><a href="/tutorials/effects.transitions.html">Transitions</a></li><li><a href="/tutorials/data-binding.html">Data Binding</a></li><li><a href="/tutorials/property-binding.html">Property Binding</a></li><li><a href="/tutorials/localization.html">Localization</a></li><li><a href="/tutorials/background-tasks.html">Background Tasks</a></li><li><a href="/tutorials/web-queries
.html">Web Queries</a></li><li><a href="/tutorials/query-servlet.html">QueryServlet</a></li><li><a href="/tutorials/scripting.html">Scripting</a></li><li><a href="/tutorials/summary.html">Summary</a></li><li><a href="/tutorials/stock-tracker.html">The "Stock Tracker" Application</a></li><li><a href="/tutorials/stock-tracker.ui.html">UI Markup Using BXML</a></li><li><a href="/tutorials/stock-tracker.events.html">Event Handling</a></li><li><a href="/tutorials/stock-tracker.web-queries.html">Web Queries</a></li><li><a href="/tutorials/stock-tracker.data-binding.html">Data Binding</a></li><li><a href="/tutorials/stock-tracker.localization.html">Localization</a></li><li><a href="/tutorials/bxml-primer.html">BXML Primer</a></li></ul><div class="content"><style type="text/css">
- applet {
- border: 1px solid #999999;
- }
- </style><!--NOTE: Syntax highlighting script is LGPL--><script src="http://alexgorbatchev.com/pub/sh/current/scripts/shCore.js" type="text/javascript"></script><script src="http://alexgorbatchev.com/pub/sh/current/scripts/shBrushJava.js" type="text/javascript"></script><script src="http://alexgorbatchev.com/pub/sh/current/scripts/shBrushXml.js" type="text/javascript"></script><script src="http://alexgorbatchev.com/pub/sh/current/scripts/shBrushJScript.js" type="text/javascript"></script><link href="http://alexgorbatchev.com/pub/sh/current/styles/shCore.css" rel="stylesheet" type="text/css"><link href="http://alexgorbatchev.com/pub/sh/current/styles/shThemeDefault.css" rel="stylesheet" type="text/css"><script type="text/javascript">
- SyntaxHighlighter.all();
- </script><div class="section">
- <p>
- In Java, any translatable text is generally stored in a set of localized property files
- called "resource bundles". The appropriate file is loaded at runtime for either the
- default locale or an explicitly selected non-default locale. While it is possible to
- use standard Java resource bundles in a Pivot application, Pivot adds support for
- JSON-based resource bundles that are slightly more flexible the built-in
- properties-based bundles. JSON resource bundles allow developers to more easily work
- with UTF-8 encoded resource strings, and also natively support hierarchical data, which
- can only be simulated when using properties files.
- </p>
-
- <p>
- The following application provides a simple demonstration of localization in Pivot:
- </p>
-
- <script src="http://java.com/js/deployJava.js" type="text/javascript"></script><script type="text/javascript">
-
- var attributes = {
- code:"org.apache.pivot.wtk.BrowserApplicationContext$HostApplet",
- width:"320",
- height:"240"
- };
-
-
-
-
-
- var libraries = [];
- libraries.push("/lib/pivot-core-2.0.jar");
- libraries.push("/lib/pivot-wtk-2.0.jar");
- libraries.push("/lib/pivot-wtk-terra-2.0.jar");
- libraries.push("/lib/pivot-tutorials-2.0.jar");
-
- libraries.push("/lib/svgSalamander-tiny.jar");
-
-
- attributes.archive = libraries.join(",");
-
-
- var parameters = {
- codebase_lookup:false,
- application_class_name:'org.apache.pivot.tutorials.localization.Localization'
- };
-
-
- var javaArguments = ["-Dsun.awt.noerasebackground=true",
- "-Dsun.awt.erasebackgroundonresize=true"];
-
-
-
- parameters.java_arguments = javaArguments.join(" ");
-
-
-
-
- deployJava.runApplet(attributes, parameters, "1.6");
- </script>
-
- <p>
- The following resource bundles are provided; if your default system locale is among
- these, you should see a localized version of the application. Otherwise, the default
- locale ("en") will be used:
- </p>
-
- <ul>
- <li>Localization.json</li>
- <li>Localization_cn.json</li>
- <li>Localization_de.json</li>
- <li>Localization_it.json</li>
- <li>Localization_ph.json</li>
- </ul>
-
- <p>
- The resource bundle for the default locale is shown below:
- </p>
-
- <pre class="brush:jscript">
-
- { firstName: "First name",
- lastName: "Last name",
- street: "Street",
- city: "City",
- state: "State",
- postalCode: "Zip",
- country: "Country"
- }
-
- </pre>
-
- <p>
- The BXML source for the application is as follows. Note the use of the "%" prefix in
- the form label attributes. This prefix is known as the "resource resolution operator"
- in BXML. As the BXML is read, attribute values that begin with the "%" character are
- replaced by the corresponding values defined in the resource bundle:
- </p>
-
- <pre class="brush:xml">
-
- <Window title="Localization" maximized="true"
- xmlns:bxml="http://pivot.apache.org/bxml"
- xmlns="org.apache.pivot.wtk">
- <windowStateListeners>
- function windowOpened(window) {
- window.requestFocus();
- }
- </windowStateListeners>
-
- <Border styles="{padding:6}">
- <Form>
- <Form.Section>
- <TextInput Form.label="%firstName"/>
- <TextInput Form.label="%lastName"/>
- <TextInput Form.label="%street"/>
- <TextInput Form.label="%city"/>
- <TextInput Form.label="%state" textSize="4"/>
- <TextInput Form.label="%postalCode"/>
- <TextInput Form.label="%country"/>
- </Form.Section>
- </Form>
- </Border>
- </Window>
-
- </pre>
-
- <p>
- The Java source for the application is shown below:
- </p>
-
- <pre class="brush:java">
-
- package org.apache.pivot.tutorials.localization;
-
- import java.awt.Font;
- import java.awt.GraphicsEnvironment;
- import java.util.Locale;
-
- import org.apache.pivot.beans.BXMLSerializer;
- import org.apache.pivot.collections.Map;
- import org.apache.pivot.util.Resources;
- import org.apache.pivot.wtk.Application;
- import org.apache.pivot.wtk.DesktopApplicationContext;
- import org.apache.pivot.wtk.Display;
- import org.apache.pivot.wtk.Theme;
- import org.apache.pivot.wtk.Window;
-
- public class Localization implements Application {
- private Window window = null;
-
- public static final String LANGUAGE_KEY = "language";
-
- @Override
- public void startup(Display display, Map<String, String> properties) throws Exception {
- String language = properties.get(LANGUAGE_KEY);
- Locale locale = (language == null) ? Locale.getDefault() : new Locale(language);
- Resources resources = new Resources(getClass().getName(), locale);
-
- Theme theme = Theme.getTheme();
- Font font = theme.getFont();
-
- // Search for a font that can support the sample string
- String sampleResource = (String)resources.get("firstName");
- if (font.canDisplayUpTo(sampleResource) != -1) {
- Font[] fonts = GraphicsEnvironment.getLocalGraphicsEnvironment().getAllFonts();
-
- for (int i = 0; i < fonts.length; i++) {
- if (fonts[i].canDisplayUpTo(sampleResource) == -1) {
- theme.setFont(fonts[i].deriveFont(Font.PLAIN, 12));
- break;
- }
- }
- }
-
- BXMLSerializer bxmlSerializer = new BXMLSerializer();
- window = (Window)bxmlSerializer.readObject(Localization.class.getResource("localization.bxml"), resources);
- window.open(display);
- }
-
- @Override
- public boolean shutdown(boolean optional) {
- if (window != null) {
- window.close();
- }
-
- return false;
- }
-
- @Override
- public void suspend() {
- }
-
- @Override
- public void resume() {
- }
-
- public static void main(String[] args) {
- DesktopApplicationContext.main(Localization.class, args);
- }
- }
-
- </pre>
-
- <p>
- The following example shows the application localized in German. Note that the applet
- is signed to allow the code to set the "user.language" system property:
- </p>
-
- <script src="http://java.com/js/deployJava.js" type="text/javascript"></script><script type="text/javascript">
-
- var attributes = {
- code:"org.apache.pivot.wtk.BrowserApplicationContext$HostApplet",
- width:"320",
- height:"240"
- };
-
-
-
-
-
- var libraries = [];
- libraries.push("/lib/pivot-core-2.0.signed.jar");
- libraries.push("/lib/pivot-wtk-2.0.signed.jar");
- libraries.push("/lib/pivot-wtk-terra-2.0.signed.jar");
- libraries.push("/lib/pivot-tutorials-2.0.signed.jar");
-
- libraries.push("/lib/svgSalamander-tiny.signed.jar");
-
-
- attributes.archive = libraries.join(",");
-
-
- var parameters = {
- codebase_lookup:false,
- application_class_name:'org.apache.pivot.tutorials.localization.Localization'
- };
-
-
- var javaArguments = ["-Dsun.awt.noerasebackground=true",
- "-Dsun.awt.erasebackgroundonresize=true"];
-
-
-
- parameters.java_arguments = javaArguments.join(" ");
-
-
-
- var startupProperties = [];
-
- startupProperties.push("language=de");
-
- parameters.startup_properties = startupProperties.join("&");
-
-
- deployJava.runApplet(attributes, parameters, "1.6");
- </script>
-
- <p>
- Notice that the <tt>startup()</tt> method includes code to search for a font that can
- display a sample set of characters obtained from the "firstName" resource. This is
- because all fonts are not guaranteed to include support for all possible Unicode
- characters. If the current theme font is not capable of displaying the sample string,
- this block of code attempts to identify and set one that can. This code must be
- executed prior to constructing any user interface elements so that the correct font
- will be used.
- </p>
- </div><p>Next: <a href="background-tasks.html">Background Tasks</a></p></div></div></div><div class="group" id="footer"><div class="footerLogo">Copyright (c) 1999-2011<br>The Apache Software Foundation.</div><div class="footerLinks"><ul class="footerMenuGr"><li><strong>Demos</strong><ul><li><a href="/demos/kitchen-sink.html" target="_new">"Kitchen Sink"</a></li><li><a href="/demos/component-explorer.html" target="_new">Component Explorer</a></li><li><a href="http://ixnay.biz/pivot-jfree-demos/charts_demo.html" target="_new">Charting</a></li><li><a href="/demos/">More Demos</a></li></ul></li><li><strong>Documentation</strong><ul><li><a href="/getting-started.html">Getting Started</a></li><li><a href="/tutorials/">Tutorial</a></li><li><a href="/faq.html">FAQ</a></li><li><a href="/2.0/docs/api/">Javadoc (2.0)</a></li></ul></li><li><strong>Get Involved</strong><ul><li><a href="/svn.html">SVN Repositories</a></li><li><a href="/lists.html">Mailing Lists</a></li><li><a href="ht
tp://issues.apache.org/jira/browse/PIVOT">Bug Database</a></li><li><a href="http://cwiki.apache.org/PIVOT/">Wiki</a></li></ul></li><li><strong>Related</strong><ul><li><a href="http://code.google.com/p/pivot-jfree/">JFreeChart Provider</a></li></ul></li><li><strong>About</strong><ul><li><a href="/who-we-are.html">Who We Are</a></li><li><a href="/contact.html">Contact</a></li><li><a href="/news.html">News</a></li><li><a href="/legal.html">Legal/License</a></li></ul></li></ul></div></div></div></body></html>
\ No newline at end of file
+--><html xmlns="http://www.w3.org/1999/xhtml"><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Localization | Apache Pivot</title><link href="/styles/pivot.css" rel="stylesheet" type="text/css"><script type="text/javascript">
+ var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
+ document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
+ </script><script type="text/javascript">
+ try {
+ var pageTracker = _gat._getTracker("UA-7977275-3");
+ pageTracker._trackPageview();
+ } catch(err) {}</script></head><body><div id="wrapper"><div id="main"><div id="header"><div xmlns="" class="logo"><a href="/index.html"><img src="/images/logo.png" alt="Apache Pivot" title="Apache Pivot Homepage"></a></div><div class="tagline"><img src="/images/tagline.png" alt="Rich Internet Applications in Java" style="visibility:hidden"></div><ul class="navi"><li><a href="/demos/">Demos</a></li><li><a href="/download.cgi#2.0.1">Download</a></li><li><a href="/tutorials/">Tutorial</a></li><li><a href="/get-involved.html">Get Involved</a></li><li><a href="/about.html">About</a></li></ul></div><div id="contentBase" class="group"><h1>Localization</h1><ul class="naviLeft"><li><a href="/tutorials/sample-application.html">Sample Application</a></li><li><a href="/tutorials/platform-overview.html">Platform Overview</a></li><li><a href="/tutorials/hello-world.html">Hello, World!</a></li><li><a href="/tutorials/hello-bxml.html">Hello, BXML!</a></li><li><a href="/tutor
ials/component-and-container.html">Component & Container</a></li><li><a href="/tutorials/labels-and-image-views.html">Labels & Image Views</a></li><li><a href="/tutorials/svg-images.html">SVG Images</a></li><li><a href="/tutorials/buttons.html">Buttons</a></li><li><a href="/tutorials/push-buttons.html">Push Buttons</a></li><li><a href="/tutorials/toggle-buttons.html">Toggle Buttons</a></li><li><a href="/tutorials/radio-buttons.html">Radio Buttons</a></li><li><a href="/tutorials/checkboxes.html">Checkboxes</a></li><li><a href="/tutorials/link-buttons.html">Link Buttons</a></li><li><a href="/tutorials/lists.html">Lists</a></li><li><a href="/tutorials/list-buttons.html">List Buttons</a></li><li><a href="/tutorials/repeatable-list-buttons.html">Repeatable List Buttons</a></li><li><a href="/tutorials/text.html">Text</a></li><li><a href="/tutorials/suggestion-popups.html">Suggestion Popups</a></li><li><a href="/tutorials/text-areas.html">Text Areas</a></li><li><a href="/tu
torials/separators.html">Separators</a></li><li><a href="/tutorials/layout-containers.html">Layout Containers</a></li><li><a href="/tutorials/flow-panes.html">Flow Panes</a></li><li><a href="/tutorials/box-panes.html">Box Panes</a></li><li><a href="/tutorials/fill-panes.html">Fill Panes</a></li><li><a href="/tutorials/grid-panes.html">Grid Panes</a></li><li><a href="/tutorials/table-panes.html">Table Panes</a></li><li><a href="/tutorials/borders.html">Borders</a></li><li><a href="/tutorials/stack-panes.html">Stack Panes</a></li><li><a href="/tutorials/split-panes.html">Split Panes</a></li><li><a href="/tutorials/forms.html">Forms</a></li><li><a href="/tutorials/panels.html">Panels</a></li><li><a href="/tutorials/navigation-containers.html">Navigation Containers</a></li><li><a href="/tutorials/card-panes.html">Card Panes</a></li><li><a href="/tutorials/tab-panes.html">Tab Panes</a></li><li><a href="/tutorials/accordions.html">Accordions</a></li><li><a href="/tutorials/expande
rs.html">Expanders</a></li><li><a href="/tutorials/rollups.html">Rollups</a></li><li><a href="/tutorials/viewports.html">Viewports</a></li><li><a href="/tutorials/scroll-panes.html">Scroll Panes</a></li><li><a href="/tutorials/panoramas.html">Panoramas</a></li><li><a href="/tutorials/progress-indicators.html">Progress Indicators</a></li><li><a href="/tutorials/meters.html">Meters</a></li><li><a href="/tutorials/activity-indicators.html">Activity Indicators</a></li><li><a href="/tutorials/bounded-range-components.html">Bounded Range Components</a></li><li><a href="/tutorials/sliders.html">Sliders</a></li><li><a href="/tutorials/scroll-bars.html">Scroll Bars</a></li><li><a href="/tutorials/spinners.html">Spinners</a></li><li><a href="/tutorials/calendars.html">Calendars</a></li><li><a href="/tutorials/menus.html">Menus</a></li><li><a href="/tutorials/context-menus.html">Context Menus</a></li><li><a href="/tutorials/menu-bars.html">Menu Bars</a></li><li><a href="/tutorials/menu
-buttons.html">Menu Buttons</a></li><li><a href="/tutorials/color-choosers.html">Color Choosers</a></li><li><a href="/tutorials/table-views.html">Table Views</a></li><li><a href="/tutorials/table-views.json.html">JSON-based TableView</a></li><li><a href="/tutorials/table-views.custom.html">Custom TableView</a></li><li><a href="/tutorials/tree-views.html">Tree Views</a></li><li><a href="/tutorials/file-browsing.html">File Browsing</a></li><li><a href="/tutorials/windows.html">Windows</a></li><li><a href="/tutorials/clipboard.html">Clipboard</a></li><li><a href="/tutorials/drag-and-drop.html">Drag and Drop</a></li><li><a href="/tutorials/effects.html">Effects</a></li><li><a href="/tutorials/effects.transitions.html">Transitions</a></li><li><a href="/tutorials/data-binding.html">Data Binding</a></li><li><a href="/tutorials/property-binding.html">Property Binding</a></li><li><a href="/tutorials/localization.html">Localization</a></li><li><a href="/tutorials/background-tasks.html
">Background Tasks</a></li><li><a href="/tutorials/web-queries.html">Web Queries</a></li><li><a href="/tutorials/query-servlet.html">QueryServlet</a></li><li><a href="/tutorials/scripting.html">Scripting</a></li><li><a href="/tutorials/summary.html">Summary</a></li><li><a href="/tutorials/stock-tracker.html">The "Stock Tracker" Application</a></li><li><a href="/tutorials/stock-tracker.ui.html">UI Markup Using BXML</a></li><li><a href="/tutorials/stock-tracker.events.html">Event Handling</a></li><li><a href="/tutorials/stock-tracker.web-queries.html">Web Queries</a></li><li><a href="/tutorials/stock-tracker.data-binding.html">Data Binding</a></li><li><a href="/tutorials/stock-tracker.localization.html">Localization</a></li><li><a href="/tutorials/bxml-primer.html">BXML Primer</a></li></ul><div class="content"><style type="text/css">
+ applet {
+ border: 1px solid #999999;
+ }
+ </style><!--NOTE: Syntax highlighting script is LGPL--><script type="text/javascript" src="http://alexgorbatchev.com/pub/sh/current/scripts/shCore.js"></script><script type="text/javascript" src="http://alexgorbatchev.com/pub/sh/current/scripts/shBrushJava.js"></script><script type="text/javascript" src="http://alexgorbatchev.com/pub/sh/current/scripts/shBrushXml.js"></script><script type="text/javascript" src="http://alexgorbatchev.com/pub/sh/current/scripts/shBrushJScript.js"></script><link type="text/css" rel="stylesheet" href="http://alexgorbatchev.com/pub/sh/current/styles/shCore.css"><link type="text/css" rel="stylesheet" href="http://alexgorbatchev.com/pub/sh/current/styles/shThemeDefault.css"><script type="text/javascript">
+ SyntaxHighlighter.all();
+ </script><div class="section">
+ <p>
+ In Java, any translatable text is generally stored in a set of localized property files
+ called "resource bundles". The appropriate file is loaded at runtime for either the
+ default locale or an explicitly selected non-default locale. While it is possible to
+ use standard Java resource bundles in a Pivot application, Pivot adds support for
+ JSON-based resource bundles that are slightly more flexible the built-in
+ properties-based bundles. JSON resource bundles allow developers to more easily work
+ with UTF-8 encoded resource strings, and also natively support hierarchical data, which
+ can only be simulated when using properties files.
+ </p>
+
+ <p>
+ The following application provides a simple demonstration of localization in Pivot:
+ </p>
+
+ <script type="text/javascript" src="http://java.com/js/deployJava.js"></script><script type="text/javascript">
+
+ var attributes = {
+ code:"org.apache.pivot.wtk.BrowserApplicationContext$HostApplet",
+ width:"320",
+ height:"240"
+ };
+
+
+
+
+
+ var libraries = [];
+ libraries.push("/lib/pivot-core-2.0.1.jar");
+ libraries.push("/lib/pivot-wtk-2.0.1.jar");
+ libraries.push("/lib/pivot-wtk-terra-2.0.1.jar");
+ libraries.push("/lib/pivot-tutorials-2.0.1.jar");
+
+ libraries.push("/lib/svgSalamander-tiny.jar");
+
+
+ attributes.archive = libraries.join(",");
+
+
+ var parameters = {
+ codebase_lookup:false,
+ application_class_name:'org.apache.pivot.tutorials.localization.Localization'
+ };
+
+
+ var javaArguments = ["-Dsun.awt.noerasebackground=true",
+ "-Dsun.awt.erasebackgroundonresize=true"];
+
+
+
+ parameters.java_arguments = javaArguments.join(" ");
+
+
+
+
+ deployJava.runApplet(attributes, parameters, "1.6");
+ </script>
+
+ <p>
+ The following resource bundles are provided; if your default system locale is among
+ these, you should see a localized version of the application. Otherwise, the default
+ locale ("en") will be used:
+ </p>
+
+ <ul>
+ <li>Localization.json</li>
+ <li>Localization_cn.json</li>
+ <li>Localization_de.json</li>
+ <li>Localization_it.json</li>
+ <li>Localization_ph.json</li>
+ </ul>
+
+ <p>
+ The resource bundle for the default locale is shown below:
+ </p>
+
+ <pre class="brush:jscript">
+
+ { firstName: "First name",
+ lastName: "Last name",
+ street: "Street",
+ city: "City",
+ state: "State",
+ postalCode: "Zip",
+ country: "Country"
+ }
+
+ </pre>
+
+ <p>
+ The BXML source for the application is as follows. Note the use of the "%" prefix in
+ the form label attributes. This prefix is known as the "resource resolution operator"
+ in BXML. As the BXML is read, attribute values that begin with the "%" character are
+ replaced by the corresponding values defined in the resource bundle:
+ </p>
+
+ <pre class="brush:xml">
+
+ <Window title="Localization" maximized="true"
+ xmlns:bxml="http://pivot.apache.org/bxml"
+ xmlns="org.apache.pivot.wtk">
+ <windowStateListeners>
+ function windowOpened(window) {
+ window.requestFocus();
+ }
+ </windowStateListeners>
+
+ <Border styles="{padding:6}">
+ <Form>
+ <Form.Section>
+ <TextInput Form.label="%firstName"/>
+ <TextInput Form.label="%lastName"/>
+ <TextInput Form.label="%street"/>
+ <TextInput Form.label="%city"/>
+ <TextInput Form.label="%state" textSize="4"/>
+ <TextInput Form.label="%postalCode"/>
+ <TextInput Form.label="%country"/>
+ </Form.Section>
+ </Form>
+ </Border>
+ </Window>
+
+ </pre>
+
+ <p>
+ The Java source for the application is shown below:
+ </p>
+
+ <pre class="brush:java">
+
+ package org.apache.pivot.tutorials.localization;
+
+ import java.awt.Font;
+ import java.awt.GraphicsEnvironment;
+ import java.util.Locale;
+
+ import org.apache.pivot.beans.BXMLSerializer;
+ import org.apache.pivot.collections.Map;
+ import org.apache.pivot.util.Resources;
+ import org.apache.pivot.wtk.Application;
+ import org.apache.pivot.wtk.DesktopApplicationContext;
+ import org.apache.pivot.wtk.Display;
+ import org.apache.pivot.wtk.Theme;
+ import org.apache.pivot.wtk.Window;
+
+ public class Localization implements Application {
+ private Window window = null;
+
+ public static final String LANGUAGE_KEY = "language";
+
+ @Override
+ public void startup(Display display, Map<String, String> properties) throws Exception {
+ String language = properties.get(LANGUAGE_KEY);
+ Locale locale = (language == null) ? Locale.getDefault() : new Locale(language);
+ Resources resources = new Resources(getClass().getName(), locale);
+
+ Theme theme = Theme.getTheme();
+ Font font = theme.getFont();
+
+ // Search for a font that can support the sample string
+ String sampleResource = (String)resources.get("firstName");
+ if (font.canDisplayUpTo(sampleResource) != -1) {
+ Font[] fonts = GraphicsEnvironment.getLocalGraphicsEnvironment().getAllFonts();
+
+ for (int i = 0; i < fonts.length; i++) {
+ if (fonts[i].canDisplayUpTo(sampleResource) == -1) {
+ theme.setFont(fonts[i].deriveFont(Font.PLAIN, 12));
+ break;
+ }
+ }
+ }
+
+ BXMLSerializer bxmlSerializer = new BXMLSerializer();
+ window = (Window)bxmlSerializer.readObject(Localization.class.getResource("localization.bxml"), resources);
+ window.open(display);
+ }
+
+ @Override
+ public boolean shutdown(boolean optional) {
+ if (window != null) {
+ window.close();
+ }
+
+ return false;
+ }
+
+ @Override
+ public void suspend() {
+ }
+
+ @Override
+ public void resume() {
+ }
+
+ public static void main(String[] args) {
+ DesktopApplicationContext.main(Localization.class, args);
+ }
+ }
+
+ </pre>
+
+ <p>
+ The following example shows the application localized in German. Note that the applet
+ is signed to allow the code to set the "user.language" system property:
+ </p>
+
+ <script type="text/javascript" src="http://java.com/js/deployJava.js"></script><script type="text/javascript">
+
+ var attributes = {
+ code:"org.apache.pivot.wtk.BrowserApplicationContext$HostApplet",
+ width:"320",
+ height:"240"
+ };
+
+
+
+
+
+ var libraries = [];
+ libraries.push("/lib/pivot-core-2.0.1.signed.jar");
+ libraries.push("/lib/pivot-wtk-2.0.1.signed.jar");
+ libraries.push("/lib/pivot-wtk-terra-2.0.1.signed.jar");
+ libraries.push("/lib/pivot-tutorials-2.0.1.signed.jar");
+
+ libraries.push("/lib/svgSalamander-tiny.signed.jar");
+
+
+ attributes.archive = libraries.join(",");
+
+
+ var parameters = {
+ codebase_lookup:false,
+ application_class_name:'org.apache.pivot.tutorials.localization.Localization'
+ };
+
+
+ var javaArguments = ["-Dsun.awt.noerasebackground=true",
+ "-Dsun.awt.erasebackgroundonresize=true"];
+
+
+
+ parameters.java_arguments = javaArguments.join(" ");
+
+
+
+ var startupProperties = [];
+
+ startupProperties.push("language=de");
+
+ parameters.startup_properties = startupProperties.join("&");
+
+
+ deployJava.runApplet(attributes, parameters, "1.6");
+ </script>
+
+ <p>
+ Notice that the <tt>startup()</tt> method includes code to search for a font that can
+ display a sample set of characters obtained from the "firstName" resource. This is
+ because all fonts are not guaranteed to include support for all possible Unicode
+ characters. If the current theme font is not capable of displaying the sample string,
+ this block of code attempts to identify and set one that can. This code must be
+ executed prior to constructing any user interface elements so that the correct font
+ will be used.
+ </p>
+ </div><p>Next: <a href="background-tasks.html">Background Tasks</a></p></div></div></div><div id="footer" class="group"><div class="footerLogo">Copyright (c) 1999-2012<br>The Apache Software Foundation.</div><div class="footerLinks"><ul class="footerMenuGr"><li><strong>Demos</strong><ul><li><a href="/demos/kitchen-sink.html" target="_new">"Kitchen Sink"</a></li><li><a href="/demos/component-explorer.html" target="_new">Component Explorer</a></li><li><a href="http://cwiki.apache.org/confluence/display/PIVOT/Other+Demos" target="_new">Charting</a></li><li><a href="/demos/">More Demos</a></li></ul></li><li><strong>Documentation</strong><ul><li><a href="/getting-started.html">Getting Started</a></li><li><a href="/tutorials/">Tutorial</a></li><li><a href="/faq.html">FAQ</a></li><li><a href="/2.0.1/docs/api/">Javadoc (2.0.1)</a></li></ul></li><li><strong>Get Involved</strong><ul><li><a href="/svn.html">SVN Repositories</a></li><li><a href="/lists.html">Mailing Lists</a></li><l
i><a href="http://issues.apache.org/jira/browse/PIVOT">Bug Database</a></li><li><a href="http://cwiki.apache.org/PIVOT/">Wiki</a></li></ul></li><li><strong>Related</strong><ul><li><a href="http://code.google.com/a/apache-extras.org/p/pivot-jfree/">JFreeChart Provider</a></li><li><a href="http://code.google.com/a/apache-extras.org/p/pivot-common/">Pivot-Common</a></li><li><a href="http://code.google.com/a/apache-extras.org/p/pivot-contrib/">Pivot-Contrib</a></li><li><a href="http://code.google.com/a/apache-extras.org/p/pivot-multilang/">Pivot-Multilang</a></li></ul></li><li><strong>About</strong><ul><li><a href="/who-we-are.html">Who We Are</a></li><li><a href="/contact.html">Contact</a></li><li><a href="http://cwiki.apache.org/confluence/display/PIVOT/News">News</a></li><li><a href="/legal.html">Legal/License</a></li></ul></li></ul></div><div class="footerLinks">
+ Apache Pivot is a trademark of the Apache Software Foundation
+ </div></div></div></body></html>
\ No newline at end of file