add Taglet module for jdk<9

Signed-off-by: Stefan Niederhauser <[email protected]>

Author: nidi3

graphviz-java/src/main/java/guru/nidi/graphviz/engine/Renderer.java

@@ -46,7 +46,7 @@ public String toString() {
         return graphviz.execute();
     }
 
-    public void toFile(File file) throws IOException {
+    public File toFile(File file) throws IOException {
         Files.createDirectories(file.getAbsoluteFile().getParentFile().toPath());
         final File target = file.getName().contains(".")
                 ? file
@@ -58,6 +58,7 @@ public void toFile(File file) throws IOException {
                 out.write(toString());
             }
         }
+        return target;
     }
 
     public void toOutputStream(OutputStream outputStream) throws IOException {

graphviz-taglet/pom.xml

@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <artifactId>graphviz-java-parent</artifactId>
+        <groupId>guru.nidi</groupId>
+        <version>0.8.6-SNAPSHOT</version>
+    </parent>
+
+    <artifactId>graphviz-taglet</artifactId>
+    <name>${project.artifactId}</name>
+
+    <build>
+        <plugins>
+            <plugin>
+                <artifactId>maven-javadoc-plugin</artifactId>
+                <configuration>
+                    <taglet>guru.nidi.graphviz.GraphvizTaglet</taglet>
+                    <tagletArtifact>
+                        <groupId>${project.groupId}</groupId>
+                        <artifactId>${project.artifactId}</artifactId>
+                        <version>${project.version}</version>
+                    </tagletArtifact>
+                </configuration>
+                <dependencies>
+                    <dependency>
+                        <groupId>${project.groupId}</groupId>
+                        <artifactId>graphviz-java</artifactId>
+                        <version>${project.version}</version>
+                    </dependency>
+                </dependencies>
+            </plugin>
+        </plugins>
+    </build>
+
+    <dependencies>
+        <dependency>
+            <groupId>${project.groupId}</groupId>
+            <artifactId>graphviz-java</artifactId>
+            <version>${project.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>ch.qos.logback</groupId>
+            <artifactId>logback-classic</artifactId>
+            <version>1.2.3</version>
+        </dependency>
+        <dependency>
+            <groupId>com.sun</groupId>
+            <artifactId>tools</artifactId>
+            <version>1.8</version>
+            <scope>system</scope>
+            <systemPath>${java.home}/../lib/tools.jar</systemPath>
+        </dependency>
+    </dependencies>
+
+</project>

graphviz-taglet/src/main/java/guru/nidi/graphviz/GraphvizTaglet.java

@@ -0,0 +1,116 @@
+/*
+ * Copyright © 2015 Stefan Niederhauser ([email protected])
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package guru.nidi.graphviz;
+
+import com.sun.javadoc.Tag;
+import com.sun.tools.doclets.Taglet;
+import guru.nidi.graphviz.engine.Format;
+import guru.nidi.graphviz.engine.Graphviz;
+
+import java.io.File;
+import java.io.IOException;
+import java.util.Map;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+
+/**
+ * Support graphviz inside javadoc.
+ * <p>
+ * {@graphviz
+ * graph test {a -- b}
+ * }
+ * end
+ */
+public class GraphvizTaglet implements Taglet {
+    public static void register(Map<String, Taglet> taglets) {
+        final GraphvizTaglet taglet = new GraphvizTaglet();
+        taglets.put(taglet.getName(), taglet);
+    }
+
+    @Override
+    public boolean inField() {
+        return false;
+    }
+
+    @Override
+    public boolean inConstructor() {
+        return false;
+    }
+
+    @Override
+    public boolean inMethod() {
+        return false;
+    }
+
+    @Override
+    public boolean inOverview() {
+        return false;
+    }
+
+    @Override
+    public boolean inPackage() {
+        return false;
+    }
+
+    @Override
+    public boolean inType() {
+        return false;
+    }
+
+    @Override
+    public boolean isInlineTag() {
+        return true;
+    }
+
+    @Override
+    public String getName() {
+        return "graphviz";
+    }
+
+    @Override
+    public String toString(Tag tag) {
+        try {
+            final File file = new File(packageOf(tag), imageNameOf(tag));
+            final File output = Graphviz.fromString(tag.text()).render(Format.PNG).toFile(file);
+            return "<img title='" + imageTitleOf(tag) + "' src='" + output.getName() + "'></img>";
+        } catch (IOException e) {
+            throw new RuntimeException("Problem writing graphviz file", e);
+        }
+    }
+
+    private String imageTitleOf(Tag tag) {
+        final Pattern startPattern = Pattern.compile("^\\s*(di)?graph\\s*(.*?)\\s\\{");
+        final Matcher matcher = startPattern.matcher(tag.text());
+        return matcher.find() ? matcher.group(2) : "";
+    }
+
+    private String imageNameOf(Tag tag) {
+        final String name = tag.position().file().getName();
+        final String simple = name.substring(0, name.lastIndexOf('.'));
+        return simple + "@" + tag.position().line();
+    }
+
+    private String packageOf(Tag tag) {
+        final String className = tag.holder().toString();
+        final String pack = className.substring(0, className.lastIndexOf('.'));
+        return pack.replace('.', '/');
+    }
+
+    @Override
+    public String toString(Tag[] tags) {
+        return null;
+    }
+}

pom.xml

@@ -27,6 +27,7 @@
     <modules>
         <module>graphviz-java</module>
         <module>graphviz-kotlin</module>
+        <module>graphviz-taglet</module>
     </modules>
 
     <scm>