public interface ServletContext { // Returns the URL prefix for the ServletContext. public String getServletContextName(); //Returns the ServletContext for the uri. public ServletContext getContext(String uri); //Returns the context-path for the web-application. public String getContextPath(); //Returns the real file path for the given uri. public String getRealPath(String uri); public RequestDispatcher getRequestDispatcher(String uri); public RequestDispatcher getNamedDispatcher(String servletName);
public Object getAttribute(String name); public Enumeration getAttributeNames(); public void setAttribute(String name, Object value); public void removeAttribute(String name);
There is one context per "web application" per Java Virtual Machine. (A "web application" is a collection of servlets and content installed under a specific subset of the server's URL namespace such as /catalog and possibly installed via a .war file.)
public class ActionContext implements Serializable {
//ThreadLocal模式下的ActionContext实例,实现多线程下的线程安全/// static ThreadLocal actionContext = new ThreadLocal(); //Sets the action context for the current thread. public static void setContext(ActionContext context) { actionContext.set(context); } //Returns the ActionContext specific to the current thread. public static ActionContext getContext() { return (ActionContext) actionContext.get(); }
///定义放置"名/值对"的Map容器,这是ActionContext的主要功能/// Map<String, Object> context; // constractor // Creates a new ActionContext initialized with another context. public ActionContext(Map<String, Object> context) { this.context = context; } public void setContextMap(Map<String, Object> contextMap) { getContext().context = contextMap; } public Map<String, Object> getContextMap() { return context; } //Returns a value that is stored in the current ActionContext by doing a lookup using the value's key. public Object get(String key) { return context.get(key); } //Stores a value in the current ActionContext. The value can be looked up using the key. public void put(String key, Object value) { context.put(key, value); }
///将各种功能属性放置入Map容器中/ //action name, Constant for the name of the action being executed. public static final String ACTION_NAME = "com.opensymphony.xwork2.ActionContext.name"; // ognl value stack public static final String VALUE_STACK = ValueStack.VALUE_STACK; public static final String SESSION = "com.opensymphony.xwork2.ActionContext.session"; public static final String APPLICATION = "com.opensymphony.xwork2.ActionContext.application"; public static final String PARAMETERS = "com.opensymphony.xwork2.ActionContext.parameters"; public static final String LOCALE = "com.opensymphony.xwork2.ActionContext.locale"; public static final String TYPE_CONVERTER = "com.opensymphony.xwork2.ActionContext.typeConverter"; public static final String ACTION_INVOCATION = "com.opensymphony.xwork2.ActionContext.actionInvocation"; public static final String CONVERSION_ERRORS = "com.opensymphony.xwork2.ActionContext.conversionErrors"; public static final String CONTAINER = "com.opensymphony.xwork2.ActionContext.container"; // 各种Action主属性:ActionName, ActionInvocation(调用action的相关信息), ognl value stack/// //Gets the name of the current Action. public String getName() { return (String) get(ACTION_NAME); } //Sets the name of the current Action in the ActionContext. public void setName(String name) { put(ACTION_NAME, name); } //Sets the action invocation (the execution state). public void setActionInvocation(ActionInvocation actionInvocation) { put(ACTION_INVOCATION, actionInvocation); } public ActionInvocation getActionInvocation() { return (ActionInvocation) get(ACTION_INVOCATION); } // Sets the OGNL value stack. public void setValueStack(ValueStack stack) { put(VALUE_STACK, stack); } //Gets the OGNL value stack. public ValueStack getValueStack() { return (ValueStack) get(VALUE_STACK); } 各种 request请求包含的内容 //Returns a Map of the HttpServletRequest parameters public Map<String, Object> getParameters() { return (Map<String, Object>) get(PARAMETERS); } public void setParameters(Map<String, Object> parameters) { put(PARAMETERS, parameters); } public void setSession(Map<String, Object> session) { put(SESSION, session); } public Map<String, Object> getSession() { return (Map<String, Object>) get(SESSION); } public void setApplication(Map<String, Object> application) { put(APPLICATION, application); } public Map<String, Object> getApplication() { return (Map<String, Object>) get(APPLICATION); } public void setConversionErrors(Map<String, Object> conversionErrors) { put(CONVERSION_ERRORS, conversionErrors); } public Map<String, Object> getConversionErrors() { Map<String, Object> errors = (Map) get(CONVERSION_ERRORS); if (errors == null) { errors = new HashMap<String, Object>(); setConversionErrors(errors); } return errors; } //Sets the Locale for the current action. public void setLocale(Locale locale) { put(LOCALE, locale); } public Locale getLocale() { Locale locale = (Locale) get(LOCALE); if (locale == null) { locale = Locale.getDefault(); setLocale(locale); } return locale; } public void setContainer(Container cont) { put(CONTAINER, cont); } public Container getContainer() { return (Container) get(CONTAINER); } public <T> T getInstance(Class<T> type) { Container cont = getContainer(); if (cont != null) { return cont.getInstance(type); } else { throw new XWorkException("Cannot find an initialized container for this request."); } } }