本文主要透過三個面向跟大家介紹webwork action呼叫相關知識,三個面向分別是:
1.這部分框架類關係
2.Webwork 取得與包裝 web 參數
3.DefaultActionProxyFactory、DefaultActionProxy、DefaultActionInvocation
一路走來,終於要開始webwork 核心業務類的總結,webwork 透過對客戶端傳遞的web 參數重新包裝,進行執行業務Action 類,並反饋執行結果,本篇源碼分析對應下圖WebWork 框架流轉圖中紅色框的地方。
1.這部分框架類關係
2.Webwork 取得與包裝 web 參數
•每個Web 框架或多或少的對 Web 請求參數的包裝,用來拿來方便自己使用,當然webwork 也不例外。
•Webwork 每次回應請求的入口方法:
public void service(HttpServletRequest request, HttpServletResponse response) throws ServletException { try { if (encoding != null) { try { request.setCharacterEncoding(encoding); } catch (Exception localException) { } } if (locale != null) { response.setLocale(locale); } if (this.paramsWorkaroundEnabled) { request.getParameter("foo"); } request = wrapRequest(request); //封装 request请求 serviceAction(request, response, getNameSpace(request), getActionName(request), getRequestMap(request), getParameterMap(request), getSessionMap(request), getApplicationMap()); } catch (IOException e) { String message = "Could not wrap servlet request with MultipartRequestWrapper!"; log.error(message, e); sendError(request, response, , new ServletException(message, e)); } }
•接受 request 、response 參數,並對 request 參數進行封裝,這次封裝主要是針對多媒體請求進行的特殊處理,例如項目中的文件上傳請求,導出各種類型文件等...
•包裝完 request 之後,service 方法呼叫 ServletDispatche.serviceAction() 方法,並呼叫 getApplicationMap、getSessionMap、getRequestMap、 getParameterMap、getActionName、getNameSpace 6 個方法開始了Action 業務邏輯呼叫前的前戲。
•getNameSpace 方法用來取得一個Action所屬的名稱空間,例如 : "/my/MyAction.action"則傳回"/my",具體實作如下:
protected String getNameSpace(HttpServletRequest request){ String servletPath = request.getServletPath(); return getNamespaceFromServletPath(servletPath); } public static String getNamespaceFromServletPath(String servletPath){ servletPath = servletPath.substring(, servletPath.lastIndexOf("/")); return servletPath; }
•getActionName 傳回請求的Action的名字,例如:"MyAction.action"則傳回"MyAction",具體實作如下:
protected String getActionName(HttpServletRequest request){ String servletPath = (String)request.getAttribute("javax.servlet.include.servlet_path"); if (servletPath == null) { servletPath = request.getServletPath(); } return getActionName(servletPath); } protected String getActionName(String name){ int beginIdx = name.lastIndexOf("/"); int endIdx = name.lastIndexOf("."); return name.substring(beginIdx == - ? : beginIdx + , endIdx == - ? name.length() : endIdx); }
• getRequestMap 方法傳回一個包含請求中所有屬性的Map,具體實作類別是 RequestMap,具體程式碼如下:
protected Map getRequestMap(HttpServletRequest request){ return new RequestMap(request); }
•getParameterMap 方法傳回一個包含請求中所有參數的Map,具體程式碼如下:
protected Map getParameterMap(HttpServletRequest request) throws IOException{ return request.getParameterMap(); }
•getSessionMap 方法傳回一個包含 session 中所有屬性的 Map,具體實作類別是 SessionMap,具體程式碼如下:
protected Map getSessionMap(HttpServletRequest request){ return new SessionMap(request); }
•getApplicationMap 方法傳回一個包含 Application 中所有屬性的Map,具體實作類別 是ApplicationMap,具體程式碼如下:
protected Map getApplicationMap(){ return new ApplicationMap(getServletContext()); }
•WebWork之所以要把request 的屬性、參數,session 中的屬性,Application 中的屬性封裝成 Map,只是為了自己使用方便。
public void serviceAction(HttpServletRequest request, HttpServletResponse response, String namespace, String actionName, Map requestMap, Map parameterMap, Map sessionMap, Map applicationMap) { HashMap extraContext = createContextMap(requestMap, parameterMap, sessionMap, applicationMap, request, response, getServletConfig()); extraContext.put("com.opensymphony.xwork.dispatcher.ServletDispatcher", this); OgnlValueStack stack = (OgnlValueStack) request.getAttribute("webwork.valueStack"); if (stack != null) { extraContext.put("com.opensymphony.xwork.util.OgnlValueStack.ValueStack", new OgnlValueStack(stack)); } try { ActionProxy proxy = ActionProxyFactory.getFactory().createActionProxy(namespace, actionName, extraContext); request.setAttribute("webwork.valueStack", proxy.getInvocation().getStack()); proxy.execute(); if (stack != null) { request.setAttribute("webwork.valueStack", stack); } } catch (ConfigurationException e) { log.error("Could not find action", e); sendError(request, response, 404, e); } catch (Exception e) { log.error("Could not execute action", e); sendError(request, response, 500, e); } }
•首先 ServiceAction 呼叫了createContextMap 以建立Action 上下文(extraContext)。 它將JavaServlet 相關的物件包裝,放入extraContext Map物件裡。
•接著檢查 上一個請求中是否有可用的值堆疊,如果有就放入extraContext 這個Map 物件裡,供本次請求使用 。
•ActionContext(com.opensymphony.xwork.ActionContext)是Action執行時的上下文,上下文可以看作是容器(其實我們這裡的容器就是一個Map 而已),它存放的是Action 在執行時需要用到的對象。
• ServletActionContext ( com.opensymphony.webwork. ServletActionContext),這個類別直接繼承了ActionContext,它提供了直接與JavaServlet 相關象存取的功能。
•OgnlValueStack主要的功能是透過表達式語言來存取物件的屬性。
3.DefaultActionProxyFactory、DefaultActionProxy、DefaultActionInvocation
前戲終於做完了,Action 呼叫的三兄弟要登場進行最重要的操作了,就是下面這三句代碼,與Webwork 學習之路(五)請求跳轉前xwork.xml 的讀取代碼有非常相似的寫法與設計:
ActionProxy proxy = ActionProxyFactory.getFactory().createActionProxy(namespace, actionName, extraContext); request.setAttribute("webwork.valueStack", proxy.getInvocation().getStack());
proxy.execute(); •通过由前面获得的namespace、actionName、extraContext 创建调用代理 ActonProxy 实例,这里也就是 DefaultActionProxy,之后调用 了 ActionProxy.execute 方法来执行我们逻辑Action.execute。
•ActionProxy是一个接口,ActionProxyFactory则是一个抽象类,默认情况下它们是通过 DefaultActionProxy和DefaultActionProxyFactory来完成操作的。
•在 ActionProxyFactory 中有一个静态变量 factory ,它指向的是一个 DefaultActionProxyFactory 实例,代码如下:
static ActionProxyFactory factory = new DefaultActionProxyFactory(); public static void setFactory(ActionProxyFactory factory){ factory = factory; } public static ActionProxyFactory getFactory(){ return factory; }
• DefaultActionProxyFactory 的 createActionProxy 方法返回了 DefaultActionProxy 实例。
public ActionProxy createActionProxy(String namespace, String actionName, Map extraContext)throws Exception { setupConfigIfActionIsCommand(namespace, actionName); return new DefaultActionProxy(namespace, actionName, extraContext, true); } •DefaultActionProxy的构造函数 protected DefaultActionProxy(String namespace, String actionName, Map extraContext, boolean executeResult) throws Exception{ if (LOG.isDebugEnabled()) { LOG.debug("Creating an DefaultActionProxy for namespace " + namespace + " and action name " + actionName); } this.actionName = actionName; this.namespace = namespace; this.executeResult = executeResult; this.extraContext = extraContext; this.config = ConfigurationManager.getConfiguration().getRuntimeConfiguration().getActionConfig(namespace, actionName); if (this.config == null) { String message; String message; if ((namespace != null) && (namespace.trim().length() > 0)) { message = LocalizedTextUtil.findDefaultText("xwork.exception.missing-package-action", Locale.getDefault(), new String[] { namespace, actionName }); } else { message = LocalizedTextUtil.findDefaultText("xwork.exception.missing-action", Locale.getDefault(), new String[] { actionName }); } throw new ConfigurationException(message); } prepare(); }
•将传入的名称空间、 Action 的名字等参数赋予本地变量,接着通过 ConfigurationManager 获得当前请求的 Action 的配置信息[这里在5中已经描述过]。接着调用自身的 prepare 方法创建一个 ActionInvocation 对象赋予自身变量 invocation。在之后的 execute 方法中通过操纵invocation 来实现我们自己写的Action 的调用。
protected void prepare() throws Exception { this.invocation = ActionProxyFactory.getFactory().createActionInvocation(this, this.extraContext); }
以上所示是针对Webwork中Action 调用 的相关知识,希望对大家有所帮助。