com.atlassian.jira.portal
Interface PortletConfigurationManager

All Known Implementing Classes:

PortletConfigurationManagerImpl

public interface PortletConfigurationManager

Manager for the PortletConfiguration domain object.

It has a legacy name, but actually manages the Google Gadgets.

Method Summary

PortletConfiguration	addGadget(Long portalPageId, Integer column, Integer row, URI gadgetXml, com.atlassian.gadgets.dashboard.Color color, Map<String,String> userPreferences) Create a new portlet configuration for the passed parameters.
void	delete(PortletConfiguration pc) Remove the passed portlet configuration.
List<PortletConfiguration>	getByPortalPage(Long portalPageId) Get all the PortletConfiguration associated with the passed Portal Page.
PortletConfiguration	getByPortletId(Long portletId) Get the passed portlet configuration.
void	store(PortletConfiguration pc) Update the passed portlet configuration.

Method Detail

getByPortalPage

List<PortletConfiguration> getByPortalPage(Long portalPageId)

Get all the PortletConfiguration associated with the passed Portal Page.

Parameters:

portalPageId - the portal page to query.

Returns:

a list of portlet configurations on the passed page.

getByPortletId

PortletConfiguration getByPortletId(Long portletId)

Get the passed portlet configuration.

Parameters:

portletId - the id of the portlet configuration to return.

Returns:

the porlet configuration identified by the passed id.

delete

void delete(PortletConfiguration pc)

Remove the passed portlet configuration.

Parameters:

pc - the portlet configuration to remove.

store

void store(PortletConfiguration pc)

Update the passed portlet configuration.

Parameters:

pc - the portlet configuration to change.

addGadget

PortletConfiguration addGadget(Long portalPageId,
                               Integer column,
                               Integer row,
                               URI gadgetXml,
                               com.atlassian.gadgets.dashboard.Color color,
                               Map<String,String> userPreferences)

Create a new portlet configuration for the passed parameters.

Parameters:

portalPageId - the portal page the configuration will belong to.

column - the column location for the new configuration.

row - the row location for the new configuration.

gadgetXml - A URI specifying the location of the gadget XML. May be null if this is a legacy portlet.

color - The chrome color for the gadget.

userPreferences - A map of key -> value user preference pairs used to store gadget configuration.

Returns:

the new portlet configuration