001    //$HeadURL: svn+ssh://rbezema@svn.wald.intevation.org/deegree/base/tags/2.1/src/org/deegree/ogcwebservices/wass/common/GetSessionHandler.java $
002    /*----------------    FILE HEADER  ------------------------------------------
003    
004     This file is part of deegree.
005     Copyright (C) 2001-2004 by:
006     EXSE, Department of Geography, University of Bonn
007     http://www.giub.uni-bonn.de/exse/
008     lat/lon GmbH
009     http://www.lat-lon.de
010    
011     This library is free software; you can redistribute it and/or
012     modify it under the terms of the GNU Lesser General Public
013     License as published by the Free Software Foundation; either
014     version 2.1 of the License, or (at your option) any later version.
015    
016     This library is distributed in the hope that it will be useful,
017     but WITHOUT ANY WARRANTY; without even the implied warranty of
018     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
019     Lesser General Public License for more details.
020    
021     You should have received a copy of the GNU Lesser General Public
022     License along with this library; if not, write to the Free Software
023     Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
024    
025     Contact:
026    
027     Andreas Poth
028     lat/lon GmbH
029     Meckenheimer Allee 176
030     53115 Bonn
031     Germany
032     E-Mail: poth@lat-lon.de
033    
034     Prof. Dr. Klaus Greve
035     Department of Geography
036     University of Bonn
037     Meckenheimer Allee 166
038     53115 Bonn
039     Germany
040     E-Mail: greve@giub.uni-bonn.de
041    
042     ---------------------------------------------------------------------------*/
043    package org.deegree.ogcwebservices.wass.common;
044    
045    import org.deegree.security.GeneralSecurityException;
046    import org.deegree.security.session.SessionStatusException;
047    
048    /**
049     * Interface to be used for all GetSession handlers.
050     * 
051     * @author <a href="mailto:schmitz@lat-lon.de">Andreas Schmitz</a>
052     * @author last edited by: $Author: bezema $
053     * 
054     * @version 2.0, $Revision: 6259 $, $Date: 2007-03-20 10:15:15 +0100 (Di, 20 Mär 2007) $
055     * 
056     * @since 2.0
057     */
058    
059    public interface GetSessionHandler {
060    
061        /**
062         * Returns a new session ID.
063         * 
064         * @param request
065         *            the request on which to base the authentication
066         * @return the new session ID or null
067         * @throws SessionStatusException
068         * @throws GeneralSecurityException
069         */
070        public String handleRequest( GetSession request )
071                                throws SessionStatusException, GeneralSecurityException;
072    
073    }
074    
075    /***************************************************************************************************
076     * Changes to this class. What the people have been up to: $Log$
077     * Changes to this class. What the people have been up to: Revision 1.3  2006/06/19 12:47:26  schmitz
078     * Changes to this class. What the people have been up to: Updated the documentation, fixed the warnings and implemented logging everywhere.
079     * Changes to this class. What the people have been up to: Changes to this class. What the
080     * people have been up to: Revision 1.2 2006/05/30 11:44:51 schmitz Changes to this class. What the
081     * people have been up to: Updated the documentation, fixed some warnings. Changes to this class.
082     * What the people have been up to: Revision 1.1 2006/05/29 12:00:58 bezema Refactored the security
083     * and authentication webservices into one package WASS (Web Authentication -and- Security
084     * Services), also created a common package and a saml package which could be updated to work in the
085     * future.
086     * 
087     * Revision 1.2 2006/05/26 11:55:09 schmitz Extended the handlers to actually do something useful.
088     * Added configuration package to WAS, added plan text file. Added GetSessionHandler interface,
089     * added CloseSessionHandler.
090     * 
091     * 
092     * 
093     **************************************************************************************************/