Apache Tapestry 5 开源项目教程

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

Apache Tapestry 5 的目录结构遵循标准的 Maven 项目结构，主要目录和文件如下：

• src/main/java：包含项目的 Java 源代码。
• src/main/resources：包含项目的资源文件，如配置文件、模板文件等。
• src/test/java：包含项目的测试代码。
• src/test/resources：包含测试所需的资源文件。
• pom.xml：Maven 项目的配置文件，定义了项目的依赖、构建配置等。

2. 项目的启动文件介绍

Tapestry 5 项目的启动文件通常是一个 Java 类，该类继承自 org.apache.tapestry5.TapestryFilter 并配置在 web.xml 中。以下是一个典型的启动文件示例：

package com.example.myapp;

import org.apache.tapestry5.TapestryFilter;
import javax.servlet.ServletContext;
import javax.servlet.ServletException;

public class AppModule {
    public static void contributeApplicationDefaults(MappedConfiguration<String, String> configuration) {
        configuration.add("tapestry.app-package", "com.example.myapp");
    }
}

在 web.xml 中配置 TapestryFilter：

<filter>
    <filter-name>app</filter-name>
    <filter-class>org.apache.tapestry5.TapestryFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>app</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

3. 项目的配置文件介绍

Tapestry 5 的配置文件主要包括 web.xml 和 AppModule.java。

web.xml

web.xml 是标准的 Servlet 配置文件，用于配置 Servlet 过滤器、监听器等。在 Tapestry 5 项目中，主要配置 TapestryFilter：

<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/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
    version="3.1">

    <filter>
        <filter-name>app</filter-name>
        <filter-class>org.apache.tapestry5.TapestryFilter</filter-class>
    </filter>

    <filter-mapping>
        <filter-name>app</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

</web-app>

AppModule.java

AppModule.java 是 Tapestry 5 的模块配置文件，用于配置应用程序的默认设置、服务等。以下是一个简单的示例：

package com.example.myapp;

import org.apache.tapestry5.ioc.MappedConfiguration;
import org.apache.tapestry5.ioc.ServiceBinder;

public class AppModule {
    public static void contributeApplicationDefaults(MappedConfiguration<String, String> configuration) {
        configuration.add("tapestry.app-package", "com.example.myapp");
    }

    public static void bind(ServiceBinder binder) {
        binder.bind(MyService.class, MyServiceImpl.class);
    }
}

以上内容涵盖了 Apache Tapestry 5 项目的基本目录结构、启动文件和配置文件的介绍。希望这些信息对您有所帮助。