Método Path relativize() en Java con ejemplos

El método relativize(Path other) de java.nio.file . Ruta utilizada para crear una ruta relativa entre esta ruta y una ruta determinada como parámetro. La relativización es lo contrario de la resolución. Este método crea una ruta relativa que, cuando se resuelve con este objeto de ruta, produce una ruta que nos ayuda a ubicar el mismo archivo que la ruta dada. Por ejemplo,si esta ruta es «/dir1/dir2» y la ruta dada como parámetro es «/dir1/dir2/dir3/file1», entonces este método construirá una ruta relativa «dir3/file1». Cuando esta ruta y la ruta dada no tienen un componente raíz, se puede construir una ruta relativa. Si alguna de las rutas tiene un componente raíz, no se puede construir la ruta relativa. Cuando ambas rutas tienen un componente raíz, depende de la implementación si se puede construir una ruta relativa. Si esta ruta y la ruta dada son iguales, se devuelve una ruta vacía. 

Sintaxis:

Path relativize(Path other)

Parámetros: este método acepta otro parámetro que es el camino a relativizar contra este camino. 

Valor devuelto: este método devuelve la ruta relativa resultante o una ruta vacía si ambas rutas son iguales. 

Excepción: este método genera IllegalArgumentException si otro no es una ruta que se puede relativizar contra esta ruta. 

Los siguientes programas ilustran el método relativize(): 

Programa 1: 

// Java program to demonstrate
// java.nio.file.Path.relativize() method
 
import java.nio.file.Path;
import java.nio.file.Paths;
public class GFG {
    public static void main(String[] args)
    {
 
        // create objects of Path
        Path path
            = Paths.get("D:\\eclipse\\p2"
                        + "\\org\\eclipse");
        Path passedPath
            = Paths.get("D:\\eclipse\\p2"
                        + "\\org\\eclipse\\equinox\\p2\\core"
                        + "\\cache\\binary");
 
        // print paths
        System.out.println("This Path:"
                           + path);
        System.out.println("Given Path:"
                           + passedPath);
 
        // call relativize() to create
        // a relative path
        Path relativize
            = path.relativize(passedPath);
 
        // print result
        System.out.println("Relative Path: "
                           + relativize);
    }
}

Producción:

Programa 2: 

// Java program to demonstrate
// java.nio.file.Path.relativize() method
 
import java.nio.file.Path;
import java.nio.file.Paths;
public class GFG {
    public static void main(String[] args)
    {
 
        // create objects of Path
        Path path
            = Paths.get("\\nEclipseWork");
        Path passedPath
            = Paths.get("\\nEclipseWork\\GFG"
                        + "\\bin\\defaultpackage");
 
        // print paths
        System.out.println("This Path:"
                           + path);
        System.out.println("Given Path:"
                           + passedPath);
 
        // call relativize()
        // to create a relative path
        Path relativize
            = path.relativize(passedPath);
 
        // print result
        System.out.println("Relative Path: "
                           + relativize);
    }
}

Producción:

Referencias: https://docs.oracle.com/javase/10/docs/api/java/nio/file/Path.html#relativize(java.nio.file.Path)