net.ymate.platform.webmvc.IWebMvcModuleCfg Maven / Gradle / Ivy

Go to download
/*
 * Copyright 2007-2017 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package net.ymate.platform.webmvc;

import net.ymate.platform.webmvc.base.Type;
import org.apache.commons.fileupload.ProgressListener;

import java.util.Set;

/**
 * WebMVC模块配置接口
 *
 * @author 刘镇 ([email protected]) on 15/5/28 下午1:33
 * @version 1.0
 */
public interface IWebMvcModuleCfg {

    /**
     * @return 控制器请求处理器，可选值为已知处理器名称或自定义处理器类名称，默认为default，目前支持已知处理器[default|json|xml|...]
     */
    IRequestProcessor getRequestProcessor();

    /**
     * @return 异常错误处理器，可选参数
     */
    IWebErrorProcessor getErrorProcessor();

    /**
     * @return 缓存处理器，可选参数
     */
    IWebCacheProcessor getCacheProcessor();

    /**
     * @return 默认字符编码集设置，可选参数，默认值为UTF-8
     */
    String getDefaultCharsetEncoding();

    /**
     * @return 请求忽略正则表达式，可选参数，默认值为^.+\.(jsp|jspx|png|gif|jpg|jpeg|js|css|swf|ico|htm|html|eot|woff|ttf|svg)$
     */
    String getRequestIgnoreRegex();

    /**
     * @return 请求方法参数名称，可选参数， 默认值为_method
     */
    String getRequestMethodParam();

    /**
     * @return 请求路径前缀，可选参数，默认值为空
     */
    String getRequestPrefix();

    /**
     * @return 控制器视图文件基础路径（必须是以 '/' 开始和结尾，默认值为/WEB-INF/templates/）
     */
    String getBaseViewPath();

    /**
     * @return 尽量返回控制器视图绝对路径
     */
    String getAbstractBaseViewPath();

    /**
     * @return Cookie键前缀，可选参数，默认值为空
     */
    String getCookiePrefix();

    /**
     * @return Cookie作用域，可选参数，默认值为空
     */
    String getCookieDomain();

    /**
     * @return Cookie作用路径，可选参数，默认值为'/'
     */
    String getCookiePath();

    /**
     * @return Cookie密钥，可选参数，默认值为空
     */
    String getCookieAuthKey();

    /**
     * @return Cookie密钥验证是否默认开启, 默认值为false
     */
    boolean isDefaultEnabledCookieAuth();

    /**
     * @return 文件上传临时目录，为空则默认使用：System.getProperty("java.io.tmpdir")
     */
    String getUploadTempDir();

    /**
     * @return 上传文件大小最大值（字节），默认值：-1（注：10485760 = 10M）
     */
    int getUploadFileSizeMax();

    /**
     * @return 上传文件总量大小最大值（字节）, 默认值：-1（注：10485760 = 10M）
     */
    int getUploadTotalSizeMax();

    /**
     * @return 内存缓冲区的大小，默认值： 10240字节（=10K），即如果文件大于10K，将使用临时文件缓存上传文件
     */
    int getUploadSizeThreshold();

    /**
     * @return 文件上传状态监听器
     */
    ProgressListener getUploadFileListener();

    /**
     * @return 是否开启视图自动渲染（约定优于配置，无需编写控制器代码，直接匹配并执行视图）模式，可选参数，默认值为false
     */
    boolean isConventionMode();

    /**
     * @return Convention模式开启时是否采用URL伪静态(URL中通过分隔符'_'传递多个请求参数，通过_path[index]方式引用参数值)模式，可选参数，默认值为false
     */
    boolean isConventionUrlrewriteMode();

    /**
     * @return Convention模式开启时是否采用拦截器规则设置，可选参数，默认值为false
     */
    boolean isConventionInterceptorMode();

    /**
     * @return Convention模式开启时视图文件路径(基于base_view_path的相对路径, 加号或无符串代表允许访问)，可选参数，默认值为空(即不限制访问路径)，多个路径间用'|'分隔
     */
    Set getConventionViewAllowPaths();

    /**
     * @return Convention模式开启时视图文件路径(基于base_view_path的相对路径, 减号代表不允许访问)，可选参数，默认值为空(即不限制访问路径)，多个路径间用'|'分隔
     */
    Set getConventionViewNotAllowPaths();

    /**
     * @return 请求参数转义模式是否开启（开启状态时，控制器方法的所有参数将默认支持转义，可针对具体控制器方法或参数设置忽略转义操作），可选参数，默认值为false
     */
    boolean isParameterEscapeMode();

    /**
     * @return 执行请求参数转义顺序，可选参数，取值范围：before(参数验证之前)和after(参数验证之后)，默认值为after
     */
    Type.EscapeOrder getParameterEscapeOrder();
}