/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.apache.jena.atlas.logging.java;

import java.io.OutputStream ;
import java.nio.charset.StandardCharsets ;
import java.util.logging.* ;

import org.apache.commons.io.output.CloseShieldOutputStream;

/** Console handler that modifies {@link java.util.logging.ConsoleHandler}.
 * Supports the configuration parameters of {@link ConsoleHandler} -- {@code .level},
 * {@code .filter}, {@code .formatter} and {@code .encoding}.
 * <p>
 * Defaults:
 * <ul>
 * <li>Stdout, rather than stderr, by default.</li>
 * <li>{@link TextFormatter} rather than {@link java.util.logging.SimpleFormatter}</li>
 * <li>UTF-8, rather than platform charset</li>
 * </ul>
 * Example:
 * <pre>
 * handlers=org.apache.jena.atlas.logging.java.ConsoleHandlerStream</pre>
 * or to configure the formatter as well:
 * <pre>
 * handlers=org.apache.jena.atlas.logging.java.ConsoleHandlerStream
 * org.apache.jena.atlas.logging.java.TextFormatter.format = %5$tT %3$-5s %2$-20s -- %6$s</pre>
 */
public class ConsoleHandlerStream extends StreamHandler {
    
    // We can't use ConsoleHandler.  
    // The setOutputStream() operation closes the previous stream but when the only
    // constructor ConsoleHandler() runs, it sets output to System.err.
    // So System.err is then closed in the app!
    // We need to chose the output in the constructor and ConsoleHandler does not allow that,
    // hence going straight to StreamHandler and having to provide the functionality here. 
    
    private static OutputStream protectStdOutput(OutputStream outputStream) {
        if ( outputStream == System.err || outputStream == System.out )
            return new CloseShieldOutputStream(outputStream);
        return outputStream;
    }
    
    public ConsoleHandlerStream() {
        this(System.out) ;
    }
    
    public ConsoleHandlerStream(OutputStream outputStream) {
        super(protectStdOutput(outputStream), new TextFormatter()) ;
        
        LogManager manager = LogManager.getLogManager();
        ClassLoader classLoader = ClassLoader.getSystemClassLoader() ;
        String cname = getClass().getName();
        
        // -- Level
        Level level = Level.INFO ;
        String pLevel = getProperty(manager, cname, "level") ;
        if ( pLevel != null )
            level = Level.parse(pLevel) ;
        setLevel(level);
        
        // -- Formatter
        // The default is TextFormatter above
        // (we had to pass a Formatter of some kind to super(,)).
        String pFormatter = getProperty(manager, cname, "formatter") ;
        if ( pFormatter != null ) {
            try {
                Class<?> cls = classLoader.loadClass(pFormatter);
                setFormatter((Formatter) cls.newInstance());
            } catch (Exception ex) {
                System.err.println("Problems setting the logging formatter") ;
                ex.printStackTrace(System.err);
            }
        }
        
        // -- Filter
        String pFilter = getProperty(manager, cname, "filter") ;
        if ( pFilter != null ) {
            try {
                Class<?> cls = classLoader.loadClass(pFilter);
                setFilter((Filter) cls.newInstance());
            } catch (Exception ex) {
                System.err.println("Problems setting the logging filter") ;
                ex.printStackTrace(System.err);
            }
        }
        
        // -- Encoding : Default UTF-8
        String pEncoding = getProperty(manager, cname, "encoding") ;
        if ( pEncoding == null )
            pEncoding = StandardCharsets.UTF_8.name() ;
        try { setEncoding(pEncoding) ; }
        catch (Exception e) { 
            // That should work for UTF-8 as it is a required charset. 
            System.err.print("Failed to set encoding: "+e.getMessage()) ;
        }
    }
    
    private static String getProperty(LogManager manager, String cname, String pname) {
        return manager.getProperty(cname+"."+pname);
    }
    
    @Override
    public void publish(LogRecord record) {
        super.publish(record);
        flush();
    }
}
