13 Internationale sider

Dette kapitel forudsætter kapitel 9, Javabønner i JSP-sider.

13.1 Internationale programmer

Når et program skal anvendes af flere kulturer og sprog, opstår behov for, at programtekster, beløb og dato angives i de pågældende landes sprog og man må i gang med at internationalisere og lokalisere programmet.

Internationalisering (eng.: Internationalization, også kaldet I18N) består i, at gøre programmet sprogneutralt, ved at sørge for, at al formatering og fortolkning af tal-, beløbs-, dato- og tidsangivelser, sker afhængigt af sproget og at al sproglig tekst er flyttet til separate filer. Det er typisk programmørens, der står for denne opgave.

Lokalisering (eng.: Localization, også kaldet L10N) består i, at oversætte filerne fra hovedsproget til de andre sprog, applikationen skal fungere på. Denne opgave varetages typisk af en professionel oversætter.

13.1.1 Formatering af tidspunkter

DateFormat formaterer Date-objekter til strenge (og den anden vej).

import java.text.*;
import java.util.*;
public class BenytDateFormat
{
  public static void main(String arg[])
  {
    DateFormat klformat, datoformat, dkf;
    klformat   = DateFormat.getTimeInstance(DateFormat.MEDIUM);
    datoformat = DateFormat.getDateInstance(DateFormat.FULL);
    dkf = DateFormat.getDateTimeInstance(DateFormat.MEDIUM,DateFormat.SHORT);

    Date tid = new Date();
    System.out.println( tid );
    System.out.println( "Kl   :"+ klformat.format(tid) );
    System.out.println( "Dato :"+ datoformat.format(tid) );
    System.out.println( "Tid  :"+ dkf.format(tid) );
  }
}

Wed Feb 05 14:23:46 GMT+00:00 2003
Kl   :14:23:46
Dato :5. februar 2003
Tid  :05-02-2003 14:23

Læg for det første mærke til, at toString() på Date ikke er lokaliseret. Den bør kun bruges til test-udskrifter og logning og ikke i tekst, som brugeren skal læse.

Ovenstående program er kørt med danske sprogindstillinger. Med amerikanske sprogindstillinger bliver uddata i stedet:

Mon Dec 03 13:27:57 GMT+01:00 2001
Kl:   1:27:57 PM
Dato: Monday, December 3, 2001
Tid:  Dec 3, 2001 1:27 PM

Det ses, at det afhænger en del af sproget, præcist hvordan tider bliver formateret (f.eks. er ugedag med i den amerikanske tekst, men ikke i den danske).

Ønsker man som programmør fuld kontrol over, hvordan teksten bliver formateret, må man selv specificere formatet med SimpleDateFormat:

import java.text.*;
import java.util.*;
public class BenytSimpleDateFormat
{
  public static void main(String arg[])
  {
    DateFormat df = new SimpleDateFormat("EEEE 'den' d. MMMM 'år' yyyy.");

    Date tid = new Date();
    System.out.println( df.format(tid) );
  }
}

mandag den 3. december år 2001.

Dermed bliver selve formaterings-strengen sprogspecifik (og den bør lægges ud i en resursefil - se senere). Køres den med amerikanske sprogindstillinger, bliver uddata:

Monday den 3. December år 2001.

13.1.2 Formatering af tal og beløb

På samme måde som med tidsangivelser formateres/fortolkes tal ved at bede om et formateringsobjekt, der klarer netop denne form for tal:

import java.text.*;
public class BenytNumberFormat
{
  public static void main(String arg[]) 
  {
    double tal = 1234.5678;
    NumberFormat fmt1 = NumberFormat.getInstance();
    NumberFormat fmt2 = NumberFormat.getCurrencyInstance();
    NumberFormat fmt3 = NumberFormat.getPercentInstance();
    System.out.println( fmt1.format(tal) );
    System.out.println( fmt2.format(tal) );
    System.out.println( fmt3.format(tal) );
  }
}

1.234,568
kr 1.234,57
123.457%

Med amerikanske sprogindstillinger bliver uddata:

1,234.568
$1,234.57
123,457%

13.1.3 Bruge Locale-objekter

Land og sprog (lokalindstillingerne) repræsenteres ved et Locale-objekt. Dette objekt bruges til al formatering, til at finde resursebundter frem og lignende.

Ønsker man kontrol over hvilket sprog, der anvendes, kan man selv oprette et Locale-objekt, og det kan så bruges til at fremskaffe formateringsobjekter til det pågældende sprog:

import java.text.*;
import java.util.*;
public class BenytDateFormat2
{
  public static void main(String arg[]) {
    DateFormat klformat, datoformat;

    Locale fransk = new Locale("fr","FR");
    klformat   = DateFormat.getTimeInstance(DateFormat.SHORT,fransk);
    datoformat = DateFormat.getDateInstance(DateFormat.LONG, fransk);

    Date tid = new Date();
    System.out.println( "Kl:   "+ klformat.format(tid) );
    System.out.println( "Dato: "+ datoformat.format(tid) );
  }
}

Kl:   14:23
Dato: 5 février 2003

13.1.4 De mulige lokalindstillinger

Man kan undersøge hvilke Locale-objekter, der er tilgængelige, ved at kalde klassemetoden Locale.getAvailableLocales(). Her er et lille program, der skriver dem ud:

import java.util.*;
public class MuligeSprog
{
  public static void main(String arg[]) {
    Locale[] lokalindstillinger = Locale.getAvailableLocales();
    for (int i=0; i<lokalindstillinger.length; i++) {
      Locale lokalindst = lokalindstillinger[i];
      System.out.print(lokalindst+" ");
      // udkommentér hvis du vil se hvad sproget hedder på sproget selv
      //System.out.println(lokalindst.getDisplayName(lokalindst));
    }
    System.out.println( );
  }
}

ar ar_AE ar_BH ar_DZ ar_EG ar_IQ ar_JO ar_KW ar_LB ar_LY ar_MA ar_OM ar_QA ar_SA ar_SD ar_SY ar_TN ar_YE hi_IN iw iw_IL ja ja_JP ko ko_KR th th_TH th_TH_TH zh 
zh_CN zh_HK zh_TW be be_BY bg bg_BG ca ca_ES cs cs_CZ da da_DK de de_AT de_CH 
de_DE de_LU el el_GR en_AU en_CA en_GB en_IE en_IN en_NZ en_ZA es es_AR es_BO 
es_CL es_CO es_CR es_DO es_EC es_ES es_GT es_HN es_MX es_NI es_PA es_PE es_PR 
es_PY es_SV es_UY es_VE et et_EE fi fi_FI fr fr_BE fr_CA fr_CH fr_FR fr_LU hr 
hr_HR hu hu_HU is is_IS it it_CH it_IT lt lt_LT lv lv_LV mk mk_MK nl nl_BE nl_NL 
no no_NO no_NO_NY pl pl_PL pt pt_BR pt_PT ro ro_RO ru ru_RU sh sh_YU sk sk_SK sl 
sl_SI sq sq_AL sr sr_YU sv sv_SE tr tr_TR uk uk_UA en en_US eo

Locale-objektet består af tre dele:

• Første del er sprogkoden, f.eks. da, sv, no, en, fr.

• En valgfri anden del er landekoden, f.eks. DK, NO, GB, DE, FR

• En valgfri tredje del er varianten inden for sprogområdet (f.eks. om valutaen er i euro).

Eksempler:

fr: Fransk
fr_BE: Fransk i Belgien
fr_CA: Fransk i Canada
no_NO: Norsk i Norge (bokmål)
no_NO_NY: Nynorsk i Norge (variant NY er nynorsk)

13.2 Eksempel: Webside med alle sprog

Her er et eksempel, der sammenfatter det ovenstående og hvor man kan vælge mellem alle de mulige sprog og se hvordan forskellige ting skrives på dette sprog:

sprogtest.jsp

<%@ page import="java.util.*,java.text.*" contentType="text/html;charset=UTF-8" %>
<html>
<head><title>Sprogtest</title></head>
<body>

<p>Din netl&aelig;sers foretrukne sprog er <%=request.getLocale().getDisplayName()%>
<br>Samtlige acceptable sprog er: 
<%
  Enumeration e = request.getLocales();
  while (e.hasMoreElements()) {
    Locale l = (Locale) e.nextElement();
    out.print(l + ":"+l.getDisplayName()+"\n" );
  }
%>
</p>

<p>V&aelig;lg sprog<br>
<font size="-1">Disse er tilg&aelig;ngelige:
<%
  Locale[] lokalindstillinger = Locale.getAvailableLocales();
  for (int i=0; i<lokalindstillinger.length; i++) {
    Locale lokalindst = lokalindstillinger[i];
    out.print(" <a href='sprogtest.jsp?sprog="+lokalindst+"'>"
      +lokalindst+"</a>:"                     // sprogkode, f.eks.: da_DK
      +lokalindst.getDisplayName(lokalindst));// fuldt navn paa sproget selv
  }
%>
</font></p>

<%
  Locale sprog = request.getLocale();             // netlaeserens foretrukne sprog
  String vsprog = request.getParameter("sprog");  // har bruger valgt et andet?
  if (vsprog != null) {
    String[] s = vsprog.split("_");               // split f.eks. da_DK op
    if (s.length==1) sprog = new Locale(vsprog);        // sprog (da)
    else if (s.length==2) sprog = new Locale(s[0],s[1]);// sprog, land (da_DK)
    else sprog = new Locale(s[0],s[1],s[2]);            // sprog, land, variant
  }
%>

<h1>Ting p&aring; <%= sprog.getDisplayName(sprog) %></h1>
<pre>
<%
  double tal = 1234.5678;
  NumberFormat fmt1 = NumberFormat.getInstance(sprog);
  NumberFormat fmt2 = NumberFormat.getCurrencyInstance(sprog);
  NumberFormat fmt3 = NumberFormat.getPercentInstance(sprog);
  out.println( "Tal             : " + fmt1.format(tal) );
  out.println( "Valuta          : " + fmt2.format(tal) );
  out.println( "Procent         : " + fmt3.format(tal) );

  Date tid = new Date();
  out.println( "tid.toString()  : "+ tid );

  SimpleDateFormat brugerdefineretFormat = 
               new SimpleDateFormat("EEEE 'den' d. MMMM '&aring;r' yyyy.", sprog);
  out.println( "SimpleDateFormat: " + brugerdefineretFormat.format(tid) );

  DateFormat klformat, datoformat, dkf;
  klformat   = DateFormat.getTimeInstance(DateFormat.MEDIUM, sprog);
  datoformat = DateFormat.getDateInstance(DateFormat.FULL, sprog);
  dkf = DateFormat.getDateTimeInstance(DateFormat.FULL, DateFormat.FULL, sprog);

  ResourceBundle res = ResourceBundle.getBundle("sprogtest.Tekster", sprog);

  out.println( res.getString("Kl_")+ klformat.format(tid) );
  out.println( res.getString("Dato_")+ datoformat.format(tid) );
  out.println( res.getString("Tid_")+ dkf.format(tid) );
%></pre>
</body>
</html>

Vælger man nu catalansk i Spanien (ca_ES) får man:

Vælger man engelsk i Canada (en_CA) får man:

Læg mærke til, at de nederste tre tekster (Kl, Dato og Tid) bliver vist på engelsk (Time of day, Date og Time). Det skyldes, at disse tekster er blevet lagt ud i en separat fil (en resursefil), der er blevet oversat til engelsk (se senere).

13.3 Tegnsæt og HTML-entiteter

Læg mærke til linjen

<%@ page contentType="text/html;charset=UTF-8" %>

øverst i eksemplet.

Sidedirektivet her specificerer at HTML-siden kommer i indkodningen UTF-8, d.v.s. Unicode. Unicode er nødvendigt, for at kunne repræsentere tegn uden for intervallet 0-256, men er ikke kompatibelt ved vestlig indkodning (ISO-8859-1) uden for ASCII-området (de amerikanske tegn A-Z), så æ, ø og å og andre specielle tegn går tabt.

Når man skriver sine websider, må man derfor enten sørge for at siderne er er indkodet i Unicode-formatet eller benytte HTML-entiteter, såsom æ (for æ), ø (for ø) og å (for å) i HTML-koden i stedet.

Det har vi gjort i eksemplet, f.eks har vi skrevet:

Din netlæser

i stedet for:

Din netlæser

13.4 Tekstindhold i resursefiler

Programmet BenytDateFormat er halvt internationaliseret, da tidsformateringen korrekt skifter afhængigt af sproget. Der mangler kun strengene "Kl: ", "Dato: " og "Tid: ".

Lad os nu fuldføre internationaliseringen ved at lægge tekstindholdet (strengene) ud i et resursebundt (eng.: resource bundle) med navnet Tekster.

Disse kan tilgås fra programmet således:

package sprogtest;

import java.text.*;
import java.util.*;
public class BenytDateFormatMedResurser
{
  public static void main(String arg[])
  {
    ResourceBundle res = ResourceBundle.getBundle("sprogtest.Tekster");
    DateFormat klformat, datoformat, dkf;
    klformat   = DateFormat.getTimeInstance(DateFormat.MEDIUM);
    datoformat = DateFormat.getDateInstance(DateFormat.FULL);
    dkf = DateFormat.getDateTimeInstance(DateFormat.MEDIUM,DateFormat.SHORT);

    Date tid = new Date();
    System.out.println( res.getString("Kl_")+ klformat.format(tid) );
    System.out.println( res.getString("Dato_")+ datoformat.format(tid) );
    System.out.println( res.getString("Tid_")+ dkf.format(tid) );
  }
}

Kl  : 14:23:50
Dato: 5. februar 2003
Tid : 05-02-2003 14:23

Resursebundtet, der skal ligge i filen sprogtest.Tekster.properties, indeholder teksten i nøgle-værdi-par.

Disse vil blive brugt, hvis der ikke findes resursefiler for det pågældende sprog:

Tid_=Tid  \:
Kl_=Kl   \:
Dato_=Dato \:

Køres programmet (på et styresystem indstillet til dansk), fås samme udskrift som før.

Lad os nu lokalisere programmet til engelsk.

Det består i, at vi opretter sprogtest.Tekster_en.properties med de engelske tekster:

Tid_=Time       \:
Kl_=Time of day\:
Dato_=Date       \:

Starter vi derefter programmet med engelske sprogindstillinger, får vi uddata:

Time of day : 3:07:28 PM
Date        : Monday, December 3, 2001
Time        : Dec 3, 2001 3:07 PM

13.4.1 Hvordan der søges efter resurser

Når programmet skal finde en programtekst ud fra sprogindstillingerne, sker det ved først at kigge i den mest specifikke resursefil. Hvis programteksten ikke findes der, kigges i en mere generel resursefil og til sidst i den mest generelle.

For eksempel vil resurser til sproget fr_CA (canadisk fransk) blive søgt

1. først i Tekster_fr_CA.properties

2. dernæst i Tekster_fr.properties

3. og sidst i Tekster.properties

13.4.2 Avanceret: Binære resursefiler

13.4.3 Avanceret tekstformatering

13.5 En international fælleskalender

13.5.1 Slutbrugerens oplevelse

Her ses kalenderen på dansk og tysk:

Her er vist redigering på sproget esperanto:

13.5.2 Fuld separation mellem layout og sprog

Eksemplet gør brug af resursebundter til samtlige programtekster og opnår derved, at JSP-siden kun beskæftiger sig med layout og visningslogik.

Oversættelseskoden (opslag i resursebundter) er lagt i en separat fil, nemlig i en Sprogdata-bønne, sådan at JSP-siden kan holdes overskuelig og sådan, at den er så lidt forstyrret af opslag i resursebundter som muligt (hver gang en tekstbid skal ind i JSP-siden kalder den metoden ovs() på bønnen med nøglen).

Her er kalendertekster.properties, med originalsproget (dansk):

# Filnavn: kalendertekster.properties
Fælleskalender_for=Fælleskalender for
kalenderen=kalenderen
kalender=kalender
måned=måned
forrige=forrige
næste=næste
redigér=redigér
vis=vis
Tryk_input_type_submit_value_OK_når_du_vil_gemme_ændringer=Tryk <input type='submit' value='OK'> når du vil gemme ændringer
_input_type_submit_value_OK_=<input type='submit' value='OK'>

Her er kalendertekster_de.properties (tysk):

# Filnavn: kalendertekster_de.properties
Fælleskalender_for=Der Gruppenkalender für
kalenderen=der Kalender
kalender=Kalender
måned=monat
forrige=vorheriger
næste=nächste
redigér=redigieren
vis=zeigen
Tryk_input_type_submit_value_OK_når_du_vil_gemme_ændringer=Drücken <input type='submit' value='OK'> um die Änderungen zu speichern
_input_type_submit_value_OK_=<input type='submit' value='OK'>

Her er kalendertekster_eo.properties (esperanto):

# Filnavn: kalendertekster_eo.properties
Fælleskalender_for=Komuna kalendaro por
kalenderen=la kalendaro
kalender=kalendaro
måned=monato
forrige=antaua
næste=posta
redigér=redaktu
vis=montru
Tryk_input_type_submit_value_OK_når_du_vil_gemme_ændringer=Premu <input type='submit' value='Bone'> por konservi shanghojn
_input_type_submit_value_OK_=<input type='submit' value='Bone'>

Her er javabønnen Sprogdata, der holder styr på sprog og resursebundter:

Sprogdata.java

package kalender;
import java.util.*;
import java.text.*;

public class Sprogdata
{
  private Locale sprog = Locale.getDefault();
  private ResourceBundle tekster;
  private Bruger bruger;

  public void setLocale(Locale sproget) 
  { 
    sprog = sproget;
    tekster = ResourceBundle.getBundle("kalendertekster",sprog);
    bruger.setLocale(sprog);
  }

  public void setBruger(Bruger brugerobjekt)
  { 
    bruger = brugerobjekt; 
    bruger.setLocale(sprog);
  }

  public void setSprog(String sproget) {
    String[] s = sproget.split("_");
    if (s.length==1) setLocale(new Locale(sproget)); 
    else if (s.length==2) setLocale(new Locale(s[0],s[1])); 
    else setLocale(new Locale(s[0],s[1],s[2])); 
  }

  /** Oversæt en tekst (slå op i det relevante resursebundt) */
  public String ovs(String nøgle)
  {
    try {
      return tekster.getString(nøgle);
    } catch (MissingResourceException e) 
    {
      System.err.println("Advarsel: Manglende resurse i kalendertekster:\n"
          + nøgle.replaceAll("[\\p{Punct}\\s]+","_")  // erstat andre tegn med _
          + "=" + nøgle.replaceAll("[\r\n]","\\\n") );
      return nøgle;
    }
  }
}

Her er JSP-siden med kalenderen:

kalender.jsp

<%-- Knyt bønnen Bruger til brugerens session under navnet b --%>
<jsp:useBean id="b" class="kalender.Bruger" scope="session" />
 <%-- <title>kalender</title> --%>
<%-- Overfør parametre til b, der svarer til egenskaber --%>
<jsp:setProperty name="b" property="*" />

<%-- Knyt bønnen Sprogdata til brugerens session under navnet s --%>
<jsp:useBean id="s" class="kalender.Sprogdata" scope="session">
  <% // Første gang: Knyt til Bruger-objekt og registrér sproget 
    s.setBruger( b );
    s.setLocale( request.getLocale() ); %>
</jsp:useBean>

<%-- Overfør evt. sprog-parameter til s --%>
<jsp:setProperty name="s" property="sprog" />

<html>      <%-- s.ovs() oversætter teksten til det pågældende sprog --%>
<head><title><%= s.ovs("kalender") %></title></head>
<body>

[<a href='kalender.jsp?sprog=da'>dansk</a> - 
 <a href='kalender.jsp?sprog=de'>Deutsch</a> -
 <a href='kalender.jsp?sprog=eo'>Esperanto</a>]

<h1><%= s.ovs("Fælleskalender_for") %> <%= b.getDatostr() %></h1>

<a href="kalender.jsp?maaned=<%= b.getMaaned()-1 %>"><%= s.ovs("forrige") %></a>
  <%= s.ovs("måned") %> -
<a href="kalender.jsp?maaned=<%= b.getMaaned()+1 %>"><%= s.ovs("næste") %></a>
  <%= s.ovs("måned") %> -

<% 
  if (b.isRediger()) { // redigering - vis en input-formular
%>
  <a href="kalender.jsp?rediger=false"><%= s.ovs("vis") %></a>
    <%= s.ovs("kalenderen") %>.<br>
  <br>
  <form action="kalender.jsp" method="post">
    <%=s.ovs("Tryk_input_type_submit_value_OK_når_du_vil_gemme_ændringer")%>.<br>

    <% b.udskrivDagsprogram(out); %>

    <br><br>
    <%= s.ovs("_input_type_submit_value_OK_") %>
  </form>
<%
  } else {             // fremvisning
%>
  <a href="kalender.jsp?rediger=true"><%= s.ovs("redigér") %></a>
    <%= s.ovs("kalenderen") %>.<br>

  <% b.udskrivDagsprogram(out); %>
<%
  } 
%>

</body>
</html>

Sammenlign med kalender.jsp i afsnit 9.4.3 (ændringer er markeret med fed).

13.6 Yderligere læsning

Om internationalisering af JSP-sider:

http://java.sun.com/webservices/docs/1.3/tutorial/doc/WebI18N.html

Generelt om Java og internationalisering:

http://java.sun.com/docs/books/tutorial/i18n/

Liste over alle sprog- og landekoder kan du se i afsnit 13.1.4 og afsnit 13.2.

Stikordsregister