PropertyTaglet.java

import com.sun.tools.doclets.Taglet;
import com.sun.javadoc.*;
import java.util.Map;

/**
 * Taglet representing @property. This tag can be used in any kind of
 * {@link com.sun.javadoc.Doc}.  It is not an inline tag. For
 * example, "@property er.migration.skipModelNames a comma-separated list of 
 * model names to NOT be migrated." would be shown as:
 * <DL>
 * <DT><B>Properties:</B></DT>
 * <DD><table><tr><th>er.migration.skipModelNames</th><td>
 * a comma-separated list of model names
 * to NOT be migrated.</td></tr></table></DD>
 * </DL>
 *
 * @author chill
 */
public class PropertyTaglet extends AbstractTaglet  {
    private static final String NAME = "property";
    private static final String HEADER = "Properties";
    
    @Override
    public String getName() {
        return NAME;
    }
    
    @Override
    public String getHeader() {
        return HEADER;
    }
    
    @Override
    public boolean inMethod() {
        return true;
    }

    /**
     * Register this Taglet.
     * 
     * @param tagletMap
     *            the map to register this tag to
     */
    @SuppressWarnings("unchecked")
    public static void register(Map tagletMap) {
       PropertyTaglet tag = new PropertyTaglet();
       Taglet t = (Taglet) tagletMap.get(tag.getName());
       if (t != null) {
           tagletMap.remove(tag.getName());
       }
       tagletMap.put(tag.getName(), tag);
    }
}