Skip to content

A pure Java library for scanning and enumerating RAR archive contents

License

Notifications You must be signed in to change notification settings

radarsh/raroscope

Repository files navigation

Introduction

Download Maven Central CircleCI

Ever faced the challenge to be able to scan RAR archives using Java? Wished the API was as simple and easy to use as the ones provided for ZIP and JAR handling in Java? Don't want the hassles of including expensive native code into your Java application?

RARoScope is here to solve all these woes. The following lines are all you've to write to list out all the entries of a RAR file, say, D:/Data.rar.

// Construct the RARFile object using the file path
RARFile file = new RARFile("D:/Data.rar");

// Get the handle to the Enumeration
Enumeration<RAREntry> entries = file.entries();

// Iterate and print
while (entries.hasMoreElements()) {
    RAREntry entry = entries.nextElement();
    
    System.out.println(entry.getName());
}

Impressed? I sure was thrilled when I first wrote the library! Go ahead, download RARoScope and start using it in your applications right now.

Usage

Gradle

compile 'com.adarshr:raroscope:1.0.2'

Maven

<dependency>
    <groupId>com.adarshr</groupId>
    <artifactId>raroscope</artifactId>
    <version>1.0.2</version>
</dependency>

What RARoScope can do

Exposing a simple API, RARoScope packs the following rich features.

Enhanced checking for true RAR archives

RARoScope ensures false RAR archives such as files with just a ".rar" extension do not interrupt further processing by reading and verifying the RAR marker header block and throwing exceptions where appropriate.

A rich RAREntry class

RARoScope reads almost all the information available in a RAR archive and loads them into the RAREntry instances. Following are the file metadata retrieved.

  • Full file name including the path
  • Date and Time the file was modified/created
  • Compressed file size
  • Uncompressed file size
  • The CRC checksum for the file
  • Whether a file is a directory
  • The operating system on which the file was added to the archive
  • The compression method used
  • The RAR version required to decompress and retrieve the file

Optimized for performance

RARoScope has been designed to make efficient use of the underlying byte buffer so that very few I/O reads happen in each cycle. An effect of this is improved performance with very small cycle iteration times.

What RARoScope can't do

However, because of various factors, RARoScope does have its limitations and can't do the following.

Creating RAR archives

Because of the proprietary nature of the RAR archive format, RARoScope can't be used to create RAR archives.

Reading file contents/decompressing

Since RARoScope has been poised as more of a "RAR scanning library" rather than a "RAR decompressor" for Java, it can't do the decompressing part. However, this is open to change in the near future. Depending on the response I get, I might implement a decompressing logic.

Reading RAR entries with comments

RARoScope doesn't support reading comments and entries with comments as of now.

Multi-volume RAR archives

RARoScope doesn't support reading multi-volume archives yet.