localization.html

turbine教程

 
<P>

<!-- ============ FIELD DETAIL =========== -->


<!-- ========= CONSTRUCTOR DETAIL ======== -->

<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="Localization()"><!-- --></A><H3>
Localization</H3>
<PRE>
public <B>Localization</B>()</PRE>
<DL>
</DL>

<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Method Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="getString(java.lang.String, java.util.Locale, java.lang.String)"><!-- --></A><H3>
getString</H3>
<PRE>
public static java.lang.String <B>getString</B>(java.lang.String&nbsp;bundleName,
                                         java.util.Locale&nbsp;locale,
                                         java.lang.String&nbsp;key)</PRE>
<DL>
<DD>Fetches the localized text from the specified bundle, ignoring
 any default bundles.<DD><DL>
<DT><B>See Also: </B><DD><A HREF="../../../../../org/apache/turbine/services/localization/LocalizationService.html#getString(java.lang.String, java.util.Locale, java.lang.String)"><CODE>LocalizationService.getString(String, Locale, String)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getString(java.lang.String)"><!-- --></A><H3>
getString</H3>
<PRE>
public static java.lang.String <B>getString</B>(java.lang.String&nbsp;key)</PRE>
<DL>
<DD>Pulls a string out of the LocalizationService with the default
 locale values of what is defined in the
 TurbineResources.properties file for the
 locale.default.language and locale.default.country property
 values.  If those cannot be found, then the JVM defaults are
 used.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>key</CODE> - Name of string.<DT><B>Returns:</B><DD>A localized String.</DL>
</DD>
</DL>
<HR>

<A NAME="getString(java.lang.String, java.util.Locale)"><!-- --></A><H3>
getString</H3>
<PRE>
public static java.lang.String <B>getString</B>(java.lang.String&nbsp;key,
                                         java.util.Locale&nbsp;locale)</PRE>
<DL>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>key</CODE> - Name of the text to retrieve.<DD><CODE>locale</CODE> - Locale to get text for.<DT><B>Returns:</B><DD>Localized text.</DL>
</DD>
</DL>
<HR>

<A NAME="getString(java.lang.String, javax.servlet.http.HttpServletRequest)"><!-- --></A><H3>
getString</H3>
<PRE>
public static java.lang.String <B>getString</B>(java.lang.String&nbsp;key,
                                         javax.servlet.http.HttpServletRequest&nbsp;req)</PRE>
<DL>
<DD>Pulls a string out of the LocalizationService and attempts to
 determine the Locale by the Accept-Language header.  If that
 header is not present, it will fall back to using the locale
 values of what is defined in the TurbineResources.properties
 file for the locale.default.language and locale.default.country
 property values.  If those cannot be found, then the JVM
 defaults are used.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>req</CODE> - HttpServletRequest information.<DD><CODE>key</CODE> - Name of string.<DT><B>Returns:</B><DD>A localized String.</DL>
</DD>
</DL>
<HR>

<A NAME="getString(java.lang.String, java.lang.String)"><!-- --></A><H3>
getString</H3>
<PRE>
public static java.lang.String <B>getString</B>(java.lang.String&nbsp;key,
                                         java.lang.String&nbsp;lang)</PRE>
<DL>
<DD>Convenience method that pulls a localized string off the
 LocalizationService using the default ResourceBundle name
 defined in the TurbineResources.properties file and the
 specified language name in ISO format.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>key</CODE> - Name of string.<DD><CODE>lang</CODE> - Desired language for the localized string.<DT><B>Returns:</B><DD>A localized string.</DL>
</DD>
</DL>
<HR>

<A NAME="getBundle(java.lang.String)"><!-- --></A><H3>
getBundle</H3>
<PRE>
public static java.util.ResourceBundle <B>getBundle</B>(java.lang.String&nbsp;bundleName)</PRE>
<DL>
<DD>Convenience method to get a ResourceBundle based on name.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>bundleName</CODE> - Name of bundle.<DT><B>Returns:</B><DD>A localized ResourceBundle.</DL>
</DD>
</DL>
<HR>

<A NAME="getBundle(java.lang.String, java.lang.String)"><!-- --></A><H3>
getBundle</H3>
<PRE>
public static java.util.ResourceBundle <B>getBundle</B>(java.lang.String&nbsp;bundleName,
                                                 java.lang.String&nbsp;languageHeader)</PRE>
<DL>
<DD>Convenience method to get a ResourceBundle based on name and
 HTTP Accept-Language header.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>bundleName</CODE> - Name of bundle.<DD><CODE>languageHeader</CODE> - A String with the language header.<DT><B>Returns:</B><DD>A localized ResourceBundle.</DL>
</DD>
</DL>
<HR>

<A NAME="getBundle(javax.servlet.http.HttpServletRequest)"><!-- --></A><H3>
getBundle</H3>
<PRE>
public static java.util.ResourceBundle <B>getBundle</B>(javax.servlet.http.HttpServletRequest&nbsp;req)</PRE>
<DL>
<DD>Convenience method to get a ResourceBundle based on name and
 HTTP Accept-Language header in HttpServletRequest.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>req</CODE> - HttpServletRequest.<DT><B>Returns:</B><DD>A localized ResourceBundle.</DL>
</DD>
</DL>
<HR>

<A NAME="getBundle(java.lang.String, javax.servlet.http.HttpServletRequest)"><!-- --></A><H3>
getBundle</H3>
<PRE>
public static java.util.ResourceBundle <B>getBundle</B>(java.lang.String&nbsp;bundleName,
                                                 javax.servlet.http.HttpServletRequest&nbsp;req)</PRE>
<DL>
<DD>Convenience method to get a ResourceBundle based on name and
 HTTP Accept-Language header in HttpServletRequest.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>bundleName</CODE> - Name of bundle.<DD><CODE>req</CODE> - HttpServletRequest.<DT><B>Returns:</B><DD>A localized ResourceBundle.</DL>
</DD>
</DL>
<HR>

<A NAME="getBundle(java.lang.String, java.util.Locale)"><!-- --></A><H3>
getBundle</H3>
<PRE>
public static java.util.ResourceBundle <B>getBundle</B>(java.lang.String&nbsp;bundleName,
                                                 java.util.Locale&nbsp;locale)</PRE>
<DL>
<DD>Convenience method to get a ResourceBundle based on name and
 Locale.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>bundleName</CODE> - Name of bundle.<DD><CODE>locale</CODE> - A Locale.<DT><B>Returns:</B><DD>A localized ResourceBundle.</DL>
</DD>
</DL>
<HR>

<A NAME="setBundle(java.lang.String)"><!-- --></A><H3>
setBundle</H3>
<PRE>
public static void <B>setBundle</B>(java.lang.String&nbsp;defaultBundle)</PRE>
<DL>
<DD>This method sets the name of the default bundle.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>defaultBundle</CODE> - Name of default bundle.</DL>
</DD>
</DL>
<HR>

<A NAME="getLocale(javax.servlet.http.HttpServletRequest)"><!-- --></A><H3>
getLocale</H3>
<PRE>
public static java.util.Locale <B>getLocale</B>(javax.servlet.http.HttpServletRequest&nbsp;req)</PRE>
<DL>
<DD>Attempts to pull the <code>Accept-Language</code> header out of
 the HttpServletRequest object and then parse it.  If the header
 is not present, it will return a null Locale.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>req</CODE> - HttpServletRequest.<DT><B>Returns:</B><DD>A Locale.</DL>
</DD>
</DL>
<HR>

<A NAME="getLocale(java.lang.String)"><!-- --></A><H3>
getLocale</H3>
<PRE>
public static java.util.Locale <B>getLocale</B>(java.lang.String&nbsp;languageHeader)</PRE>
<DL>
<DD>This method parses the <code>Accept-Language</code> header and
 attempts to create a Locale out of it.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>languageHeader</CODE> - A String with the language header.<DT><B>Returns:</B><DD>A Locale.</DL>
</DD>
</DL>
<HR>

<A NAME="getDefaultBundleName()"><!-- --></A><H3>
getDefaultBundleName</H3>
<PRE>
public static java.lang.String <B>getDefaultBundleName</B>()</PRE>
<DL>
<DD><DL>
<DT><B>See Also: </B><DD><CODE>org.apache.turbine.services.localization.LocalizationService#getDefaultBundle()</CODE></DL>
</DD>
</DL>
<HR>

<A NAME="getService()"><!-- --></A><H3>
getService</H3>
<PRE>
protected static final <A HREF="../../../../../org/apache/turbine/services/localization/LocalizationService.html">LocalizationService</A> <B>getService</B>()</PRE>
<DL>
<DD>Gets the <code>LocalizationService</code> implementation.<DD><DL>
<DT><B>Returns:</B><DD>the LocalizationService implementation.</DL>
</DD>
</DL>
<HR>

<A NAME="getString(org.apache.turbine.util.RunData, java.lang.String)"><!-- --></A><H3>
getString</H3>
<PRE>
public static java.lang.String <B>getString</B>(<A HREF="../../../../../org/apache/turbine/util/RunData.html">RunData</A>&nbsp;data,
                                         java.lang.String&nbsp;key)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<I>Call getString(data.getRequest()) instead.</I>
<P>
</DL>
<HR>

<A NAME="getBundle(java.lang.String, org.apache.turbine.util.RunData)"><!-- --></A><H3>
getBundle</H3>
<PRE>
public static java.util.ResourceBundle <B>getBundle</B>(java.lang.String&nbsp;bundleName,
                                                 <A HREF="../../../../../org/apache/turbine/util/RunData.html">RunData</A>&nbsp;data)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<I>Call getBundle(bundleName, data.getRequest()) instead.</I>
<P>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>

<!-- ========== START OF NAVBAR ========== -->
<A NAME="navbar_bottom"><!-- --></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/Localization.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../../../org/apache/turbine/services/localization/LocaleTokenizer.html"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../../../org/apache/turbine/services/localization/LocalizationTool.html"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="Localization.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  SUMMARY: &nbsp;INNER&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: &nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<!-- =========== END OF NAVBAR =========== -->

<HR>
Copyright &copy; 2000-2002 Apache Software Foundation. All Rights Reserved.
</BODY>
</HTML>