From 41609ee63f1df4b42a1daf537e05dafc1d0f18f7 Mon Sep 17 00:00:00 2001
From: Kai Yuan <kent.yuan@Gmail.com>
Date: Fri, 16 Oct 2020 23:38:46 +0200
Subject: [PATCH] [BAEL-4533] get class names from a jar

---
 core-java-modules/core-java-jar/.gitignore    |   1 +
 .../baeldung/jar/GetClassNamesFromJar.java    |  43 ++++++++++++++++++
 .../jar/GetClassNamesFromJarUnitTest.java     |  39 ++++++++++++++++
 .../example-jar/stripe-0.0.1-SNAPSHOT.jar     | Bin 0 -> 10082 bytes
 4 files changed, 83 insertions(+)
 create mode 100644 core-java-modules/core-java-jar/.gitignore
 create mode 100644 core-java-modules/core-java-jar/src/main/java/com/baeldung/jar/GetClassNamesFromJar.java
 create mode 100644 core-java-modules/core-java-jar/src/test/java/com/baeldung/jar/GetClassNamesFromJarUnitTest.java
 create mode 100644 core-java-modules/core-java-jar/src/test/resources/example-jar/stripe-0.0.1-SNAPSHOT.jar

diff --git a/core-java-modules/core-java-jar/.gitignore b/core-java-modules/core-java-jar/.gitignore
new file mode 100644
index 0000000000..ba516c02b5
--- /dev/null
+++ b/core-java-modules/core-java-jar/.gitignore
@@ -0,0 +1 @@
+!src/test/resources/example-jar/stripe-0.0.1-SNAPSHOT.jar
diff --git a/core-java-modules/core-java-jar/src/main/java/com/baeldung/jar/GetClassNamesFromJar.java b/core-java-modules/core-java-jar/src/main/java/com/baeldung/jar/GetClassNamesFromJar.java
new file mode 100644
index 0000000000..0d8a67dbd6
--- /dev/null
+++ b/core-java-modules/core-java-jar/src/main/java/com/baeldung/jar/GetClassNamesFromJar.java
@@ -0,0 +1,43 @@
+package com.baeldung.jar;
+
+import java.io.File;
+import java.io.IOException;
+import java.net.URL;
+import java.net.URLClassLoader;
+import java.util.Enumeration;
+import java.util.HashSet;
+import java.util.Set;
+import java.util.jar.JarEntry;
+import java.util.jar.JarFile;
+
+public class GetClassNamesFromJar {
+
+    public static Set<String> getClassNamesFromJarFile(File givenFile) throws IOException {
+        Set<String> classNames = new HashSet<>();
+        try (JarFile jarFile = new JarFile(givenFile)) {
+            Enumeration<JarEntry> e = jarFile.entries();
+            while (e.hasMoreElements()) {
+                JarEntry jarEntry = e.nextElement();
+                if (jarEntry.getName().endsWith(".class")) {
+                    String className = jarEntry.getName()
+                      .replace("/", ".")
+                      .replace(".class", "");
+                    classNames.add(className);
+                }
+            }
+            return classNames;
+        }
+    }
+
+    public static Set<Class> getClassesFromJarFile(File jarFile) throws IOException, ClassNotFoundException {
+        Set<String> classNames = getClassNamesFromJarFile(jarFile);
+        Set<Class> classes = new HashSet<>(classNames.size());
+        try (URLClassLoader cl = URLClassLoader.newInstance(new URL[] { new URL("jar:file:" + jarFile + "!/") })) {
+            for (String name : classNames) {
+                Class clazz = cl.loadClass(name); // Loading the class by its name
+                classes.add(clazz);
+            }
+        }
+        return classes;
+    }
+}
diff --git a/core-java-modules/core-java-jar/src/test/java/com/baeldung/jar/GetClassNamesFromJarUnitTest.java b/core-java-modules/core-java-jar/src/test/java/com/baeldung/jar/GetClassNamesFromJarUnitTest.java
new file mode 100644
index 0000000000..7af3ff59fd
--- /dev/null
+++ b/core-java-modules/core-java-jar/src/test/java/com/baeldung/jar/GetClassNamesFromJarUnitTest.java
@@ -0,0 +1,39 @@
+package com.baeldung.jar;
+
+import com.google.common.collect.Sets;
+import org.junit.Assert;
+import org.junit.Test;
+
+import java.io.File;
+import java.io.IOException;
+import java.net.URISyntaxException;
+import java.util.Arrays;
+import java.util.Objects;
+import java.util.Set;
+import java.util.stream.Collectors;
+
+public class GetClassNamesFromJarUnitTest {
+    private static final String JAR_PATH = "example-jar/stripe-0.0.1-SNAPSHOT.jar";
+    private static final Set<String> EXPECTED_CLASS_NAMES = Sets.newHashSet(
+      "com.baeldung.stripe.StripeApplication",
+      "com.baeldung.stripe.ChargeRequest",
+      "com.baeldung.stripe.StripeService",
+      "com.baeldung.stripe.ChargeRequest$Currency",
+      "com.baeldung.stripe.ChargeController",
+      "com.baeldung.stripe.CheckoutController");
+
+    @Test
+    public void givenJarFilePath_whenLoadClassNames_thenGetClassNames() throws IOException, URISyntaxException {
+        File jarFile = new File(Objects.requireNonNull(getClass().getClassLoader().getResource(JAR_PATH)).toURI());
+        Set<String> classNames = GetClassNamesFromJar.getClassNamesFromJarFile(jarFile);
+        Assert.assertEquals(EXPECTED_CLASS_NAMES, classNames);
+    }
+
+    @Test
+    public void givenJarFilePath_whenLoadClass_thenGetClassObjects() throws IOException, ClassNotFoundException, URISyntaxException {
+        File jarFile = new File(Objects.requireNonNull(getClass().getClassLoader().getResource(JAR_PATH)).toURI());
+        Set<Class> classes = GetClassNamesFromJar.getClassesFromJarFile(jarFile);
+        Set<String> names = classes.stream().map(Class::getName).collect(Collectors.toSet());
+        Assert.assertEquals(EXPECTED_CLASS_NAMES, names);
+    }
+}
diff --git a/core-java-modules/core-java-jar/src/test/resources/example-jar/stripe-0.0.1-SNAPSHOT.jar b/core-java-modules/core-java-jar/src/test/resources/example-jar/stripe-0.0.1-SNAPSHOT.jar
new file mode 100644
index 0000000000000000000000000000000000000000..213d7f94001cf375a3bfc9b7d4ee0500851e572b
GIT binary patch
literal 10082
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

literal 0
HcmV?d00001