001    //$HeadURL: svn+ssh://rbezema@svn.wald.intevation.org/deegree/base/tags/2.1/src/org/deegree/ogcwebservices/wass/common/URN.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    
044    package org.deegree.ogcwebservices.wass.common;
045    
046    /**
047     * Encapsulates a Uniform Resource Name (URN) which encodes an authentication method according to
048     * the GDI NRW access control specification.
049     * 
050     * @author <a href="mailto:schmitz@lat-lon.de">Andreas Schmitz</a>
051     * @author last edited by: $Author: bezema $
052     * 
053     * @version 2.0, $Revision: 6259 $, $Date: 2007-03-20 10:15:15 +0100 (Di, 20 Mär 2007) $
054     * 
055     * @since 2.0
056     */
057    public class URN {
058    
059        private String urn;
060    
061        /**
062         * Creates new one from a String.
063         * 
064         * @param urn
065         *            the string
066         */
067        public URN( String urn ) {
068            this.urn = urn;
069        }
070    
071        /**
072         * Returns the last part of the name, or null, if it is not a wellformed GDI NRW authentication.
073         * method URN.
074         * 
075         * @return the name, or null
076         */
077        public String getAuthenticationMethod() {
078            if ( !isWellformedGDINRW() )
079                return null;
080            return getLastName();
081        }
082    
083        /**
084         * Returns the last part of the name, or null, if it is not a URN.
085         * 
086         * @return the last part of this URN
087         */
088        public String getLastName() {
089            if ( urn == null )
090                return null;
091            if ( !urn.startsWith( "urn:" ) )
092                return null;
093            return urn.substring( urn.lastIndexOf( ':' ) + 1 );
094        }
095    
096        /**
097         * Returns, whether this is a wellformed GDI NRW authentication method URN.
098         * 
099         * @return true, if it is
100         */
101        public boolean isWellformedGDINRW() {
102            if ( urn == null )
103                return false;
104            String lastName = getLastName();
105            if ( urn.startsWith( "urn:x-gdi-nrw:authnMethod:1.0:" ) )
106                if ( lastName.equalsIgnoreCase( "password" ) || lastName.equalsIgnoreCase( "was" )
107                     || lastName.equalsIgnoreCase( "session" )
108                     || lastName.equalsIgnoreCase( "anonymous" ) )
109                    return true;
110            return false;
111        }
112        
113        /**
114         * @param other
115         * @return true if other equals this URN
116         */
117        public boolean equals ( URN other ){
118            if( other == null )
119                return false;
120            if( !other.isWellformedGDINRW() || !this.isWellformedGDINRW() )
121                return false;
122            return other.getLastName().equals( this.getLastName() );
123        }
124    
125        @Override
126        public String toString() {
127            return urn;
128        }
129    
130    }
131    
132    /***************************************************************************************************
133     * Changes to this class. What the people have been up to: $Log$
134     * Changes to this class. What the people have been up to: Revision 1.4  2006/06/27 13:10:47  bezema
135     * Changes to this class. What the people have been up to: Finished the last bits of the configuration of the wass.
136     * Changes to this class. What the people have been up to:
137     * Changes to this class. What the people have been up to: Revision 1.3  2006/06/09 12:58:32  schmitz
138     * Changes to this class. What the people have been up to: Set up some tests for WAS/WSS and the URN class.
139     * Changes to this class. What the people have been up to: Commented out some of the deegree param stuff in order for the
140     * Changes to this class. What the people have been up to: tests to run.
141     * Changes to this class. What the people have been up to: Tests have hardcoded URLs in them, so they won't run just anywhere.
142     * Changes to this class. What the people have been up to:
143     * Changes to this class. What the people have been up to: Revision 1.2  2006/05/30 11:44:51  schmitz
144     * Changes to this class. What the people have been up to: Updated the documentation, fixed some warnings.
145     * Changes to this class. What the people have been up to: Revision 1.1 2006/05/29 12:00:58
146     * bezema Refactored the security and authentication webservices into one package WASS (Web
147     * Authentication -and- Security Services), also created a common package and a saml package which
148     * could be updated to work in the future.
149     * 
150     * Revision 1.4 2006/05/26 14:38:32 schmitz Added some KVP constructors to WAS operations. Added
151     * some comments, updated the plan. Restructured WAS operations by adding an AbstractRequest base
152     * class.
153     * 
154     * Revision 1.3 2006/05/26 11:55:09 schmitz Extended the handlers to actually do something useful.
155     * Added configuration package to WAS, added plan text file. Added GetSessionHandler interface,
156     * added CloseSessionHandler.
157     * 
158     * Revision 1.2 2006/05/15 15:22:19 bezema The authentication.xsd elements will now be parsed by
159     * AuthenticationDocument. Data containing classes have also been created.
160     * 
161     * Revision 1.1 2006/04/24 16:01:48 bezema Initializing gac (GDI NRW Access Control)
162     * 
163     * 
164     **************************************************************************************************/