手册

概述

框架核心（Core）

核心概述包类的自动扫描（AutoScan）依赖注入（IoC）方法拦截（AOP）记录类属性状态 (PropertyState) 事件服务（Event）模块（Module）国际化（I18N） Lang

配置体系(Configuration

配置体系概述配置体系目录结构及配置示例一：解析XML配置示例二：解析Properties配置配置体系模块更多操作

日志(log)

日志概述日志模块配置使用示例

持久化(Persistence)

JDBC持久化概述及模块配置数据源（DataSource）数据实体（Entity）自动生成实体类（方式一）自动生成实体类（方式二）事务（Transaction）会话（Session）数据实体操作结果集（ResultSet）查询（Query）存储器（Repository）高级特性—多表查询及自定义结果集数据处理高级特性—存储过程调用与结果集数据处理高级特性—数据库锁操作

插件（Plugin）

插件概述插件工厂自定义插件工厂插件结构插件的实现及使用

服务(Serv)

服务概述服务端（Server）示例客户端（Client）示例客户端和服务端对象的使用

验证（Validation）

验证概述默认验证器及参数说明默认国际化资源文件内容验证框架使用示例自定义验证器

缓存（Cache）

缓存概述缓存模块配置缓存模块使用示例

WebMVC

WebMVC概述模块初始化及配置说明控制器（Controller）控制器参数（Parameter）环境上下文对象（WebContext）文件上传（Upload）视图（View）验证（Validation）缓存（Cache）拦截器（Intercept） Cookies操作国际化（I18N）约定模式（Convention Mode）高级特性—控制器请求处理器高级特性—异常错误处理器

首页后端开发 Java YMP在线手册

缓存（Cache）

阅读11891

更新时间2022-04-11

验证（Validation）

拦截器（Intercept）

集成缓存模块

WebMVC模块已集成缓存模块，通过@Cacheable注解即可轻松实现控制器方法的缓存，通过配置缓存模块的scope_processor_class参数可以支持APPLICATION和SESSION作用域；

# 设置缓存作用域处理器
ymp.configs.cache.scope_processor_class=net.ymate.platform.webmvc.support.WebCacheScopeProcessor

示例代码：将方法执行结果以会话(SESSION)级别缓存180秒；

    @Controller
    @RequestMapping("/demo")
    @Cacheable
    public class CacheController {

        @RequestMapping("/cache")
        @Cacheable(scope = ICaches.Scope.SESSION, timeout = 180)
        public IView doCacheable(@RequestParam String content) throws Exception {
            // ......
            return View.textView("Content: " + content);
        }
    }

注意：基于@Cacheable的方法缓存只是缓存控制器方法返回的结果对象，并不能缓存IView视图的最终执行结果；

自定义缓存处理器

WebMVC模块提供了缓存处理器IWebCacheProcessor接口，可以让开发者通过此接口对控制器执行结果进行最终处理，该接口作用于被声明@ResponseCache注解的控制器类和方法上；

说明: 框架提供IWebCacheProcessor接口默认实现net.ymate.platform.webmvc.support.WebCacheProcessor用以缓存视图执行结果，
但需要注意的是当使用它时, 请检查web.xml的过滤器DispatchFilter中不要配置INCLUDE，否则将会产生死循环；

@ResponseCache注解参数说明：

cacheName：缓存名称, 可选参数, 默认值为default；
key：缓存Key, 可选参数, 若未设置则由IWebCacheProcessor接口实现自动生成；
processorClass：自定义视图缓存处理器, 可选参数，若未提供则采用默认IWebCacheProcessor接口参数配置；
scope：缓存作用域, 可选参数，可选值为APPLICATION、SESSION和DEFAULT，默认为DEFAULT；
timeout：缓存数据超时时间, 可选参数，数值必须大于等于0，为0表示默认缓存300秒；
useGZip：是否使用GZIP压缩, 默认值为true

默认IWebCacheProcessor接口参数配置：

# 缓存处理器，可选参数
ymp.configs.webmvc.cache_processor_class=demo.WebCacheProc

框架默认提供了该接口的实现类：net.ymate.platform.webmvc.support.WebCacheProcessor
基于Cache缓存模块使其对@ResponseCache注解中的Scope.DEFAULT作用域支持Last-Modified等浏览器相关配置，并支持GZIP压缩等特性

示例代码：

package demo;

import net.ymate.platform.webmvc.*;
import net.ymate.platform.webmvc.view.IView;

public class WebCacheProc implements IWebCacheProcessor {
    public boolean processResponseCache(IWebMvc owner, ResponseCache responseCache, IRequestContext requestContext, IView resultView) throws Exception {
        // 这里是对View视图自定义处理逻辑...
        // 完整的示例代码请查看net.ymate.platform.webmvc.support.WebCacheProcessor类源码
        return false;
    }
}

@Controller
@RequestMapping("/demo")
public class CacheController {

    @RequestMapping("/cache")
    @ResponseCache
    public IView doCacheable(@RequestParam String content) throws Exception {
        // ......
        return View.textView("Content: " + content);
    }
}

说明：该接口方法返回布尔值，用于通知WebMVC框架是否继续处理控制器视图；

验证（Validation）

拦截器（Intercept）