|
Liferay 6.1.2-ce-ga3 | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface PortletDataHandler
A PortletDataHandler
is a special class capable of exporting and
importing portlet specific data to a Liferay Archive file (LAR) when a site's
layouts are exported or imported. PortletDataHandler
s are
defined by placing a portlet-data-handler-class
element in the
portlet
section of the liferay-portlet.xml file.
Method Summary | |
---|---|
PortletPreferences |
deleteData(PortletDataContext portletDataContext,
String portletId,
PortletPreferences portletPreferences)
Deletes the data created by the portlet. |
String |
exportData(PortletDataContext portletDataContext,
String portletId,
PortletPreferences portletPreferences)
Returns a string of data to be placed in the <portlet-data> section of the LAR file. |
String[] |
getDataPortletPreferences()
Returns an array of the portlet preferences that reference data. |
PortletDataHandlerControl[] |
getExportControls()
Returns an array of the controls defined for this data handler. |
PortletDataHandlerControl[] |
getExportMetadataControls()
Returns an array of the metadata controls defined for this data handler. |
PortletDataHandlerControl[] |
getImportControls()
Returns an array of the controls defined for this data handler. |
PortletDataHandlerControl[] |
getImportMetadataControls()
Returns an array of the metadata controls defined for this data handler. |
PortletPreferences |
importData(PortletDataContext portletDataContext,
String portletId,
PortletPreferences portletPreferences,
String data)
Handles any special processing of the data when the portlet is imported into a new layout. |
boolean |
isAlwaysExportable()
Returns true to allow the user to export data for this
portlet even though it may not belong to any pages. |
boolean |
isAlwaysStaged()
|
boolean |
isDataLocalized()
|
boolean |
isPublishToLiveByDefault()
Returns whether the data exported by this handler should be included by default when publishing to live. |
Method Detail |
---|
PortletPreferences deleteData(PortletDataContext portletDataContext, String portletId, PortletPreferences portletPreferences) throws PortletDataException
preferences
if it contains reference to data that
does not exist anymore.
portletDataContext
- the context of the data deletionportletId
- the portlet ID of the portletportletPreferences
- the portlet preferences of the portlet
Null
if the portlet preferences were unmodified by
this data handler.
PortletDataException
String exportData(PortletDataContext portletDataContext, String portletId, PortletPreferences portletPreferences) throws PortletDataException
data
parameter of importData()
.
portletDataContext
- the context of the data exportportletId
- the portlet ID of the portletportletPreferences
- the portlet preferences of the portlet
Null
should be returned if no portlet
data is to be written out.
PortletDataException
String[] getDataPortletPreferences()
PortletDataHandlerControl[] getExportControls() throws PortletDataException
PortletDataException
PortletDataHandlerControl[] getExportMetadataControls() throws PortletDataException
PortletDataException
PortletDataHandlerControl[] getImportControls() throws PortletDataException
PortletDataException
PortletDataHandlerControl[] getImportMetadataControls() throws PortletDataException
PortletDataException
PortletPreferences importData(PortletDataContext portletDataContext, String portletId, PortletPreferences portletPreferences, String data) throws PortletDataException
preferences
to be saved in the new portlet.
portletDataContext
- the context of the data importportletId
- the portlet ID of the portletportletPreferences
- the portlet preferences of the portletdata
- the string data that was returned by
exportData()
Null
if the portlet preferences were unmodified by
this data handler.
PortletDataException
boolean isAlwaysExportable()
true
to allow the user to export data for this
portlet even though it may not belong to any pages. See LPS-1624.
true
to allow the user to export data for this
portlet even though it may not belong to any pagesboolean isAlwaysStaged()
boolean isDataLocalized()
boolean isPublishToLiveByDefault()
true
for data that is meant to be managed in an staging environment such as
CMS content, but not for data meant to be input by users such as wiki
pages or message board posts.
true
to publish to live by default
|
Liferay 6.1.2-ce-ga3 | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |