[MNG-6931] Deprecate custom logging approach

This closes #385
This commit is contained in:
Michael Osipov 2020-10-18 20:06:04 +02:00
parent a5b292ddf8
commit 87670ddc08
5 changed files with 26 additions and 8 deletions

View File

@ -24,7 +24,10 @@ import org.codehaus.plexus.logging.Logger;
/** /**
* @author jdcasey * @author jdcasey
*
* @deprecated Use SLF4J directly
*/ */
@Deprecated
public class DefaultLog public class DefaultLog
implements Log implements Log
{ {
@ -128,4 +131,4 @@ public class DefaultLog
return logger.isErrorEnabled(); return logger.isErrorEnabled();
} }
} }

View File

@ -128,9 +128,9 @@ import org.apache.maven.plugin.logging.SystemStreamLog;
* </td> * </td>
* </tr> * </tr>
* </table> * </table>
* <p>This is only a small set of all the options. A complete list can be found at * <p>This is only a small set of all the options. A complete list can be found at
* <a href="https://maven.apache.org/components/plugin-tools/maven-plugin-tools-annotations/index.html" target="_blank"> * <a href="https://maven.apache.org/components/plugin-tools/maven-plugin-tools-annotations/index.html" target="_blank">
* Maven Plugin Tool for Annotations</a>. * Maven Plugin Tool for Annotations</a>.
* *
* @see <a href="https://maven.apache.org/guides/plugin/guide-java-plugin-development.html" target="_blank">Guide to Developing Java Plugins</a> * @see <a href="https://maven.apache.org/guides/plugin/guide-java-plugin-development.html" target="_blank">Guide to Developing Java Plugins</a>
* @see <a href="https://maven.apache.org/guides/mini/guide-configuring-plugins.html" target="_blank">Guide to Configuring Plug-ins</a> * @see <a href="https://maven.apache.org/guides/mini/guide-configuring-plugins.html" target="_blank">Guide to Configuring Plug-ins</a>
@ -149,6 +149,10 @@ public abstract class AbstractMojo
/** Plugin container context */ /** Plugin container context */
private Map pluginContext; private Map pluginContext;
/**
* @deprecated Use SLF4J directly
*/
@Deprecated
@Override @Override
public void setLog( Log log ) public void setLog( Log log )
{ {
@ -167,7 +171,9 @@ public abstract class AbstractMojo
* method directly whenever you need the logger, it is fast enough and needs no caching. * method directly whenever you need the logger, it is fast enough and needs no caching.
* *
* @see org.apache.maven.plugin.Mojo#getLog() * @see org.apache.maven.plugin.Mojo#getLog()
* @deprecated Use SLF4J directly
*/ */
@Deprecated
@Override @Override
public Log getLog() public Log getLog()
{ {

View File

@ -54,16 +54,19 @@ public interface Mojo
* and feedback to the user. * and feedback to the user.
* *
* @param log a new logger * @param log a new logger
*
* @deprecated Use SLF4J directly
*/ */
// TODO not sure about this here, and may want a getLog on here as well/instead @Deprecated
void setLog( Log log ); void setLog( Log log );
/** /**
* Furnish access to the standard Maven logging mechanism which is managed in this base class. * Furnish access to the standard Maven logging mechanism which is managed in this base class.
* *
* @return a log4j-like logger object which allows plugins to create messages at levels of <code>"debug"</code>, * @return a log4j-like logger object which allows plugins to create messages at levels of <code>"debug"</code>,
* <code>"info"</code>, <code>"warn"</code>, and <code>"error"</code>. This logger is the accepted means to display * <code>"info"</code>, <code>"warn"</code>, and <code>"error"</code>.
* information to the user. * @deprecated Use SLF4J directly
*/ */
@Deprecated
Log getLog(); Log getLog();
} }

View File

@ -28,7 +28,10 @@ package org.apache.maven.plugin.logging;
* rather than formatting first by calling <code>toString()</code>. * rather than formatting first by calling <code>toString()</code>.
* *
* @author jdcasey * @author jdcasey
*
* @deprecated Use SLF4J directly
*/ */
@Deprecated
public interface Log public interface Log
{ {
/** /**
@ -146,4 +149,4 @@ public interface Log
* @param error * @param error
*/ */
void error( Throwable error ); void error( Throwable error );
} }

View File

@ -26,7 +26,10 @@ import java.io.StringWriter;
* Logger with "standard" output and error output stream. * Logger with "standard" output and error output stream.
* *
* @author jdcasey * @author jdcasey
*
* @deprecated Use SLF4J directly
*/ */
@Deprecated
public class SystemStreamLog public class SystemStreamLog
implements Log implements Log
{ {
@ -193,4 +196,4 @@ public class SystemStreamLog
System.out.println( "[" + prefix + "] " + content.toString() + "\n\n" + sWriter.toString() ); System.out.println( "[" + prefix + "] " + content.toString() + "\n\n" + sWriter.toString() );
} }
} }