/** * Copyright 2010 JogAmp Community. All rights reserved. * * Redistribution and use in source and binary forms, with or without modification, are * permitted provided that the following conditions are met: * * 1. Redistributions of source code must retain the above copyright notice, this list of * conditions and the following disclaimer. * * 2. Redistributions in binary form must reproduce the above copyright notice, this list * of conditions and the following disclaimer in the documentation and/or other materials * provided with the distribution. * * THIS SOFTWARE IS PROVIDED BY JogAmp Community ``AS IS'' AND ANY EXPRESS OR IMPLIED * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL JogAmp Community OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * * The views and conclusions contained in the software and documentation are those of the * authors and should not be interpreted as representing official policies, either expressed * or implied, of JogAmp Community. */ /* * Created on Wednesday, March 31 2010 13:30 */ package com.jogamp.gluegen; import java.util.HashMap; import java.util.Map; import java.util.logging.ConsoleHandler; import java.util.logging.Formatter; import java.util.logging.Handler; import java.util.logging.Level; import java.util.logging.LogRecord; import java.util.logging.Logger; import jogamp.common.Debug; import com.jogamp.common.util.PropertyAccess; import com.jogamp.gluegen.cgram.types.AliasedSymbol; import com.jogamp.gluegen.cgram.types.Type; /** * * @author Michael Bien, et.al. */ public class Logging { public static final boolean DEBUG = Debug.debug("Logging"); /** * An interface for {@link Logger}. */ public static interface LoggerIf { /** * See {@link Logger#info(String)} */ void info(final String msg); /** * See {@link Logger#info(String)} */ void info(final ASTLocusTag loc, final String msg); /** * See {@link Logger#warning(String)} */ void warning(final String msg); /** * See {@link Logger#warning(String)} */ void warning(final ASTLocusTag loc, final String msg); /** * Calls {@link #log(Level, String)} w/ {@link Level#FINE}. */ void debug(final String msg); /** * Calls {@link #log(Level, ASTLocusTag, String)} w/ {@link Level#FINE}. */ void debug(final ASTLocusTag loc, final String msg); /** * See {@link Logger#log(Level, String)} */ void log(final Level level, final String msg); /** * See {@link Logger#log(Level, String, Object)} */ void log(final Level level, final String msg, final Object param); /** * See {@link Logger#log(Level, String, Object[])} */ void log(final Level level, final String msg, final Object ... params); /** * See {@link Logger#log(Level, String)} */ void log(final Level level, final ASTLocusTag loc, final String msg); /** * See {@link Logger#log(Level, String, Object)} */ void log(final Level level, final ASTLocusTag loc, final String msg, final Object param); /** * See {@link Logger#log(Level, String, Object[])} */ void log(final Level level, final ASTLocusTag loc, final String msg, final Object ... params); /** * See {@link Logger#setLevel(Level)} */ void setLevel(final Level newLevel) throws SecurityException; /** * See {@link Handler#setLevel(Level)} */ void setLevelOfAllHandler(final Level newLevel) throws SecurityException; /** * See {@link Logger#getLevel()} */ Level getLevel(); /** * See {@link Logger#isLoggable(Level)} */ boolean isLoggable(Level level); /** * See {@link Logger#getName()} */ String getName(); /** * See {@link Logger#getHandlers()} */ Handler[] getHandlers(); /** * See {@link LogRecord#getSourceClassName()} */ String getSourceClassName(); } /* pp */ static class FQNLogger implements LoggerIf { public final Logger impl; public final PlainLogConsoleHandler handler; /* pp */ FQNLogger(final String fqnClassName, final String simpleClassName, final Level level) { this.impl = Logger.getLogger(fqnClassName); this.handler = new PlainLogConsoleHandler(new PlainLogFormatter(simpleClassName), Level.ALL); this.impl.setUseParentHandlers(false); this.impl.setLevel(level); this.impl.addHandler(this.handler); this.impl.log(Level.INFO, "Logging.new: "+impl.getName()+": level "+level+ ": obj 0x"+Integer.toHexString(impl.hashCode())); } @Override public void info(final String msg) { impl.info(msg); } @Override public void info(final ASTLocusTag loc, final String msg) { handler.plf.setASTLocusTag(loc); try { impl.info(msg); } finally { handler.plf.setASTLocusTag(null); } } @Override public void warning(final String msg) { impl.warning(msg); } @Override public void warning(final ASTLocusTag loc, final String msg) { handler.plf.setASTLocusTag(loc); try { impl.warning(msg); } finally { handler.plf.setASTLocusTag(null); } } @Override public void debug(final String msg) { log(Level.FINE, msg); } @Override public void debug(final ASTLocusTag loc, final String msg) { log(Level.FINE, loc, msg); } @Override public void log(final Level level, final String msg) { impl.log(level, msg); } @Override public void log(final Level level, final String msg, final Object param) { impl.log(level, msg, param); } @Override public void log(final Level level, final String msg, final Object ... params) { impl.log(level, msg, params); } @Override public void log(final Level level, final ASTLocusTag loc, final String msg) { handler.plf.setASTLocusTag(loc); try { impl.log(level, msg); } finally { handler.plf.setASTLocusTag(null); } } @Override public void log(final Level level, final ASTLocusTag loc, final String msg, final Object param) { handler.plf.setASTLocusTag(loc); try { impl.log(level, msg, param); } finally { handler.plf.setASTLocusTag(null); } } @Override public void log(final Level level, final ASTLocusTag loc, final String msg, final Object ... params) { handler.plf.setASTLocusTag(loc); try { impl.log(level, msg, params); } finally { handler.plf.setASTLocusTag(null); } } @Override public void setLevel(final Level newLevel) throws SecurityException { impl.setLevel(newLevel); } @Override public void setLevelOfAllHandler(final Level newLevel) throws SecurityException { final Handler[] hs = getHandlers(); for(final Handler h:hs) { h.setLevel(newLevel); } } @Override public Level getLevel() { return impl.getLevel(); } @Override public boolean isLoggable(final Level level) { return impl.isLoggable(level); } @Override public String getName() { return impl.getName(); } @Override public synchronized Handler[] getHandlers() { return impl.getHandlers(); } @Override public String getSourceClassName() { return handler.plf.simpleClassName; } } static class PlainLogConsoleHandler extends ConsoleHandler { final PlainLogFormatter plf; PlainLogConsoleHandler(final PlainLogFormatter plf, final Level level) { this.plf = plf; setFormatter(plf); setLevel(level); } @Override public java.util.logging.Formatter getFormatter() { return plf; } } static class PlainLogFormatter extends Formatter { final String simpleClassName; ASTLocusTag astLocus; PlainLogFormatter(final String simpleClassName) { this.simpleClassName = simpleClassName; } public void setASTLocusTag(final ASTLocusTag loc) { astLocus = loc; } @Override public String format(final LogRecord record) { // Replace [Type, JavaType] -> its debug string! final Object[] params = record.getParameters(); if( null != params ) { for(int i=params.length-1; 0<=i; i--) { final Object o = params[i]; if( o instanceof Type ) { params[i] = ((Type)o).getDebugString(); } else if( o instanceof JavaType ) { params[i] = ((JavaType)o).getDebugString(); } else if( o instanceof AliasedSymbol ) { params[i] = ((AliasedSymbol)o).getAliasedString(); } } } final StringBuilder sb = new StringBuilder(256); if( null != astLocus ) { astLocus.toString(sb, getCanonicalName(record.getLevel()), GlueGen.debug()).append(": "); } if( GlueGen.debug() ) { sb.append(simpleClassName).append(": "); } sb.append(formatMessage(record)).append("\n"); return sb.toString(); } } private final static Map loggers; private final static FQNLogger rootPackageLogger; static { loggers = new HashMap(); final String packageName = Logging.class.getPackage().getName(); final String property = PropertyAccess.getProperty(packageName+".level", true); Level level; if(property != null) { level = Level.parse(property); } else { if( DEBUG || GlueGen.debug() ) { level = Level.ALL; } else { level = Level.WARNING; } } final String simpleClassName = Logging.class.getSimpleName(); final String fqnClassName = packageName+"."+simpleClassName; rootPackageLogger = new FQNLogger(fqnClassName, simpleClassName, level); loggers.put(fqnClassName, rootPackageLogger); } /** provokes static initialization */ static void init() { } public static String getCanonicalName(final Level level) { if( Level.CONFIG == level ) { return "config"; } else if( Level.FINER == level ) { return "verbose"; } else if( Level.FINE == level ) { return "debug"; } else if( Level.INFO == level ) { return "info"; } else if( Level.WARNING == level ) { return "warning"; } else if( Level.SEVERE == level ) { return "error"; } else { return level.getName().toLowerCase(); } } /** Returns the root package logger. */ public static LoggerIf getLogger() { return rootPackageLogger; } /** Returns the demanded logger, while aligning its log-level to the root logger's level. */ public static synchronized LoggerIf getLogger(final Class clazz) { return getLogger(clazz.getPackage().getName(), clazz.getSimpleName()); } /** Returns the demanded logger, while aligning its log-level to the root logger's level. */ public static synchronized LoggerIf getLogger(final String packageName, final String simpleClassName) { final String fqnClassName = packageName+"."+simpleClassName; LoggerIf res = loggers.get(fqnClassName); if( null == res ) { res = new FQNLogger(fqnClassName, simpleClassName, rootPackageLogger.getLevel()); loggers.put(fqnClassName, res); } return res; } /** Align log-level of given logger to the root logger's level. */ public static void alignLevel(final LoggerIf l) { alignLevel(l, rootPackageLogger.getLevel()); } /** Align log-level of given logger and all its handlers to the given level. */ public static void alignLevel(final LoggerIf l, final Level level) { l.setLevel(level); l.setLevelOfAllHandler(level); } }