/*
* This software and supporting documentation were developed by
*
* Siemens Corporate Technology
* Competence Center Knowledge Management and Business Transformation
* D-81730 Munich, Germany
*
* Authors (representing a really great team ;-) )
* Stefan B. Augustin, Thorbj�rn Hansen, Manfred Langen
*
* This software is Open Source under GNU General Public License (GPL).
* Read the text of this license in LICENSE.TXT
* or look at www.opensource.org/licenses/
*
* Once more we emphasize, that:
* THIS SOFTWARE IS MADE AVAILABLE, AS IS, WITHOUT ANY WARRANTY
* REGARDING THE SOFTWARE, ITS PERFORMANCE OR
* FITNESS FOR ANY PARTICULAR USE, FREEDOM FROM ANY COMPUTER DISEASES OR
* ITS CONFORMITY TO ANY SPECIFICATION. THE ENTIRE RISK AS TO QUALITY AND
* PERFORMANCE OF THE SOFTWARE IS WITH THE USER.
*
*/
// CAS_Servlet
// ************ package ******************************************************
package appl.Portal.CAS.Servlet;
// ************ imports ******************************************************
// This application/module packages
import appl.Portal.CAS.Servlet.CAS_Props;
import appl.Portal.CAS.GUI.*;
import appl.Portal.CAS.Utils.*;
// Other application/module packages
// KFM packages
import KFM.Exceptions.KFMException;
import KFM.ServletFramework.*;
import KFM.Language;
import KFM.Servlet.KFM_Servlet2;
// Library classes (JHDK, JSDK, RegExp, ...)
import javax.servlet.*;
import javax.servlet.http.*;
// Java packages
import java.io.*;
/** Servlet for communication with CAS.
* @version 0.1 (02.07.22)
*/
public class CAS_Servlet extends KFM_PropertyServlet2
{
// ************************************************************
// Variables
// ************************************************************
/** The servlet properties.
*
* Shadows `super.mProps�, which is OK, as both refer to the same object.
*/
protected CAS_Props mProps = null;
public static boolean doInitAlreadyCalled=false;
// ************************************************************
// Methods
// ************************************************************
/** Called by the web server when the servlet is just loaded, and
* after a destroy.
*/
public void init (ServletConfig aConfig)
throws ServletException
{
super.init(aConfig, mProps = new CAS_Props() /*sic*/);
}
/**
* Exception handling will be done by the calling father class (currently
* KFM_PropertyServlet2).
*/
public void doInit(ServletConfig aConfig)
throws ServletException, NoSuchServletPropertyException, KFMException
{
// * Read the required and optional properties of `CAS_Props�, which see.
String tUpdateIntervall = mServletProps.getOptional("TimeIntervall");
if (!tUpdateIntervall.equals("")){
mProps.TimeIntervall = Integer.parseInt(tUpdateIntervall);
} else {
mProps.TimeIntervall = 24;
}
mProps.GetDataFromCas = mServletProps.getRequiredBoolean("GetDataFromCas");
mProps.password = mServletProps.getRequired("password");
mProps.HostKey1 = mServletProps.getRequired("HostKey1");
mProps.DTD = mServletProps.getRequired("DTD");
// create and start new thread for communication with CAS
// unfortunately doInit will be called more than once (J mentioned
// that's a known Tomcat bug).
//
// Since I want only one thread communicating with CAS I introduced
// the variable doInitAlreadyCalled
//
// In addition we want only one instance of the CAS servlet to get the data
// from CAS. Our developer PCs should not contact CAS and only one of
// the servlets running on ep1, ..., ep4 should contact CAS.
//
// On the developer PCs we set the property GetDataFromCas=false.
//
// Due to the comparison of HostKey1 with getHostName I ensure that only
// one of the four epx instances (the first one) contacts CAS.
if (!doInitAlreadyCalled && mProps.GetDataFromCas && mProps.HostKey1.equals(getHostName())){
CAS_CommThread mCASComm=new CAS_CommThread(mProps.TimeIntervall*60*60*1000, mLog, mProps);
mCASComm.start();
mLog.info("CAS_CommThread gestartet");
}
doInitAlreadyCalled=true;
}
/** Handle all HTTP request (escpecially `doGet� and `doPost�).
*
* This method is called for each HTTP requerst.
* It Creates an applicationpage for each request and calls its `write�.
* When we get user states etc. we cannot create a new applicationpage each time,
* but don't worry about that yet.
*
* @param aReq The POST or GET request information.
* @param aRes The HTTP response object.
*
* @exception ServletException
* @exception IOException
*/
public void processRequest2 (
HttpServletRequest aReq,
HttpServletResponse aRes)
throws ServletException, IOException, KFMException
{
// Create a new ApplicationPage for each request. Really.
CAS_ApplicationPage tCAS = new CAS_ApplicationPage(mProps, aReq);
tCAS.setServletName(this);
// try {
tCAS.write(/*user state*/ null, aReq, aRes);
aRes.getWriter().close();
// } catch(Exception e) {
// PrintWriter tWriter = aRes.getWriter();
// tWriter.print(e.toString());
// tWriter.close();
// }
// Note that the ApplicationPage is thrown away. Really.
}
/**
* This method returns the name of the host on which the software is running.
*/
private String getHostName() {
String tHostname="Unknown";
try {
tHostname= java.net.InetAddress.getLocalHost().getHostName();
} catch (Exception e){}
return tHostname;
}
}