- producer links are moved to an "advanced" page, not intended for normal
[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 the com.oreilly.servlet library, any library
22  * licensed under the Apache Software License, The Sun (tm) Java Advanced
23  * Imaging library (JAI), The Sun JIMI library (or with modified versions of
24  * the above that use the same license as the above), and distribute linked
25  * combinations including the two.  You must obey the GNU General Public
26  * License in all respects for all of the code used other than the above
27  * mentioned libraries.  If you modify this file, you may extend this exception
28  * to your version of the file, but you are not obligated to do so.  If you do
29  * not wish to do so, delete this exception statement from your version.
30  */
31
32 package  mir.servlet;
33
34 import  java.lang.reflect.*;
35 import  javax.servlet.http.*;
36 import  mir.servlet.ServletModuleException;
37 import  mir.misc.*;
38 import  mir.log.*;
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.8 2002/10/25 03:25:15 zapata Exp $
46  *
47  * @Author rk
48  *
49  */
50 public final class ServletModuleDispatch {
51
52   private static LoggerWrapper logger;
53   private static final Class[] SIGNATURE = { HttpServletRequest.class, HttpServletResponse.class };
54
55   static {
56     logger = new LoggerWrapper("servlet.dispatch");
57   }
58
59  /**
60   * private constructor to prevent unwanted instantiation;
61   */
62
63   private ServletModuleDispatch () {
64   }
65
66         /**
67          *  Die Dispatch-Routine ruft das von dem Hauptservlet kommende ServletModule
68          *  mit dem per HttpServletRequest angegebenen Paramter <code>do</code> auf.
69          *  Ist kein Parameter angegeben, so wird versucht, in die <code>defaultAction</code>
70          *  des ServletModules zu springen.
71          *
72          * @param req Http-Request, das vom Dispatcher an die Methode des
73          *    ServletModules durchgereicht wird
74          * @param res Http-Response, die vom Dispatcher an die Methode des
75          *    ServletModules durchgereicht wird
76          * @param sMod ServletModule, an das dispatched wird.
77          * @param mod Name des Modules als String (für Logfile)
78          */
79
80   public static void dispatch(ServletModule sMod, HttpServletRequest req,
81                               HttpServletResponse res) throws ServletModuleException, ServletModuleUserException
82   {
83     //sMod.predeliver(req,res);
84
85     String doParam = req.getParameter("do");
86     logger.info("ServletModuleDispatch: " + sMod.toString() + " with method " + doParam);
87     if (doParam == null) {
88       if (sMod.defaultAction() != null)
89         doParam = sMod.defaultAction();
90       else
91         throw new ServletModuleException("no parameter do supplied!");
92     }
93
94     try {
95       Method method = sMod.getClass().getMethod(doParam,SIGNATURE);
96       if (method != null) {
97         method.invoke(sMod,new Object[] {req,res} );
98         return;
99       }
100       else logger.debug("method lookup unsuccesful");
101     }
102     catch ( NoSuchMethodException e) {
103       throw new ServletModuleException("no such method '"+doParam+"' (" + e.getMessage() + ")");
104     }
105     catch ( SecurityException e) {
106       throw new ServletModuleException("method not allowed!" + e.getMessage());
107     }
108     catch ( InvocationTargetException e) {
109       System.out.println(e.getMessage());
110       if (e.getTargetException() instanceof ServletModuleUserException) {
111         throw new ServletModuleUserException(e.getTargetException().getMessage());
112       }
113       else {
114         e.printStackTrace();
115         throw new ServletModuleException(e.getTargetException().getMessage());
116       }
117     }
118     catch ( IllegalAccessException e) {
119       throw new ServletModuleException("illegal method not allowed!" + e.getMessage());
120     }
121
122 //hopefully we don't get here ...
123     throw new ServletModuleException("delivery failed! -- ");
124   }
125 }