APIdia Launch Partner
Top Description Fields Constructors Methods
jdk.javadoc.internal.doclets.toolkit

public Class DocFileElement

extends Object
implements DocletElement
Class Inheritance
All Implemented Interfaces
jdk.javadoc.internal.doclets.toolkit.DocletElement, javax.lang.model.element.Element, javax.lang.model.AnnotatedConstruct
Imports
java.util.Objects, javax.lang.model.element.Element, .ModuleElement, .PackageElement, javax.tools.FileObject, jdk.javadoc.internal.doclets.toolkit.util.Utils

This is a pseudo-element wrapper for doc-files html contents, essentially to associate the doc-files' html documentation's DocCommentTree to an element.

Field Summary

Modifier and TypeField and Description
private final Element
private final FileObject
private final PackageElement

Constructor Summary

AccessConstructor and Description
public
DocFileElement(Utils
the standard utilities class
utils
,
Element
the module element or package element that "owns" the doc-files subdirectory
element
,
FileObject
the file object
fo
)

Creates a pseudo-element that wraps a doc-files documentation file.

Method Summary

Modifier and TypeMethod and Description
public boolean
equals(Object o)

Overrides java.lang.Object.equals.

Implements javax.lang.model.element.Element.equals.

Returns true if the argument represents the same element as this, or false otherwise.

public Element

Returns:

the element that "owns" the doc-files directory
getElement
()

Returns the element that "owns" the doc-files directory.

public FileObject
getFileObject()

Implements jdk.javadoc.internal.doclets.toolkit.DocletElement.getFileObject.

Returns the file object associated with this special element such as overview.html, doc-files/foo.html.

public PackageElement
getPackageElement()

Implements jdk.javadoc.internal.doclets.toolkit.DocletElement.getPackageElement.

Returns the anchoring package element, in the case of a module element, this is the module's unnamed package.

public DocletElement.Kind
getSubKind()

Implements jdk.javadoc.internal.doclets.toolkit.DocletElement.getSubKind.

Returns the subkind of this element.

public int
Inherited from java.lang.Object:
clonefinalizegetClassnotifynotifyAlltoStringwaitwaitwait

Field Detail

elementback to summary
private final Element element
foback to summary
private final FileObject fo
packageElementback to summary
private final PackageElement packageElement

Constructor Detail

DocFileElementback to summary
public DocFileElement(Utils utils, Element element, FileObject fo)

Creates a pseudo-element that wraps a doc-files documentation file.

Parameters
utils:Utils

the standard utilities class

element:Element

the module element or package element that "owns" the doc-files subdirectory

fo:FileObject

the file object

Exceptions
IllegalArgumentException:
if the given element is not a module element or package element

Method Detail

equalsback to summary
public boolean equals(Object o)

Overrides java.lang.Object.equals.

Implements javax.lang.model.element.Element.equals.

Doc from javax.lang.model.element.Element.equals.

Returns true if the argument represents the same element as this, or false otherwise.

Annotations
@Override
getElementback to summary
public Element getElement()

Returns the element that "owns" the doc-files directory.

Returns:Element

the element that "owns" the doc-files directory

getFileObjectback to summary
public FileObject getFileObject()

Implements jdk.javadoc.internal.doclets.toolkit.DocletElement.getFileObject.

Doc from jdk.javadoc.internal.doclets.toolkit.DocletElement.getFileObject.

Returns the file object associated with this special element such as overview.html, doc-files/foo.html.

Annotations
@Override
getPackageElementback to summary
public PackageElement getPackageElement()

Implements jdk.javadoc.internal.doclets.toolkit.DocletElement.getPackageElement.

Doc from jdk.javadoc.internal.doclets.toolkit.DocletElement.getPackageElement.

Returns the anchoring package element, in the case of a module element, this is the module's unnamed package.

Annotations
@Override
getSubKindback to summary
public DocletElement.Kind getSubKind()

Implements jdk.javadoc.internal.doclets.toolkit.DocletElement.getSubKind.

Doc from jdk.javadoc.internal.doclets.toolkit.DocletElement.getSubKind.

Returns the subkind of this element.

Annotations
@Override
hashCodeback to summary
public int hashCode()

Overrides java.lang.Object.hashCode.

Implements javax.lang.model.element.Element.hashCode.

Doc from javax.lang.model.element.Element.hashCode.

Obeys the general contract of Object.hashCode.

Annotations
@Override