Nutzerverwaltung
view | history | commit | commitdiff
ulrich
2017-02-10 70a614a0d43b3a8a614e751df442aac1900aedba
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;
88117b 24 import de.uhilger.transit.web.RequestKontext;
1fc020 25 import de.uhilger.transit.web.WebKontext;
6240cd 26 import de.uhilger.um.Digester;
c65695 27 import de.uhilger.um.daten.User;
61cf48 28 import de.uhilger.um.daten.UserData;
87e382 29 import de.uhilger.um.daten.UserRole;
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;
88117b 35 import javax.servlet.http.HttpServletRequest;
c65695 36
U 37 /**
1fc020 38  * <p>Die Methoden der Klasse UserMgr sind  
U 39  * die 'Fassade', die &uuml;ber Transit als Programmschnittstelle 
40  * (Application Programming Interface, API) 
41  * nach au&szlig;en bereitgestellt wird. UserMgr dient weitgehend 
42  * als 'Durchreiche' f&uuml;r die Funktionalit&auml;t anderer Klassen.</p>
59f8b3 43  * 
1fc020 44  * <p>
U 45  * Der UserMgr erh&auml;lt die ben&ouml;tigten Methoden aus dem ServletContext. 
46  * Auf diese Weise sind keine statischen Abh&auml;ngigkeiten in den Code 
47  * gewandert. Die folgenden Elemente werden vom UserMgr im ServletContext 
48  * erwartet:
c43d2a 49  * <ul>
U 50  * <li>PersistenceManager</li>
51  * <li>SQL-Properties</li>
52  * <li>Digester</li>
1fc020 53  * </p> 
627850 54  * 
6240cd 55  * @author Copyright (c) Ulrich Hilger, http://uhilger.de
U 56  * @author Published under the terms and conditions of the
57  * <a href="http://www.gnu.org/licenses/agpl-3.0" target="_blank">GNU Affero
58  * General Public License</a>
59  *
60  * @version 2, December 27, 2016
c65695 61  */
70a614 62 public class UserMgr extends Api /*implements WebKontext, RequestKontext*/ {
1fc020 63   
61cf48 64   private static final Logger logger = Logger.getLogger(UserMgr.class.getName());
U 65   
c43d2a 66   /** Zeiger zum Servlet-Kontext dieser Anwendung */
70a614 67   //private ServletContext ctx;
88117b 68   
70a614 69   //private HttpServletRequest request;
1fc020 70   
U 71   /** Name, unter dem das Properties-Objekt mit den SQL-Befehlen im ServletContext hinterlegt ist */
72   public static final String UM_SQL_PROPERTIES = "umSqlProperties";
73
c43d2a 74   /** Name, unter dem das Digester-Objekt im ServletContext hinterlegt ist */
35c04d 75   public static final String P_DIGESTER = "digester";
U 76
1fc020 77   /** Name, unter dem das Zugriffsobjekt zur Datenbank im ServletContext hinterlegt ist */
U 78   public static final String UM_DB = "umDb";
c65695 79   
35c04d 80   /** Boolean-Konstante zur Kennzeichnung von Datenbankergebnissen ohne Blobs */
U 81   public static final boolean WITHOUT_BLOBS = false;
82
c43d2a 83   /** Referenz zum SQL-Befehl zur Ermittlung der Benutzer */
725d10 84   public static final String SQL_GET_USER_LIST = "getUserList";
c43d2a 85   /** Referenz zum SQL-Befehl zur Ermittlung der Benutzer-Namen */
725d10 86   public static final String SQL_GET_USER_NAME_LIST = "getUserNameList";
c43d2a 87   /** Referenz zum SQL-Befehl zur Ermittlung der Rollen */
87e382 88   public static final String SQL_GET_ROLE_LIST = "getRoleList";
c43d2a 89   /** Referenz zum SQL-Befehl zur Ermittlung der Rollen eines Benutzers */
c79c12 90   public static final String SQL_GET_USER_ROLES = "getUserRoles";
c43d2a 91   /** Referenz zum SQL-Befehl zum Loeschen aller Rollen eines Nutzers */
4f4b29 92   public static final String SQL_DELETE_USER_ROLES = "deleteUserRoles";
70a614 93   public static final String SQL_GET_USER_DATA = "getUserData";
U 94   
95   public static final String MP_USER = "userMapper";
96   public static final String MP_USER_DATA = "userDataMapper";
97   public static final String MP_USER_ROLE = "userRoleMapper";
725d10 98   
c43d2a 99   /** Mapper-Objekt fuer Benutzer */
70a614 100   //private static final Record UserMapper = new GenericRecord(User.class);
61cf48 101   /** Mapper-Objekt fuer Benutzerdaten */
ff2dff 102   //private static final Record UserDataMapper = new GenericRecord(UserData.class);
c43d2a 103   /** Mapper-Objekt fuer Benutzerrollen */
70a614 104   //private static final Record UserRoleMapper = new GenericRecord(UserRole.class);
c43d2a 105   
be9fa2 106   /* ----------- Benutzer -------------- */
U 107   
35c04d 108   public User createUser(User user) throws ClassNotFoundException, InstantiationException, IllegalAccessException {
c65695 109     String kw = user.getPw();
70a614 110     String digesterClassName = getServletContext().getInitParameter(P_DIGESTER);
35c04d 111     Digester digester = (Digester) Class.forName(digesterClassName).newInstance();
e0ec31 112     /*
U 113       MD5 geht nicht mehr,
114       vgl. http://stackoverflow.com/questions/39967289/how-to-use-digest-authentication-in-tomcat-8-5
115     */
116     String digestedPw = digester.digest(kw, Digester.SHA256, null);
c65695 117     user.setPw(digestedPw);
70a614 118     getDb().insert(user, getMapper(MP_USER));
c65695 119     return user;
U 120   }
121   
725d10 122   public List getUserNameList() {
ff2dff 123     return removeHeadline(getDb().select(getSql(SQL_GET_USER_NAME_LIST), WITHOUT_BLOBS));
725d10 124   }
U 125   
72c5c3 126   public User deleteUser(User user) {
35c04d 127     PersistenceManager pm = getDb();
4f4b29 128     Connection c = pm.getConnection();
U 129     pm.startTransaction(c);
35c04d 130     pm.execute(c, getSql(SQL_DELETE_USER_ROLES), user.getId());
70a614 131     User deletedUser = (User) pm.delete(c, user, getMapper(MP_USER));
4f4b29 132     pm.commit(c);
U 133     return deletedUser;
72c5c3 134   }
70a614 135      
88117b 136   public String logout() {
U 137     getRequest().getSession().invalidate();
138         return "logged out";
139   }
140   
be9fa2 141   /* ------------ Rollen ------------------ */
U 142   
ccefc8 143   public UserRole grantRole(UserRole role) {
70a614 144     getDb().insert(role, getMapper(MP_USER_ROLE));
ccefc8 145     return role;
be9fa2 146   }
U 147   
ccefc8 148   public UserRole revokeRole(UserRole role) {
70a614 149     getDb().delete(role, getMapper(MP_USER_ROLE));
ccefc8 150     return role;
be9fa2 151   }
U 152   
153   public List getRoleNamesGranted() {
ff2dff 154     return removeHeadline(getDb().select(getSql(SQL_GET_ROLE_LIST), WITHOUT_BLOBS));
be9fa2 155   }
U 156   
c79c12 157   public List getUserRoleNames(String userId) {
ff2dff 158     return removeHeadline(getDb().select(getSql(SQL_GET_USER_ROLES), WITHOUT_BLOBS, userId));
f8b605 159   }
U 160   
1fc020 161   /* ----------- Helfer ---- */
U 162   
ff2dff 163   private List removeHeadline(List list) {
U 164     if(list != null && list.size() > 0) {
165       list.remove(0);
166     }
167     return list;
168   }
169   
1fc020 170   /**
U 171    * Ein benanntes SQL-Kommando ermitteln 
172    * @param id Name des gewuenschten SQL-Kommandos
173    * @return das SQL-Kommando mit der in id angegebenen Bezeichnung 
174    */
70a614 175   /*
35c04d 176   private String getSql(String id) {
1fc020 177     Properties sql = (Properties) ctx.getAttribute(UserMgr.UM_SQL_PROPERTIES);
U 178     return sql.getProperty(id);
179   }
180   
35c04d 181   private PersistenceManager getDb() {
U 182     return (PersistenceManager) ctx.getAttribute(UM_DB);
183   }
184   
70a614 185   private Record getMapper(String mapperName) {
U 186     Record record = null;
187     Object o = getServletContext().getAttribute(mapperName);
188     if(o instanceof Record) {
189       record = (Record) o;
190     }
191     return record;
192   }
193   */
1fc020 194   /* ------------- Implementierung WebKontext ------------- */
U 195
70a614 196   /*
1fc020 197   @Override
U 198   public ServletContext getServletContext() {
199     return ctx;
200   }
201
202   @Override
203   public void setServletContext(ServletContext servletContext) {
204     this.ctx = servletContext;
205   }
70a614 206   */
1fc020 207   
88117b 208   /* ------------- Implementierung RequestKontext ------------- */
U 209
70a614 210   /*
88117b 211   @Override
U 212   public HttpServletRequest getRequest() {
213     return request;
214   }
215
216   @Override
217   public void setRequest(HttpServletRequest r) {
218     this.request = r;
219   }
70a614 220   */
1fc020 221   
c65695 222 }