RubyGems Navigation menu

qdox 1.10.1

QDox -

QDox is a high speed, small footprint parser for extracting class/interface/method definitions from Java source files complete with JavaDoc @tags. It is designed to be used by active code generators or documentation tools.

QDox is a Java library. Therefore this RubyGem needs JRuby.


Step 1: Load your Java sources. In JRuby (or jirb) write:

require 'qdox'
builder =


Step 2: Inspect the source model.

src = builder.sources.first
pkg = src.package
puts # e.g. ""
imports = src.imports # => e.g. ["java.util.List", "java.util.Set"]
some_class = src.classes.first # => a QDox::Model::JavaClass

# output the javadoc comment for the first method in some_class
puts some_class.methods.first.comment


As you may have noticed, the Java packages used have been aliased to shorter Ruby Module names: The Java package com.thoughtworks.qdox is the Ruby module QDox etc.

In a Nutshell

A custom built parser has been built using JFlex and BYacc/J. These have been chosen because of their proven performance and they require no external libraries at runtime.

The parser skims the source files only looking for things of interest such as class/interface definitions, import statements, JavaDoc and member declarations. The parser ignores things such as actual method implementations to avoid overhead (while in method blocks, curly brace counting suffices).

The end result of the parser is a very simple document model containing enough information to be useful.


Apache License, Version 2.0 QDox was created by Joe Walnes, Aslak Hellesoy, Paul Hammant, Mike Williams, Mauro Talevi, Robert Scholte, and others. The RubyGem was created by Benjamin Bock.


  1. 1.10.1 - March 7, 2010 (163 KB)
Show all versions (2 total)


  • Benjamin Bock



Sha 256 checksum:


Total downloads 1,774

For this version 1,770

Show all versions (2 total)

= Copy to clipboard Copied!

= Copy to clipboard Copied!



Required Ruby Version: None