Last Updated : 23 Jul, 2025
URL class in Java is a part of java.net
package that makes it easy to work with Uniform Resource Locators (URLs). URL is simply a string of text that identifies all the resources on the internet, telling us the address of the resource, how to communicate with it, and retrieve something from it. This article covers the key components, classes, constructors, methods, and examples of using the URL
class in Java applications.
A URL can have many forms. The most general however follows a three-component system as proposed below:
URL
class in Java is a fundamental component for accessing resources on the internetURL
class provides constructors and methods to create URL objects and retrieve their components.1. URL(String address): It creates a URL object from the specified String.
Example:
try {
URL url = new URL("https://www.example.com/");
} catch (MalformedURLException e) {
e.printStackTrace();
}
2. URL(String protocol, String host, String file): Creates a URL object from the specified protocol, host, and file name.
Example:
try {
URL url = new URL("http", "www.example.com", "/path/to/resource");
} catch (MalformedURLException e) {
e.printStackTrace();
}
3. URL(String protocol, String host, int port, String file): Creates a URL object from protocol, host, port, and file name.
Example:
try {
URL url = new URL("https", "www.example.com", 443, "/path/to/resource");
} catch (MalformedURLException e) {
e.printStackTrace();
}
4. URL(URL context, String spec): Creates a URL object by parsing the given spec in the given context.
Example:
try {
URL baseUrl = new URL("https://www.example.com/");
URL relativeUrl = new URL(baseUrl, "/path/to/resource");
} catch (MalformedURLException e) {
e.printStackTrace();
}
5. URL(String protocol, String host, int port, String file, URLStreamHandler handler): Creates a URL object from the specified protocol, host, port number, file, and handler.
Example:
try {
URL url = new URL("http", "www.example.com", 80, "/path/to/resource", new MyCustomHandler());
} catch (MalformedURLException e) {
e.printStackTrace();
}
6. URL(URL context, String spec, URLStreamHandler handler): Creates a URL by parsing the given spec with the specified handler within a specified context.
Example:
Java URL Methods Method Description getAuthority() Returns the authority part of URL or null if empty getDefaultPort() Returns the default port used getFile() Returns the file name. getHost() Return the hostname of the URL in IPv6 format getPath() Returns the path of the URL, or null if empty getPort() Returns the port associated with the protocol specified by the URL getProtocol() Returns the protocol used by the URL getQuery() Return the query part of the URL, which is the portion following thetry {
URL baseUrl = new URL("https://www.example.com/");
URL relativeUrl = new URL(baseUrl, "/path/to/resource", new MyCustomHandler());
} catch (MalformedURLException e) {
e.printStackTrace();
}
?
character, used to pass parameters to a web application. getRef() Return the reference part of the URL, which is the portion following the #
character, typically used to navigate to a specific section within a web page. toString() As in any class, toString() returns the string representation of the given URL object.
Example: The below Java program demonstrate the working of URL.
Java
// Java program to demonstrate working of URL
import java.net.MalformedURLException;
import java.net.URL;
public class Geeks {
public static void main(String[] args)
throws MalformedURLException
{
// Creating a URL with string representation
URL u1 = new URL(
"https://www.google.co.in/?gfe_rd=cr&ei=ptYq"
+ "WK26I4fT8gfth6CACg#q=geeks+for+geeks+java");
// Creating a URL with a protocol, hostname, and
// path
URL u2 = new URL("http", "www.geeksforgeeks.org",
"/jvm-works-jvm-architecture/");
URL u3 = new URL(
"https://www.google.co.in/search"
+ "q=gnu&rlz=1C1CHZL_enIN714IN715&oq=gnu&aqs=chrome..69i57j69i60l5.653j0j7&sourceid=chrome&ie=UTF-8#q=geeks+for+geeks+java");
// Printing the string representation of the URL
System.out.println(u1.toString());
System.out.println(u2.toString());
System.out.println();
System.out.println("Different components of URL3:");
// Retrieving the protocol for the URL
System.out.println("Protocol: " + u3.getProtocol());
// Retrieving the hostname of the URL
System.out.println("Hostname: " + u3.getHost());
// Retrieving the default port
System.out.println("Default port: "
+ u3.getDefaultPort());
// Retrieving the query part of the URL
System.out.println("Query: " + u3.getQuery());
// Retrieving the path of the URL
System.out.println("Path: " + u3.getPath());
// Retrieving the file name
System.out.println("File: " + u3.getFile());
// Retrieving the reference
System.out.println("Reference: " + u3.getRef());
}
}
Output:
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4