Java tutorial
/* * * Copyright 2013 Entando S.r.l. (http://www.entando.com) All rights reserved. * * This file is part of Entando software. * Entando is a free software; * You can redistribute it and/or modify it * under the terms of the GNU General Public License (GPL) as published by the Free Software Foundation; version 2. * * See the file License for the specific language governing permissions * and limitations under the License * * * * Copyright 2013 Entando S.r.l. (http://www.entando.com) All rights reserved. * */ package com.agiletec.aps.system.services.baseconfig; import java.io.StringReader; import java.util.Map; import org.apache.commons.digester.Digester; import org.apache.commons.digester.Rule; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import com.agiletec.aps.system.SystemConstants; import com.agiletec.aps.system.common.AbstractService; import com.agiletec.aps.system.exception.ApsSystemException; import com.agiletec.aps.util.MapSupportRule; /** * Servizio di configurazione. Carica da db e rende disponibile * la configurazione. La configurazione costituita da voci (items), individuate * da un nome, e da parametri, anch'essi individuati da un nome. I parametri sono * stringhe semplici, le voci possono essere testi XML complessi. * In particolare, una delle voci contiene la configurazione dei parametri * in forma di testo XML. * L'insieme dei parametri comprende anche le propriet di inizializzazione, * passate alla factory del contesto di sistema; i valori di queste possono * essere sovrascritti dai valori di eventuali parametri omonimi. * @author M.Diana - E.Santoboni */ public class BaseConfigManager extends AbstractService implements ConfigInterface { private static final Logger _logger = LoggerFactory.getLogger(BaseConfigManager.class); @Override public void init() throws Exception { this.loadConfigItems(); this.parseParams(); _logger.debug("{} ready. Initialized {} configuration items and {} parameters", this.getClass().getName(), this._configItems.size(), this._params.size()); //ApsSystemUtils.getLogger().debug(this.getClass().getName() + ": initialized # " //+ this._configItems.size() + " configuration items and " //+ this._params.size() + " parameters"); } /** * Restituisce il valore di una voce della tabella di sistema. * Il valore pu essere un XML complesso. * @param name Il nome della voce di configurazione. * @return Il valore della voce di configurazione. */ @Override public String getConfigItem(String name) { return (String) this._configItems.get(name); } /** * Aggiorna un'item di configurazione nella mappa * della configurazione degli item e nel db. * @param itemName Il nome dell'item da aggiornare. * @param config La nuova configurazione. * @throws ApsSystemException */ @Override public void updateConfigItem(String itemName, String config) throws ApsSystemException { String oldParamValue = this.getConfigItem(itemName); this._configItems.put(itemName, config); String version = (String) this._params.get(SystemConstants.INIT_PROP_CONFIG_VERSION); try { this.getConfigDAO().updateConfigItem(itemName, config, version); this.refresh(); } catch (Throwable t) { this._configItems.put(itemName, oldParamValue); _logger.error("Error while updating item {}", itemName, t); //ApsSystemUtils.logThrowable(t, this, "updateConfigItem"); throw new ApsSystemException("Error while updating item", t); } } /** * Restituisce il valore di un parametro di configurazione. * I parametri sono desunti dalla voce "params" della tabella di sistema. * @param name Il nome del parametro di configurazione. * @return Il valore del parametro di configurazione. */ @Override public String getParam(String name) { return (String) this._params.get(name); } /** * Carica le voci di configurazione da db e le memorizza su un Map. * @throws ApsSystemException in caso di errori di lettura da db */ private void loadConfigItems() throws ApsSystemException { String version = (String) this._params.get(SystemConstants.INIT_PROP_CONFIG_VERSION); try { _configItems = this.getConfigDAO().loadVersionItems(version); } catch (Throwable t) { throw new ApsSystemException("Error while loading items", t); } } /** * Esegue il parsing della voce di configurazione "params" per * estrarre i parametri. I parametri sono caricati sul Map passato * come argomento. I parametri corrispondono a tag del tipo:<br> * <Param name="nome_parametro">valore_parametro</Param><br> * qualunque sia la loro posizione relativa nel testo XML.<br> * ATTENZIONE: non viene controllata l'univocit del nome, in caso * di doppioni il precedente valore perso. * @throws ApsSystemException In caso di errori IO e Sax */ private void parseParams() throws ApsSystemException { String xml = this.getConfigItem(SystemConstants.CONFIG_ITEM_PARAMS); Digester dig = new Digester(); Rule rule = new MapSupportRule("name"); dig.addRule("*/Param", rule); dig.push(this._params); try { dig.parse(new StringReader(xml)); } catch (Exception e) { _logger.error( "Error detected while parsing the \"params\" item in the \"sysconfig\" table: verify the \"sysconfig\" table", e); //ApsSystemUtils.logThrowable(e, this, "parseParams"); throw new ApsSystemException( "Error detected while parsing the \"params\" item in the \"sysconfig\" table:" + " verify the \"sysconfig\" table", e); } } /** * Restutuisce il dao in uso al manager. * @return Il dao in uso al manager. */ protected IConfigItemDAO getConfigDAO() { return _configDao; } /** * Setta il dao in uso al manager. * @param configDao Il dao in uso al manager. */ public void setConfigDAO(IConfigItemDAO configDao) { this._configDao = configDao; } /** * Setta la mappa dei parametri di inizializzazione del sistema. * @param systemParams La mappa dei parametri di inizializzazione. */ public void setSystemParams(Map<String, String> systemParams) { this._params = systemParams; } /** * Map contenente tutte le voci di configurazione di una versione. */ private Map<String, String> _configItems; /** * Map contenente tutti i parametri di configurazione di una versione. */ private Map<String, String> _params; private IConfigItemDAO _configDao; }