Skip to content

json backend for javadoc (doclet 9 api)

Notifications You must be signed in to change notification settings

liuyan1001/jsondoclet

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

73 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

jsondoclet(beta)

JSON backend prototype for javadoc (Doclet 9 API).

doclet generating json formatted javadoc

usage

  • assuming ./target contains the doclet jar
  • and src/main/java/ is the root of java source files
javadoc -cp target/jsondoclet-0.1b-SNAPSHOT.jar\
        -docletpath target/jsondoclet-0.1b-SNAPSHOT.jar\
    -doclet jnpn.json.JSONDoclet\
    src/main/java/jnpn/json/*.java

produces json output into jsondocs

  • edit src/main/resources/custom/config.properties to customize output-dir name

dataflow

doctree -> Tree[javax.lang.model.Element] -> json tree

TODO

  • actual JSON ouput (gson | jackson | custom)

  • format specs define a clear mapping from POJO metaclasses to Json Objects

  • tests obviously

  • configuration file :DONE use java Properties to load configuration from config.properties jar resource

  • overridable configuration file

  • configurable pojo : json mapping metamodel description to json object

    	Element.name -> [name]
    	...
    
  • Redis endpoint LSP oriented javadoc server, so your IDE can query documentation

CLI :wip:

  • jsondoclet generate
  • jsondoclet serve port:8081

About

json backend for javadoc (doclet 9 api)

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Java 100.0%