51ac52501638def939bf533349bd4e34682eac65
[mir.git] / source / mir / core / ui / action / DispatchAction.java
1 /*
2  * DispatchAction.java
3  * 
4  * Copyright (C) 2001, 2002, 2003 The Mir-coders group
5  *
6  * This file is part of Mir.
7  *
8  * Mir is free software; you can redistribute it and/or modify
9  * it under the terms of the GNU General Public License as published by
10  * the Free Software Foundation; either version 2 of the License, or
11  * (at your option) any later version.
12  *
13  * Mir is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16  * GNU General Public License for more details.
17  *
18  * You should have received a copy of the GNU General Public License
19  * along with Mir; if not, write to the Free Software
20  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
21  *
22  * In addition, as a special exception, The Mir-coders gives permission to link
23  * the code of this program with  any library licensed under the Apache Software License,
24  * The Sun (tm) Java Advanced Imaging library (JAI), The Sun JIMI library
25  * (or with modified versions of the above that use the same license as the above),
26  * and distribute linked combinations including the two.  You must obey the
27  * GNU General Public License in all respects for all of the code used other than
28  * the above mentioned libraries.  If you modify this file, you may extend this
29  * exception to your version of the file, but you are not obligated to do so.
30  * If you do not wish to do so, delete this exception statement from your version.
31  */
32 package mir.core.ui.action;
33
34 import java.lang.reflect.Method;
35
36 import javax.servlet.http.HttpServletRequest;
37 import javax.servlet.http.HttpServletResponse;
38
39 import org.apache.struts.action.Action;
40 import org.apache.struts.action.ActionForm;
41 import org.apache.struts.action.ActionForward;
42 import org.apache.struts.action.ActionMapping;
43
44
45 /**
46  * DispatchAction<br>
47  * This Action dispatches a call of execute() to a method with a name defined
48  * as parameter in the action mapping. To use this Action you have to define a 
49  * action mapping in the following way:<br>
50  * 
51  * <code><pre>
52  * <action-mappings>
53  *   <action
54  *      parameter="logon"
55  *      path="/logon"
56  *      type="my.action.MyAction"
57  *   ... 
58  *   />
59  *   </action> 
60  * <action-mappings>
61  * </pre></code><br>
62  * If <code>logon.do</code> is called by the user the method <code>logon()</code>
63  * of the class MyAction is called.
64  * 
65  * 
66  * @version $Id: DispatchAction.java,v 1.1 2003/09/10 20:58:27 idfx Exp $
67  * @author idefix
68  */
69 public class DispatchAction extends Action {
70
71         /**
72          * Dispatches to a method with a name defined as parameter of the action mapping.
73          * @see org.apache.struts.action.Action#execute(org.apache.struts.action.ActionMapping, org.apache.struts.action.ActionForm, javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse)
74          */
75         public ActionForward execute(ActionMapping actionMapping, ActionForm actionForm, 
76                 HttpServletRequest request, HttpServletResponse response)
77                 throws Exception {
78                 String parameter = actionMapping.getParameter();
79                 Method method = getClass().getDeclaredMethod(parameter, 
80                         new Class[]{ActionMapping.class, ActionForm.class,
81                         HttpServletRequest.class, HttpServletResponse.class});
82                 method.setAccessible(true);
83                 return (ActionForward) method.invoke(
84                                 this, new Object[]{actionMapping, actionForm, request, response});
85         }
86 }