88435d0d85ffd083194ba7a961498a34daaeae74
[mir.git] / source / mir / servlet / ServletModuleDispatch.java
1 /*
2  * Copyright (C) 2001, 2002 The Mir-coders group
3  *
4  * This file is part of Mir.
5  *
6  * Mir is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 2 of the License, or
9  * (at your option) any later version.
10  *
11  * Mir is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with Mir; if not, write to the Free Software
18  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
19  *
20  * In addition, as a special exception, The Mir-coders gives permission to link
21  * the code of this program with  any library licensed under the Apache Software License, 
22  * The Sun (tm) Java Advanced Imaging library (JAI), The Sun JIMI library 
23  * (or with modified versions of the above that use the same license as the above), 
24  * and distribute linked combinations including the two.  You must obey the 
25  * GNU General Public License in all respects for all of the code used other than 
26  * the above mentioned libraries.  If you modify this file, you may extend this 
27  * exception to your version of the file, but you are not obligated to do so.  
28  * If you do not wish to do so, delete this exception statement from your version.
29  */
30 package  mir.servlet;
31
32 import java.lang.reflect.InvocationTargetException;
33 import java.lang.reflect.Method;
34
35 import javax.servlet.http.HttpServletRequest;
36 import javax.servlet.http.HttpServletResponse;
37
38 import mir.log.LoggerWrapper;
39
40
41 /**
42  * Dispatcher, calls the method passed to ServletModule Class, through the "do"
43  * Parameter (via POST or GET)
44  *
45  * @version $Id: ServletModuleDispatch.java,v 1.15 2003/04/21 12:42:50 idfx Exp $
46  *
47  * @Author rk
48  *
49  */
50 public final class ServletModuleDispatch {
51
52   private static LoggerWrapper logger = new LoggerWrapper("ServletModule.Dispatch");
53   private static final Class[] SIGNATURE = { HttpServletRequest.class, HttpServletResponse.class };
54
55  /**
56   * private constructor to prevent unwanted instantiation;
57   */
58
59   private ServletModuleDispatch () {
60   }
61
62   /**
63    *  Die Dispatch-Routine ruft das von dem Hauptservlet kommende ServletModule
64    *  mit dem per HttpServletRequest angegebenen Paramter <code>do</code> auf.
65    *  Ist kein Parameter angegeben, so wird versucht, in die <code>defaultAction</code>
66    *  des ServletModules zu springen.
67    *
68    * @param req Http-Request, das vom Dispatcher an die Methode des
69    *    ServletModules durchgereicht wird
70    * @param res Http-Response, die vom Dispatcher an die Methode des
71    *    ServletModules durchgereicht wird
72    * @param sMod ServletModule, an das dispatched wird.
73    * @param mod Name des Modules als String (f?r Logfile)
74    */
75
76   public static void dispatch(ServletModule sMod, HttpServletRequest req,
77           HttpServletResponse res) throws ServletModuleExc, ServletModuleUserExc, ServletModuleFailure
78   {
79     String doParam = req.getParameter("do");
80     logger.info("ServletModuleDispatch: " + sMod.toString() + " with method " + doParam);
81     if (doParam == null) {
82       if (sMod.defaultAction() != null)
83         doParam = sMod.defaultAction();
84       else
85         throw new ServletModuleExc("no parameter do supplied!");
86     }
87
88     try {
89       Method method = sMod.getClass().getMethod(doParam,SIGNATURE);
90       if (method != null) {
91         method.invoke(sMod,new Object[] {req,res} );
92         return;
93       }
94       else logger.debug("method lookup unsuccesful");
95     }
96     catch ( InvocationTargetException e) {
97       logger.error( "invocation target exception: " + e.getMessage());
98       e.getTargetException().printStackTrace(logger.asPrintWriter(LoggerWrapper.DEBUG_MESSAGE));
99
100       throw new ServletModuleFailure(e.getTargetException().getMessage(), e.getTargetException());
101     }
102     catch (Throwable t) {
103       logger.error( "ServletModuleDispatch: " + t.getMessage());
104       t.printStackTrace(logger.asPrintWriter(LoggerWrapper.DEBUG_MESSAGE));
105       throw new ServletModuleFailure(t);
106     }
107   }
108 }