Nutzerverwaltung
view | history | commit | commitdiff
ulrich
2017-02-01 61cf4822e1f4080e0625610470f232dd32cb4dd6
commit | author | age
6240cd 1 /*
51c9e3 2  *  Nutzerverwaltung - User and role management in your browser
U 3  *  Copyright (C) 2011-2016 Ulrich Hilger, http://uhilger.de
4  *
5  *  This program is free software: you can redistribute it and/or modify
6  *  it under the terms of the GNU General Public License as published by
7  *  the Free Software Foundation, either version 3 of the License, or
8  *  (at your option) any later version.
9  *
10  *  This program is distributed in the hope that it will be useful,
11  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
12  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13  *  GNU General Public License for more details.
14  *
15  *  You should have received a copy of the GNU General Public License
16  *  along with this program.  If not, see http://www.gnu.org/licenses/
6240cd 17  */
51c9e3 18
c65695 19 package de.uhilger.um.api;
U 20
21 import de.uhilger.baselink.GenericRecord;
4f4b29 22 import de.uhilger.baselink.PersistenceManager;
c65695 23 import de.uhilger.baselink.Record;
1fc020 24 import de.uhilger.transit.web.WebKontext;
6240cd 25 import de.uhilger.um.Digester;
c65695 26 import de.uhilger.um.daten.User;
61cf48 27 import de.uhilger.um.daten.UserData;
87e382 28 import de.uhilger.um.daten.UserRole;
61cf48 29 import de.uhilger.um.web.Initialiser;
4f4b29 30 import java.sql.Connection;
725d10 31 import java.util.List;
1fc020 32 import java.util.Properties;
61cf48 33 import java.util.logging.Logger;
1fc020 34 import javax.servlet.ServletContext;
c65695 35
U 36 /**
1fc020 37  * <p>Die Methoden der Klasse UserMgr sind  
U 38  * die 'Fassade', die &uuml;ber Transit als Programmschnittstelle 
39  * (Application Programming Interface, API) 
40  * nach au&szlig;en bereitgestellt wird. UserMgr dient weitgehend 
41  * als 'Durchreiche' f&uuml;r die Funktionalit&auml;t anderer Klassen.</p>
59f8b3 42  * 
1fc020 43  * <p>
U 44  * Der UserMgr erh&auml;lt die ben&ouml;tigten Methoden aus dem ServletContext. 
45  * Auf diese Weise sind keine statischen Abh&auml;ngigkeiten in den Code 
46  * gewandert. Die folgenden Elemente werden vom UserMgr im ServletContext 
47  * erwartet:
c43d2a 48  * <ul>
U 49  * <li>PersistenceManager</li>
50  * <li>SQL-Properties</li>
51  * <li>Digester</li>
1fc020 52  * </p> 
627850 53  * 
6240cd 54  * @author Copyright (c) Ulrich Hilger, http://uhilger.de
U 55  * @author Published under the terms and conditions of the
56  * <a href="http://www.gnu.org/licenses/agpl-3.0" target="_blank">GNU Affero
57  * General Public License</a>
58  *
59  * @version 2, December 27, 2016
c65695 60  */
1fc020 61 public class UserMgr implements WebKontext {
U 62   
61cf48 63   private static final Logger logger = Logger.getLogger(UserMgr.class.getName());
U 64   
c43d2a 65   /** Zeiger zum Servlet-Kontext dieser Anwendung */
1fc020 66   private ServletContext ctx;
U 67   
68   /** Name, unter dem das Properties-Objekt mit den SQL-Befehlen im ServletContext hinterlegt ist */
69   public static final String UM_SQL_PROPERTIES = "umSqlProperties";
70
c43d2a 71   /** Name, unter dem das Digester-Objekt im ServletContext hinterlegt ist */
35c04d 72   public static final String P_DIGESTER = "digester";
U 73
1fc020 74   /** Name, unter dem das Zugriffsobjekt zur Datenbank im ServletContext hinterlegt ist */
U 75   public static final String UM_DB = "umDb";
c65695 76   
35c04d 77   /** Boolean-Konstante zur Kennzeichnung von Datenbankergebnissen ohne Blobs */
U 78   public static final boolean WITHOUT_BLOBS = false;
79
c43d2a 80   /** Referenz zum SQL-Befehl zur Ermittlung der Benutzer */
725d10 81   public static final String SQL_GET_USER_LIST = "getUserList";
c43d2a 82   /** Referenz zum SQL-Befehl zur Ermittlung der Benutzer-Namen */
725d10 83   public static final String SQL_GET_USER_NAME_LIST = "getUserNameList";
c43d2a 84   /** Referenz zum SQL-Befehl zur Ermittlung der Rollen */
87e382 85   public static final String SQL_GET_ROLE_LIST = "getRoleList";
c43d2a 86   /** Referenz zum SQL-Befehl zur Ermittlung der Rollen eines Benutzers */
c79c12 87   public static final String SQL_GET_USER_ROLES = "getUserRoles";
c43d2a 88   /** Referenz zum SQL-Befehl zum Loeschen aller Rollen eines Nutzers */
4f4b29 89   public static final String SQL_DELETE_USER_ROLES = "deleteUserRoles";
725d10 90   
c43d2a 91   /** Mapper-Objekt fuer Benutzer */
U 92   private static final Record UserMapper = new GenericRecord(User.class);
61cf48 93   /** Mapper-Objekt fuer Benutzerdaten */
U 94   private static final Record UserDataMapper = new GenericRecord(UserData.class);
c43d2a 95   /** Mapper-Objekt fuer Benutzerrollen */
U 96   private static final Record UserRoleMapper = new GenericRecord(UserRole.class);
97   
be9fa2 98   /* ----------- Benutzer -------------- */
U 99   
35c04d 100   public User createUser(User user) throws ClassNotFoundException, InstantiationException, IllegalAccessException {
c65695 101     String kw = user.getPw();
35c04d 102     String digesterClassName = ctx.getInitParameter(P_DIGESTER);
U 103     Digester digester = (Digester) Class.forName(digesterClassName).newInstance();
e0ec31 104     /*
U 105       MD5 geht nicht mehr,
106       vgl. http://stackoverflow.com/questions/39967289/how-to-use-digest-authentication-in-tomcat-8-5
107     */
108     String digestedPw = digester.digest(kw, Digester.SHA256, null);
c65695 109     user.setPw(digestedPw);
35c04d 110     getDb().insert(user, UserMapper);
c65695 111     return user;
U 112   }
113   
725d10 114   public List getUserNameList() {
61cf48 115     String sql = getSql(SQL_GET_USER_NAME_LIST);
U 116     logger.info(sql);
117     return getDb().select(sql, UserDataMapper);
725d10 118   }
U 119   
72c5c3 120   public User deleteUser(User user) {
35c04d 121     PersistenceManager pm = getDb();
4f4b29 122     Connection c = pm.getConnection();
U 123     pm.startTransaction(c);
35c04d 124     pm.execute(c, getSql(SQL_DELETE_USER_ROLES), user.getId());
4f4b29 125     User deletedUser = (User) pm.delete(c, user, UserMapper);
U 126     pm.commit(c);
127     return deletedUser;
72c5c3 128   }
627850 129     
be9fa2 130   /* ------------ Rollen ------------------ */
U 131   
ccefc8 132   public UserRole grantRole(UserRole role) {
U 133     getDb().insert(role, UserRoleMapper);
134     return role;
be9fa2 135   }
U 136   
ccefc8 137   public UserRole revokeRole(UserRole role) {
U 138     getDb().delete(role, UserRoleMapper);
139     return role;
be9fa2 140   }
U 141   
142   public List getRoleNamesGranted() {
35c04d 143     return getDb().select(getSql(SQL_GET_ROLE_LIST), WITHOUT_BLOBS);
be9fa2 144   }
U 145   
c79c12 146   public List getUserRoleNames(String userId) {
35c04d 147     return getDb().select(getSql(SQL_GET_USER_ROLES), WITHOUT_BLOBS, userId);
f8b605 148   }
U 149   
1fc020 150   /* ----------- Helfer ---- */
U 151   
152   /**
153    * Ein benanntes SQL-Kommando ermitteln 
154    * @param id Name des gewuenschten SQL-Kommandos
155    * @return das SQL-Kommando mit der in id angegebenen Bezeichnung 
156    */
35c04d 157   private String getSql(String id) {
1fc020 158     Properties sql = (Properties) ctx.getAttribute(UserMgr.UM_SQL_PROPERTIES);
U 159     return sql.getProperty(id);
160   }
161   
35c04d 162   private PersistenceManager getDb() {
U 163     return (PersistenceManager) ctx.getAttribute(UM_DB);
164   }
165   
1fc020 166   /* ------------- Implementierung WebKontext ------------- */
U 167
168   @Override
169   public ServletContext getServletContext() {
170     return ctx;
171   }
172
173   @Override
174   public void setServletContext(ServletContext servletContext) {
175     this.ctx = servletContext;
176   }
177   
178   
c65695 179 }