SessionManager hinzugefuegt, abstrakte Api-Klasse hinzugefuegt

ulrich

2017-02-10 70a614a0d43b3a8a614e751df442aac1900aedba

 src/java/de/uhilger/um/api/UserMgr.java

@@ -1,102 +1,222 @@
/*
 *  Nutzerverwaltung - User and role management in your browser
 *  Copyright (C) 2011-2016 Ulrich Hilger, http://uhilger.de
 *
 *  This program is free software: you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation, either version 3 of the License, or
 *  (at your option) any later version.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program.  If not, see http://www.gnu.org/licenses/
 */

package de.uhilger.um.api;

import de.uhilger.baselink.GenericRecord;
import de.uhilger.baselink.PersistenceManager;
import de.uhilger.baselink.Record;
import de.uhilger.um.App;
import de.uhilger.transit.web.RequestKontext;
import de.uhilger.transit.web.WebKontext;
import de.uhilger.um.Digester;
import de.uhilger.um.daten.User;
import de.uhilger.um.daten.UserData;
import de.uhilger.um.daten.UserRole;
import java.sql.Connection;
import java.util.List;
import org.apache.catalina.realm.RealmBase;
import java.util.Properties;
import java.util.logging.Logger;
import javax.servlet.ServletContext;
import javax.servlet.http.HttpServletRequest;

/**
 * Klasse zur Verwaltung von Benutzern und Rollen 
 * in einer Datenbank
 * <p>Die Methoden der Klasse UserMgr sind  
 * die 'Fassade', die &uuml;ber Transit als Programmschnittstelle 
 * (Application Programming Interface, API) 
 * nach au&szlig;en bereitgestellt wird. UserMgr dient weitgehend 
 * als 'Durchreiche' f&uuml;r die Funktionalit&auml;t anderer Klassen.</p>
 * 
 * @author Ulrich Hilger
 * <p>
 * Der UserMgr erh&auml;lt die ben&ouml;tigten Methoden aus dem ServletContext. 
 * Auf diese Weise sind keine statischen Abh&auml;ngigkeiten in den Code 
 * gewandert. Die folgenden Elemente werden vom UserMgr im ServletContext 
 * erwartet:
 * <ul>
 * <li>PersistenceManager</li>
 * <li>SQL-Properties</li>
 * <li>Digester</li>
 * </p> 
 * 
 * @author Copyright (c) Ulrich Hilger, http://uhilger.de
 * @author Published under the terms and conditions of the
 * <a href="http://www.gnu.org/licenses/agpl-3.0" target="_blank">GNU Affero
 * General Public License</a>
 *
 * @version 2, December 27, 2016
 */
public class UserMgr {
public class UserMgr extends Api /*implements WebKontext, RequestKontext*/ {
  
  private static final String MD5 = "MD5";
  private static final Logger logger = Logger.getLogger(UserMgr.class.getName());
  
  private static final Record UserMapper = new GenericRecord(User.class);
  private static final Record UserRoleMapper = new GenericRecord(UserRole.class);
  /** Zeiger zum Servlet-Kontext dieser Anwendung */
  //private ServletContext ctx;
  
  //private HttpServletRequest request;
  
  /** Name, unter dem das Properties-Objekt mit den SQL-Befehlen im ServletContext hinterlegt ist */
  public static final String UM_SQL_PROPERTIES = "umSqlProperties";

  /** Name, unter dem das Digester-Objekt im ServletContext hinterlegt ist */
  public static final String P_DIGESTER = "digester";

  /** Name, unter dem das Zugriffsobjekt zur Datenbank im ServletContext hinterlegt ist */
  public static final String UM_DB = "umDb";
  
  /** Boolean-Konstante zur Kennzeichnung von Datenbankergebnissen ohne Blobs */
  public static final boolean WITHOUT_BLOBS = false;

  /** Referenz zum SQL-Befehl zur Ermittlung der Benutzer */
  public static final String SQL_GET_USER_LIST = "getUserList";
  /** Referenz zum SQL-Befehl zur Ermittlung der Benutzer-Namen */
  public static final String SQL_GET_USER_NAME_LIST = "getUserNameList";
  /** Referenz zum SQL-Befehl zur Ermittlung der Rollen */
  public static final String SQL_GET_ROLE_LIST = "getRoleList";
  /** Referenz zum SQL-Befehl zur Ermittlung der Rollen eines Benutzers */
  public static final String SQL_GET_USER_ROLES = "getUserRoles";
  public static final String SQL_DELETE_USER = "deleteUser";
  /** Referenz zum SQL-Befehl zum Loeschen aller Rollen eines Nutzers */
  public static final String SQL_DELETE_USER_ROLES = "deleteUserRoles";
  public static final String SQL_GET_USER_DATA = "getUserData";
  
  public static final String MP_USER = "userMapper";
  public static final String MP_USER_DATA = "userDataMapper";
  public static final String MP_USER_ROLE = "userRoleMapper";
  
  /** Mapper-Objekt fuer Benutzer */
  //private static final Record UserMapper = new GenericRecord(User.class);
  /** Mapper-Objekt fuer Benutzerdaten */
  //private static final Record UserDataMapper = new GenericRecord(UserData.class);
  /** Mapper-Objekt fuer Benutzerrollen */
  //private static final Record UserRoleMapper = new GenericRecord(UserRole.class);
  
  /* ----------- Benutzer -------------- */
  
  public User createUser(User user) {
  public User createUser(User user) throws ClassNotFoundException, InstantiationException, IllegalAccessException {
    String kw = user.getPw();
    String digestedPw = RealmBase.Digest(kw, MD5, null);
    String digesterClassName = getServletContext().getInitParameter(P_DIGESTER);
    Digester digester = (Digester) Class.forName(digesterClassName).newInstance();
    /*
      MD5 geht nicht mehr,
      vgl. http://stackoverflow.com/questions/39967289/how-to-use-digest-authentication-in-tomcat-8-5
    */
    String digestedPw = digester.digest(kw, Digester.SHA256, null);
    user.setPw(digestedPw);
    App.getDatabase().insert(user, UserMapper);
    getDb().insert(user, getMapper(MP_USER));
    return user;
  }
  
  public List getUserNameList() {
    String sql = App.getSqlStatement(SQL_GET_USER_NAME_LIST);
    List userNames = App.getDatabase().select(sql, App.WITHOUT_BLOBS);
    return userNames;
    return removeHeadline(getDb().select(getSql(SQL_GET_USER_NAME_LIST), WITHOUT_BLOBS));
  }
  
  public User deleteUser(User user) {
    return (User) App.getDatabase().delete(user, UserMapper);
    PersistenceManager pm = getDb();
    Connection c = pm.getConnection();
    pm.startTransaction(c);
    pm.execute(c, getSql(SQL_DELETE_USER_ROLES), user.getId());
    User deletedUser = (User) pm.delete(c, user, getMapper(MP_USER));
    pm.commit(c);
    return deletedUser;
  }
  
  /*
  public List getUserList() {
    String sql = App.getSqlStatement(SQL_GET_USER_LIST);
    List users = App.getDatabase().select(sql, UserMapper, App.WITHOUT_BLOBS);
    return users;
     
  public String logout() {
    getRequest().getSession().invalidate();
      return "logged out";
  }
  */
  
  /* ------------ Rollen ------------------ */
  
  public UserRole grantRole(String userId, String roleName) {
    UserRole ur = new UserRole();
    ur.setRole(roleName);
    ur.setUser(userId);
    App.getDatabase().insert(ur, UserRoleMapper);
    return ur;
  public UserRole grantRole(UserRole role) {
    getDb().insert(role, getMapper(MP_USER_ROLE));
    return role;
  }
  
  public UserRole revokeRole(String userId, String roleName) {
    UserRole ur = new UserRole();
    ur.setRole(roleName);
    ur.setUser(userId);
    App.getDatabase().delete(ur, UserRoleMapper);
    return ur;
  public UserRole revokeRole(UserRole role) {
    getDb().delete(role, getMapper(MP_USER_ROLE));
    return role;
  }
  
  public List getRoleNamesGranted() {
    String sql = App.getSqlStatement(SQL_GET_ROLE_LIST);
    List roleNames = App.getDatabase().select(sql, App.WITHOUT_BLOBS);
    return roleNames;
    return removeHeadline(getDb().select(getSql(SQL_GET_ROLE_LIST), WITHOUT_BLOBS));
  }
  
  public List getUserRoleNames(String userId) {
    return removeHeadline(getDb().select(getSql(SQL_GET_USER_ROLES), WITHOUT_BLOBS, userId));
  }
  
  /* ----------- Helfer ---- */
  
  private List removeHeadline(List list) {
    if(list != null && list.size() > 0) {
      list.remove(0);
    }
    return list;
  }
  
  /**
   * 
   * 
   * list.get(recordno).get(fieldno)
   * 
   * @param userId  ID des Benutzers
   * @return List<List<String>> Rollennamen des Benutzers
   * Ein benanntes SQL-Kommando ermitteln 
   * @param id Name des gewuenschten SQL-Kommandos
   * @return das SQL-Kommando mit der in id angegebenen Bezeichnung 
   */
  public List getUserRoleNames(String userId) {
    String sql = App.getSqlStatement(SQL_GET_USER_ROLES);
    List roleNames = App.getDatabase().select(sql, App.WITHOUT_BLOBS, userId);
    return roleNames;
  /*
  private String getSql(String id) {
    Properties sql = (Properties) ctx.getAttribute(UserMgr.UM_SQL_PROPERTIES);
    return sql.getProperty(id);
  }
  
  /* ------------ sonstige Methoden -------------- */
  
  public String hallo() {
    return "Hallo Welt";
  private PersistenceManager getDb() {
    return (PersistenceManager) ctx.getAttribute(UM_DB);
  }
  
  private Record getMapper(String mapperName) {
    Record record = null;
    Object o = getServletContext().getAttribute(mapperName);
    if(o instanceof Record) {
      record = (Record) o;
    }
    return record;
  }
  */
  /* ------------- Implementierung WebKontext ------------- */

  /*
  @Override
  public ServletContext getServletContext() {
    return ctx;
  }

  @Override
  public void setServletContext(ServletContext servletContext) {
    this.ctx = servletContext;
  }
  */
  
  /* ------------- Implementierung RequestKontext ------------- */

  /*
  @Override
  public HttpServletRequest getRequest() {
    return request;
  }

  @Override
  public void setRequest(HttpServletRequest r) {
    this.request = r;
  }
  */
  
}