1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
|
/*
Derby - Class org.apache.derbyBuild.javadoc.PurposeTaglet
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You 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 org.apache.derbyBuild.javadoc;
import jdk.javadoc.doclet.Taglet;
import com.sun.source.doctree.DocTree;
import java.util.EnumSet;
import java.util.List;
import java.util.Map;
import java.util.Set;
import javax.lang.model.element.Element;
public class PurposeTaglet implements Taglet {
private static final String NAME = "derby.purpose";
private static final String ROWNAME = "Purpose";
private static final EnumSet<Location> allowedSet = EnumSet.allOf(Location.class);
/**
* Returns the name of this taglet
* @return NAME
*/
public String getName() { return NAME; }
@Override
public Set<Taglet.Location> getAllowedLocations() { return allowedSet; }
/**
* purpose is not an inline tag.
* @return false
*/
public boolean isInlineTag() {
return false;
}
/**
* Embed the contents of the purpose tag as a row
* in the disk format table.
* @param tag The tag to embed to the disk format the table.
*/
public String toString(DocTree tag) {
return "<tr><td>" + ROWNAME + "</td>"
+ "<td>" + DiskLayoutTaglet.getText(tag) + "</td></tr>\n";
}
/**
* Embed multiple purpose tags as cells in the disk format table.
* @param tags An array of tags to add to the disk format table.
* @param element the element to which the enclosing comment belongs
*/
public String toString(List<? extends DocTree> tags, Element element)
{
if ((tags == null) || (tags.size() == 0)) {
return null;
}
String result = "<tr><td>" + ROWNAME + "</td><td>";
for (int i = 0; i < tags.size(); i++) {
if (i > 0) {
result += "";
}
result += "<tr><td>" + DiskLayoutTaglet.getText(tags.get(i)) + "</td></tr>";
}
return result + "\n";
}
}
|
