diff options
Diffstat (limited to 'aspectj-attic/ajdoc-src/org/aspectj/tools/ajdoc/DocImpl.java')
-rw-r--r-- | aspectj-attic/ajdoc-src/org/aspectj/tools/ajdoc/DocImpl.java | 280 |
1 files changed, 280 insertions, 0 deletions
diff --git a/aspectj-attic/ajdoc-src/org/aspectj/tools/ajdoc/DocImpl.java b/aspectj-attic/ajdoc-src/org/aspectj/tools/ajdoc/DocImpl.java new file mode 100644 index 000000000..87dad677e --- /dev/null +++ b/aspectj-attic/ajdoc-src/org/aspectj/tools/ajdoc/DocImpl.java @@ -0,0 +1,280 @@ +/* -*- Mode: JDE; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- + * + * This file is part of the debugger and core tools for the AspectJ(tm) + * programming language; see http://aspectj.org + * + * The contents of this file are subject to the Mozilla Public License + * Version 1.1 (the "License"); you may not use this file except in + * compliance with the License. You may obtain a copy of the License at + * either http://www.mozilla.org/MPL/ or http://aspectj.org/MPL/. + * + * Software distributed under the License is distributed on an "AS IS" basis, + * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License + * for the specific language governing rights and limitations under the + * License. + * + * The Original Code is AspectJ. + * + * The Initial Developer of the Original Code is Xerox Corporation. Portions + * created by Xerox Corporation are Copyright (C) 1999-2002 Xerox Corporation. + * All Rights Reserved. + */ +package org.aspectj.tools.ajdoc; + +import org.aspectj.ajdoc.Doc; + +import com.sun.javadoc.SeeTag; +import com.sun.javadoc.Tag; + +import java.util.Locale; + +public abstract class DocImpl + implements org.aspectj.ajdoc.Doc { + + /** Keep track of whether this is included or not. */ + private boolean isIncluded = true; + + /** The comment for this Doc. */ + private Comment comment; + + /** The error printer for this Doc. */ + private ErrPrinter err; + + /** Keep track of whether this is included or not. */ + private boolean isInterface = true; + + /** The locale of the object -- default to <code>Locale.US</code>. */ + private Locale locale = Locale.US; //TODO + + /** + * Returns the locale. + * + * @return the locale. + */ + public Locale locale() { //XXX + return locale; + } + + + public void setErr(ErrPrinter err) { this.err = err; } + public ErrPrinter err() { return ErrPrinter.instance; } + + public void setComment(Comment comment) { this.comment = comment; } + public Comment getComment() { return comment; } + + /** + * Delegates to {@link Util#compareTo(Object)} to compare + * with another Object. + * + * @return a negative integer, zero, or a positive integer + * as this object is less than, equal to, or greater + * than the specified object based on name. + * @see java.lang.Comparable.compareTo(Object) + */ + public int compareTo(Object other) { + return other instanceof Doc + ? Util.compareTo(this, (Doc)other) + : -1; + } + + /** + * Returns the Tags that comprise the first + * sentence of the comment. + * + * @return an array of Tag representing the first + * sentence of the comment. + */ + public Tag[] firstSentenceTags() { + return getComment() != null + ? getComment().firstSentenceTags() + : new Tag[0]; + } + + /** + * Returns the full unprocessed text of the comment. + * + * @return the full unprocessed text of the comment. + */ + public String getRawCommentText() { + return getComment() != null + ? getComment().rawCommentText() + : ""; + } + + /** + * Sets the full unprocessed text of the comment. + * + * @param rawCommentText the new full unprocessed text of the comment.. + */ + public void setRawCommentText(String rawCommentText) { + if (getComment() != null) { + getComment().setRawCommentText(rawCommentText); + } + } + + /** + * Returns the comment as an array of Tag. + * + * @return an array of Tag representing the comment. + */ + public Tag[] inlineTags() { + return getComment() != null + ? getComment().inlineTags() + : new Tag[0]; + } + + /** + * Returns the see tags of the comment. + * + * @return an array of SeeTag representing the + * see tags of the comment. + */ + public SeeTag[] seeTags() { + return getComment() != null + ? getComment().seeTags() + : new SeeTag[0]; + } + + /** + * Returns all tags of the comment. + * + * @return an array of Tag representing all + * tags of the comment. + */ + public Tag[] tags() { + return getComment() != null + ? getComment().tags() + : new Tag[0]; + } + + /** + * Returns all tags of the comment whose name equals + * <code>tagname</code>. + * + * @return an array of Tag representing all tags of the + * comment whose name equals <code>tagname</code>. + */ + public Tag[] tags(String tagname) { + return getComment() != null + ? getComment().tags(tagname) + : new Tag[0]; + } + + /** + * Returns the commext text for non-null comments, + * otherwise the empty String. + * + * @return non-null comment text. + */ + public String commentText() { + return getComment() != null + ? getComment().commentText() + : ""; + } + + /** + * Sets <code>isIncluded</code>. + * + * @param isIncluded the new value of <code>isIncluded</code>. + */ + public void setIncluded(boolean isIncluded) { + this.isIncluded = isIncluded; + } + + /** + * Returns <code>false</code> by default. + * + * @return <code>false</code> by default. + */ + public boolean isClass() { + return false; + } + + /** + * Returns <code>false</code> by default. + * + * @return <code>false</code> by default. + */ + public boolean isConstructor() { + return false; + } + + /** + * Returns <code>false</code> by default. + * + * @return <code>false</code> by default. + */ + public boolean isError() { + return false; + } + + /** + * Returns <code>false</code> by default. + * + * @return <code>false</code> by default. + */ + public boolean isException() { + return false; + } + /** + * Returns <code>false</code> by default. + * + * @return <codealse</code> by default./ + */ + public boolean isField() { + return false; + } + /** + * Returns <code>isIncluded</code> by default. + * + * @return <codesIncluded</code> by default./ + */ + public boolean isIncluded() { + return isIncluded; + } + + /** + * Returns <code>false</code> by default. + * + * @return <codealse</code> by default./ + */ + public boolean isInterface() { + return false; + } + + /** + * Returns <code>false</code> by default. + * + * @return <codealse</code> by default./ + */ + public boolean isMethod() { + return false; + } + + /** + * Returns <code>false</code> by default. + * + * @return <codealse</code> by default./ + */ + public boolean isOrdinaryClass() { + return false; + } + + /** + * Returns <code>false</code> by default. + * + * @return <codealse</code> by default./ + */ + public boolean isPointcut() { + return false; + } + + /** + * Returns <code>false</code> by default. + * + * @return <codealse</code> by default./ + */ + public boolean isAdvice() { + return false; + } +} |