org.eclipse.mat.query.annotations.descriptors
Interface IAnnotatedObjectDescriptor

All Known Implementing Classes:
AnnotatedObjectDescriptor, HeapDumpProviderDescriptor, QueryDescriptor, VmInfoDescriptor

public interface IAnnotatedObjectDescriptor

A descriptor which allows to inspect an annotated object, e.g. a IQuery

Since:
1.0

Method Summary
 java.util.List<ArgumentDescriptor> getArguments()
          Get descriptors for the fields annotated by the annotation Argument.
 java.lang.String getHelp()
          Get the help String, for example provided by the annotation Help.
 java.util.Locale getHelpLocale()
          Get the help locale
 java.lang.String getHelpUrl()
          Get the help URL, for example provided by the annotation HelpUrl.
 java.net.URL getIcon()
          Get the Icon representing the annotated object, for example provided by the annotation Icon.
 java.lang.String getIdentifier()
          Get the identifier for the annotated object, for example provided by the annotation CommandName or getName().
 java.lang.String getName()
          Get the name, for example provided by the annotation Name.
 java.lang.String getUsage(IQueryContext context)
          Get the usage information, for example provided by the annotation Usage, or by a combination of the getIdentifier() and ArgumentDescriptor.appendUsage(java.lang.StringBuilder).
 boolean isHelpAvailable()
          Check if the object has provided some help via annotations.
 

Method Detail

getUsage

java.lang.String getUsage(IQueryContext context)
Get the usage information, for example provided by the annotation Usage, or by a combination of the getIdentifier() and ArgumentDescriptor.appendUsage(java.lang.StringBuilder).

Parameters:
context - used to fill in some arguments leaving usage to explain the remainder
Returns:
the usage information for that query

getIcon

java.net.URL getIcon()
Get the Icon representing the annotated object, for example provided by the annotation Icon.

Returns:
the Icon as a URL

getIdentifier

java.lang.String getIdentifier()
Get the identifier for the annotated object, for example provided by the annotation CommandName or getName().

Returns:
the identifier

getName

java.lang.String getName()
Get the name, for example provided by the annotation Name.

Returns:
the name

getHelp

java.lang.String getHelp()
Get the help String, for example provided by the annotation Help.

Returns:
the help

getHelpUrl

java.lang.String getHelpUrl()
Get the help URL, for example provided by the annotation HelpUrl.

Returns:
the help URL

getHelpLocale

java.util.Locale getHelpLocale()
Get the help locale

Returns:
the locale

getArguments

java.util.List<ArgumentDescriptor> getArguments()
Get descriptors for the fields annotated by the annotation Argument. TODO Should this have been IArgumentDescriptor ?

Returns:
the list of annotated arguments, see ArgumentDescriptor

isHelpAvailable

boolean isHelpAvailable()
Check if the object has provided some help via annotations.

Returns:
true if the object or arguments were annotated with Help.