MacroDefinition (Atlassian Confluence 5.9.1 API)

java.lang.Object
- com.atlassian.confluence.xhtml.api.MacroDefinition

```
public class MacroDefinition
extends Object
```
An object that encapsulates the state for a macro.

Field Summary

Fields
Modifier and Type Field and Description

static int INITIAL_SCHEMA_VERSION

static String STORAGE_VERSION_1

static String STORAGE_VERSION_2

Fields
Modifier and Type	Field and Description
`static int`	`INITIAL_SCHEMA_VERSION`
`static String`	`STORAGE_VERSION_1`
`static String`	`STORAGE_VERSION_2`

Constructor Summary

Constructors
Constructor and Description
`MacroDefinition()` Deprecated. since 5.8. Use `MacroDefinitionBuilder`
`MacroDefinition(MacroDefinition macroDefinition)` Copy constructor.
`MacroDefinition(String name, MacroBody body, Map<String,String> parameters, Map<String,Object> typedParameters, String storageVersion)` Deprecated. since 5.7. Use `MacroDefinitionBuilder`
`MacroDefinition(String name, MacroBody body, Map<String,String> parameters, Map<String,Object> typedParameters, String storageVersion, com.atlassian.fugue.Option<MacroId> macroId, int schemaVersion)` Deprecated. since 5.8. Use `MacroDefinitionBuilder`
`MacroDefinition(String name, MacroBody body, String defaultParameterValue, Map<String,String> parameters)` Deprecated. since 5.2. Use `MacroDefinitionBuilder`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static MacroDefinitionBuilder`	`builder()` The correct way to construct a new MacroDefinition.
`static MacroDefinitionBuilder`	`builder(String macroName)` The correct way to construct a new MacroDefinition.
`boolean`	`equals(Object o)`
`MacroBody`	`getBody()`
`Streamable`	`getBodyStream()`
`String`	`getBodyText()`
`String`	`getDefaultParameterValue()` Equivalent to `getParameter(java.lang.String)` or `getTypedParameter(java.lang.String, java.lang.Class<T>)` with ""
`com.atlassian.fugue.Option<MacroId>`	`getMacroId()` Each macro definition is assigned a macroId when the page is stored, this can be used to identify macros within a page.
`String`	`getName()`
`String`	`getParameter(String name)`
`Map<String,String>`	`getParameters()`
`int`	`getSchemaVersion()` The macro schema is the definition of the parameters and the macro body, an incompatible change of schema will require an increase in the schema version and a corresponding macro-schema-migration module to migrate from the old schema to the new schema.
`Streamable`	`getStorageBodyStream()`
`String`	`getStorageVersion()`
`Streamable`	`getTransformedBodyStream()`
`<T> T`	`getTypedParameter(String name, Class<T> type)`
`Map<String,Object>`	`getTypedParameters()`
`boolean`	`hasBody()`
`int`	`hashCode()`
`boolean`	`isValid()`
`String`	`macroHash()` The macroHash is used to identify a macro if there is no macroId stored.
`void`	`setBody(MacroBody body)`
`void`	`setDefaultParameterValue(String defaultParameterValue)`
`void`	`setMacroId(com.atlassian.fugue.Option<MacroId> macroId)`
`void`	`setName(String name)`
`void`	`setParameter(String name, String value)`
`void`	`setParameters(Map<String,String> parameters)`
`void`	`setSchemaVersion(int schemaVersion)`
`void`	`setStorageVersion(String storageVersion)`
`void`	`setTypedParameter(String name, Object value)`
`void`	`setTypedParameters(Map<String,Object> typedParameters)`
`String`	`toString()`

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - STORAGE_VERSION_1
```
public static final String STORAGE_VERSION_1
```
    See Also:
    
    Constant Field Values
  - STORAGE_VERSION_2
```
public static final String STORAGE_VERSION_2
```
    See Also:
    
    Constant Field Values
  - INITIAL_SCHEMA_VERSION
```
public static final int INITIAL_SCHEMA_VERSION
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - MacroDefinition
```
@Deprecated
public MacroDefinition()
```
    Deprecated. since 5.8. Use MacroDefinitionBuilder
  - MacroDefinition
```
public MacroDefinition(MacroDefinition macroDefinition)
```
    Copy constructor.
    
    Parameters:
    
    macroDefinition - copy the state of this macro definition into this new instance
  - MacroDefinition
```
@Deprecated
public MacroDefinition(String name,
                                   MacroBody body,
                                   String defaultParameterValue,
                                   Map<String,String> parameters)
```
    Deprecated. since 5.2. Use MacroDefinitionBuilder
    
    Construct a macro definition.
    
    Parameters:
    
    name - the name of the macro
    
    body - the macro body. Should be set to null if the macro does not have a body. Also see PlainTextMacroBody and RichTextMacroBody.
    
    defaultParameterValue - the default macro parameter value. This value is not assigned an actual parameter name.
    
    parameters - the macro parameters
  - MacroDefinition
```
@Deprecated
public MacroDefinition(String name,
                                   MacroBody body,
                                   Map<String,String> parameters,
                                   Map<String,Object> typedParameters,
                                   String storageVersion)
```
    Deprecated. since 5.7. Use MacroDefinitionBuilder
    
    Construct a macro definition.
    
    Parameters:
    
    name - the name of the macro
    
    body - the macro body. Should be set to null if the macro does not have a body. Also see PlainTextMacroBody and RichTextMacroBody.
    
    parameters - the macro parameters
    
    typedParameters - the macro parameters that are pre-parsed into their associated types
    
    Since:
    
    5.2
  - MacroDefinition
```
@Deprecated
public MacroDefinition(String name,
                                   MacroBody body,
                                   Map<String,String> parameters,
                                   Map<String,Object> typedParameters,
                                   String storageVersion,
                                   com.atlassian.fugue.Option<MacroId> macroId,
                                   int schemaVersion)
```
    Deprecated. since 5.8. Use MacroDefinitionBuilder
    
    Construct a macro definition.
    
    Parameters:
    
    name - the name of the macro
    
    body - the macro body. Should be set to null if the macro does not have a body. Also see PlainTextMacroBody and RichTextMacroBody.
    
    parameters - the macro parameters
    
    typedParameters - the macro parameters that are pre-parsed into their associated types
    
    macroId - the unique id of this macro
    
    Since:
    
    5.7
- Method Detail
  - builder
```
public static MacroDefinitionBuilder builder()
```
    The correct way to construct a new MacroDefinition. Get a builder, load it, and build it.
  - builder
```
public static MacroDefinitionBuilder builder(String macroName)
```
    The correct way to construct a new MacroDefinition. Get a builder, load it, and build it. Macro names are required at the time of building the definitions, so provide a shortcut here to supply one when creating the builder.
  - getName
```
public String getName()
```
  - getDefaultParameterValue
```
public String getDefaultParameterValue()
```
    Equivalent to getParameter(java.lang.String) or getTypedParameter(java.lang.String, java.lang.Class<T>) with ""
    
    Returns:
    
    the value of the default parameter, or null if there isn't one.
  - getBodyText
```
public String getBodyText()
```
    Returns:
    
    the body as a string. Can be empty. May be transformed, if that is the required format.
    
    See Also:
    
    getStorageBodyStream(), getTransformedBodyStream(), RequiresFormat
  - getBodyStream
```
public Streamable getBodyStream()
```
    Returns:
    
    the body as a stream. Can be empty. May be transformed, if that is the required format.
    
    See Also:
    
    getStorageBodyStream(), getTransformedBodyStream(), RequiresFormat
  - getStorageBodyStream
```
public Streamable getStorageBodyStream()
```
  - getTransformedBodyStream
```
public Streamable getTransformedBodyStream()
```
  - getBody
```
public MacroBody getBody()
```
  - hasBody
```
public boolean hasBody()
```
  - getParameters
```
public Map<String,String> getParameters()
```
  - getTypedParameters
```
public Map<String,Object> getTypedParameters()
```
  - getParameter
```
public String getParameter(String name)
```
  - getTypedParameter
```
public <T> T getTypedParameter(String name,
                               Class<T> type)
```
  - setName
```
public void setName(String name)
```
  - setDefaultParameterValue
```
public void setDefaultParameterValue(String defaultParameterValue)
```
  - setBody
```
public void setBody(MacroBody body)
```
  - setParameters
```
public void setParameters(Map<String,String> parameters)
```
  - setTypedParameters
```
public void setTypedParameters(Map<String,Object> typedParameters)
```
  - setParameter
```
public void setParameter(String name,
                         String value)
```
  - setTypedParameter
```
public void setTypedParameter(String name,
                              Object value)
```
  - getStorageVersion
```
public String getStorageVersion()
```
  - setStorageVersion
```
public void setStorageVersion(String storageVersion)
```
  - getMacroId
```
public com.atlassian.fugue.Option<MacroId> getMacroId()
```
    Each macro definition is assigned a macroId when the page is stored, this can be used to identify macros within a page.
    If there is no macroId specified for this macro, it means the page containing this macro has not yet been saved after the macro id changes were committed to Confluence.
    
    Returns:
    
    the id of this macro definition, for use when rendering macros for remote add-ons, or when looking up macros through the ContentMacroService, if one is available.
    
    Since:
    
    5.8
  - setMacroId
```
public void setMacroId(com.atlassian.fugue.Option<MacroId> macroId)
```
  - getSchemaVersion
```
public int getSchemaVersion()
```
    The macro schema is the definition of the parameters and the macro body, an incompatible change of schema will require an increase in the schema version and a corresponding macro-schema-migration module to migrate from the old schema to the new schema.
    
    Returns:
    
    the schema version for this macro definition
  - setSchemaVersion
```
public void setSchemaVersion(int schemaVersion)
```
  - isValid
```
public boolean isValid()
```
    Returns:
    
    true if there is at least a name on this MacroDefinition.
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - equals
```
public boolean equals(Object o)
```
    Overrides:
    
    equals in class Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - macroHash
```
public String macroHash()
```
    The macroHash is used to identify a macro if there is no macroId stored. The concept of macro hash's are now only used as backup in favor of macroId's which should be used instead.
    
    Returns:
    
    the hash of this macro definition, for use when rendering macros for remote add-ons, or when looking up macros through the ContentMacroService when no MacroId is available
    
    Since:
    
    5.6

Class MacroDefinition

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

STORAGE_VERSION_1

STORAGE_VERSION_2

INITIAL_SCHEMA_VERSION

Constructor Detail

MacroDefinition

MacroDefinition

MacroDefinition

MacroDefinition

MacroDefinition

Method Detail

builder

builder

getName

getDefaultParameterValue

getBodyText

getBodyStream

getStorageBodyStream

getTransformedBodyStream

getBody

hasBody

getParameters

getTypedParameters

getParameter

getTypedParameter

setName

setDefaultParameterValue

setBody

setParameters

setTypedParameters

setParameter

setTypedParameter

getStorageVersion

setStorageVersion

getMacroId

setMacroId

getSchemaVersion

setSchemaVersion

isValid

toString

equals

hashCode

macroHash