convention-plugin

【Struts2 Convention 插件】 Struts2 Convention 插件是从 Struts2.1 版本开始引入的一种零配置或少配置的框架插件，它的目标是通过约定优于配置的原则，简化Action、结果页面（如JSP、FreeMarker）和拦截器等的配置。以下是对这个插件的详细介绍： 1. **Action定位与命名约定** - 通过包名约定Action的位置，例如`com.example.actions.Products`对应`/products`的URL。 - 类名到URL的转换，如`MyAction`对应`my-action`。 2. **命名空间（Namespace）** - 包名被映射为命名空间，比如`com.example`可能对应`/example`的命名空间。 3. **SEO友好的URL** - 使用驼峰命名的Action在URL中会被转换为短横线分隔的形式，提升搜索引擎友好性。 4. **注解支持** - **Action注解**：用于标记Action类，可以定义Action的名称、方法等属性。 - **InterceptorRef注解**：指定Action使用哪些拦截器。 - **Result注解**：定义Action执行后的结果页面路径。 - **Namespace注解**：定义Action所在的命名空间。 - **ResultPath注解**：指定结果页面的默认路径。 - **ParentPackage注解**：继承自哪个包的配置。 - **ExceptionMapping注解**：异常映射，将特定异常映射到特定的结果。 5. **默认配置与扩展** - 默认Action：如果请求的URL没有明确的Action，Convention会尝试寻找默认Action。 - 结果页面默认路径：通常位于`WEB-INF/content`下，可通过`struts.convention.result.path`属性调整。 - 通过配置属性或覆盖类方法可以控制和扩展约定。 6. **在JAR文件中的Action** - 支持在JAR文件内定义Action，方便模块化开发。 7. **自动配置重载** - 支持配置文件的热更新，便于开发和调试。 8. **问题排查** - 提供了一些调试技巧和常见错误的解决办法。 安装和启用 Convention 插件，只需将JAR文件放入`WEB-INF/lib`目录或在Maven项目中添加依赖。对于RESTful应用，可以在`struts.xml`配置文件中设置相关常量，如`struts.convention.action.suffix`、`struts.convention.action.mapAllMatches`和`struts.convention.default.parent.package`。 9. **Hello World示例** - 创建一个简单的Action，例如`HelloWorldController`，并返回一个`hello-world`的结果。默认情况下，结果页面`hello-world.jsp`会被放在`WEB-INF/content`下。 通过以上介绍，我们可以看到Struts2 Convention插件极大地减少了XML配置，使开发更加便捷。开发者可以专注于业务逻辑，而不用花费大量时间在配置上。