Apache Tapestry 5 项目教程

1. 项目的目录结构及介绍

Apache Tapestry 5 项目的目录结构遵循标准的 Maven 项目结构，主要包含以下几个部分：

• src/main/java: 存放 Java 源代码文件。
• src/main/resources: 存放项目的资源文件，如配置文件、模板文件等。
• src/test/java: 存放测试代码文件。
• src/test/resources: 存放测试资源文件。
• pom.xml: Maven 项目配置文件，定义了项目的依赖、插件等。

目录结构示例

tapestry-5
├── pom.xml
├── src
│   ├── main
│   │   ├── java
│   │   │   └── org
│   │   │       └── example
│   │   │           └── AppModule.java
│   │   └── resources
│   │       └── log4j.properties
│   └── test
│       ├── java
│       │   └── org
│       │       └── example
│       │           └── AppTest.java
│       └── resources
│           └── test.properties

2. 项目的启动文件介绍

在 Apache Tapestry 5 项目中，启动文件通常是一个 Java 类，用于配置和启动应用。以下是一个典型的启动文件示例：

AppModule.java

package org.example;

import org.apache.tapestry5.ioc.MappedConfiguration;
import org.apache.tapestry5.ioc.ServiceBinder;
import org.apache.tapestry5.ioc.annotations.Contribute;
import org.apache.tapestry5.ioc.services.ApplicationDefaults;
import org.apache.tapestry5.ioc.services.SymbolProvider;

public class AppModule {

    public static void bind(ServiceBinder binder) {
        // 绑定服务
        binder.bind(MyService.class, MyServiceImpl.class);
    }

    @Contribute(SymbolProvider.class)
    @ApplicationDefaults
    public static void contributeApplicationDefaults(MappedConfiguration<String, String> configuration) {
        // 配置应用默认值
        configuration.add("tapestry.app-package", "org.example");
        configuration.add("tapestry.supported-locales", "en");
    }
}

3. 项目的配置文件介绍

Apache Tapestry 5 项目的配置文件主要包含以下几种：

• pom.xml: Maven 项目配置文件，定义了项目的依赖、插件等。
• log4j.properties: 日志配置文件，用于配置日志输出格式和级别。
• web.xml: Web 应用部署描述符，定义了 Servlet 和 Filter 的配置。

pom.xml

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>org.example</groupId>
    <artifactId>tapestry-app</artifactId>
    <version>1.0-SNAPSHOT</version>
    <dependencies>
        <dependency>
            <groupId>org.apache.tapestry</groupId>
            <artifactId>tapestry-core</artifactId>
            <version>5.8.6</version>
        </dependency>
    </dependencies>
</project>

log4j.properties

log4j.rootLogger=INFO, stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d %p [%c] - %m%n

web.xml

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/