Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors

Deprecated Interfaces

Interface and Description
org.apache.maven.shared.utils.io.DirectoryWalkListener use java.nio.file.FileVisitor and related classes
org.apache.maven.shared.utils.io.ScanConductor use java.nio.file.Files.walkFileTree() and related classes

Deprecated Classes

Class and Description
org.apache.maven.shared.utils.cli.shell.CommandShell Windows ME is long dead. Update to Windows 10 and use CmdShell.
org.apache.maven.shared.utils.io.DirectoryScanner use java.nio.file.DirectoryStream and related classes
org.apache.maven.shared.utils.io.DirectoryScanResult use java.nio.file.DirectoryStream and related classes
org.apache.maven.shared.utils.io.Java7Support no longer needed, prefer to use Files methods directly.
org.apache.maven.shared.utils.io.MatchPattern use java.nio.filejava.nio.file.DirectoryStream.Filter<T> and related classes
org.apache.maven.shared.utils.io.MatchPatterns use java.nio.filejava.nio.file.DirectoryStream.Filter<T> and related classes
org.apache.maven.shared.utils.io.SelectorUtils use java.nio.file.Files.walkFileTree() and related classes
org.apache.maven.shared.utils.io.WalkCollector use java.nio.file.FileVisitor and related classes
org.apache.maven.shared.utils.xml.XmlStreamReader use org.apache.commons.io.input.XmlStreamReader instead

Deprecated Fields

Field and Description
org.apache.maven.shared.utils.WriterFactory.ISO_8859_1 use java.nio.charset.StandardCharset.ISO_8859_1
org.apache.maven.shared.utils.ReaderFactory.ISO_8859_1 use java.nio.charset.StandardCharset.ISO_8859_1
org.apache.maven.shared.utils.WriterFactory.US_ASCII use java.nio.charset.StandardCharset.US_ASCII
org.apache.maven.shared.utils.ReaderFactory.US_ASCII use java.nio.charset.StandardCharset.US_ASCII
org.apache.maven.shared.utils.WriterFactory.UTF_16 use java.nio.charset.StandardCharset.UTF_16
org.apache.maven.shared.utils.ReaderFactory.UTF_16 use java.nio.charset.StandardCharset.UTF_16
org.apache.maven.shared.utils.WriterFactory.UTF_16BE use java.nio.charset.StandardCharset.UTF_16BE
org.apache.maven.shared.utils.ReaderFactory.UTF_16BE use java.nio.charset.StandardCharset.UTF_16BE
org.apache.maven.shared.utils.WriterFactory.UTF_16LE use java.nio.charset.StandardCharset.UTF_16LE
org.apache.maven.shared.utils.ReaderFactory.UTF_16LE use java.nio.charset.StandardCharset.UTF_16LE
org.apache.maven.shared.utils.WriterFactory.UTF_8 use java.nio.charset.StandardCharset.UTF_8
org.apache.maven.shared.utils.ReaderFactory.UTF_8 use java.nio.charset.StandardCharset.UTF_8

Deprecated Methods

Method and Description
org.apache.maven.shared.utils.io.FileUtils.cleanDirectory(File) use org.apache.commons.io.FileUtils.cleanDirectory()
org.apache.maven.shared.utils.cli.StreamPumper.close() As of 3.2.0, removed without replacement.
org.apache.maven.shared.utils.io.IOUtil.close(Channel) use try-with-resources
org.apache.maven.shared.utils.io.IOUtil.close(InputStream) use try-with-resources
org.apache.maven.shared.utils.io.IOUtil.close(OutputStream) use try-with-resources
org.apache.maven.shared.utils.io.IOUtil.close(Reader) use try-with-resources
org.apache.maven.shared.utils.io.IOUtil.close(Writer) use try-with-resources
org.apache.maven.shared.utils.io.IOUtil.contentEquals(InputStream, InputStream) use org.apache.commons.io.IOUtils.contentEquals()
org.apache.maven.shared.utils.io.IOUtil.copy(byte[], OutputStream) inline this method
org.apache.maven.shared.utils.io.IOUtil.copy(byte[], Writer) always specify a character encoding
org.apache.maven.shared.utils.io.IOUtil.copy(byte[], Writer, int) always specify a character encoding
org.apache.maven.shared.utils.io.IOUtil.copy(byte[], Writer, String) use org.apache.commons.io.IOUtils.write().
org.apache.maven.shared.utils.io.IOUtil.copy(byte[], Writer, String, int) use org.apache.commons.io.IOUtils.write().
org.apache.maven.shared.utils.io.IOUtil.copy(InputStream, OutputStream) use org.apache.commons.io.IOUtils.copy() or in Java 9 and later InputStream.transferTo().
org.apache.maven.shared.utils.io.IOUtil.copy(InputStream, OutputStream, int) use org.apache.commons.io.IOUtils.copy() or in Java 9 and later InputStream.transferTo().
org.apache.maven.shared.utils.io.IOUtil.copy(InputStream, Writer) use org.apache.commons.io.IOUtils.copy().
org.apache.maven.shared.utils.io.IOUtil.copy(InputStream, Writer, int) use org.apache.commons.io.IOUtils.copy().
org.apache.maven.shared.utils.io.IOUtil.copy(InputStream, Writer, String) use org.apache.commons.io.IOUtils.copy().
org.apache.maven.shared.utils.io.IOUtil.copy(InputStream, Writer, String, int) use org.apache.commons.io.IOUtils.copy().
org.apache.maven.shared.utils.io.IOUtil.copy(Reader, OutputStream) always specify a character encoding
org.apache.maven.shared.utils.io.IOUtil.copy(Reader, OutputStream, int) always specify a character encoding
org.apache.maven.shared.utils.io.IOUtil.copy(Reader, Writer)
org.apache.maven.shared.utils.io.IOUtil.copy(Reader, Writer, int) use org.apache.commons.io.IOUtils.copy().
org.apache.maven.shared.utils.io.IOUtil.copy(String, OutputStream) always specify a character encoding
org.apache.maven.shared.utils.io.IOUtil.copy(String, OutputStream, int) always specify a character encoding
org.apache.maven.shared.utils.io.IOUtil.copy(String, Writer) use org.apache.commons.io.IOUtils.write().
org.apache.maven.shared.utils.io.FileUtils.copyDirectory(File, File) use org.apache.commons.io.FileUtils.copyDirectory()
org.apache.maven.shared.utils.io.FileUtils.copyDirectory(File, File, String, String) use org.apache.commons.io.FileUtils.copyDirectory()
org.apache.maven.shared.utils.io.FileUtils.copyDirectoryStructure(File, File) use org.apache.commons.io.FileUtils.copyDirectory()
org.apache.maven.shared.utils.io.FileUtils.copyFile(File, File) use java.nio.Files.copy(source.toPath(), destination.toPath(), LinkOption.NOFOLLOW_LINKS, StandardCopyOption.REPLACE_EXISTING)
org.apache.maven.shared.utils.io.FileUtils.copyFileToDirectory(File, File) use org.apache.commons.io.FileUtils.copyFileToDirectory()
org.apache.maven.shared.utils.io.FileUtils.copyURLToFile(URL, File) use java.nio.Files.copy(source.openStream(), destination.toPath(), StandardCopyOption.REPLACE_EXISTING)
org.apache.maven.shared.utils.io.FileUtils.createTempFile(String, String, File) use java.nio.Files.createTempFile()
org.apache.maven.shared.utils.StringUtils.defaultString(Object) use java.lang.Objects.toString()
org.apache.maven.shared.utils.StringUtils.defaultString(Object, String) use java.lang.Objects.toString()
org.apache.maven.shared.utils.io.FileUtils.delete(File) use java.nio.files.Files.delete(file.toPath())
org.apache.maven.shared.utils.io.FileUtils.deleteDirectory(File) use org.apache.commons.io.FileUtils.deleteDirectory()
org.apache.maven.shared.utils.io.FileUtils.deleteDirectory(String) use org.apache.commons.io.FileUtils.deleteDirectory()
org.apache.maven.shared.utils.io.FileUtils.deleteLegacyStyle(File) use java.nio.files.Files.delete(file.toPath())
org.apache.maven.shared.utils.io.FileUtils.dirname(String) use Paths.get(path).getParent().getName()
org.apache.maven.shared.utils.StringUtils.equals(String, String) use java.lang.Objects.equals()
org.apache.maven.shared.utils.io.FileUtils.extension(String) use org.apache.commons.io.FilenameUtils.getExtension
org.apache.maven.shared.utils.io.FileUtils.fileAppend(String, String) use java.nio.files.Files.write(filename, data.getBytes(), StandardOpenOption.APPEND, StandardOpenOption.CREATE)
org.apache.maven.shared.utils.io.FileUtils.fileAppend(String, String, String) use java.nio.files.Files.write(filename, data.getBytes(encoding), StandardOpenOption.APPEND, StandardOpenOption.CREATE)
org.apache.maven.shared.utils.io.FileUtils.fileDelete(String) use Files.delete(Paths.get(fileName))
org.apache.maven.shared.utils.io.FileUtils.fileExists(String) use java.io.File.exists()
org.apache.maven.shared.utils.io.FileUtils.filename(String) use Paths.get(path).getName()
org.apache.maven.shared.utils.io.FileUtils.fileRead(File) use new String(java.nio.files.Files.readAllBytes(file.toPath()))
org.apache.maven.shared.utils.io.FileUtils.fileRead(File, String) use new String(java.nio.files.Files.readAllBytes(file.toPath()), encoding)
org.apache.maven.shared.utils.io.FileUtils.fileRead(String) use new String(java.nio.files.Files.readAllBytes(file))
org.apache.maven.shared.utils.io.FileUtils.fileReadArray(File) use java.nio.files.Files.readAllLines()
org.apache.maven.shared.utils.io.FileUtils.fileWrite(File, String, String) use java.nio.files.Files.write(file.toPath(), data.getBytes(encoding), StandardOpenOption.CREATE)
org.apache.maven.shared.utils.io.FileUtils.fileWrite(String, String) use java.nio.files.Files.write(filename, data.getBytes(), StandardOpenOption.CREATE)
org.apache.maven.shared.utils.io.FileUtils.fileWrite(String, String, String) use java.nio.files.Files.write(Paths.get(filename), data.getBytes(encoding), StandardOpenOption.CREATE)
org.apache.maven.shared.utils.io.FileUtils.fileWriteArray(File, String...) use java.nio.files.Files.write(file.toPath(), data.getBytes(encoding), StandardOpenOption.CREATE)
org.apache.maven.shared.utils.io.FileUtils.fileWriteArray(File, String, String...) use java.nio.files.Files.write(file.toPath(), data.getBytes(encoding), StandardOpenOption.CREATE)
org.apache.maven.shared.utils.cli.StreamPumper.flush() As of 3.2.0, removed without replacement.
org.apache.maven.shared.utils.io.FileUtils.forceDelete(File) use org.apache.commons.io.FileUtils.deleteQuietly()
org.apache.maven.shared.utils.io.FileUtils.forceDelete(String) use org.apache.commons.io.FileUtils.deleteQuietly()
org.apache.maven.shared.utils.io.FileUtils.getExtension(String) use org.apache.commons.io.FilenameUtils.getExtension()
org.apache.maven.shared.utils.io.DirectoryScanner.getIncludedDirectories() this method is buggy. Do not depend on it.
org.apache.maven.shared.utils.io.DirectoryScanner.getIncludedFiles() this method does not work correctly on Windows.
org.apache.maven.shared.utils.cli.CommandLineUtils.getSystemEnvVars() use System#getenv()
org.apache.maven.shared.utils.cli.CommandLineUtils.getSystemEnvVars(boolean) use System#getenv()
org.apache.maven.shared.utils.io.FileUtils.isSymbolicLink(File) use java.nio.file.Files.isSymbolicLink(file.toPath())
org.apache.maven.shared.utils.io.FileUtils.isSymbolicLinkForSure(File) use java.nio.file.Files.isSymbolicLink(file.toPath())
org.apache.maven.shared.utils.io.FileUtils.loadFile(File) assumes the platform default character set
org.apache.maven.shared.utils.PropertyUtils.loadProperties(File) use PropertyUtils.loadOptionalProperties(java.io.File) instead. This method should not be used as it suppresses exceptions silently when loading properties fails and returns null instead of an empty Properties instance when the given File is null.
org.apache.maven.shared.utils.PropertyUtils.loadProperties(InputStream) use PropertyUtils.loadOptionalProperties(java.io.InputStream) instead. This method should not be used as it suppresses exceptions silently when loading properties fails.
org.apache.maven.shared.utils.PropertyUtils.loadProperties(URL) use PropertyUtils.loadOptionalProperties(java.net.URL) instead. This method should not be used as it suppresses exceptions silently when loading properties fails and returns null instead of an empty Properties instance when the given URL is null.
org.apache.maven.shared.utils.io.FileUtils.mkdir(String) use java.nio.file.Files.createDirectories(Paths.get(dir))
org.apache.maven.shared.utils.ReaderFactory.newPlatformReader(File) always specify an encoding. Do not depend on the default platform character set.
org.apache.maven.shared.utils.WriterFactory.newPlatformWriter(File) always specify an encoding. Do not depend on the default platform character set.
org.apache.maven.shared.utils.WriterFactory.newPlatformWriter(OutputStream) always specify an encoding. Do not depend on the default platform character set.
org.apache.maven.shared.utils.ReaderFactory.newXmlReader(File) use org.apache.commons.io.input.XmlStreamReader instead
org.apache.maven.shared.utils.ReaderFactory.newXmlReader(InputStream) use org.apache.commons.io.input.XmlStreamReader instead
org.apache.maven.shared.utils.ReaderFactory.newXmlReader(URL) use org.apache.commons.io.input.XmlStreamReader instead
org.apache.maven.shared.utils.io.FileUtils.normalize(String) use org.apache.commons.io.FileNameUtils.normalize()
org.apache.maven.shared.utils.io.FileUtils.removeExtension(String) use org.apache.commons.io.FilenameUtils.removeExtension()
org.apache.maven.shared.utils.io.FileUtils.rename(File, File) use java.nio.Files.move()
org.apache.maven.shared.utils.io.FileUtils.sizeOfDirectory(File) use org.apache.commons.io.FileUtils.sizeOf()
org.apache.maven.shared.utils.io.FileUtils.sizeOfDirectory(String) use org.apache.commons.io.FileUtils.sizeOf()
org.apache.maven.shared.utils.io.IOUtil.toByteArray(InputStream) use org.apache.commons.io.IOUtils.readFully().
org.apache.maven.shared.utils.io.IOUtil.toByteArray(InputStream, int) use org.apache.commons.io.IOUtils.readFully().
org.apache.maven.shared.utils.io.IOUtil.toByteArray(Reader) always specify a character encoding
org.apache.maven.shared.utils.io.IOUtil.toByteArray(Reader, int) always specify a character encoding
org.apache.maven.shared.utils.io.IOUtil.toByteArray(String) always specify a character encoding
org.apache.maven.shared.utils.io.IOUtil.toByteArray(String, int) always specify a character encoding
org.apache.maven.shared.utils.io.IOUtil.toString(byte[]) always specify a character encoding
org.apache.maven.shared.utils.io.IOUtil.toString(byte[], int) always specify a character encoding
org.apache.maven.shared.utils.io.IOUtil.toString(byte[], String) use new String(input, encoding)
org.apache.maven.shared.utils.io.IOUtil.toString(byte[], String, int) use new String(input, encoding)
org.apache.maven.shared.utils.io.IOUtil.toString(InputStream) always specify a character encoding
org.apache.maven.shared.utils.io.IOUtil.toString(InputStream, int) always specify a character encoding
org.apache.maven.shared.utils.io.IOUtil.toString(InputStream, String) use org.apache.commons.io.IOUtils.toString().
org.apache.maven.shared.utils.io.IOUtil.toString(InputStream, String, int) use org.apache.commons.io.IOUtils.toString().
org.apache.maven.shared.utils.io.IOUtil.toString(Reader) use org.apache.commons.io.IOUtils.toString().
org.apache.maven.shared.utils.io.IOUtil.toString(Reader, int) use org.apache.commons.io.IOUtils.toString().
org.apache.maven.shared.utils.StringUtils.unifyLineSeparators(String) this method produces platform dependent code and contributes to non-reproducible builds. In the context of Maven, this is almost never what's needed. Remove calls to this method and do not replace them. That is, change Stringutils.unifyLineSeparators(s) to simply s.

Deprecated Constructors

Constructor and Description
org.apache.maven.shared.utils.PathTool() This is a utility class with only static methods. Don't create instances of it.
org.apache.maven.shared.utils.PropertyUtils() This is a utility class with only static methods. Don't create instances of it.