6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation. Oracle designates this
8 * particular file as subject to the "Classpath" exception as provided
9 * by Oracle in the LICENSE file that accompanied this code.
10 *
11 * This code is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 * version 2 for more details (a copy is included in the LICENSE file that
15 * accompanied this code).
16 *
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22 * or visit www.oracle.com if you need additional information or have any
23 * questions.
24 */
25
26 package com.sun.tools.doclets.formats.html;
27
28 import java.io.*;
29 import java.util.*;
30
31 import com.sun.javadoc.*;
32 import com.sun.tools.doclets.formats.html.markup.*;
33 import com.sun.tools.doclets.internal.toolkit.*;
34 import com.sun.tools.doclets.internal.toolkit.util.DocPath;
35
36 /**
37 * Abstract class to generate the overview files in
38 * Frame and Non-Frame format. This will be sub-classed by to
39 * generate overview-frame.html as well as overview-summary.html.
40 *
41 * <p><b>This is NOT part of any supported API.
42 * If you write code that depends on this, you do so at your own risk.
43 * This code and its internal interfaces are subject to change or
44 * deletion without notice.</b>
45 *
46 * @author Atul M Dambalkar
47 * @author Bhavesh Patel (Modified)
48 */
49 public abstract class AbstractPackageIndexWriter extends HtmlDocletWriter {
50
51 /**
52 * A Set of Packages to be documented.
53 */
54 protected SortedSet<PackageDoc> packages;
55
56 /**
57 * Constructor. Also initializes the packages variable.
58 *
59 * @param configuration The current configuration
60 * @param filename Name of the package index file to be generated.
61 */
62 public AbstractPackageIndexWriter(ConfigurationImpl configuration,
63 DocPath filename) throws IOException {
64 super(configuration, filename);
65 packages = configuration.packages;
66 }
67
68 /**
69 * Adds the navigation bar header to the documentation tree.
70 *
71 * @param body the document tree to which the navigation bar header will be added
72 */
73 protected abstract void addNavigationBarHeader(Content body);
74
77 *
78 * @param body the document tree to which the navigation bar footer will be added
79 */
80 protected abstract void addNavigationBarFooter(Content body);
81
82 /**
83 * Adds the overview header to the documentation tree.
84 *
85 * @param body the document tree to which the overview header will be added
86 */
87 protected abstract void addOverviewHeader(Content body);
88
89 /**
90 * Adds the packages list to the documentation tree.
91 *
92 * @param packages a collection of packagedoc objects
93 * @param text caption for the table
94 * @param tableSummary summary for the table
95 * @param body the document tree to which the packages list will be added
96 */
97 protected abstract void addPackagesList(Collection<PackageDoc> packages, String text,
98 String tableSummary, Content body);
99
100 /**
101 * Generate and prints the contents in the package index file. Call appropriate
102 * methods from the sub-class in order to generate Frame or Non
103 * Frame format.
104 *
105 * @param title the title of the window.
106 * @param includeScript boolean set true if windowtitle script is to be included
107 */
108 protected void buildPackageIndexFile(String title, boolean includeScript) throws IOException {
109 String windowOverview = configuration.getText(title);
110 Content body = getBody(includeScript, getWindowTitle(windowOverview));
111 addNavigationBarHeader(body);
112 addOverviewHeader(body);
113 addIndex(body);
114 addOverview(body);
115 addNavigationBarFooter(body);
116 printHtmlDocument(configuration.metakeywords.getOverviewMetaKeywords(title,
117 configuration.doctitle), includeScript, body);
129 * Adds the frame or non-frame package index to the documentation tree.
130 *
131 * @param body the document tree to which the index will be added
132 */
133 protected void addIndex(Content body) {
134 addIndexContents(packages, "doclet.Package_Summary",
135 configuration.getText("doclet.Member_Table_Summary",
136 configuration.getText("doclet.Package_Summary"),
137 configuration.getText("doclet.packages")), body);
138 }
139
140 /**
141 * Adds package index contents. Call appropriate methods from
142 * the sub-classes. Adds it to the body HtmlTree
143 *
144 * @param packages a collection of packages to be documented
145 * @param text string which will be used as the heading
146 * @param tableSummary summary for the table
147 * @param body the document tree to which the index contents will be added
148 */
149 protected void addIndexContents(Collection<PackageDoc> packages, String text,
150 String tableSummary, Content body) {
151 if (!packages.isEmpty()) {
152 HtmlTree htmlTree = (configuration.allowTag(HtmlTag.NAV))
153 ? HtmlTree.NAV()
154 : new HtmlTree(HtmlTag.DIV);
155 htmlTree.addStyle(HtmlStyle.indexNav);
156 HtmlTree ul = new HtmlTree(HtmlTag.UL);
157 addAllClassesLink(ul);
158 if (configuration.showProfiles) {
159 addAllProfilesLink(ul);
160 }
161 htmlTree.addContent(ul);
162 body.addContent(htmlTree);
163 if (configuration.showProfiles && configuration.profilePackages.size() > 0) {
164 Content profileSummary = configuration.getResource("doclet.Profiles");
165 addProfilesList(profileSummary, body);
166 }
167 addPackagesList(packages, text, tableSummary, body);
168 }
169 }
170
171 /**
172 * Adds the doctitle to the documentation tree, if it is specified on the command line.
173 *
174 * @param body the document tree to which the title will be added
175 */
176 protected void addConfigurationTitle(Content body) {
177 if (configuration.doctitle.length() > 0) {
178 Content title = new RawHtml(configuration.doctitle);
179 Content heading = HtmlTree.HEADING(HtmlConstants.TITLE_HEADING,
180 HtmlStyle.title, title);
181 Content div = HtmlTree.DIV(HtmlStyle.header, heading);
182 body.addContent(div);
183 }
184 }
185
186 /**
187 * Returns highlighted "Overview", in the navigation bar as this is the
188 * overview page.
189 *
190 * @return a Content object to be added to the documentation tree
191 */
192 protected Content getNavLinkContents() {
193 Content li = HtmlTree.LI(HtmlStyle.navBarCell1Rev, overviewLabel);
194 return li;
195 }
196
197 /**
198 * Do nothing. This will be overridden.
199 *
200 * @param div the document tree to which the all classes link will be added
201 */
202 protected void addAllClassesLink(Content div) {
203 }
204
205 /**
206 * Do nothing. This will be overridden.
207 *
208 * @param div the document tree to which the all profiles link will be added
209 */
210 protected void addAllProfilesLink(Content div) {
211 }
212
213 /**
214 * Do nothing. This will be overridden.
215 *
216 * @param profileSummary the profile summary heading
217 * @param body the content tree to which the profiles list will be added
218 */
219 protected void addProfilesList(Content profileSummary, Content body) {
220 }
221 }
|
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation. Oracle designates this
8 * particular file as subject to the "Classpath" exception as provided
9 * by Oracle in the LICENSE file that accompanied this code.
10 *
11 * This code is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 * version 2 for more details (a copy is included in the LICENSE file that
15 * accompanied this code).
16 *
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22 * or visit www.oracle.com if you need additional information or have any
23 * questions.
24 */
25
26 package jdk.javadoc.internal.doclets.formats.html;
27
28 import java.io.*;
29 import java.util.*;
30
31 import javax.lang.model.element.PackageElement;
32
33 import jdk.javadoc.internal.doclets.formats.html.markup.HtmlConstants;
34 import jdk.javadoc.internal.doclets.formats.html.markup.HtmlStyle;
35 import jdk.javadoc.internal.doclets.formats.html.markup.HtmlTag;
36 import jdk.javadoc.internal.doclets.formats.html.markup.HtmlTree;
37 import jdk.javadoc.internal.doclets.formats.html.markup.RawHtml;
38 import jdk.javadoc.internal.doclets.toolkit.Content;
39 import jdk.javadoc.internal.doclets.toolkit.util.DocPath;
40
41 /**
42 * Abstract class to generate the overview files in
43 * Frame and Non-Frame format. This will be sub-classed by to
44 * generate overview-frame.html as well as overview-summary.html.
45 *
46 * <p><b>This is NOT part of any supported API.
47 * If you write code that depends on this, you do so at your own risk.
48 * This code and its internal interfaces are subject to change or
49 * deletion without notice.</b>
50 *
51 * @author Atul M Dambalkar
52 * @author Bhavesh Patel (Modified)
53 */
54 public abstract class AbstractPackageIndexWriter extends HtmlDocletWriter {
55
56 /**
57 * A Set of Packages to be documented.
58 */
59 protected SortedSet<PackageElement> packages;
60
61 /**
62 * Constructor. Also initializes the packages variable.
63 *
64 * @param configuration The current configuration
65 * @param filename Name of the package index file to be generated.
66 */
67 public AbstractPackageIndexWriter(ConfigurationImpl configuration,
68 DocPath filename) throws IOException {
69 super(configuration, filename);
70 packages = configuration.packages;
71 }
72
73 /**
74 * Adds the navigation bar header to the documentation tree.
75 *
76 * @param body the document tree to which the navigation bar header will be added
77 */
78 protected abstract void addNavigationBarHeader(Content body);
79
82 *
83 * @param body the document tree to which the navigation bar footer will be added
84 */
85 protected abstract void addNavigationBarFooter(Content body);
86
87 /**
88 * Adds the overview header to the documentation tree.
89 *
90 * @param body the document tree to which the overview header will be added
91 */
92 protected abstract void addOverviewHeader(Content body);
93
94 /**
95 * Adds the packages list to the documentation tree.
96 *
97 * @param packages a collection of packagedoc objects
98 * @param text caption for the table
99 * @param tableSummary summary for the table
100 * @param body the document tree to which the packages list will be added
101 */
102 protected abstract void addPackagesList(Collection<PackageElement> packages, String text,
103 String tableSummary, Content body);
104
105 /**
106 * Generate and prints the contents in the package index file. Call appropriate
107 * methods from the sub-class in order to generate Frame or Non
108 * Frame format.
109 *
110 * @param title the title of the window.
111 * @param includeScript boolean set true if windowtitle script is to be included
112 */
113 protected void buildPackageIndexFile(String title, boolean includeScript) throws IOException {
114 String windowOverview = configuration.getText(title);
115 Content body = getBody(includeScript, getWindowTitle(windowOverview));
116 addNavigationBarHeader(body);
117 addOverviewHeader(body);
118 addIndex(body);
119 addOverview(body);
120 addNavigationBarFooter(body);
121 printHtmlDocument(configuration.metakeywords.getOverviewMetaKeywords(title,
122 configuration.doctitle), includeScript, body);
134 * Adds the frame or non-frame package index to the documentation tree.
135 *
136 * @param body the document tree to which the index will be added
137 */
138 protected void addIndex(Content body) {
139 addIndexContents(packages, "doclet.Package_Summary",
140 configuration.getText("doclet.Member_Table_Summary",
141 configuration.getText("doclet.Package_Summary"),
142 configuration.getText("doclet.packages")), body);
143 }
144
145 /**
146 * Adds package index contents. Call appropriate methods from
147 * the sub-classes. Adds it to the body HtmlTree
148 *
149 * @param packages a collection of packages to be documented
150 * @param text string which will be used as the heading
151 * @param tableSummary summary for the table
152 * @param body the document tree to which the index contents will be added
153 */
154 protected void addIndexContents(Collection<PackageElement> packages, String text,
155 String tableSummary, Content body) {
156 if (!packages.isEmpty()) {
157 HtmlTree htmlTree = (configuration.allowTag(HtmlTag.NAV))
158 ? HtmlTree.NAV()
159 : new HtmlTree(HtmlTag.DIV);
160 htmlTree.addStyle(HtmlStyle.indexNav);
161 HtmlTree ul = new HtmlTree(HtmlTag.UL);
162 addAllClassesLink(ul);
163 htmlTree.addContent(ul);
164 body.addContent(htmlTree);
165 addPackagesList(packages, text, tableSummary, body);
166 }
167 }
168
169 /**
170 * Adds the doctitle to the documentation tree, if it is specified on the command line.
171 *
172 * @param body the document tree to which the title will be added
173 */
174 protected void addConfigurationTitle(Content body) {
175 if (configuration.doctitle.length() > 0) {
176 Content title = new RawHtml(configuration.doctitle);
177 Content heading = HtmlTree.HEADING(HtmlConstants.TITLE_HEADING,
178 HtmlStyle.title, title);
179 Content div = HtmlTree.DIV(HtmlStyle.header, heading);
180 body.addContent(div);
181 }
182 }
183
184 /**
185 * Returns highlighted "Overview", in the navigation bar as this is the
186 * overview page.
187 *
188 * @return a Content object to be added to the documentation tree
189 */
190 protected Content getNavLinkContents() {
191 Content li = HtmlTree.LI(HtmlStyle.navBarCell1Rev, overviewLabel);
192 return li;
193 }
194
195 /**
196 * Do nothing. This will be overridden.
197 *
198 * @param div the document tree to which the all classes link will be added
199 */
200 protected void addAllClassesLink(Content div) {
201 }
202 }
|