I recently thought about writing a Groovy [1] script to search JARs for a specific string, but decided to first look for an alternative rather than writing a script. The alternative needed to be easy to use, freely available, and not bogged down with a load of dependencies. I was glad I looked first, because the Linux-based approach [2] provided by "jan61" satisfied my need nicely. In this blog post, I look at that example more closely.
As documented on the LinuxQuestions.org [3] thread searching contents of .class file within jar (for strings) [4], a single line command in Linux [5] nicely does the job of searching JARs recursively from a given directory for a given String. This search isn't searching for the names of the entries themselves in the JAR, but rather is searching the contents of each searchable file in the JAR. Here is that simple line (the token <stringWithOrWithoutSpacesToFind> represents the string to search for):
Linux Command to Search Contents of .jar Files for Specific String
find . -iname '*.jar' -printf "unzip -c %p | grep -q '<stringWithOrWithoutSpacesToFind>' && echo %p\n" | sh
I like to have this in script form (or as an alias) because that name is easier to remember than typing in that entire command each time. Here is an example script that could be used.
Linux Script Form of Above Command
printf "Searching JARs for string '${1}'...\n"
find . -iname '*.jar' -printf "unzip -c %p | grep -q '${1}' && echo %p\n" | sh
The two versions of the command shown immediately above will work as-is and the rest of this blog post focuses on how the command works. I start analyzing the command from the inside and move outward.
The Linux unzip command [6] "list[s], test[s] and extract[s] compressed files in a ZIP archive." The -c passed to the unzip command "extract[s] files to stdout" and includes the name of the extracted files with that standard output. The %p is associated with the Linux find command [7]. More specifically, %p is a directive to the -printf flag of the find command that directs it to include the found file's name.
Each found file is unzipped and its content directed to standard output where it is piped to a grep command [8] to search for the provided text String. The provided -q parameter specifies "quiet" mode in which nothing is written to standard output and the grep exits immediately with zero status code upon detecting a match. The && [9] symbols indicate that the echo command [10] will be run to print out the file name with content matching the grep-ed for String if (and only when) the grep command returns a successful status (0).
All of the above are only executed against files with .jar extension thanks to the find . -iname '*.jar' command. The whole thing is piped to a shell.
Thanks to jan61 for the elegant Linux command covered in this post that makes it easy to search contents of files in JARs for a given string.