ucla-pls / jvm-binary

A library for reading and writing Java class-files in Haskell

jvm-binary

A library for reading and writing Java class-files. To get started importing the Language.JVM file should be sufficient for most uses.

If you want to access Code elements of methods it is recommended to import Language.JVM.Attribute.Code qualified, like this:

import           Language.JVM
import qualified Language.JVM.Attribute.Code as Code

import qualified Data.ByteString.Lazy as BL

main :: IO ()
main = 
  ecfl <- readClassFile <$> BL.readFile "test/data/project/Main.class" 
  case ecfl of 
    Right clf -> do
      print (cThisClass clf)
      print (cSuperClass clf)
    Left msg -> 
      print msg

Stages

There are two stages in the current state of the repository. Low is closer to the class-file, while the High stage is easier to work with. The reason that we have the two stages is that the class-file representation has indices into the Constant Pool. The High stage eliminates all these problems.

Todo's

• Add more Attributes as to the docs.
• Add documentation for Code
• Setup regular benchmarks

Developing

Use stack to build, test, and benchmark.

jvm-binary's Issues

Merge New, NewArray, and MultiNewArray into one instruction

The idea is that they all talk about the same thing creating an new reference, and they all
have the same structure. Ei. read X integers of the stack related to how deep the array is.

...
  | New (Ref ClassName r)
  | NewArray (ExactArrayType r)
  | MultiNewArray (Ref ClassName r) Word8

Suggestion Create a new, New instruction:

...
  | New (RefType r)

Check that the Invk* instructions point the correct methods