动态更改 WebSphere Portal 中的的语言

本文描述如何实现通过一次点击动态更改 WebSphere Portal 中的语言的逻辑。

引言

WebSphere Portal V4 和 V5 中的内容显示语言是由用户首选语言或系统的位置驱动的。WebSphere Portal 不允许您在活动的会话期间更改您的语言首选项。本文描述如何实现通过一次点击动态更改 WebSphere Portal 中的语言的逻辑。其主要的好处在于没有更改概要中用户的首选语言。在用户会话到期和用户重新登录到 WebSphere Portal，它会根据用户的概要语言呈现内容。

 

回页首

 

确定显示语言

WebSphere Portal 通过一个选择过程来确定呈现门户内容的语言，其顺序如下：

• WebSphere Portal 用首选语言来显示内容，首选语言存储在存储库 (LDAP) 内的用户概要中。
• 如果用户概要中没有首选语言，WebSphere Portal 就查找用户的浏览器（本地）中所定义的语言，并用该语言显示内容。
• 如果上述语言都不存在，WebSphere Portal 就使用缺省语言。缺省语言是英语。
• Portlet 基于自身处理多语言支持的能力来显示内容。

选择首选语言

您可以在注册过程中选择用于呈现门户内容的首选语言。您有从可用语言列表中选择语言的选项。您可以通过选择 Edit my profile来更改在 WebSphere Portal 的“self care”功能中选定的语言。

您不能在没有更改您的概要的情况下切换 WebSphere Portal 显示语言。用户首选语言中的更改会影响 LDAP 属性中的更改，并且这是用户概要中的永久性更改。这种更改会反映在其他同样使用 LDAP 进行身份验证和授权的应用程序中。

对于一些国家（如加拿大），支持英语和法语双语是通常的惯例。这就需要在 WebSphere Portal 中增加一个新的功能，使用该功能，您能够通过点击一个按钮来更改显示语言（英语与法语）。这种更改在会话期间起作用，并且不会覆盖轻量级目录访问协议（Lightweight Directory Access Protocol，LDAP）内的用户概要中的用户首选语言。

• 通常，您可以在 WebSphere Portal 中实现自定义功能，方法是编写 Portlet，或者在主题中添加逻辑。然而，这两种方法都不会显式地动态更改语言选择。您不能通过点击显示条上的按钮来调用 Portlet，因为您只能将 Portlet 部署到页面。Portlet 逻辑由 WebSphere Portal 的运行时页面容器执行。
• 您不能在浏览器中将 url 从主题直接重定向到重新加载门户内容来进行动态语言选择。虽然有其他的解决方案来处理这个问题，但是并没有提供一个简洁而可接受的解决方案。另外，由于 WebSphere Portal 框架中的限制，我们难以实现其他的解决方案。

对现有解决方案的评估引出了另一个实现动态语言支持的选择，在下一部分中，我们将对此进行讨论。

 

回页首

 

推荐的解决方案

您可以更改 HttpSession 中的语言首选项。只有激活会话之前进行这样的更改才是有效的。下面的解决方案是一个更好的选择，而且比较容易实现：

1. 单击主题中的语言更改按钮，这将调用主题 (Banner.jsp) 中的 JSP (LanguageChange.jsp)。图 1 显示了 WebSphere Portal 中的动态语言更改行为。
   图 1. 动态语言更改
   
2. 将以下代码添加到特定主题目录中的 Banner.jsp，以添加一个语言按钮。下面的代码显示了基于当前会话语言的“English”或“French”按钮：

   <% if(preferredLang.equals("en")){ %> <wps:if loggedIn="yes"><ahref="/wps/LanguageChange/LanguageChange.jsp"> <img align="top" border="0" alt='<wps:text key="title" bundle="nls.engine">Francais</wps:text>' title='<wps:text key="title" bundle="nls.engine">Francais</wps:text>' src='<wps:urlFindInTheme File="b_francais.gif"/>' <% } else { %> <wps:if loggedIn="yes"><a href="/wps/LanguageChange/LanguageChange.jsp"> <img align="top" border="0" alt='<wps:text key="title" bundle="nls.engine">English</wps:text>' title='<wps:text key="title" bundle="nls.engine">English</wps:text>' src='<wps:urlFindInTheme File="b_english.gif"/>' <% } %>

   
   在 Default.jsp 中已经声明好了 preferredLang 变量。现在添加下面的代码，以从会话中检索 preferredLang ：

   <%@ page session="false" buffer="none" %> <%@ page import="javax.servlet.http.HttpServletRequest" %> <%@ page import="javax.servlet.http.HttpServletResponse" %> <%@ page import="javax.servlet.http.HttpSession" %> <%@ page import="java.util.Locale" %> <%@ page import="java.util.StringTokenizer" %> <%@ page import="com.ibm.wps.puma.User" %> <!-- <%@ page import="com.ibm.wps.puma.UserWrapper" %> uncomment this line for WebSphere Portal Version 5.x --> <% Locale locale[] = null; HttpSession session = request.getSession(); User user =( User)session.getAttribute("com.ibm.wps.util.session_user"); // In WebSphere Portal Version 5.x, use the following code to get language //UserWrapper userWrapper =new UserWrapper(user); //String preferredLang = userWrapper.getAttributeNotNull("preferredLanguage"); try { locale = user.getPreferredLanguage(); } catch(Exception e) { System.out.println("ERROR in jsp: " + e.toString()); } String preferredLang = locale[0].getLanguage(); %>

3. LanguageChange.jsp 基于当前值改变 HTTPSession 中的用户首选语言。一旦该语言发生改变，JSP 就将用户重新定向到 WebSphere Portal。图 2 显示 WebSphere Portal 已经用法语重新组织了它的内容。
   图 2. 法语版本
   

• LanguageChange.jsp 必须驻留在 WPS.war 文件 WPS_HOME/lib/wps.ear/wps.war/LanguageChange/ 中，因此它可以共享 HTTPSession。LanguageChange.jsp 的源代码如下：

  <%@ page session="false" buffer="100" %> <%@ page import="com.ibm.wps.turbine.om.security.IBMTurbineUser" %> <%@ page import="javax.servlet.http.HttpServletRequest" %> <%@ page import="javax.servlet.http.HttpServletResponse" %> <%@ page import="javax.servlet.http.HttpSession" %> <%@ page import="java.util.Locale" %> <%@ page import="java.util.StringTokenizer" %> <% Locale locale[] = null; HttpSession session = request.getSession(); IBMTurbineUser user = (IBMTurbineUser)session.getAttribute("wps.engine.user"); try { locale = user.getPreferredLanguage(); } catch(Exception e) { System.out.println("ERROR in jsp: " + e.toString()); } String preferredLang = locale[0].getLanguage(); if (preferredLang.equals("en") ){ user.setPreferredLanguage("fr"); } else { user.setPreferredLanguage("en"); } String url = "http://shergilli.torolab.ibm.com/wps/myportal"; response.sendRedirect(url); %>

• 在上面的方案中，用户通过点击一个按钮来切换 WebSphere Portal 的显示语言，而不需要更新用户存储库 (LDAP) 中的用户概要。

   

  回页首

   

  1. 结束语
  2. 本文讨论了如何在 WebSphere Portal 中实现支持动态语言的逻辑。通过使用一种易于实现和维护的选择，您可以通过点击按钮来更改显示语言，而不需要对用户概要文件进行永久性的更改。您还可以将这种概念用于自定义，在自定义中，您能够执行 WebSphere Portal 框架以外的自定义代码。