Course contentsShow
← Java
Lesson 2030 of 2,87041. NIO.2 and the Path APIFree lesson

Relativizing Paths: Creating Relative References

Use relativize() to compute the relative path between two Path objects, useful for expressing one path in terms of another.

Relativizing Paths: Creating Relative References

You'll learn how to express one path relative to another using the relativize() method.

The Core Idea

When working with file systems, you often need to describe how to get from one location to another. Instead of using absolute paths everywhere, you can express one path relative to another. This is where relativize() comes in—it computes the relative path needed to navigate from one Path to another.

Think of it like giving directions: instead of saying "The store is at 123 Main Street," you might say "From your house, go two blocks north." The relativize() method creates those relative directions between paths.

How relativize() Works

The relativize() method is called on one Path (the "starting point") and takes another Path as an argument (the "destination"). It returns a new Path representing the relative route between them.

Path base = Paths.get("/home/user/documents");
Path target = Paths.get("/home/user/photos/vacation.jpg");

Path relative = base.relativize(target);
// Result: ../photos/vacation.jpg

Here, to get from documents to vacation.jpg, you go up one level (..) then into the photos directory.

Important Constraints

Both paths must be either absolute or relative—you cannot mix types. Attempting to relativize an absolute path against a relative one (or vice versa) throws an IllegalArgumentException.

Path absolute = Paths.get("/home/user");
Path relative = Paths.get("documents/file.txt");

// This would throw IllegalArgumentException:
// Path invalid = absolute.relativize(relative);

Key Takeaway: Use relativize() to compute the relative path from one location to another, making your path references more flexible and contextual—but ensure both paths are the same type (absolute or relative).