com.atlassian.jira.upgrade.util

Class AbstractLegacyPortletUpgradeTask

java.lang.Object

com.atlassian.jira.upgrade.util.AbstractLegacyPortletUpgradeTask

All Implemented Interfaces:

LegacyPortletUpgradeTask

Direct Known Subclasses:

SimpleLegacyPortletUpgradeTask

public abstract class AbstractLegacyPortletUpgradeTask
extends Object
implements LegacyPortletUpgradeTask

Abstract implementation that provides a default way of converting properties to the new userpreferences format.

Since:

v4.0

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	MULTIVALUE_SEPARATOR Separator used by new gadgets
static String	PORTLET_MULTI_VALUE_SEPARATOR
protected static String	SEPARATOR_ENCODED If a multivalue value contains a '|' then Shindig will %encode it to this

Constructor Summary

Constructors

Constructor and Description
AbstractLegacyPortletUpgradeTask()

Method Summary

Modifier and Type	Method and Description
protected String	convertMultiSelectValue(String values)
Map<String,String>	convertUserPrefs(com.opensymphony.module.propertyset.PropertySet propertySet) Converts the propertySet in use by this portletConfiguration to a Map.
abstract URI	getGadgetUri() Returns the gadget URI to be used for this portlet.
abstract String	getPortletKey() Returns the portletKey that this upgrade task can convert.

Methods inherited from class java.lang.Object

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

Field Detail

MULTIVALUE_SEPARATOR

protected static final String MULTIVALUE_SEPARATOR

Separator used by new gadgets

See Also:

Constant Field Values

SEPARATOR_ENCODED

protected static final String SEPARATOR_ENCODED

If a multivalue value contains a '|' then Shindig will %encode it to this

See Also:

Constant Field Values

PORTLET_MULTI_VALUE_SEPARATOR

public static final String PORTLET_MULTI_VALUE_SEPARATOR

See Also:

Constant Field Values

Constructor Detail

AbstractLegacyPortletUpgradeTask

public AbstractLegacyPortletUpgradeTask()

Method Detail

getPortletKey

public abstract String getPortletKey()

Description copied from interface: LegacyPortletUpgradeTask

Returns the portletKey that this upgrade task can convert. Note that this is the full key that can be contained via com.atlassian.jira.portal.Portlet#getId(). For example: 'com.atlassian.jira.plugin.system.portlets:inprogress'

Specified by:

getPortletKey in interface LegacyPortletUpgradeTask

Returns:

the portletKey that this upgrade task can convert.

getGadgetUri

public abstract URI getGadgetUri()

Description copied from interface: LegacyPortletUpgradeTask

Returns the gadget URI to be used for this portlet. Should be a relative URI pointing to the gadget replacing this portlet. For example: 'rest/gadgets/1.0/g/com.atlassian.jira.gadgets/gadgets/filter-results-gadget.xml'

Specified by:

getGadgetUri in interface LegacyPortletUpgradeTask

Returns:

the gadget URI to be used for this portlet.

convertUserPrefs

public Map<String,String> convertUserPrefs(com.opensymphony.module.propertyset.PropertySet propertySet)

Description copied from interface: LegacyPortletUpgradeTask

Converts the propertySet in use by this portletConfiguration to a Map. Please note that multi value values (values separated by _*|*_ in the propertyset) should be converted to values simply separated by '|'. If '|' occurs in a value it needs to be % encoded to '%7C'.

Implementations may choose to convert properties to userprefs depending on the new gadgets requirements. This doesn't have to represent a 1 to 1 mapping.

Specified by:

convertUserPrefs in interface LegacyPortletUpgradeTask

Parameters:

propertySet - the old portletConfiguration propertySet to be converted

Returns:

the propertySet converted to a map of key -> value pairs.

convertMultiSelectValue

protected String convertMultiSelectValue(String values)