// serverAbstractSwitch.java // ------------------------------------- // (C) by Michael Peter Christen; mc@yacy.net // first published on http://www.anomic.de // Frankfurt, Germany, 2004, 2005 // last major change: 24.03.2005 // // 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 2 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, write to the Free Software // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA package de.anomic.server; import java.io.File; import java.io.IOException; import java.net.InetAddress; import java.util.HashMap; import java.util.Iterator; import java.util.Map; import java.util.SortedMap; import java.util.TreeMap; import java.util.concurrent.LinkedBlockingQueue; import de.anomic.kelondro.util.FileUtils; import de.anomic.yacy.logging.Log; public abstract class serverAbstractSwitch implements serverSwitch { // configuration management private final File configFile; private final String configComment; private final File rootPath; protected boolean firstInit; protected Log log; protected int serverJobs; private Map configProps; private final Map configRemoved; private final HashMap authorization; private final TreeMap workerThreads; private final TreeMap switchActions; private final LinkedBlockingQueue cacheStack; private final serverAccessTracker accessTracker; public serverAbstractSwitch(final File rootPath, final String initPath, final String configPath, final boolean applyPro) { // we initialize the switchboard with a property file, // but maintain these properties then later in a new 'config' file // to reset all changed configs, the config file must // be deleted, but not the init file // the only attribute that will always be read from the init is the // file name of the config file this.cacheStack = new LinkedBlockingQueue(); this.rootPath = rootPath; this.configComment = "This is an automatically generated file, updated by serverAbstractSwitch and initialized by " + initPath; final File initFile = new File(rootPath, initPath); this.configFile = new File(rootPath, configPath); // propertiesFile(config); firstInit = !configFile.exists(); // this is true if the application was started for the first time new File(configFile.getParent()).mkdir(); // predefine init's Map initProps; if (initFile.exists()) initProps = FileUtils.loadMap(initFile); else initProps = new HashMap(); // if 'pro'-version is selected, overload standard settings with 'pro'-settings Iterator i; String prop; if (applyPro) { i = new HashMap(initProps).keySet().iterator(); // clone the map to avoid concurrent modification exceptions while (i.hasNext()) { prop = i.next(); if (prop.endsWith("__pro")) { initProps.put(prop.substring(0, prop.length() - 5), initProps.get(prop)); } } } // delete the 'pro' init settings i = initProps.keySet().iterator(); while (i.hasNext()) { prop = i.next(); if (prop.endsWith("__pro")) { i.remove(); } } // load config's from last save if (configFile.exists()) configProps = FileUtils.loadMap(configFile); else configProps = new HashMap(); // remove all values from config that do not appear in init configRemoved = new HashMap(); synchronized (configProps) { i = configProps.keySet().iterator(); String key; while (i.hasNext()) { key = i.next(); if (!(initProps.containsKey(key))) { configRemoved.put(key, this.configProps.get(key)); i.remove(); } } // doing a config settings migration //HashMap migratedSettings = migrateSwitchConfigSettings((HashMap) removedProps); //if (migratedSettings != null) configProps.putAll(migratedSettings); // merge new props from init to config // this is necessary for migration, when new properties are attached initProps.putAll(configProps); configProps = initProps; // save result; this may initially create a config file after // initialization saveConfig(); } // other settings authorization = new HashMap(); // init thread control workerThreads = new TreeMap(); // init switch actions switchActions = new TreeMap(); // init busy state control serverJobs = 0; // init server tracking this.accessTracker = new serverAccessTracker( getConfigLong("server.maxTrackingTime", 60 * 60 * 1000), (int) getConfigLong("server.maxTrackingCount", 1000), (int) getConfigLong("server.maxTrackingHostCount", 100) ); } // a logger for this switchboard public void setLog(final Log log) { this.log = log; } public Log getLog() { return log; } public void setConfig(final Map otherConfigs) { final Iterator> i = otherConfigs.entrySet().iterator(); Map.Entry entry; while (i.hasNext()) { entry = i.next(); setConfig(entry.getKey(), entry.getValue()); } } public void setConfig(final String key, final boolean value) { setConfig(key, (value) ? "true" : "false"); } public void setConfig(final String key, final long value) { setConfig(key, Long.toString(value)); } public void setConfig(final String key, final double value) { setConfig(key, Double.toString(value)); } public void setConfig(final String key, final String value) { // perform action before setting new value final Iterator bevore = switchActions.values().iterator(); final Iterator after = switchActions.values().iterator(); synchronized (configProps) { serverSwitchAction action; while (bevore.hasNext()) { action = bevore.next(); try { action.doBevoreSetConfig(key, value); } catch (final Exception e) { log.logSevere("serverAction bevoreSetConfig '" + action.getShortDescription() + "' failed with exception: " + e.getMessage()); } } // set the value final Object oldValue = configProps.put(key, value); saveConfig(); // perform actions afterwards while (after.hasNext()) { action = after.next(); try { action.doAfterSetConfig(key, value, (oldValue == null) ? null : (String) oldValue); } catch (final Exception e) { log.logSevere("serverAction afterSetConfig '" + action.getShortDescription() + "' failed with exception: " + e.getMessage()); } } } } public void removeConfig(final String key) { configProps.remove(key); } /* (non-Javadoc) * @see de.anomic.server.serverSwitch#getConfig(java.lang.String, java.lang.String) */ public String getConfig(final String key, final String dflt) { final Iterator i = switchActions.values().iterator(); synchronized (configProps) { // get the value final Object s = configProps.get(key); // do action serverSwitchAction action; while (i.hasNext()) { action = i.next(); try { action.doWhenGetConfig(key, (s == null) ? null : (String) s, dflt); } catch (final Exception e) { log.logSevere("serverAction whenGetConfig '" + action.getShortDescription() + "' failed with exception: " + e.getMessage()); } } // return value if (s == null) return dflt; return (String) s; } } public long getConfigLong(final String key, final long dflt) { try { return Long.parseLong(getConfig(key, Long.toString(dflt))); } catch (final NumberFormatException e) { return dflt; } } public double getConfigDouble(final String key, final double dflt) { try { return Double.parseDouble(getConfig(key, Double.toString(dflt))); } catch (final NumberFormatException e) { return dflt; } } public boolean getConfigBool(final String key, final boolean dflt) { return Boolean.valueOf(getConfig(key, Boolean.toString(dflt))).booleanValue(); } /** * Create a File instance for a configuration setting specifying a path. * @param key config key * @param dflt default path value, that is used when there is no value * key in the configuration. * @return if the value of the setting is an absolute path String, then the * returned File is derived from this setting only. Otherwise the path's file * is constructed from the applications root path + the relative path setting. */ public File getConfigPath(final String key, final String dflt) { File ret; final String path = getConfig(key, dflt).replace('\\', '/'); final File f = new File(path); if (f == null) { ret = null; } else { ret = (f.isAbsolute() ? f : new File(this.rootPath, path)); } return ret; } public Iterator configKeys() { return configProps.keySet().iterator(); } private void saveConfig() { try { synchronized (configProps) { FileUtils.saveMap(configFile, configProps, configComment); } } catch (final IOException e) { System.out.println("ERROR: cannot write config file " + configFile.toString() + ": " + e.getMessage()); } } public Map getRemoved() { // returns configuration that had been removed during initialization return configRemoved; } // add/remove action listener public void deployAction(final String actionName, final String actionShortDescription, final String actionLongDescription, final serverSwitchAction newAction) { newAction.setLog(log); newAction.setDescription(actionShortDescription, actionLongDescription); switchActions.put(actionName, newAction); log.logInfo("Deployed Action '" + actionShortDescription + "', (" + switchActions.size() + " actions registered)"); } public void undeployAction(final String actionName) { final serverSwitchAction action = switchActions.get(actionName); action.close(); switchActions.remove(actionName); log.logInfo("Undeployed Action '" + action.getShortDescription() + "', (" + switchActions.size() + " actions registered)"); } public void deployThread( final String threadName, final String threadShortDescription, final String threadLongDescription, final String threadMonitorURL, final serverBusyThread newThread, final long startupDelay) { deployThread(threadName, threadShortDescription, threadLongDescription, threadMonitorURL, newThread, startupDelay, Long.parseLong(getConfig(threadName + "_idlesleep" , "100")), Long.parseLong(getConfig(threadName + "_busysleep" , "1000")), Long.parseLong(getConfig(threadName + "_memprereq" , "1000000"))); } public void deployThread( final String threadName, final String threadShortDescription, final String threadLongDescription, final String threadMonitorURL, final serverBusyThread newThread, final long startupDelay, final long initialIdleSleep, final long initialBusySleep, final long initialMemoryPreRequisite) { if (newThread.isAlive()) throw new RuntimeException("undeployed threads must not live; they are started as part of the deployment"); newThread.setStartupSleep(startupDelay); long x; try { x = Long.parseLong(getConfig(threadName + "_idlesleep" , "novalue")); newThread.setIdleSleep(x); } catch (final NumberFormatException e) { newThread.setIdleSleep(initialIdleSleep); setConfig(threadName + "_idlesleep", initialIdleSleep); } try { x = Long.parseLong(getConfig(threadName + "_busysleep" , "novalue")); newThread.setBusySleep(x); } catch (final NumberFormatException e) { newThread.setBusySleep(initialBusySleep); setConfig(threadName + "_busysleep", initialBusySleep); } try { x = Long.parseLong(getConfig(threadName + "_memprereq" , "novalue")); newThread.setMemPreReqisite(x); } catch (final NumberFormatException e) { newThread.setMemPreReqisite(initialMemoryPreRequisite); setConfig(threadName + "_memprereq", initialMemoryPreRequisite); } newThread.setLog(log); newThread.setDescription(threadShortDescription, threadLongDescription, threadMonitorURL); workerThreads.put(threadName, newThread); // start the thread if (workerThreads.containsKey(threadName)) newThread.start(); } public serverBusyThread getThread(final String threadName) { return workerThreads.get(threadName); } public void setThreadPerformance(final String threadName, final long idleMillis, final long busyMillis, final long memprereqBytes) { final serverBusyThread thread = workerThreads.get(threadName); if (thread != null) { thread.setIdleSleep(idleMillis); thread.setBusySleep(busyMillis); thread.setMemPreReqisite(memprereqBytes); } } public synchronized void terminateThread(final String threadName, final boolean waitFor) { if (workerThreads.containsKey(threadName)) { ((serverThread) workerThreads.get(threadName)).terminate(waitFor); workerThreads.remove(threadName); } } public void intermissionAllThreads(final long pause) { final Iterator e = workerThreads.keySet().iterator(); while (e.hasNext()) { workerThreads.get(e.next()).intermission(pause); } } public synchronized void terminateAllThreads(final boolean waitFor) { Iterator e = workerThreads.keySet().iterator(); while (e.hasNext()) { ((serverThread) workerThreads.get(e.next())).terminate(false); } if (waitFor) { e = workerThreads.keySet().iterator(); while (e.hasNext()) { ((serverThread) workerThreads.get(e.next())).terminate(true); e.remove(); } } } public Iterator /*of serverThread-Names (String)*/ threadNames() { return workerThreads.keySet().iterator(); } public int queueSize() { return cacheStack.size(); } public E queuePeek() { return cacheStack.peek(); } public void enQueue(final E job) { cacheStack.add(job); } public E deQueue() throws InterruptedException { return cacheStack.take(); } // authentification routines: public void setAuthentify(final InetAddress host, final String user, final String rights) { // sets access attributes according to host addresses authorization.put(host, user + "@" + rights); } public void removeAuthentify(final InetAddress host) { // remove access attributes according to host addresses authorization.remove(host); } public String getAuthentifyUser(final InetAddress host) { // read user name according to host addresses final String a = authorization.get(host); if (a == null) return null; final int p = a.indexOf("@"); if (p < 0) return null; return a.substring(0, p); } public String getAuthentifyRights(final InetAddress host) { // read access rigths according to host addresses final String a = authorization.get(host); if (a == null) return null; final int p = a.indexOf("@"); if (p < 0) return null; return a.substring(p + 1); } public void addAuthentifyRight(final InetAddress host, final String right) { final String rights = getAuthentifyRights(host); if (rights == null) { // create new authentification setAuthentify(host, "unknown", right); } else { // add more authentification final String user = getAuthentifyUser(host); setAuthentify(host, user, rights + right); } } public boolean hasAuthentifyRight(final InetAddress host, final String right) { final String rights = getAuthentifyRights(host); if (rights == null) return false; return rights.indexOf(right) >= 0; } public abstract serverObjects action(String actionName, serverObjects actionInput); public File getRootPath() { return rootPath; } public String toString() { return configProps.toString(); } public void handleBusyState(final int jobs) { serverJobs = jobs; } public void track(String host, String accessPath) { this.accessTracker.track(host, accessPath); } public SortedMap accessTrack(String host) { return this.accessTracker.accessTrack(host); } public Iterator accessHosts() { return this.accessTracker.accessHosts(); } }