?? documenter.html
字號:
<HTML>
<BODY BGCOLOR="white">
<PRE>
<FONT color="green">001</FONT> // Copyright (C) 2004-2006 Ferdinand Prantl <prantl@host.sk><a name="line.1"></a>
<FONT color="green">002</FONT> // All rights reserved.<a name="line.2"></a>
<FONT color="green">003</FONT> //<a name="line.3"></a>
<FONT color="green">004</FONT> // This library is free software; you can redistribute it and/or<a name="line.4"></a>
<FONT color="green">005</FONT> // modify it under the terms of the GNU Library General Public<a name="line.5"></a>
<FONT color="green">006</FONT> // License as published by the Free Software Foundation; either<a name="line.6"></a>
<FONT color="green">007</FONT> // version 2 of the License, or (at your option) any later version.<a name="line.7"></a>
<FONT color="green">008</FONT> //<a name="line.8"></a>
<FONT color="green">009</FONT> // This library is distributed in the hope that it will be useful,<a name="line.9"></a>
<FONT color="green">010</FONT> // but WITHOUT ANY WARRANTY; without even the implied warranty of<a name="line.10"></a>
<FONT color="green">011</FONT> // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<a name="line.11"></a>
<FONT color="green">012</FONT> // GNU Library General Public License for more details.<a name="line.12"></a>
<FONT color="green">013</FONT> //<a name="line.13"></a>
<FONT color="green">014</FONT> // You should have received a copy of the GNU Library General<a name="line.14"></a>
<FONT color="green">015</FONT> // Public License along with this library; if not, write to the<a name="line.15"></a>
<FONT color="green">016</FONT> // Free Software Foundation, Inc., 59 Temple Place - Suite 330,<a name="line.16"></a>
<FONT color="green">017</FONT> // Boston, MA 02111-1307, USA.<a name="line.17"></a>
<FONT color="green">018</FONT> //<a name="line.18"></a>
<FONT color="green">019</FONT> // See http://prantl.host.sk/jarin or http://jarin.sourceforge.net<a name="line.19"></a>
<FONT color="green">020</FONT> // for the most recent version and more information.<a name="line.20"></a>
<FONT color="green">021</FONT> <a name="line.21"></a>
<FONT color="green">022</FONT> package sk.host.prantl.jarek;<a name="line.22"></a>
<FONT color="green">023</FONT> <a name="line.23"></a>
<FONT color="green">024</FONT> import java.lang.reflect.Member;<a name="line.24"></a>
<FONT color="green">025</FONT> import java.util.HashMap;<a name="line.25"></a>
<FONT color="green">026</FONT> import java.util.Vector;<a name="line.26"></a>
<FONT color="green">027</FONT> <a name="line.27"></a>
<FONT color="green">028</FONT> import com.sun.javadoc.ClassDoc;<a name="line.28"></a>
<FONT color="green">029</FONT> import com.sun.javadoc.ConstructorDoc;<a name="line.29"></a>
<FONT color="green">030</FONT> import com.sun.javadoc.Doc;<a name="line.30"></a>
<FONT color="green">031</FONT> import com.sun.javadoc.DocErrorReporter;<a name="line.31"></a>
<FONT color="green">032</FONT> import com.sun.javadoc.Doclet;<a name="line.32"></a>
<FONT color="green">033</FONT> import com.sun.javadoc.ExecutableMemberDoc;<a name="line.33"></a>
<FONT color="green">034</FONT> import com.sun.javadoc.FieldDoc;<a name="line.34"></a>
<FONT color="green">035</FONT> import com.sun.javadoc.MemberDoc;<a name="line.35"></a>
<FONT color="green">036</FONT> import com.sun.javadoc.MethodDoc;<a name="line.36"></a>
<FONT color="green">037</FONT> import com.sun.javadoc.PackageDoc;<a name="line.37"></a>
<FONT color="green">038</FONT> import com.sun.javadoc.ParamTag;<a name="line.38"></a>
<FONT color="green">039</FONT> import com.sun.javadoc.Parameter;<a name="line.39"></a>
<FONT color="green">040</FONT> import com.sun.javadoc.RootDoc;<a name="line.40"></a>
<FONT color="green">041</FONT> import com.sun.javadoc.SeeTag;<a name="line.41"></a>
<FONT color="green">042</FONT> import com.sun.javadoc.Tag;<a name="line.42"></a>
<FONT color="green">043</FONT> import com.sun.javadoc.ThrowsTag;<a name="line.43"></a>
<FONT color="green">044</FONT> import com.sun.javadoc.Type;<a name="line.44"></a>
<FONT color="green">045</FONT> <a name="line.45"></a>
<FONT color="green">046</FONT> /**<a name="line.46"></a>
<FONT color="green">047</FONT> * Doclet generating xml output with documentation comments for all the public and<a name="line.47"></a>
<FONT color="green">048</FONT> * protected interface of input classes with a possible subtree of classes to exclude.<a name="line.48"></a>
<FONT color="green">049</FONT> */<a name="line.49"></a>
<FONT color="green">050</FONT> public class Documenter extends Doclet {<a name="line.50"></a>
<FONT color="green">051</FONT> <a name="line.51"></a>
<FONT color="green">052</FONT> private boolean quiet = false;<a name="line.52"></a>
<FONT color="green">053</FONT> private boolean verbose = false;<a name="line.53"></a>
<FONT color="green">054</FONT> private HashMap demanded = new HashMap();<a name="line.54"></a>
<FONT color="green">055</FONT> <a name="line.55"></a>
<FONT color="green">056</FONT> private Documenter(boolean quiet, boolean verbose) {<a name="line.56"></a>
<FONT color="green">057</FONT> // initialize the documenter object<a name="line.57"></a>
<FONT color="green">058</FONT> this.quiet = quiet;<a name="line.58"></a>
<FONT color="green">059</FONT> this.verbose = verbose;<a name="line.59"></a>
<FONT color="green">060</FONT> }<a name="line.60"></a>
<FONT color="green">061</FONT> <a name="line.61"></a>
<FONT color="green">062</FONT> private void documentLink(SeeTag tag) {<a name="line.62"></a>
<FONT color="green">063</FONT> PackageDoc scope = tag.referencedPackage();<a name="line.63"></a>
<FONT color="green">064</FONT> if (scope != null) {<a name="line.64"></a>
<FONT color="green">065</FONT> // fill reference: reference="..."<a name="line.65"></a>
<FONT color="green">066</FONT> System.out.print("reference=\"" + scope.name() + "\"");<a name="line.66"></a>
<FONT color="green">067</FONT> } else {<a name="line.67"></a>
<FONT color="green">068</FONT> ClassDoc type = tag.referencedClass();<a name="line.68"></a>
<FONT color="green">069</FONT> if (type != null) {<a name="line.69"></a>
<FONT color="green">070</FONT> // fill reference: reference="..." type="class|interface"<a name="line.70"></a>
<FONT color="green">071</FONT> System.out.print("reference=\"" + type.qualifiedTypeName() + "\"");<a name="line.71"></a>
<FONT color="green">072</FONT> if (type.isClass())<a name="line.72"></a>
<FONT color="green">073</FONT> System.out.print(" type=\"class\"");<a name="line.73"></a>
<FONT color="green">074</FONT> else if (type.isInterface())<a name="line.74"></a>
<FONT color="green">075</FONT> System.out.print(" type=\"interface\"");<a name="line.75"></a>
<FONT color="green">076</FONT> else<a name="line.76"></a>
<FONT color="green">077</FONT> throw new IllegalStateException(<a name="line.77"></a>
<FONT color="green">078</FONT> "Unsupported reference type for \""<a name="line.78"></a>
<FONT color="green">079</FONT> + type.qualifiedTypeName()<a name="line.79"></a>
<FONT color="green">080</FONT> + "\". Only classes and interfaces are supported as compound references.");<a name="line.80"></a>
<FONT color="green">081</FONT> } else {<a name="line.81"></a>
<FONT color="green">082</FONT> MemberDoc member = tag.referencedMember();<a name="line.82"></a>
<FONT color="green">083</FONT> if (member != null) {<a name="line.83"></a>
<FONT color="green">084</FONT> // fill reference: reference="..." type="constructor|method|field"<a name="line.84"></a>
<FONT color="green">085</FONT> System.out.print("reference=\"" + member.qualifiedName() + "\"");<a name="line.85"></a>
<FONT color="green">086</FONT> if (member instanceof ConstructorDoc)<a name="line.86"></a>
<FONT color="green">087</FONT> System.out.print(" type=\"constructor\"");<a name="line.87"></a>
<FONT color="green">088</FONT> else if (member instanceof MethodDoc)<a name="line.88"></a>
<FONT color="green">089</FONT> System.out.print(" type=\"method\"");<a name="line.89"></a>
<FONT color="green">090</FONT> else if (member instanceof FieldDoc)<a name="line.90"></a>
<FONT color="green">091</FONT> System.out.print(" type=\"field\"");<a name="line.91"></a>
<FONT color="green">092</FONT> else<a name="line.92"></a>
<FONT color="green">093</FONT> throw new IllegalStateException(<a name="line.93"></a>
<FONT color="green">094</FONT> "Unsupported reference type for \""<a name="line.94"></a>
<FONT color="green">095</FONT> + member.qualifiedName()<a name="line.95"></a>
<FONT color="green">096</FONT> + "\". Only constructors, methods and fields are supported as member references.");<a name="line.96"></a>
<FONT color="green">097</FONT> }<a name="line.97"></a>
<FONT color="green">098</FONT> }<a name="line.98"></a>
<FONT color="green">099</FONT> }<a name="line.99"></a>
<FONT color="green">100</FONT> }<a name="line.100"></a>
<FONT color="green">101</FONT> <a name="line.101"></a>
<FONT color="green">102</FONT> private void documentText(Tag[] tags) {<a name="line.102"></a>
<FONT color="green">103</FONT> // replaces {@link ...} with <link reference="..." /><a name="line.103"></a>
<FONT color="green">104</FONT> for (int i = 0; i < tags.length; ++i)<a name="line.104"></a>
<FONT color="green">105</FONT> if (tags[i] instanceof SeeTag) {<a name="line.105"></a>
<FONT color="green">106</FONT> System.out.print("<link ");<a name="line.106"></a>
<FONT color="green">107</FONT> documentLink((SeeTag) tags[i]);<a name="line.107"></a>
<FONT color="green">108</FONT> String label = ((SeeTag) tags[i]).label();<a name="line.108"></a>
<FONT color="green">109</FONT> if (label.length() == 0)<a name="line.109"></a>
<FONT color="green">110</FONT> System.out.print(" />");<a name="line.110"></a>
<FONT color="green">111</FONT> else {<a name="line.111"></a>
<FONT color="green">112</FONT> System.out.print(">");<a name="line.112"></a>
<FONT color="green">113</FONT> System.out.print(label);<a name="line.113"></a>
<FONT color="green">114</FONT> System.out.print("</link>");<a name="line.114"></a>
<FONT color="green">115</FONT> }<a name="line.115"></a>
<FONT color="green">116</FONT> } else<a name="line.116"></a>
<FONT color="green">117</FONT> System.out.print(tags[i].text());<a name="line.117"></a>
<FONT color="green">118</FONT> }<a name="line.118"></a>
<FONT color="green">119</FONT> <a name="line.119"></a>
<FONT color="green">120</FONT> private void documentSee(String label) {<a name="line.120"></a>
<FONT color="green">121</FONT> // close the see, optionallly with content: </see><a name="line.121"></a>
<FONT color="green">122</FONT> if (label != null && label.length() != 0) {<a name="line.122"></a>
<FONT color="green">123</FONT> System.out.print("><![CDATA[");<a name="line.123"></a>
<FONT color="green">124</FONT> System.out.print(label);<a name="line.124"></a>
?? 快捷鍵說明
復制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -