Get the Full Path of a JAR File From a Class – 从一个类中获取JAR文件的完整路径

最后修改: 2022年 7月 11日

1. Overview


JAR files are Java archives. We may include various JAR files as libraries when we build Java applications.


In this tutorial, we’ll explore how to find the JAR file and its full path from a given class.


2. Introduction to the Problem


Let’s say we have a Class object at runtime. Our goal is to find out which JAR file the class belongs to.


An example may help us understand the problem quickly. Let’s say we have the class instance of Guava‘s Ascii class. We want to create a method to find out the full path of the JAR file that holds the Ascii class.


We’ll mainly address two different methods to get the JAR file’s full path. Further, we’ll discuss their pros and cons.


For simplicity, we’ll verify the result by unit test assertions.


Next, let’s see them in action.


3. Using the getProtectionDomain() Method


Java’s class object provides the getProtectionDomain() method to obtain the ProtectionDomain object. Then, we can get the CodeSource through the ProtectionDomain object. The CodeSource instance will be the JAR file we’re looking for. Further, CodeSource.getLocation() method gives us the URL object of the JAR file. Finally, we can use the Paths class to get the full path of the JAR file.


3.1. Implementing the byGetProtectionDomain() Method


If we wrap all steps that we’ve mentioned above in a method, a couple of lines will do the job:


public class JarFilePathResolver {
    String byGetProtectionDomain(Class clazz) throws URISyntaxException {
        URL url = clazz.getProtectionDomain().getCodeSource().getLocation();
        return Paths.get(url.toURI()).toString();

Next, let’s take the Guava Ascii class as an example to test if our method works as expected:


String jarPath = jarFilePathResolver.byGetProtectionDomain(Ascii.class);
assertThat(new File(jarPath)).exists();

As we can see, we’ve verified the returned jarPath through two assertions:


  • first, the path should point to the Guava JAR file
  • if jarPath is a valid full path, we can create a File object from jarPath, and the file should exist

If we run the test, it passes. So the byGetProtectionDomain() method works as expected.


3.2. Some Limitations of the getProtectionDomain() Method


As the code above shows, our byGetProtectionDomain() method is pretty compact and straightforward. However, if we read the JavaDoc of the getProtectionDomain() method, it says the getProtectionDomain() method may throw SecurityException.

正如上面的代码所示,我们的byGetProtectionDomain()方法是相当紧凑和简单的。然而,如果我们阅读getProtectionDomain()方法的JavaDoc,它说the getProtectionDomain()方法可能会抛出SecurityException

We’ve written a unit test, and the test passes. This is because we’re testing the method in our local development environment. In our example, the Guava JAR is located in our local Maven repository. Therefore, no SecurityException was raised.

我们写了一个单元测试,而且测试通过了。这是因为我们是在本地开发环境中测试该方法。在我们的例子中,Guava JAR位于我们本地的Maven资源库中。因此,没有引发SecurityException

However, some platforms, for instance, Java/OpenWebStart and some application servers, may prohibit getting the ProtectionDomain object by calling the getProtectionDomain() method. Therefore, if we deploy our application to those platforms, our method will fail and throw SecurityException.


Next, let’s see another approach to get the JAR file’s full path.


4. Using the getResource() Method


We know that we call the Class.getResource() method to get the URL object of the resource of the class. So let’s start with this method to resolve the full path of the corresponding JAR file finally.


4.1. Implementing the byGetResource() Method


Let’s first have a look at the implementation and then understand how it works:


String byGetResource(Class clazz) {
    URL classResource = clazz.getResource(clazz.getSimpleName() + ".class");
    if (classResource == null) {
        throw new RuntimeException("class resource is null");
    String url = classResource.toString();
    if (url.startsWith("jar:file:")) {
        // extract 'file:......jarName.jar' part from the url string
        String path = url.replaceAll("^jar:(file:.*[.]jar)!/.*", "$1");
        try {
            return Paths.get(new URL(path).toURI()).toString();
        } catch (Exception e) {
            throw new RuntimeException("Invalid Jar File URL String");
    throw new RuntimeException("Invalid Jar File URL String");

Compared to the byGetProtectionDomain approach, the method above looks complex. But in fact, it’s pretty easy to understand as well.


Next, let’s walk through the method quickly and understand how it works. For simplicity, we throw RuntimeException for various exception cases.


4.2. Understanding How It Works


First, we call the Class.getResource(className) method to get the URL of the given class.


If the class is from a JAR file on the local filesystem, the URL string should be in this format:



For example, here’s the URL string of Guava’s Ascii class on a Linux system:



As we can see, the full path of the JAR file lies in the middle of the URL string.


As the file URL format on different operating systems may differ, we’ll extract the “file:…..jar” part, convert it back to a URL object, and use the Paths class to get the path as a String.


We build a regex and use String‘s replaceAll() method to extract the part we need: String path = url.replaceAll(“^jar:(file:.*[.]jar)!/.*”, “$1”);

我们建立一个重合词,并使用StringreplaceAll()方法来提取我们需要的部分。String path = url.replaceAll(“^jar:(file:.*[.]jar)!/.*”, “$1”);

Next, similar to the byGetProtectionDomain() approach, we get the final result using the Paths class.


Now, let’s create a test to verify if our method works with Guava’s Ascii class:


String jarPath = jarFilePathResolver.byGetResource(Ascii.class);
assertThat(new File(jarPath)).exists();

The test will pass if we give it a run.


5. Combining the Two Methods


So far, we’ve seen two approaches to solve the problem. The byGetProtectionDomain approach is straightforward and reliable, but may fail on some platforms due to security limitations.


On the other hand, the byGetResource method doesn’t have security issues. However, we need to do more manual manipulations, such as handling different exception cases and extracting the URL string of the JAR file using regex.


5.1. Implementing the getJarFilePath() Method


We can combine the two methods. First, let’s try to resolve the JAR file’s path with byGetProtectionDomain(). If it fails, we call the byGetResource() method as a fallback:


String getJarFilePath(Class clazz) {
    try {
        return byGetProtectionDomain(clazz);
    } catch (Exception e) {
        // cannot get jar file path using byGetProtectionDomain
        // Exception handling omitted
    return byGetResource(clazz);

5.2. Testing the getJarFilePath() Method


To simulate byGetProtectionDomain() throwing SecurityException in our local development environment, let’s add Mockito dependency and partially mock the JarFilePathResolver using the @Spy annotation:


class JarFilePathResolverUnitTest {
    JarFilePathResolver jarFilePathResolver;

Next, let’s first test the scenario that the getProtectionDomain() method doesn’t throw a SecurityException:


String jarPath = jarFilePathResolver.getJarFilePath(Ascii.class);
assertThat(new File(jarPath)).exists();
verify(jarFilePathResolver, times(1)).byGetProtectionDomain(Ascii.class);
verify(jarFilePathResolver, never()).byGetResource(Ascii.class);

As the code above shows, apart from testing whether the path is valid, we also verify that if we can get the JAR file’s path by the byGetProtectionDomain() method, the byGetResource() method should never be called.


Of course, if byGetProtectionDomain() throws SecurityException, the two methods will be called once:


when(jarFilePathResolver.byGetProtectionDomain(Ascii.class)).thenThrow(new SecurityException("not allowed"));
String jarPath = jarFilePathResolver.getJarFilePath(Ascii.class);
assertThat(new File(jarPath)).exists();
verify(jarFilePathResolver, times(1)).byGetProtectionDomain(Ascii.class);
verify(jarFilePathResolver, times(1)).byGetResource(Ascii.class);

If we execute the tests, both tests pass.


6. Conclusion


In this article, we’ve learned how to get a JAR file’s full path from a given class.


As always, the complete source code is available over on GitHub.