Java File getCanonicalFile() method example

HQ ¬Ľ Java Tutorial ¬Ľ ¬Ľ File ¬Ľ getCanonicalFile() method example
Java File getCanonicalFile() method example 2018-02-16T07:26:43+00:00 getCanonicalFile()


On this document we will be showing a java example on how to use the getCanonicalFile() method of File Class. This method returns the canonical form of this abstract pathname. Equivalent to new File(this.getCanonicalPath()).


  • IOException – If an I/O error occurs, which is possible because the construction of the canonical pathname may require filesystem queries.
  • SecurityException – If a required system property value cannot be accessed, or if a security manager exists and its SecurityManager.checkRead( method denies read access to the file.

Method Syntax

public File getCanonicalFile()
throws IOException

Method Argument

Data Type Parameter Description

Method Returns

This method returns a File which denotes the canonical pathname string denoting the same file or directory as this abstract pathname.


Requires Java 1.2 and up

Java File getCanonicalFile() Example

Below is a java code¬†demonstrates the use of getCanonicalFile()¬†method of File class. The example presented might be simple however it shows the behaviour of the getCanonicalFile()¬†method of File class.¬†Basically we have put a check first if the file exists or not. If the file exists based on the return value of the exists() method, we print the result of the¬†getCanonicalFile() method to illustrate it’s behaviour.

Sample Output

Below is the sample output when you run the above example.

java lang File getCanonicalFile() example output

Contact Info


Our Goal

JavaTutorialHQ aims to to be The Ultimate Guide on Java with hundreds of examples from basic to advance Topics.

By continuing to use the site, you agree to the use of cookies. more information

The cookie settings on this website are set to "allow cookies" to give you the best browsing experience possible. If you continue to use this website without changing your cookie settings or you click "Accept" below then you are consenting to this.