com.atlassian.confluence.macro.browser
Interface MacroMetadataProvider

All Known Implementing Classes:

CachingGadgetsMacroMetadataProvider, DefaultMacroMetadataProvider, DelegatingMacroMetadataProvider, UserMacroMetadataProvider

public interface MacroMetadataProvider

Implementations of this class will be used by the MacroBrowserManager to provide additional MacroMetadata.

Method Summary

MacroMetadata	getByMacroName(java.lang.String macroName) Returns the metadata for the named macro if it is known to this provider.
MacroMetadata	getByMacroNameAndId(java.lang.String macroName, java.lang.String alternateId) Returns the metadata for the named macro if it is known to this provider.
java.util.Collection<MacroMetadata>	getData() Returns a collection of MacroMetadata for use in the Macro Browser.
java.util.Collection<MacroSummary>	getSummaries() Returns a collection of MacroMetadata for use in the Macro Browser.

Method Detail

getData

java.util.Collection<MacroMetadata> getData()

Returns a collection of MacroMetadata for use in the Macro Browser. This collection need not necessarily be unique.

getSummaries

java.util.Collection<MacroSummary> getSummaries()

Returns a collection of MacroMetadata for use in the Macro Browser. This collection need not necessarily be unique. It's just the summaries.

getByMacroName

MacroMetadata getByMacroName(java.lang.String macroName)

Returns the metadata for the named macro if it is known to this provider. Otherwise returns null.

Parameters:

macroName - the (simple, unfriendly) name of the macro.

Returns:

the macro's metadata or null if it is not known to this provider.

Since:

4.0

getByMacroNameAndId

MacroMetadata getByMacroNameAndId(java.lang.String macroName,
                                  java.lang.String alternateId)

Returns the metadata for the named macro if it is known to this provider. Otherwise returns null.

Parameters:

macroName - the (simple, unfriendly) name of the macro.

alternateId - additional identification for macros where the macroName is not sufficient. If alternateId is null, then it should be ignored.

Returns:

the macro's metadata or null if it is not known to this provider.

Since:

5.5