项目集成koala i18n组件

最新推荐文章于 2025-08-20 15:04:37 发布

转载最新推荐文章于 2025-08-20 15:04:37 发布 · 177 阅读

0 ·

CC 4.0 BY-SA版权

原文链接：https://my.oschina.net/xiaokaceng/blog/282657

文章标签：

#java #python #web.xml

本文介绍如何在Maven项目中集成Koala平台的i18n国际化组件，包括添加依赖、配置文件及JSP页面应用等步骤。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

2019独角兽企业重金招聘Python工程师标准>>>

Koala平台的i18n组件是基于Maven的项目模块，最方便的集成是项目也使用Maven，war项目集成会稍显麻烦

Maven项目集成

添加仓库

<repositories>
		<repository>
			<id>koala-releases</id>
			<url>http://nexus.openkoala.org/content/repositories/public-releases/</url>
			<releases>
				<enabled>true</enabled>
			</releases>
			<snapshots>
				<enabled>false</enabled>
			</snapshots>
		</repository>
		<repository>
			<id>koala-snapshots</id>
			<url>http://nexus.openkoala.org/content/repositories/public-snapshots/</url>
			<releases>
				<enabled>false</enabled>
			</releases>
			<snapshots>
				<enabled>true</enabled>
			</snapshots>
		</repository>
	</repositories>

添加依赖

<dependency>
	<groupId>org.openkoala.koalacommons</groupId>
	<artifactId>koala-commons-i18n</artifactId>
	<version>3.0.0</version>
   </dependency>

创建i18n.tld文件

在WEB-INF目录下创建i18n.tld

<?xml version="1.0" encoding="UTF-8" ?>

<taglib xmlns="http://java.sun.com/xml/ns/j2ee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd"
    version="2.0">
    
  <tlib-version>1.1</tlib-version>
  <short-name>i18n</short-name>
  <uri>http://www.openkoala.org/i18n</uri>

  <tag>
    <name>i18n</name>
    <tag-class>org.openkoala.framework.i18n.tag.I18nTag</tag-class>
    <body-content>empty</body-content>
    <attribute>
        <name>key</name>
        <required>true</required>
        <rtexprvalue>true</rtexprvalue>
    </attribute>
    <attribute>
        <name>locale</name>
        <required>false</required>
        <rtexprvalue>true</rtexprvalue>
    </attribute>
  </tag>
</taglib>

配置web.xml

<jsp-config>
		<taglib>
			<taglib-uri>http://www.openkoala.org/i18n</taglib-uri>
			<taglib-location>/WEB-INF/i18n.tld</taglib-location>
		</taglib>
	</jsp-config>

创建资源文件

在类路径下创建i18n目录，资源文件名称必须是xxxx_语言_国家(大写).properties，内容是key-value键值对

如：test_zh_CN.properties

test_en_US.properties

i18n目录下可以按业务模块创建子目录，这样可以使资源文件内容分散到各个模块

应用JSP页面

创建i18n.jsp页面

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ taglib uri="http://www.openkoala.org/i18n" prefix="koala" %>
<!DOCTYPE html>
<html>
<head>
<title>I18N</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body>
I18N:<koala:i18n key="test" />
</body>
</html>

效果：