Top Description Inners Methods
jdk.javadoc.internal.doclets.formats.html.taglets

public Interface Taglet

Known Direct Implementers
jdk.javadoc.internal.doclets.formats.html.taglets.UserTaglet, jdk.javadoc.internal.doclets.formats.html.taglets.BaseTaglet
Imports
java.util.Set, javax.lang.model.element.Element, com.sun.source.doctree.DocTree, jdk.javadoc.doclet.Taglet.Location, jdk.javadoc.internal.doclets.formats.html.markup.HtmlTree, jdk.javadoc.internal.doclets.formats.html.Content

This is the taglet interface used internally within the doclet. The public jdk.javadoc.doclet.Taglet interface only supports output to strings. This interface supports structured output, to Content objects, such as HtmlTree. User-provided taglets are supported using the UserTaglet wrapper class.

Nested and Inner Type Summary

Modifier and TypeClass and Description
public static class

Method Summary

Modifier and TypeMethod and Description
public Content

Returns:

the output for this tag
getAllBlockTagOutput
(Element
the element for the enclosing doc comment
owner
,
TagletWriter
the taglet-writer used in this doclet
tagletWriter
)

Returns the content to be included in the generated output for all instances of block tags handled by this taglet.

public Set<Taglet.Location>

Returns:

the set of allowable locations
getAllowedLocations
()

Returns the set of allowed locations for a block tag handled by this taglet.

public Content

Returns:

the output for this tag
getInlineTagOutput
(Element
the element for the enclosing doc comment
owner
,
DocTree
the tag
tag
,
TagletWriter
the taglet-writer used in this doclet
tagletWriter
)

Returns the content to be included in the generated output for an instance of an inline tag handled by this taglet.

public String

Returns:

the name of this tag
getName
()

Returns the name of this tag.

public default boolean

Returns:

true if this Taglet can be used in constructor documentation and false otherwise
inConstructor
()

Indicates whether this Taglet can be used in constructor documentation.

public default boolean

Returns:

true if this Taglet can be used in field documentation and false otherwise
inField
()

Indicates whether this Taglet can be used in field documentation.

public default boolean

Returns:

true if this Taglet can be used in method documentation and false otherwise
inMethod
()

Indicates whether this Taglet can be used in method documentation.

public default boolean

Returns:

true if this Taglet can be used in module documentation and false otherwise
inModule
()

Indicates whether this Taglet can be used in module documentation.

public default boolean

Returns:

true if this Taglet can be used in overview documentation and false otherwise
inOverview
()

Indicates whether this Taglet can be used in overview documentation.

public default boolean

Returns:

true if this Taglet can be used in package documentation and false otherwise
inPackage
()

Indicates whether this Taglet can be used in package documentation.

public default boolean

Returns:

true if this Taglet can be used in type documentation and false otherwise
inType
()

Indicates whether this Taglet can be used in type documentation (classes or interfaces).

public default boolean

Returns:

true if this Taglet represents a block tag
isBlockTag
()

Indicates whether this Taglet represents a block tag.

public boolean

Returns:

true if this Taglet represents an inline tag and false otherwise
isInlineTag
()

Indicates whether this Taglet represents an inline tag.

Method Detail

getAllBlockTagOutputback to summary
public Content getAllBlockTagOutput(Element owner, TagletWriter tagletWriter) throws UnsupportedTagletOperationException

Returns the content to be included in the generated output for all instances of block tags handled by this taglet.

Parameters
owner:Element

the element for the enclosing doc comment

tagletWriter:TagletWriter

the taglet-writer used in this doclet

Returns:Content

the output for this tag

Exceptions
UnsupportedTagletOperationException:
if the method is not supported by the taglet
getAllowedLocationsback to summary
public Set<Taglet.Location> getAllowedLocations()

Returns the set of allowed locations for a block tag handled by this taglet.

Returns:Set<Taglet.Location>

the set of allowable locations

getInlineTagOutputback to summary
public Content getInlineTagOutput(Element owner, DocTree tag, TagletWriter tagletWriter) throws UnsupportedTagletOperationException

Returns the content to be included in the generated output for an instance of an inline tag handled by this taglet.

Parameters
owner:Element

the element for the enclosing doc comment

tag:DocTree

the tag

tagletWriter:TagletWriter

the taglet-writer used in this doclet

Returns:Content

the output for this tag

Exceptions
UnsupportedTagletOperationException:
if the method is not supported by the taglet
getNameback to summary
public String getName()

Returns the name of this tag.

Returns:String

the name of this tag

inConstructorback to summary
public default boolean inConstructor()

Indicates whether this Taglet can be used in constructor documentation.

Returns:boolean

true if this Taglet can be used in constructor documentation and false otherwise

inFieldback to summary
public default boolean inField()

Indicates whether this Taglet can be used in field documentation.

Returns:boolean

true if this Taglet can be used in field documentation and false otherwise

inMethodback to summary
public default boolean inMethod()

Indicates whether this Taglet can be used in method documentation.

Returns:boolean

true if this Taglet can be used in method documentation and false otherwise

inModuleback to summary
public default boolean inModule()

Indicates whether this Taglet can be used in module documentation.

Returns:boolean

true if this Taglet can be used in module documentation and false otherwise

inOverviewback to summary
public default boolean inOverview()

Indicates whether this Taglet can be used in overview documentation.

Returns:boolean

true if this Taglet can be used in overview documentation and false otherwise

inPackageback to summary
public default boolean inPackage()

Indicates whether this Taglet can be used in package documentation.

Returns:boolean

true if this Taglet can be used in package documentation and false otherwise

inTypeback to summary
public default boolean inType()

Indicates whether this Taglet can be used in type documentation (classes or interfaces).

Returns:boolean

true if this Taglet can be used in type documentation and false otherwise

isBlockTagback to summary
public default boolean isBlockTag()

Indicates whether this Taglet represents a block tag.

Implementation Specification

This implementation returns the inverse result to isInlineTag.

Returns:boolean

true if this Taglet represents a block tag

isInlineTagback to summary
public boolean isInlineTag()

Indicates whether this Taglet represents an inline tag.

Returns:boolean

true if this Taglet represents an inline tag and false otherwise

jdk.javadoc.internal.doclets.formats.html.taglets back to summary

public Class Taglet.UnsupportedTagletOperationException

extends UnsupportedOperationException
Class Inheritance

Field Summary

Modifier and TypeField and Description
private static final long

Constructor Summary

AccessConstructor and Description
public

Field Detail

serialVersionUIDback to summary
private static final long serialVersionUID

Hides java.lang.UnsupportedOperationException.serialVersionUID.

Constructor Detail

UnsupportedTagletOperationExceptionback to summary
public UnsupportedTagletOperationException(String message)