jdk8-mips64-public/langtools: src/share/classes/com/sun/tools/doclets/internal/toolkit/SerializedFormWriter.java@90af8d87741f (annotated)

src/share/classes/com/sun/tools/doclets/internal/toolkit/SerializedFormWriter.java@90af8d87741f (annotated)

src/share/classes/com/sun/tools/doclets/internal/toolkit/SerializedFormWriter.java

Wed, 01 Dec 2010 11:02:38 -0800

author: bpatel
date: Wed, 01 Dec 2010 11:02:38 -0800
changeset 766: 90af8d87741f
parent 554: 9d9f26857129
child 798: 4868a36f6fd8
permissions: -rw-r--r--

6851834: Javadoc doclet needs a structured approach to generate the output HTML.
Reviewed-by: jjg

 /*
  * Copyright (c) 2003, 2009, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
  * under the terms of the GNU General Public License version 2 only, as
  * published by the Free Software Foundation.  Oracle designates this
  * particular file as subject to the "Classpath" exception as provided
  * by Oracle in the LICENSE file that accompanied this code.
  *
  * This code is distributed in the hope that it will be useful, but WITHOUT
  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  * version 2 for more details (a copy is included in the LICENSE file that
  * accompanied this code).
  *
  * You should have received a copy of the GNU General Public License version
  * 2 along with this work; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  *
  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  * or visit www.oracle.com if you need additional information or have any
  * questions.
  */
 package com.sun.tools.doclets.internal.toolkit;
 import java.io.*;
 import com.sun.javadoc.*;
 /**
  * The interface for writing serialized form output.
  *
  * This code is not part of an API.
  * It is implementation that is subject to change.
  * Do not use it as an API
  *
  * @author Jamie Ho
  * @since 1.5
  */
 public interface SerializedFormWriter {
     /**
      * Get the header.
      *
      * @param header the header to write.
      * @return the header content tree
      */
     public Content getHeader(String header);
     /**
      * Get the serialized form summaries header.
      *
      * @return the serialized form summary header tree
      */
     public Content getSerializedSummariesHeader();
     /**
      * Get the package serialized form header.
      *
      * @return the package serialized form header tree
      */
     public Content getPackageSerializedHeader();
     /**
      * Get the given package header.
      *
      * @param packageName the package header to write
      * @return a content tree for the package header
      */
     public Content getPackageHeader(String packageName);
     /**
      * Get the serialized class header.
      *
      * @return a content tree for the serialized class header
      */
     public Content getClassSerializedHeader();
     /**
      * Get the heading for the serializable class.
      *
      * @param classDoc the class being processed
      * @return a content tree for the class heading
      */
     public Content getClassHeader(ClassDoc classDoc);
     /**
      * Get the serial UID info header.
      *
      * @return a content tree for the serial uid info header
      */
     public Content getSerialUIDInfoHeader();
     /**
      * Adds the serial UID info.
      *
      * @param header the header that will show up before the UID.
      * @param serialUID the serial UID to print.
      * @param serialUidTree the serial UID tree to which the content will be added.
      */
     public void addSerialUIDInfo(String header, String serialUID,
             Content serialUidTree);
     /**
      * Get the class serialize content header.
      *
      * @return a content tree for the class serialize content header
      */
     public Content getClassContentHeader();
     /**
      * Return an instance of a SerialFieldWriter.
      *
      * @return an instance of a SerialFieldWriter.
      */
     public SerialFieldWriter getSerialFieldWriter(ClassDoc classDoc);
     /**
      * Return an instance of a SerialMethodWriter.
      *
      * @return an instance of a SerialMethodWriter.
      */
     public SerialMethodWriter getSerialMethodWriter(ClassDoc classDoc);
     /**
      * Close the writer.
      */
     public abstract void close() throws IOException;
     /**
      * Get the serialized content.
      *
      * @param serializedTreeContent content for serialized data
      * @return a content tree for serialized information
      */
     public Content getSerializedContent(Content serializedTreeContent);
     /**
      * Add the footer.
      *
      * @param serializedTree the serialized tree to be added
      */
     public void addFooter(Content serializedTree);
     /**
      * Print the serialized form document.
      *
      * @param serializedTree the content tree that will be printed
      */
     public abstract void printDocument(Content serializedTree);
     /**
      * Write the serialized form for a given field.
      */
     public interface SerialFieldWriter {
         /**
          * Get the serializable field header.
          *
          * @return serialized fields header content tree
          */
         public Content getSerializableFieldsHeader();
         /**
          * Get the field content header.
          *
          * @param isLastContent true if this is the last content to be documented
          * @return fields header content tree
          */
         public Content getFieldsContentHeader(boolean isLastContent);
         /**
          * Get the fields content.
          *
          * @param heading the heading to write.
          * @param contentTree content tree to which the heading will be added
          * @return serializable fields content tree
          */
         public Content getSerializableFields(String heading, Content contentTree);
         /**
          * Adds the deprecated information for this member.
          *
          * @param field the field to document.
          * @param contentTree content tree to which the deprecated information will be added
          */
         public void addMemberDeprecatedInfo(FieldDoc field, Content contentTree);
         /**
          * Adds the description text for this member.
          *
          * @param field the field to document.
          * @param contentTree content tree to which the member description will be added
          */
         public void addMemberDescription(FieldDoc field, Content contentTree);
         /**
          * Adds the description text for this member represented by the tag.
          *
          * @param serialFieldTag the field to document (represented by tag).
          * @param contentTree content tree to which the member description will be added
          */
         public void addMemberDescription(SerialFieldTag serialFieldTag, Content contentTree);
         /**
          * Adds the tag information for this member.
          *
          * @param field the field to document.
          * @param contentTree content tree to which the member tags will be added
          */
         public void addMemberTags(FieldDoc field, Content contentTree);
         /**
          * Adds the member header.
          *
          * @param fieldType the type of the field.
          * @param fieldTypeStr the type of the field in string format.  We will
          * print this out if we can't link to the type.
          * @param fieldDimensions the dimensions of the field.
          * @param fieldName the name of the field.
          * @param contentTree content tree to which the member header will be added
          */
         public void addMemberHeader(ClassDoc fieldType, String fieldTypeStr,
             String fieldDimensions, String fieldName, Content contentTree);
         /**
          * Check to see if overview details should be printed. If
          * nocomment option set or if there is no text to be printed
          * for deprecation info, inline comment or tags,
          * do not print overview details.
          *
          * @param field the field to check overview details for.
          * @return true if overview details need to be printed
          */
         public boolean shouldPrintOverview(FieldDoc field);
     }
     /**
      * Write the serialized form for a given field.
      */
     public interface SerialMethodWriter {
         /**
          * Get the serializable method header.
          *
          * @return serializable methods content tree
          */
         public Content getSerializableMethodsHeader();
         /**
          * Get the method content header.
          *
          * @param isLastContent true if this is the last content to be documented
          * @return methods content tree
          */
         public Content getMethodsContentHeader(boolean isLastContent);
         /**
          * Write the given heading.
          *
          * @param heading the heading to write
          * @param serializableMethodTree content tree which will be added
          * @return serializable methods content tree
          */
         public Content getSerializableMethods(String heading, Content serializableMethodTree);
         /**
          * Write a warning that no serializable methods exist.
          *
          * @param msg the warning to print
          * @return no customization message tree
          */
         public Content getNoCustomizationMsg(String msg);
         /**
          * Adds the header.
          *
          * @param member the member to write the header for
          * @param methodsContentTree content tree to which the header will be added
          */
         public void addMemberHeader(MethodDoc member, Content methodsContentTree);
         /**
          * Adds the deprecated information for this member.
          *
          * @param member the member to write the deprecated information for
          * @param methodsContentTree content tree to which the deprecated
          * information will be added
          */
         public void addDeprecatedMemberInfo(MethodDoc member, Content methodsContentTree);
         /**
          * Adds the description for this member.
          *
          * @param member the member to write the information for
          * @param methodsContentTree content tree to which the member
          * information will be added
          */
         public void addMemberDescription(MethodDoc member, Content methodsContentTree);
         /**
          * Adds the tag information for this member.
          *
          * @param member the member to write the tags information for
          * @param methodsContentTree content tree to which the tags
          * information will be added
          */
         public void addMemberTags(MethodDoc member, Content methodsContentTree);
     }
 }

Mercurial > jdk8-mips64-public > langtools / annotate

src/share/classes/com/sun/tools/doclets/internal/toolkit/SerializedFormWriter.java@90af8d87741f (annotated)

src/share/classes/com/sun/tools/doclets/internal/toolkit/SerializedFormWriter.java