Apache Turbine Fulcrum Localization服务组件指南

1. 项目目录结构及介绍

Apache Turbine Fulcrum Localization项目是专为实现字符串本地化设计的组件。以下是其基本的目录结构概览：

turbine-fulcrum-localization/
├── src
│   ├── main
│   │   ├── java     # 包含主要的源代码，如 LocalizationService 实现类
│   │   └── resources # 配置文件，可能包括默认的本地化资源文件
│   └── test         # 测试代码目录，包含单元测试等
├── pom.xml           # Maven项目配置文件，定义了依赖、构建过程等
├── README.md         # 项目简介和快速入门指南
└── other metadata files # 如LICENSE、NOTICE等ASF要求的文件

主要目录说明:

• src/main/java: 包含所有业务逻辑和实现本地化功能的核心类。
• src/main/resources: 存放配置文件以及本地化资源束，例如不同语言环境下的字符串翻译。
• src/test: 包括测试案例，确保代码质量。

2. 项目的启动文件介绍

由于该项目是作为Apache Turbine的一个组件，它本身不直接提供一个独立的应用启动文件。启动流程通常嵌入在使用该组件的应用中。一般情况下，使用Turbine框架时，会在应用的入口点（如Servlet容器中的Web应用）集成Turbine与Fulcrum的环境，然后通过Turbine的生命周期管理来初始化LocalizationService。不过，具体启动配置和服务注册可能分散在多个配置文件或代码初始化部分中，比如web.xml、Spring配置或Turbine的配置文件。

示例初始化步骤（非直接启动文件示例）

1. 配置Turbine: 确保Turbine框架已正确设置，且加入了Fulcrum Localization的依赖。
2. 配置本地化: 在应用的配置中添加类似下面的XML片段以配置默认语言和国家，以及本地化束。

   <localization locale-default-language="en" locale-default-country="US">
       <bundles>
           <bundle>org.apache.fulcrum.localization.BarBundle</bundle>
           <bundle>org.apache.fulcrum.localization.FooBundle</bundle>
       </bundles>
   </localization>
   

3. 角色配置: 在Turbine的角色配置中指定LocalizationService的实现类。

   <role name="org.apache.fulcrum.localization.LocalizationService" 
          shorthand="localization" 
          default-class="org.apache.fulcrum.localization.DefaultLocalizationService"/>
   

实际启动是通过启动你的Java Web应用程序完成的，这可能涉及到运行Tomcat或其他Servlet容器。

3. 项目的配置文件介绍

• 主配置文件: 虽然具体的配置文件名和位置可以因应用而异，但关键的配置通常位于Turbine的配置体系内。上述提到的 <localization> 标签一般放在Turbine的环境配置文件中，如turbine.properties或特定的XML配置文件中，用于设定默认的本地化环境。

• 本地化资源文件: 不是单一文件，而是一系列特定命名规则的.properties文件，存储于类路径下。每个文件对应不同的语言区域，比如messages_en.properties用于英语环境，里面包含键值对用于本地化的字符串。

确保将这些配置正确地融入您的应用配置之中，才能使Apache Turbine Fulcrum Localization组件正常工作。