JspContext源码翻译

package javax.servlet.jsp;import java.util.Enumeration;import javax.el.ELContext;/** * <p>JspContext是PageContext抽象类的基类，并抽象所有不针对servlet的信息。 * 这允许在请求/响应上下文之外使用简单的标记扩展。 *  * <p>JspContext为页面/组件创建者和页面实现者提供以下工具： *     a. 管理各种范围的名称空间的API； *     b. 获取JspWriter的机制； *     c. 向脚本环境公开页面指令属性的机制。 * <p>用于容器生成代码的方法： *    能够管理内嵌的JspWriter流去实现标签扩展:pushBody()和popBody() * <p>用于JSP创建的方法： *    一些方法提供统一访问不同表示范围的对象。实现必须使用对应于该范围的底层机制。因此， * 信息可以在底层环境(例如servlet)和JSP页面之间来回传递。方法是： *     setAttribute()，getAttribute()，findAttribute()， *     removeAttribute()，getAttributesScope()， *     getAttributeNamesInScope()。 * <p>获取隐式对象的方法：getOut() * <p>EL计算器的方法：getExpressionEvaluator(),getVariableResolver()。 * @author TCM * @create 2017年10月27日下午1:32:10 * @since  JSP 2.0 */public abstract class JspContext {        public JspContext() {    }        //注册页面范围的属性    abstract public void setAttribute(String name, Object value);    //scope是属性范围，参考：PageContext    abstract public void setAttribute(String name, Object value, int scope);    abstract public Object getAttribute(String name);    abstract public Object getAttribute(String name, int scope);    abstract public Object findAttribute(String name);    abstract public void removeAttribute(String name);    abstract public void removeAttribute(String name, int scope);    //获取属性的范围    abstract public int getAttributesScope(String name);    //获取指定范围内的所有属性名    abstract public Enumeration<String> getAttributeNamesInScope(int scope);        //JspWriter对象：响应客户端中使用    abstract public JspWriter getOut();            /**     * 返回与JspContext相关的ELContext。     *      * <p>ELContext被惰性地创建，同时若果已经存在，则重用。     * 每一个JspContext都有一个新的ELContext。     *      * <p>在JSP规格中，ELContext必须含有ELResolver。     * {@link JspApplicationContext#addELResolver}     * @return {@link ELContext}     * @since JSP 2.1     */    public abstract ELContext getELContext();    /**     * 返回JspWriter对象     * 作用：保存当前的out对象，并更新PageContext中Page范围内Out对象     * 参考资料：http://xiaodiandian.iteye.com/blog/662995     * @since JSP 2.0     */    public JspWriter pushBody( java.io.Writer writer ) {        return null; // XXX to implement    }        public JspWriter popBody() {        return null; // XXX to implement    }}