src/share/classes/com/sun/tools/doclets/formats/html/NestedClassWriterImpl.java

Mon, 15 Dec 2008 16:55:33 -0800

author
xdono
date
Mon, 15 Dec 2008 16:55:33 -0800
changeset 174
fdfed22db054
parent 1
9a66ca7c79fa
child 182
47a62d8d98b4
permissions
-rw-r--r--

6785258: Update copyright year
Summary: Update copyright for files that have been modified starting July 2008 to Dec 2008
Reviewed-by: katleman, ohair, tbell

duke@1 1 /*
duke@1 2 * Copyright 1997-2004 Sun Microsystems, Inc. All Rights Reserved.
duke@1 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
duke@1 4 *
duke@1 5 * This code is free software; you can redistribute it and/or modify it
duke@1 6 * under the terms of the GNU General Public License version 2 only, as
duke@1 7 * published by the Free Software Foundation. Sun designates this
duke@1 8 * particular file as subject to the "Classpath" exception as provided
duke@1 9 * by Sun in the LICENSE file that accompanied this code.
duke@1 10 *
duke@1 11 * This code is distributed in the hope that it will be useful, but WITHOUT
duke@1 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
duke@1 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
duke@1 14 * version 2 for more details (a copy is included in the LICENSE file that
duke@1 15 * accompanied this code).
duke@1 16 *
duke@1 17 * You should have received a copy of the GNU General Public License version
duke@1 18 * 2 along with this work; if not, write to the Free Software Foundation,
duke@1 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
duke@1 20 *
duke@1 21 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
duke@1 22 * CA 95054 USA or visit www.sun.com if you need additional information or
duke@1 23 * have any questions.
duke@1 24 */
duke@1 25
duke@1 26 package com.sun.tools.doclets.formats.html;
duke@1 27
duke@1 28 import com.sun.tools.doclets.internal.toolkit.*;
duke@1 29 import com.sun.tools.doclets.internal.toolkit.util.*;
duke@1 30 import com.sun.javadoc.*;
duke@1 31
duke@1 32 import java.io.*;
duke@1 33
duke@1 34 /**
duke@1 35 * Writes nested class documentation in HTML format.
duke@1 36 *
duke@1 37 * @author Robert Field
duke@1 38 * @author Atul M Dambalkar
duke@1 39 * @author Jamie Ho (rewrite)
duke@1 40 */
duke@1 41 public class NestedClassWriterImpl extends AbstractMemberWriter
duke@1 42 implements MemberSummaryWriter {
duke@1 43
duke@1 44 private boolean printedSummaryHeader = false;
duke@1 45
duke@1 46 public NestedClassWriterImpl(SubWriterHolderWriter writer,
duke@1 47 ClassDoc classdoc) {
duke@1 48 super(writer, classdoc);
duke@1 49 }
duke@1 50
duke@1 51 public NestedClassWriterImpl(SubWriterHolderWriter writer) {
duke@1 52 super(writer);
duke@1 53 }
duke@1 54
duke@1 55 /**
duke@1 56 * Write the classes summary header for the given class.
duke@1 57 *
duke@1 58 * @param classDoc the class the summary belongs to.
duke@1 59 */
duke@1 60 public void writeMemberSummaryHeader(ClassDoc classDoc) {
duke@1 61 printedSummaryHeader = true;
duke@1 62 writer.println("<!-- ======== NESTED CLASS SUMMARY ======== -->");
duke@1 63 writer.println();
duke@1 64 writer.printSummaryHeader(this, classDoc);
duke@1 65 }
duke@1 66
duke@1 67 /**
duke@1 68 * Write the classes summary footer for the given class.
duke@1 69 *
duke@1 70 * @param classDoc the class the summary belongs to.
duke@1 71 */
duke@1 72 public void writeMemberSummaryFooter(ClassDoc classDoc) {
duke@1 73 writer.printSummaryFooter(this, classDoc);
duke@1 74 }
duke@1 75
duke@1 76 /**
duke@1 77 * Write the inherited classes summary header for the given class.
duke@1 78 *
duke@1 79 * @param classDoc the class the summary belongs to.
duke@1 80 */
duke@1 81 public void writeInheritedMemberSummaryHeader(ClassDoc classDoc) {
duke@1 82 if(! printedSummaryHeader){
duke@1 83 //We don't want inherited summary to not be under heading.
duke@1 84 writeMemberSummaryHeader(classDoc);
duke@1 85 writeMemberSummaryFooter(classDoc);
duke@1 86 printedSummaryHeader = true;
duke@1 87 }
duke@1 88 writer.printInheritedSummaryHeader(this, classDoc);
duke@1 89 }
duke@1 90
duke@1 91 /**
duke@1 92 * {@inheritDoc}
duke@1 93 */
duke@1 94 public void writeInheritedMemberSummary(ClassDoc classDoc,
duke@1 95 ProgramElementDoc nestedClass, boolean isFirst, boolean isLast) {
duke@1 96 writer.printInheritedSummaryMember(this, classDoc, nestedClass, isFirst);
duke@1 97 }
duke@1 98
duke@1 99 /**
duke@1 100 * Write the inherited classes summary footer for the given class.
duke@1 101 *
duke@1 102 * @param classDoc the class the summary belongs to.
duke@1 103 */
duke@1 104 public void writeInheritedMemberSummaryFooter(ClassDoc classDoc) {
duke@1 105 writer.printInheritedSummaryFooter(this, classDoc);
duke@1 106 writer.println();
duke@1 107 }
duke@1 108
duke@1 109 /**
duke@1 110 * Write the header for the nested class documentation.
duke@1 111 *
duke@1 112 * @param classDoc the class that the classes belong to.
duke@1 113 */
duke@1 114 public void writeHeader(ClassDoc classDoc, String header) {
duke@1 115 writer.anchor("nested class_detail");
duke@1 116 writer.printTableHeadingBackground(header);
duke@1 117 }
duke@1 118
duke@1 119 /**
duke@1 120 * Write the nested class header for the given nested class.
duke@1 121 *
duke@1 122 * @param nestedClass the nested class being documented.
duke@1 123 * @param isFirst the flag to indicate whether or not the nested class is the
duke@1 124 * first to be documented.
duke@1 125 */
duke@1 126 public void writeClassHeader(ClassDoc nestedClass, boolean isFirst) {
duke@1 127 if (! isFirst) {
duke@1 128 writer.printMemberHeader();
duke@1 129 writer.println("");
duke@1 130 }
duke@1 131 writer.anchor(nestedClass.name());
duke@1 132 writer.dl();
duke@1 133 writer.h3();
duke@1 134 writer.print(nestedClass.name());
duke@1 135 writer.h3End();
duke@1 136 }
duke@1 137
duke@1 138
duke@1 139
duke@1 140 /**
duke@1 141 * Close the writer.
duke@1 142 */
duke@1 143 public void close() throws IOException {
duke@1 144 writer.close();
duke@1 145 }
duke@1 146
duke@1 147 public int getMemberKind() {
duke@1 148 return VisibleMemberMap.INNERCLASSES;
duke@1 149 }
duke@1 150
duke@1 151 public void printSummaryLabel(ClassDoc cd) {
duke@1 152 writer.boldText("doclet.Nested_Class_Summary");
duke@1 153 }
duke@1 154
duke@1 155 public void printSummaryAnchor(ClassDoc cd) {
duke@1 156 writer.anchor("nested_class_summary");
duke@1 157 }
duke@1 158
duke@1 159 public void printInheritedSummaryAnchor(ClassDoc cd) {
duke@1 160 writer.anchor("nested_classes_inherited_from_class_" +
duke@1 161 cd.qualifiedName());
duke@1 162 }
duke@1 163
duke@1 164 public void printInheritedSummaryLabel(ClassDoc cd) {
duke@1 165 String clslink = writer.getPreQualifiedClassLink(
duke@1 166 LinkInfoImpl.CONTEXT_MEMBER, cd, false);
duke@1 167 writer.bold();
duke@1 168 writer.printText(cd.isInterface() ?
duke@1 169 "doclet.Nested_Classes_Interface_Inherited_From_Interface" :
duke@1 170 "doclet.Nested_Classes_Interfaces_Inherited_From_Class",
duke@1 171 clslink);
duke@1 172 writer.boldEnd();
duke@1 173 }
duke@1 174
duke@1 175 protected void writeSummaryLink(int context, ClassDoc cd, ProgramElementDoc member) {
duke@1 176 writer.bold();
duke@1 177 writer.printLink(new LinkInfoImpl(context, (ClassDoc)member, false));
duke@1 178 writer.boldEnd();
duke@1 179 }
duke@1 180
duke@1 181 protected void writeInheritedSummaryLink(ClassDoc cd,
duke@1 182 ProgramElementDoc member) {
duke@1 183 writer.printLink(new LinkInfoImpl(LinkInfoImpl.CONTEXT_MEMBER,
duke@1 184 (ClassDoc)member, false));
duke@1 185 }
duke@1 186
duke@1 187 protected void printSummaryType(ProgramElementDoc member) {
duke@1 188 ClassDoc cd = (ClassDoc)member;
duke@1 189 printModifierAndType(cd, null);
duke@1 190 }
duke@1 191
duke@1 192 protected void printHeader(ClassDoc cd) {
duke@1 193 // N.A.
duke@1 194 }
duke@1 195
duke@1 196 protected void printBodyHtmlEnd(ClassDoc cd) {
duke@1 197 // N.A.
duke@1 198 }
duke@1 199
duke@1 200 protected void printMember(ProgramElementDoc member) {
duke@1 201 // N.A.
duke@1 202 }
duke@1 203
duke@1 204 protected void writeDeprecatedLink(ProgramElementDoc member) {
duke@1 205 writer.printQualifiedClassLink(LinkInfoImpl.CONTEXT_MEMBER,
duke@1 206 (ClassDoc)member);
duke@1 207 }
duke@1 208
duke@1 209 protected void printNavSummaryLink(ClassDoc cd, boolean link) {
duke@1 210 if (link) {
duke@1 211 writer.printHyperLink("", (cd == null) ? "nested_class_summary":
duke@1 212 "nested_classes_inherited_from_class_" +
duke@1 213 cd.qualifiedName(),
duke@1 214 ConfigurationImpl.getInstance().getText("doclet.navNested"));
duke@1 215 } else {
duke@1 216 writer.printText("doclet.navNested");
duke@1 217 }
duke@1 218 }
duke@1 219
duke@1 220 protected void printNavDetailLink(boolean link) {
duke@1 221 }
duke@1 222
duke@1 223 protected void printMemberLink(ProgramElementDoc member) {
duke@1 224 }
duke@1 225
duke@1 226 protected void printMembersSummaryLink(ClassDoc cd, ClassDoc icd,
duke@1 227 boolean link) {
duke@1 228 if (link) {
duke@1 229 writer.printHyperLink(cd.name() + ".html",
duke@1 230 (cd == icd)?
duke@1 231 "nested_class_summary":
duke@1 232 "nested_classes_inherited_from_class_" +
duke@1 233 icd.qualifiedName(),
duke@1 234 ConfigurationImpl.getInstance().getText(
duke@1 235 "doclet.Nested_Class_Summary"));
duke@1 236 } else {
duke@1 237 writer.printText("doclet.Nested_Class_Summary");
duke@1 238 }
duke@1 239 }
duke@1 240 }

mercurial