org.sandev.generator.tags
Class StructTagSummaryfields

java.lang.Object
  org.sandev.generator.tags.AbstractSandBaseTag
      org.sandev.generator.tags.AbstractSandClassTag
          org.sandev.generator.tags.AbstractSandStructTag
              org.sandev.generator.tags.StructTagSummaryfields

All Implemented Interfaces:

com.sun.tools.doclets.Taglet

public class StructTagSummaryfields
extends AbstractSandStructTag

Handle the @sand.summaryfields declaration.

Declares one or more fields which will be used to form a summary description. A summary description is used when displaying a collection of instances, and to provide human-readable navigational linkage in a UI. The names of the fields, together with their values are made available in the raw UI display output, which is then transformed to provide the finished display.

Not all the fields specified in this declaration will necessarily be used in a UI. They may be filtered out based on context, space considerations, or other reasons. It is recommended that the summary display fields be specified in priority order.

What's valid to specify:

• Any field name in the current struct declaration
• referenceFieldName.fieldInReferencedStruct
• fieldName="display name"
• fully.qualified.classname.methodName(this)="display name"

Array fields are NOT valid to specify in a summary.

If no fields are specified for a summary, then for a persistent message the uniqueID is used. Otherwise the first declared field is used. If a struct has no fields, then this method will return an empty array, and what happens in the UI is indeterminate. The expectation is that all struct declarations will have at least one data field.

parameters: One or more field (data member) names separated by whitespace.
This tag does not support comments.

Field Summary

static java.lang.String	CORENAME The core name of this tag.
protected java.lang.String[]	fieldNames The array of field names
static java.lang.String	TAGNAME Our fixed name, used for hash lookup and text parsing.

Fields inherited from class org.sandev.generator.tags.AbstractSandBaseTag

PREFIX

Constructor Summary

StructTagSummaryfields()

Method Summary

protected int	countQuotes(java.lang.String text) Return the number of quotes in the given text
static boolean	exists(com.sun.javadoc.ClassDoc fd) Returns true if the given field contains this tag, false otherwise.
java.lang.String[]	getFieldNames() accessor for fieldNames
java.lang.String	getName() Return our tag name
static StructTagSummaryfields	getStructTagSummaryfields(com.sun.javadoc.ClassDoc cd) Factory method for retrieving a new instance given a ClassDoc.
void	init(com.sun.javadoc.Tag tag) Initialize this instance from the tag information.
static void	register(java.util.Map tagletMap) Registers this taglet when triggered by the taglet declaration being loaded in as part of the build.
void	setFieldNames(java.lang.String[] names) mutator for fieldNames
java.lang.String	toString(com.sun.javadoc.Tag tag) Return a documentation description of this tag.
java.lang.String	toString(com.sun.javadoc.Tag[] tags) Return the documentation text for when several of these tags are present

Methods inherited from class org.sandev.generator.tags.AbstractSandClassTag

inType

Methods inherited from class org.sandev.generator.tags.AbstractSandBaseTag

inConstructor, inField, inMethod, inOverview, inPackage, isInlineTag, registerHelper

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

CORENAME

public static final java.lang.String CORENAME

The core name of this tag.

See Also:

Constant Field Values

fieldNames

protected java.lang.String[] fieldNames

The array of field names

TAGNAME

public static final java.lang.String TAGNAME

Our fixed name, used for hash lookup and text parsing.

See Also:

Constant Field Values

Constructor Detail

StructTagSummaryfields

public StructTagSummaryfields()

Method Detail

getFieldNames

public java.lang.String[] getFieldNames()

accessor for fieldNames

setFieldNames

public void setFieldNames(java.lang.String[] names)

mutator for fieldNames

init

public void init(com.sun.javadoc.Tag tag)

Initialize this instance from the tag information. When reading we are tokenizing based on whitespace but we need to ignore embedded spaces within quotes. We will need to be able to handle things like org.sandev.whatever.class.method(blah,"some value")="print value" org.sandev.whatever.class.method(blah,"some value")="print" org.sandev.whatever.class.method(blah,"value")="print" org.sandev.whatever.class.method(blah,"value")="print value" Not worth a full bore parsing just to get these through. If we have an even number of quotes, pass it through. If we have odd number then accumulate until the next odd number.

countQuotes

protected int countQuotes(java.lang.String text)

Return the number of quotes in the given text

getName

public java.lang.String getName()

Return our tag name

register

public static void register(java.util.Map tagletMap)

Registers this taglet when triggered by the taglet declaration being loaded in as part of the build.

toString

public java.lang.String toString(com.sun.javadoc.Tag tag)

Return a documentation description of this tag.

Specified by:

toString in interface com.sun.tools.doclets.Taglet

Specified by:

toString in class AbstractSandBaseTag

Parameters:

tag - the Tag representation of this custom tag.

toString

public java.lang.String toString(com.sun.javadoc.Tag[] tags)

Return the documentation text for when several of these tags are present

Specified by:

toString in interface com.sun.tools.doclets.Taglet

Specified by:

toString in class AbstractSandBaseTag

Parameters:

tags - the array of Tags representing of this custom tag.

getStructTagSummaryfields

public static StructTagSummaryfields getStructTagSummaryfields(com.sun.javadoc.ClassDoc cd)

Factory method for retrieving a new instance given a ClassDoc. Returns an initialized instance in all cases. If there are fields declared, then that's what's get used. Otherwise if there are no fields declared, then we use the uniqueID for a persistent message, or the first declared field otherwise.

exists

public static boolean exists(com.sun.javadoc.ClassDoc fd)

Returns true if the given field contains this tag, false otherwise.