SiteMesh 3 项目教程

SiteMesh 3 项目教程

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

SiteMesh 3 是一个用于页面布局和装饰的框架，其目录结构如下：

sitemesh3/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── org/
│   │   │       └── sitemesh/
│   │   │           ├── filter/
│   │   │           ├── html/
│   │   │           ├── io/
│   │   │           ├── parser/
│   │   │           ├── sitemesh/
│   │   │           └── util/
│   │   └── resources/
│   │       └── META-INF/
│   └── test/
│       ├── java/
│       │   └── org/
│       │       └── sitemesh/
│       └── resources/
├── build.gradle
├── gradlew
├── gradlew.bat
├── settings.gradle
└── README.md

目录结构介绍

• src/main/java/org/sitemesh/: 包含SiteMesh的核心代码，包括过滤器、HTML解析器、工具类等。
• src/main/resources/META-INF/: 包含项目的配置文件。
• src/test/java/org/sitemesh/: 包含测试代码。
• build.gradle: Gradle构建脚本。
• gradlew 和 gradlew.bat: Gradle包装器脚本。
• settings.gradle: Gradle设置文件。
• README.md: 项目说明文档。

2. 项目的启动文件介绍

SiteMesh 3 的启动主要依赖于配置文件和过滤器。以下是主要的启动文件：

web.xml

在 web.xml 中配置SiteMesh过滤器：

<web-app>
    <filter>
        <filter-name>sitemesh</filter-name>
        <filter-class>org.sitemesh.config.ConfigurableSiteMeshFilter</filter-class>
    </filter>
    <filter-mapping>
        <filter-name>sitemesh</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>
</web-app>

ConfigurableSiteMeshFilter

ConfigurableSiteMeshFilter 是SiteMesh的核心过滤器，负责拦截请求并应用装饰器。

3. 项目的配置文件介绍

SiteMesh 3 的配置文件主要包括 web.xml 和 sitemesh3.xml。

web.xml

如上所述，web.xml 中配置了SiteMesh过滤器。

sitemesh3.xml

在 WEB-INF/sitemesh3.xml 中配置装饰器：

<sitemesh>
    <mapping decorator="/default-decorator.html"/>
    <mapping path="/admin/*" decorator="/another-decorator.html"/>
</sitemesh>

配置文件介绍

• web.xml: 配置SiteMesh过滤器，拦截所有请求。
• sitemesh3.xml: 配置装饰器路径和对应的装饰器文件。

通过以上配置，SiteMesh 3 可以拦截请求并应用相应的装饰器，实现统一的页面布局和外观。