Skip to content

A Rust library that parses class files that conform to the Java Virtual Machine Specification.

License

Notifications You must be signed in to change notification settings

vcfxb/classreader-rs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

classreader

Parses the class file format that is used by the Java Virtual Machine version 8.

Synopsis

extern crate classreader;

use classreader::ClassReader;
use std::fs::File;

pub fn main() {
    let mut file = File::open("pkg/Test.class").unwrap();
    let class = ClassReader::new_from_reader(file).unwrap();

    assert_eq!(0xCAFEBABE, class.magic);
}

classreader uses the log crate to emit some log messages. They are mainly useful for low level debugging.

Completeness

Parses the whole rt.jar of OpenJDK 8 without issue. Code is not yet decoded. Apart from that, everything is parsed into suitable data structures.

Issues

Strings from a class file's constant pool are currently parsed into a Rust String. It seems that class files may contain code points for surrogate pairs. These are invalid for UTF-8 encoded strings which is what Rust uses. So whenever such a code point is decoded, it is replaced by the Unicode Replacement Character U+FFFD. This happens rarely but it does happen. A log message with info level is emitted.

License

Apache License Version 2. See LICENSE for the text.

About

A Rust library that parses class files that conform to the Java Virtual Machine Specification.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published