Liferay 6.2-ce-ga5

com.liferay.portal.service
Interface LayoutLocalService

All Superinterfaces:
BaseLocalService, PersistedModelLocalService
All Known Implementing Classes:
LayoutLocalServiceWrapper

@ProviderType
@Transactional(isolation=PORTAL,
               rollbackFor={PortalException.class,SystemException.class})
public interface LayoutLocalService
extends BaseLocalService, PersistedModelLocalService

Provides the local service interface for Layout. Methods of this service will not have security checks based on the propagated JAAS credentials because this service can only be accessed from within the same VM.

See Also:
LayoutLocalServiceUtil, LayoutLocalServiceBaseImpl, com.liferay.portal.service.impl.LayoutLocalServiceImpl

Method Summary
 Layout addLayout(Layout layout)
          Adds the layout to the database.
 Layout addLayout(long userId, long groupId, boolean privateLayout, long parentLayoutId, Map<Locale,String> nameMap, Map<Locale,String> titleMap, Map<Locale,String> descriptionMap, Map<Locale,String> keywordsMap, Map<Locale,String> robotsMap, String type, boolean hidden, String friendlyURL, ServiceContext serviceContext)
          Deprecated. As of 6.2.0, replaced by addLayout(long, long, boolean, long, Map, Map, Map, Map, Map, String, String, boolean, Map, ServiceContext)
 Layout addLayout(long userId, long groupId, boolean privateLayout, long parentLayoutId, Map<Locale,String> nameMap, Map<Locale,String> titleMap, Map<Locale,String> descriptionMap, Map<Locale,String> keywordsMap, Map<Locale,String> robotsMap, String type, String typeSettings, boolean hidden, Map<Locale,String> friendlyURLMap, ServiceContext serviceContext)
          Adds a layout with additional parameters.
 Layout addLayout(long userId, long groupId, boolean privateLayout, long parentLayoutId, String name, String title, String description, String type, boolean hidden, String friendlyURL, ServiceContext serviceContext)
          Adds a layout with single entry maps for name, title, and description to the default locale.
 Layout createLayout(long plid)
          Creates a new layout with the primary key.
 Layout deleteLayout(Layout layout)
          Deletes the layout from the database.
 void deleteLayout(Layout layout, boolean updateLayoutSet, ServiceContext serviceContext)
          Deletes the layout, its child layouts, and its associated resources.
 Layout deleteLayout(long plid)
          Deletes the layout with the primary key from the database.
 void deleteLayout(long groupId, boolean privateLayout, long layoutId, ServiceContext serviceContext)
          Deletes the layout with the primary key, also deleting the layout's child layouts, and associated resources.
 void deleteLayout(long plid, ServiceContext serviceContext)
          Deletes the layout with the plid, also deleting the layout's child layouts, and associated resources.
 void deleteLayouts(long groupId, boolean privateLayout, ServiceContext serviceContext)
          Deletes the group's private or non-private layouts, also deleting the layouts' child layouts, and associated resources.
 DynamicQuery dynamicQuery()
           
 List dynamicQuery(DynamicQuery dynamicQuery)
          Performs a dynamic query on the database and returns the matching rows.
 List dynamicQuery(DynamicQuery dynamicQuery, int start, int end)
          Performs a dynamic query on the database and returns a range of the matching rows.
 List dynamicQuery(DynamicQuery dynamicQuery, int start, int end, OrderByComparator orderByComparator)
          Performs a dynamic query on the database and returns an ordered range of the matching rows.
 long dynamicQueryCount(DynamicQuery dynamicQuery)
          Returns the number of rows that match the dynamic query.
 long dynamicQueryCount(DynamicQuery dynamicQuery, Projection projection)
          Returns the number of rows that match the dynamic query.
 byte[] exportLayouts(long groupId, boolean privateLayout, long[] layoutIds, Map<String,String[]> parameterMap, Date startDate, Date endDate)
          Exports layouts with the primary keys and criteria as a byte array.
 byte[] exportLayouts(long groupId, boolean privateLayout, Map<String,String[]> parameterMap, Date startDate, Date endDate)
          Exports all layouts that match the criteria as a byte array.
 File exportLayoutsAsFile(long groupId, boolean privateLayout, long[] layoutIds, Map<String,String[]> parameterMap, Date startDate, Date endDate)
          Exports the layouts that match the primary keys and criteria as a file.
 long exportLayoutsAsFileInBackground(long userId, String taskName, long groupId, boolean privateLayout, long[] layoutIds, Map<String,String[]> parameterMap, Date startDate, Date endDate, String fileName)
           
 byte[] exportPortletInfo(long plid, long groupId, String portletId, Map<String,String[]> parameterMap, Date startDate, Date endDate)
          Exports the portlet information (categories, permissions, ... etc.) as a byte array.
 byte[] exportPortletInfo(long companyId, String portletId, Map<String,String[]> parameterMap, Date startDate, Date endDate)
           
 File exportPortletInfoAsFile(long plid, long groupId, String portletId, Map<String,String[]> parameterMap, Date startDate, Date endDate)
          Exports the portlet information (categories, permissions, ... etc.) as a file.
 File exportPortletInfoAsFile(long companyId, String portletId, Map<String,String[]> parameterMap, Date startDate, Date endDate)
           
 long exportPortletInfoAsFileInBackground(long userId, String taskName, long plid, long groupId, String portletId, Map<String,String[]> parameterMap, Date startDate, Date endDate, String fileName)
           
 long exportPortletInfoAsFileInBackground(long userId, String taskName, String portletId, Map<String,String[]> parameterMap, Date startDate, Date endDate, String fileName)
           
 Layout fetchFirstLayout(long groupId, boolean privateLayout, long parentLayoutId)
           
 Layout fetchLayout(long plid)
           
 Layout fetchLayout(long groupId, boolean privateLayout, long layoutId)
           
 Layout fetchLayoutByFriendlyURL(long groupId, boolean privateLayout, String friendlyURL)
           
 Layout fetchLayoutByUuidAndCompanyId(String uuid, long companyId)
          Returns the layout with the matching UUID and company.
 Layout fetchLayoutByUuidAndGroupId(String uuid, long groupId, boolean privateLayout)
          Returns the layout matching the UUID, group, and privacy.
 String getBeanIdentifier()
          Returns the Spring bean ID for this bean.
 long getDefaultPlid(long groupId)
          Returns the primary key of the default layout for the group
 long getDefaultPlid(long groupId, boolean privateLayout)
          Returns primary key of the matching default layout for the group
 long getDefaultPlid(long groupId, boolean privateLayout, String portletId)
          Returns primary key of the default portlet layout for the group
 Layout getFriendlyURLLayout(long groupId, boolean privateLayout, String friendlyURL)
          Returns the layout for the friendly URL
 Layout getLayout(long plid)
          Returns the layout with the primary key.
 Layout getLayout(long groupId, boolean privateLayout, long layoutId)
          Returns the layout matching the primary key, group, and privacy; throws a NoSuchLayoutException otherwise.
 Layout getLayoutByIconImageId(long iconImageId)
          Returns the layout for the icon image; throws a NoSuchLayoutException otherwise.
 Layout getLayoutByUuidAndCompanyId(String uuid, long companyId)
          Returns the layout with the matching UUID and company.
 Layout getLayoutByUuidAndGroupId(String uuid, long groupId, boolean privateLayout)
          Returns the layout matching the UUID, group, and privacy.
 List<Layout> getLayouts(int start, int end)
          Returns a range of all the layouts.
 List<Layout> getLayouts(long groupId, boolean privateLayout)
          Returns all the layouts belonging to the group.
 List<Layout> getLayouts(long groupId, boolean privateLayout, long parentLayoutId)
          Returns all the layouts belonging to the group that are children of the parent layout.
 List<Layout> getLayouts(long groupId, boolean privateLayout, long[] layoutIds)
          Returns all the layouts that match the layout IDs and belong to the group.
 List<Layout> getLayouts(long groupId, boolean privateLayout, long parentLayoutId, boolean incomplete, int start, int end)
          Returns a range of all the layouts belonging to the group that are children of the parent layout.
 List<Layout> getLayouts(long groupId, boolean privateLayout, String type)
          Returns all the layouts that match the type and belong to the group.
 LayoutReference[] getLayouts(long companyId, String portletId, String preferencesKey, String preferencesValue)
          Returns the layout references for all the layouts that belong to the company and belong to the portlet that matches the preferences.
 List<Layout> getLayoutsByLayoutPrototypeUuid(String layoutPrototypeUuid)
           
 int getLayoutsByLayoutPrototypeUuidCount(String layoutPrototypeUuid)
           
 int getLayoutsCount()
          Returns the number of layouts.
 int getLayoutsCount(Group group, boolean privateLayout)
           
 int getLayoutsCount(Group group, boolean privateLayout, boolean includeUserGroups)
           
 int getLayoutsCount(User user, boolean privateLayout)
           
 int getLayoutsCount(User user, boolean privateLayout, boolean includeUserGroups)
           
 long getNextLayoutId(long groupId, boolean privateLayout)
          Returns the primary key to use for the next layout.
 List<Layout> getNoPermissionLayouts(long roleId)
          Returns all the layouts without resource permissions
 List<Layout> getNullFriendlyURLLayouts()
          Returns all the layouts whose friendly URLs are null
 Layout getParentLayout(Layout layout)
           
 PersistedModel getPersistedModel(Serializable primaryKeyObj)
           
 List<Layout> getScopeGroupLayouts(long groupId, boolean privateLayout)
          Returns all the layouts within scope of the group
 boolean hasLayouts(Group group, boolean privateLayout)
           
 boolean hasLayouts(Group group, boolean privateLayout, boolean includeUserGroups)
           
 boolean hasLayouts(long groupId, boolean privateLayout, long parentLayoutId)
          Returns true if the group has any layouts; false otherwise.
 boolean hasLayouts(User user, boolean privateLayout)
           
 boolean hasLayouts(User user, boolean privateLayout, boolean includeUserGroups)
           
 boolean hasLayoutSetPrototypeLayout(long layoutSetPrototypeId, String layoutUuid)
           
 boolean hasLayoutSetPrototypeLayout(String layoutSetPrototypeUuid, long companyId, String layoutUuid)
           
 void importLayouts(long userId, long groupId, boolean privateLayout, Map<String,String[]> parameterMap, byte[] bytes)
          Imports the layouts from the byte array.
 void importLayouts(long userId, long groupId, boolean privateLayout, Map<String,String[]> parameterMap, File file)
          Imports the layouts from the file.
 void importLayouts(long userId, long groupId, boolean privateLayout, Map<String,String[]> parameterMap, InputStream is)
          Imports the layouts from the input stream.
 long importLayoutsInBackground(long userId, String taskName, long groupId, boolean privateLayout, Map<String,String[]> parameterMap, File file)
           
 long importLayoutsInBackground(long userId, String taskName, long groupId, boolean privateLayout, Map<String,String[]> parameterMap, InputStream is)
           
 void importPortletInfo(long userId, long plid, long groupId, String portletId, Map<String,String[]> parameterMap, File file)
          Imports the portlet information (categories, permissions, ... etc.) from the file.
 void importPortletInfo(long userId, long plid, long groupId, String portletId, Map<String,String[]> parameterMap, InputStream is)
          Imports the portlet information (categories, permissions, ... etc.) from the input stream.
 void importPortletInfo(long userId, String portletId, Map<String,String[]> parameterMap, File file)
           
 void importPortletInfo(long userId, String portletId, Map<String,String[]> parameterMap, InputStream is)
           
 long importPortletInfoInBackground(long userId, String taskName, long plid, long groupId, String portletId, Map<String,String[]> parameterMap, File file)
           
 long importPortletInfoInBackground(long userId, String taskName, long plid, long groupId, String portletId, Map<String,String[]> parameterMap, InputStream is)
           
 long importPortletInfoInBackground(long userId, String taskName, String portletId, Map<String,String[]> parameterMap, File file)
           
 long importPortletInfoInBackground(long userId, String taskName, String portletId, Map<String,String[]> parameterMap, InputStream is)
           
 void setBeanIdentifier(String beanIdentifier)
          Sets the Spring bean ID for this bean.
 void setLayouts(long groupId, boolean privateLayout, long parentLayoutId, long[] layoutIds, ServiceContext serviceContext)
          Sets the layouts for the group, replacing and prioritizing all layouts of the parent layout.
 Layout updateFriendlyURL(long plid, String friendlyURL, String languageId)
          Updates the friendly URL of the layout.
 Layout updateLayout(Layout layout)
          Updates the layout in the database or adds it if it does not yet exist.
 Layout updateLayout(long groupId, boolean privateLayout, long layoutId, long parentLayoutId, Map<Locale,String> nameMap, Map<Locale,String> titleMap, Map<Locale,String> descriptionMap, Map<Locale,String> keywordsMap, Map<Locale,String> robotsMap, String type, boolean hidden, Map<Locale,String> friendlyURLMap, Boolean iconImage, byte[] iconBytes, ServiceContext serviceContext)
          Updates the layout.
 Layout updateLayout(long groupId, boolean privateLayout, long layoutId, long parentLayoutId, Map<Locale,String> nameMap, Map<Locale,String> titleMap, Map<Locale,String> descriptionMap, Map<Locale,String> keywordsMap, Map<Locale,String> robotsMap, String type, boolean hidden, String friendlyURL, Boolean iconImage, byte[] iconBytes, ServiceContext serviceContext)
          Deprecated. As of 6.2.0, replaced by updateLayout(long, boolean, long, long, Map, Map, Map, Map, Map, String, boolean, Map, Boolean, byte[], ServiceContext)
 Layout updateLayout(long groupId, boolean privateLayout, long layoutId, String typeSettings)
          Updates the layout replacing its type settings.
 Layout updateLookAndFeel(long groupId, boolean privateLayout, long layoutId, String themeId, String colorSchemeId, String css, boolean wapTheme)
          Updates the look and feel of the layout.
 Layout updateName(Layout layout, String name, String languageId)
          Updates the name of the layout.
 Layout updateName(long groupId, boolean privateLayout, long layoutId, String name, String languageId)
          Updates the name of the layout matching the group, layout ID, and privacy.
 Layout updateName(long plid, String name, String languageId)
          Updates the name of the layout matching the primary key.
 Layout updateParentLayoutId(long groupId, boolean privateLayout, long layoutId, long parentLayoutId)
          Updates the parent layout ID of the layout matching the group, layout ID, and privacy.
 Layout updateParentLayoutId(long plid, long parentPlid)
          Updates the parent layout ID of the layout matching the primary key.
 Layout updateParentLayoutIdAndPriority(long plid, long parentPlid, int priority)
           
 void updatePriorities(long groupId, boolean privateLayout)
          Updates the priorities of the layouts.
 Layout updatePriority(Layout layout, int priority)
          Updates the priority of the layout.
 Layout updatePriority(long groupId, boolean privateLayout, long layoutId, int priority)
          Updates the priority of the layout matching the group, layout ID, and privacy.
 Layout updatePriority(long groupId, boolean privateLayout, long layoutId, long nextLayoutId, long previousLayoutId)
          Updates the priority of the layout matching the group, layout ID, and privacy, setting the layout's priority based on the priorities of the next and previous layouts.
 Layout updatePriority(long plid, int priority)
          Updates the priority of the layout matching the primary key.
 void updateScopedPortletNames(long groupId, boolean privateLayout, long layoutId, Map<Locale,String> nameMap, List<Locale> nameMapModifiedLocales)
          Deprecated. As of 6.2.0, with no direct replacement
 void updateScopedPortletNames(long groupId, boolean privateLayout, long layoutId, String name, String languageId)
          Deprecated. As of 6.2.0, with no direct replacement
 MissingReferences validateImportLayoutsFile(long userId, long groupId, boolean privateLayout, Map<String,String[]> parameterMap, File file)
           
 MissingReferences validateImportLayoutsFile(long userId, long groupId, boolean privateLayout, Map<String,String[]> parameterMap, InputStream inputStream)
           
 MissingReferences validateImportPortletInfo(long userId, long plid, long groupId, String portletId, Map<String,String[]> parameterMap, File file)
           
 MissingReferences validateImportPortletInfo(long userId, long plid, long groupId, String portletId, Map<String,String[]> parameterMap, InputStream inputStream)
           
 

Method Detail

addLayout

@Indexable(type=REINDEX)
Layout addLayout(Layout layout)
                 throws SystemException
Adds the layout to the database. Also notifies the appropriate model listeners.

Parameters:
layout - the layout
Returns:
the layout that was added
Throws:
SystemException - if a system exception occurred

createLayout

Layout createLayout(long plid)
Creates a new layout with the primary key. Does not add the layout to the database.

Parameters:
plid - the primary key for the new layout
Returns:
the new layout

deleteLayout

@Indexable(type=DELETE)
Layout deleteLayout(long plid)
                    throws PortalException,
                           SystemException
Deletes the layout with the primary key from the database. Also notifies the appropriate model listeners.

Parameters:
plid - the primary key of the layout
Returns:
the layout that was removed
Throws:
PortalException - if a layout with the primary key could not be found
SystemException - if a system exception occurred

deleteLayout

@Indexable(type=DELETE)
Layout deleteLayout(Layout layout)
                    throws SystemException
Deletes the layout from the database. Also notifies the appropriate model listeners.

Parameters:
layout - the layout
Returns:
the layout that was removed
Throws:
SystemException - if a system exception occurred

dynamicQuery

DynamicQuery dynamicQuery()

dynamicQuery

List dynamicQuery(DynamicQuery dynamicQuery)
                  throws SystemException
Performs a dynamic query on the database and returns the matching rows.

Parameters:
dynamicQuery - the dynamic query
Returns:
the matching rows
Throws:
SystemException - if a system exception occurred

dynamicQuery

List dynamicQuery(DynamicQuery dynamicQuery,
                  int start,
                  int end)
                  throws SystemException
Performs a dynamic query on the database and returns a range of the matching rows.

Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil.ALL_POS will return the full result set. If orderByComparator is specified, then the query will include the given ORDER BY logic. If orderByComparator is absent and pagination is required (start and end are not QueryUtil.ALL_POS), then the query will include the default ORDER BY logic from LayoutModelImpl. If both orderByComparator and pagination are absent, for performance reasons, the query will not have an ORDER BY clause and the returned result set will be sorted on by the primary key in an ascending order.

Parameters:
dynamicQuery - the dynamic query
start - the lower bound of the range of model instances
end - the upper bound of the range of model instances (not inclusive)
Returns:
the range of matching rows
Throws:
SystemException - if a system exception occurred

dynamicQuery

List dynamicQuery(DynamicQuery dynamicQuery,
                  int start,
                  int end,
                  OrderByComparator orderByComparator)
                  throws SystemException
Performs a dynamic query on the database and returns an ordered range of the matching rows.

Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil.ALL_POS will return the full result set. If orderByComparator is specified, then the query will include the given ORDER BY logic. If orderByComparator is absent and pagination is required (start and end are not QueryUtil.ALL_POS), then the query will include the default ORDER BY logic from LayoutModelImpl. If both orderByComparator and pagination are absent, for performance reasons, the query will not have an ORDER BY clause and the returned result set will be sorted on by the primary key in an ascending order.

Parameters:
dynamicQuery - the dynamic query
start - the lower bound of the range of model instances
end - the upper bound of the range of model instances (not inclusive)
orderByComparator - the comparator to order the results by (optionally null)
Returns:
the ordered range of matching rows
Throws:
SystemException - if a system exception occurred

dynamicQueryCount

long dynamicQueryCount(DynamicQuery dynamicQuery)
                       throws SystemException
Returns the number of rows that match the dynamic query.

Parameters:
dynamicQuery - the dynamic query
Returns:
the number of rows that match the dynamic query
Throws:
SystemException - if a system exception occurred

dynamicQueryCount

long dynamicQueryCount(DynamicQuery dynamicQuery,
                       Projection projection)
                       throws SystemException
Returns the number of rows that match the dynamic query.

Parameters:
dynamicQuery - the dynamic query
projection - the projection to apply to the query
Returns:
the number of rows that match the dynamic query
Throws:
SystemException - if a system exception occurred

fetchLayout

@Transactional(propagation=SUPPORTS,
               readOnly=true)
Layout fetchLayout(long plid)
                   throws SystemException
Throws:
SystemException

fetchLayoutByUuidAndCompanyId

@Transactional(propagation=SUPPORTS,
               readOnly=true)
Layout fetchLayoutByUuidAndCompanyId(String uuid,
                                                                              long companyId)
                                     throws SystemException
Returns the layout with the matching UUID and company.

Parameters:
uuid - the layout's UUID
companyId - the primary key of the company
Returns:
the matching layout, or null if a matching layout could not be found
Throws:
SystemException - if a system exception occurred

fetchLayoutByUuidAndGroupId

@Transactional(propagation=SUPPORTS,
               readOnly=true)
Layout fetchLayoutByUuidAndGroupId(String uuid,
                                                                            long groupId,
                                                                            boolean privateLayout)
                                   throws SystemException
Returns the layout matching the UUID, group, and privacy.

Parameters:
uuid - the layout's UUID
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
Returns:
the matching layout, or null if a matching layout could not be found
Throws:
SystemException - if a system exception occurred

getLayout

@Transactional(propagation=SUPPORTS,
               readOnly=true)
Layout getLayout(long plid)
                 throws PortalException,
                        SystemException
Returns the layout with the primary key.

Parameters:
plid - the primary key of the layout
Returns:
the layout
Throws:
PortalException - if a layout with the primary key could not be found
SystemException - if a system exception occurred

getPersistedModel

@Transactional(propagation=SUPPORTS,
               readOnly=true)
PersistedModel getPersistedModel(Serializable primaryKeyObj)
                                 throws PortalException,
                                        SystemException
Specified by:
getPersistedModel in interface PersistedModelLocalService
Throws:
PortalException
SystemException

getLayoutByUuidAndCompanyId

@Transactional(propagation=SUPPORTS,
               readOnly=true)
Layout getLayoutByUuidAndCompanyId(String uuid,
                                                                            long companyId)
                                   throws PortalException,
                                          SystemException
Returns the layout with the matching UUID and company.

Parameters:
uuid - the layout's UUID
companyId - the primary key of the company
Returns:
the matching layout
Throws:
PortalException - if a matching layout could not be found
SystemException - if a system exception occurred

getLayoutByUuidAndGroupId

@Transactional(propagation=SUPPORTS,
               readOnly=true)
Layout getLayoutByUuidAndGroupId(String uuid,
                                                                          long groupId,
                                                                          boolean privateLayout)
                                 throws PortalException,
                                        SystemException
Returns the layout matching the UUID, group, and privacy.

Parameters:
uuid - the layout's UUID
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
Returns:
the matching layout
Throws:
PortalException - if a matching layout could not be found
SystemException - if a system exception occurred

getLayouts

@Transactional(propagation=SUPPORTS,
               readOnly=true)
List<Layout> getLayouts(int start,
                                                                 int end)
                        throws SystemException
Returns a range of all the layouts.

Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil.ALL_POS will return the full result set. If orderByComparator is specified, then the query will include the given ORDER BY logic. If orderByComparator is absent and pagination is required (start and end are not QueryUtil.ALL_POS), then the query will include the default ORDER BY logic from LayoutModelImpl. If both orderByComparator and pagination are absent, for performance reasons, the query will not have an ORDER BY clause and the returned result set will be sorted on by the primary key in an ascending order.

Parameters:
start - the lower bound of the range of layouts
end - the upper bound of the range of layouts (not inclusive)
Returns:
the range of layouts
Throws:
SystemException - if a system exception occurred

getLayoutsCount

@Transactional(propagation=SUPPORTS,
               readOnly=true)
int getLayoutsCount()
                    throws SystemException
Returns the number of layouts.

Returns:
the number of layouts
Throws:
SystemException - if a system exception occurred

updateLayout

@Indexable(type=REINDEX)
Layout updateLayout(Layout layout)
                    throws SystemException
Updates the layout in the database or adds it if it does not yet exist. Also notifies the appropriate model listeners.

Parameters:
layout - the layout
Returns:
the layout that was updated
Throws:
SystemException - if a system exception occurred

getBeanIdentifier

String getBeanIdentifier()
Returns the Spring bean ID for this bean.

Returns:
the Spring bean ID for this bean

setBeanIdentifier

void setBeanIdentifier(String beanIdentifier)
Sets the Spring bean ID for this bean.

Parameters:
beanIdentifier - the Spring bean ID for this bean

addLayout

Layout addLayout(long userId,
                 long groupId,
                 boolean privateLayout,
                 long parentLayoutId,
                 Map<Locale,String> nameMap,
                 Map<Locale,String> titleMap,
                 Map<Locale,String> descriptionMap,
                 Map<Locale,String> keywordsMap,
                 Map<Locale,String> robotsMap,
                 String type,
                 boolean hidden,
                 String friendlyURL,
                 ServiceContext serviceContext)
                 throws PortalException,
                        SystemException
Deprecated. As of 6.2.0, replaced by addLayout(long, long, boolean, long, Map, Map, Map, Map, Map, String, String, boolean, Map, ServiceContext)

Adds a layout.

This method handles the creation of the layout including its resources, metadata, and internal data structures. It is not necessary to make subsequent calls to any methods to setup default groups, resources, ... etc.

Parameters:
userId - the primary key of the user
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
parentLayoutId - the primary key of the parent layout (optionally LayoutConstants.DEFAULT_PARENT_LAYOUT_ID)
nameMap - the layout's locales and localized names
titleMap - the layout's locales and localized titles
descriptionMap - the layout's locales and localized descriptions
keywordsMap - the layout's locales and localized keywords
robotsMap - the layout's locales and localized robots
type - the layout's type (optionally LayoutConstants.TYPE_PORTLET). The possible types can be found in LayoutConstants.
hidden - whether the layout is hidden
friendlyURL - the layout's friendly URL (optionally PropsValues.DEFAULT_USER_PRIVATE_LAYOUT_FRIENDLY_URL or PropsValues.DEFAULT_USER_PUBLIC_LAYOUT_FRIENDLY_URL). The default values can be overridden in portal-ext.properties by specifying new values for the corresponding properties defined in PropsValues. To see how the URL is normalized when accessed, see FriendlyURLNormalizerUtil.normalize( String).
serviceContext - the service context to be applied. Must set the UUID for the layout. Can set the creation date, modification date and the expando bridge attributes for the layout. For layouts that belong to a layout set prototype, an attribute named layoutUpdateable can be set to specify whether site administrators can modify this page within their site. For layouts that are created from a layout prototype, attributes named layoutPrototypeUuid and layoutPrototypeLinkedEnabled can be specified to provide the unique identifier of the source prototype and a boolean to determine whether a link to it should be enabled to activate propagation of changes made to the linked page in the prototype.
Returns:
the layout
Throws:
PortalException - if a group or user with the primary key could not be found, if layout values were invalid, or if a portal exception occurred
SystemException - if a system exception occurred

addLayout

Layout addLayout(long userId,
                 long groupId,
                 boolean privateLayout,
                 long parentLayoutId,
                 Map<Locale,String> nameMap,
                 Map<Locale,String> titleMap,
                 Map<Locale,String> descriptionMap,
                 Map<Locale,String> keywordsMap,
                 Map<Locale,String> robotsMap,
                 String type,
                 String typeSettings,
                 boolean hidden,
                 Map<Locale,String> friendlyURLMap,
                 ServiceContext serviceContext)
                 throws PortalException,
                        SystemException
Adds a layout with additional parameters.

This method handles the creation of the layout including its resources, metadata, and internal data structures. It is not necessary to make subsequent calls to any methods to setup default groups, resources, ... etc.

Parameters:
userId - the primary key of the user
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
parentLayoutId - the primary key of the parent layout (optionally LayoutConstants.DEFAULT_PARENT_LAYOUT_ID)
nameMap - the layout's locales and localized names
titleMap - the layout's locales and localized titles
descriptionMap - the layout's locales and localized descriptions
keywordsMap - the layout's locales and localized keywords
robotsMap - the layout's locales and localized robots
type - the layout's type (optionally LayoutConstants.TYPE_PORTLET). The possible types can be found in LayoutConstants.
typeSettings - the settings to load the unicode properties object. See #fastLoad(String).
hidden - whether the layout is hidden
friendlyURLMap - the layout's locales and localized friendly URLs. To see how the URL is normalized when accessed, see FriendlyURLNormalizerUtil.normalize( String).
serviceContext - the service context to be applied. Must set the UUID for the layout. Can set the creation date, modification date, and expando bridge attributes for the layout. For layouts that belong to a layout set prototype, an attribute named layoutUpdateable can be set to specify whether site administrators can modify this page within their site. For layouts that are created from a layout prototype, attributes named layoutPrototypeUuid and layoutPrototypeLinkedEnabled can be specified to provide the unique identifier of the source prototype and a boolean to determine whether a link to it should be enabled to activate propagation of changes made to the linked page in the prototype.
Returns:
the layout
Throws:
PortalException - if a group or user with the primary key could not be found, if layout values were invalid, or if a portal exception occurred
SystemException - if a system exception occurred

addLayout

Layout addLayout(long userId,
                 long groupId,
                 boolean privateLayout,
                 long parentLayoutId,
                 String name,
                 String title,
                 String description,
                 String type,
                 boolean hidden,
                 String friendlyURL,
                 ServiceContext serviceContext)
                 throws PortalException,
                        SystemException
Adds a layout with single entry maps for name, title, and description to the default locale.

This method handles the creation of the layout including its resources, metadata, and internal data structures. It is not necessary to make subsequent calls to any methods to setup default groups, resources, ... etc.

Parameters:
userId - the primary key of the user
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
parentLayoutId - the primary key of the parent layout (optionally LayoutConstants.DEFAULT_PARENT_LAYOUT_ID). The possible values can be found in LayoutConstants.
name - the layout's name (optionally PropsValues.DEFAULT_USER_PRIVATE_LAYOUT_NAME or PropsValues.DEFAULT_USER_PUBLIC_LAYOUT_NAME). The default values can be overridden in portal-ext.properties by specifying new values for the corresponding properties defined in PropsValues
title - the layout's title
description - the layout's description
type - the layout's type (optionally LayoutConstants.TYPE_PORTLET). The possible types can be found in LayoutConstants.
hidden - whether the layout is hidden
friendlyURL - the friendly URL of the layout (optionally PropsValues.DEFAULT_USER_PRIVATE_LAYOUT_FRIENDLY_URL or PropsValues.DEFAULT_USER_PUBLIC_LAYOUT_FRIENDLY_URL). The default values can be overridden in portal-ext.properties by specifying new values for the corresponding properties defined in PropsValues. To see how the URL is normalized when accessed, see FriendlyURLNormalizerUtil.normalize( String).
serviceContext - the service context to be applied. Must set the UUID for the layout. Can set the creation date and modification date for the layout. For layouts that belong to a layout set prototype, an attribute named layoutUpdateable can be set to specify whether site administrators can modify this page within their site.
Returns:
the layout
Throws:
PortalException - if a group or user with the primary key could not be found, or if a portal exception occurred
SystemException - if a system exception occurred

deleteLayout

@SystemEvent(action=1,
             type=1)
void deleteLayout(Layout layout,
                                        boolean updateLayoutSet,
                                        ServiceContext serviceContext)
                  throws PortalException,
                         SystemException
Deletes the layout, its child layouts, and its associated resources.

Parameters:
layout - the layout
updateLayoutSet - whether the layout set's page counter needs to be updated
serviceContext - the service context to be applied
Throws:
PortalException - if a portal exception occurred
SystemException - if a system exception occurred

deleteLayout

void deleteLayout(long groupId,
                  boolean privateLayout,
                  long layoutId,
                  ServiceContext serviceContext)
                  throws PortalException,
                         SystemException
Deletes the layout with the primary key, also deleting the layout's child layouts, and associated resources.

Parameters:
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
layoutId - the primary key of the layout
serviceContext - the service context to be applied
Throws:
PortalException - if a matching layout could not be found , or if some other portal exception occurred
SystemException - if a system exception occurred

deleteLayout

void deleteLayout(long plid,
                  ServiceContext serviceContext)
                  throws PortalException,
                         SystemException
Deletes the layout with the plid, also deleting the layout's child layouts, and associated resources.

Parameters:
plid - the primary key of the layout
serviceContext - the service context to be applied
Throws:
PortalException - if a layout with the primary key could not be found , or if some other portal exception occurred
SystemException - if a system exception occurred

deleteLayouts

void deleteLayouts(long groupId,
                   boolean privateLayout,
                   ServiceContext serviceContext)
                   throws PortalException,
                          SystemException
Deletes the group's private or non-private layouts, also deleting the layouts' child layouts, and associated resources.

Parameters:
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
serviceContext - the service context to be applied. The parent layout set's page count will be updated by default, unless an attribute named updatePageCount is set to false.
Throws:
PortalException - if a group with the primary key could not be found or if a layout set for the group and privacy could not be found
SystemException - if a system exception occurred

exportLayouts

byte[] exportLayouts(long groupId,
                     boolean privateLayout,
                     long[] layoutIds,
                     Map<String,String[]> parameterMap,
                     Date startDate,
                     Date endDate)
                     throws PortalException,
                            SystemException
Exports layouts with the primary keys and criteria as a byte array.

Parameters:
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
layoutIds - the primary keys of the layouts to be exported
parameterMap - the mapping of parameters indicating which information to export. For information on the keys used in the map see PortletDataHandlerKeys.
startDate - the export's start date
endDate - the export's end date
Returns:
the layouts as a byte array
Throws:
PortalException - if a group or any layout with the primary key could not be found, or if some other portal exception occurred
SystemException - if a system exception occurred

exportLayouts

byte[] exportLayouts(long groupId,
                     boolean privateLayout,
                     Map<String,String[]> parameterMap,
                     Date startDate,
                     Date endDate)
                     throws PortalException,
                            SystemException
Exports all layouts that match the criteria as a byte array.

Parameters:
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
parameterMap - the mapping of parameters indicating which information to export. For information on the keys used in the map see PortletDataHandlerKeys.
startDate - the export's start date
endDate - the export's end date
Returns:
the layout as a byte array
Throws:
PortalException - if a group with the primary key could not be found or if some other portal exception occurred
SystemException - if a system exception occurred

exportLayoutsAsFile

File exportLayoutsAsFile(long groupId,
                         boolean privateLayout,
                         long[] layoutIds,
                         Map<String,String[]> parameterMap,
                         Date startDate,
                         Date endDate)
                         throws PortalException,
                                SystemException
Exports the layouts that match the primary keys and criteria as a file.

Parameters:
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
layoutIds - the primary keys of the layouts to be exported (optionally null)
parameterMap - the mapping of parameters indicating which information to export. For information on the keys used in the map see PortletDataHandlerKeys.
startDate - the export's start date
endDate - the export's end date
Returns:
the layouts as a File
Throws:
PortalException - if a group or any layout with the primary key could not be found, or if some other portal exception occurred
SystemException - if a system exception occurred

exportLayoutsAsFileInBackground

long exportLayoutsAsFileInBackground(long userId,
                                     String taskName,
                                     long groupId,
                                     boolean privateLayout,
                                     long[] layoutIds,
                                     Map<String,String[]> parameterMap,
                                     Date startDate,
                                     Date endDate,
                                     String fileName)
                                     throws PortalException,
                                            SystemException
Throws:
PortalException
SystemException

exportPortletInfo

byte[] exportPortletInfo(long plid,
                         long groupId,
                         String portletId,
                         Map<String,String[]> parameterMap,
                         Date startDate,
                         Date endDate)
                         throws PortalException,
                                SystemException
Exports the portlet information (categories, permissions, ... etc.) as a byte array.

Parameters:
plid - the primary key of the layout
groupId - the primary key of the group
portletId - the primary key of the portlet
parameterMap - the mapping of parameters indicating which information to export. For information on the keys used in the map see PortletDataHandlerKeys.
startDate - the export's start date
endDate - the export's end date
Returns:
the portlet information as a byte array
Throws:
PortalException - if a group or portlet with the primary key could not be found, or if some other portal exception occurred
SystemException - if a system exception occurred

exportPortletInfo

byte[] exportPortletInfo(long companyId,
                         String portletId,
                         Map<String,String[]> parameterMap,
                         Date startDate,
                         Date endDate)
                         throws PortalException,
                                SystemException
Throws:
PortalException
SystemException

exportPortletInfoAsFile

File exportPortletInfoAsFile(long plid,
                             long groupId,
                             String portletId,
                             Map<String,String[]> parameterMap,
                             Date startDate,
                             Date endDate)
                             throws PortalException,
                                    SystemException
Exports the portlet information (categories, permissions, ... etc.) as a file.

Parameters:
plid - the primary key of the layout
groupId - the primary key of the group
portletId - the primary key of the portlet
parameterMap - the mapping of parameters indicating which information to export. For information on the keys used in the map see PortletDataHandlerKeys.
startDate - the export's start date
endDate - the export's end date
Returns:
the portlet information as a file
Throws:
PortalException - if a group or portlet with the primary key could not be found, or if some other portal exception occurred
SystemException - if a system exception occurred

exportPortletInfoAsFile

File exportPortletInfoAsFile(long companyId,
                             String portletId,
                             Map<String,String[]> parameterMap,
                             Date startDate,
                             Date endDate)
                             throws PortalException,
                                    SystemException
Throws:
PortalException
SystemException

exportPortletInfoAsFileInBackground

long exportPortletInfoAsFileInBackground(long userId,
                                         String taskName,
                                         long plid,
                                         long groupId,
                                         String portletId,
                                         Map<String,String[]> parameterMap,
                                         Date startDate,
                                         Date endDate,
                                         String fileName)
                                         throws PortalException,
                                                SystemException
Throws:
PortalException
SystemException

exportPortletInfoAsFileInBackground

long exportPortletInfoAsFileInBackground(long userId,
                                         String taskName,
                                         String portletId,
                                         Map<String,String[]> parameterMap,
                                         Date startDate,
                                         Date endDate,
                                         String fileName)
                                         throws PortalException,
                                                SystemException
Throws:
PortalException
SystemException

fetchFirstLayout

@Transactional(propagation=SUPPORTS,
               readOnly=true)
Layout fetchFirstLayout(long groupId,
                                                                 boolean privateLayout,
                                                                 long parentLayoutId)
                        throws SystemException
Throws:
SystemException

fetchLayout

@Transactional(propagation=SUPPORTS,
               readOnly=true)
Layout fetchLayout(long groupId,
                                                            boolean privateLayout,
                                                            long layoutId)
                   throws SystemException
Throws:
SystemException

fetchLayoutByFriendlyURL

@Transactional(propagation=SUPPORTS,
               readOnly=true)
Layout fetchLayoutByFriendlyURL(long groupId,
                                                                         boolean privateLayout,
                                                                         String friendlyURL)
                                throws SystemException
Throws:
SystemException

getDefaultPlid

@Transactional(propagation=SUPPORTS,
               readOnly=true)
long getDefaultPlid(long groupId)
                    throws SystemException
Returns the primary key of the default layout for the group

Parameters:
groupId - the primary key of the group
Returns:
the primary key of the default layout for the group (optionally LayoutConstants.DEFAULT_PLID)
Throws:
SystemException - if a system exception occurred

getDefaultPlid

@Transactional(propagation=SUPPORTS,
               readOnly=true)
long getDefaultPlid(long groupId,
                                                             boolean privateLayout)
                    throws SystemException
Returns primary key of the matching default layout for the group

Parameters:
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
Returns:
the primary key of the default layout for the group; LayoutConstants.DEFAULT_PLID) otherwise
Throws:
SystemException - if a system exception occurred

getDefaultPlid

@Transactional(propagation=SUPPORTS,
               readOnly=true)
long getDefaultPlid(long groupId,
                                                             boolean privateLayout,
                                                             String portletId)
                    throws PortalException,
                           SystemException
Returns primary key of the default portlet layout for the group

Parameters:
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
portletId - the primary key of the portlet
Returns:
the primary key of the default portlet layout for the group; LayoutConstants.DEFAULT_PLID otherwise
Throws:
PortalException - if a portlet with the primary key could not be found
SystemException - if a system exception occurred

getFriendlyURLLayout

@Transactional(propagation=SUPPORTS,
               readOnly=true)
Layout getFriendlyURLLayout(long groupId,
                                                                     boolean privateLayout,
                                                                     String friendlyURL)
                            throws PortalException,
                                   SystemException
Returns the layout for the friendly URL

Parameters:
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
friendlyURL - the friendly URL of the layout
Returns:
the layout for the friendly URL
Throws:
PortalException - if the friendly URL is null or a matching layout could not be found
SystemException - if a system exception occurred

getLayout

@Transactional(propagation=SUPPORTS,
               readOnly=true)
Layout getLayout(long groupId,
                                                          boolean privateLayout,
                                                          long layoutId)
                 throws PortalException,
                        SystemException
Returns the layout matching the primary key, group, and privacy; throws a NoSuchLayoutException otherwise.

Parameters:
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
layoutId - the primary key of the layout
Returns:
the matching layout
Throws:
PortalException - if a matching layout could not be found
SystemException - if a system exception occurred

getLayoutByIconImageId

@Transactional(propagation=SUPPORTS,
               readOnly=true)
Layout getLayoutByIconImageId(long iconImageId)
                              throws PortalException,
                                     SystemException
Returns the layout for the icon image; throws a NoSuchLayoutException otherwise.

Parameters:
iconImageId - the primary key of the icon image
Returns:
Returns the layout for the icon image
Throws:
PortalException - if an icon image with the primary key could not be found
SystemException - if a system exception occurred

getLayouts

@Transactional(propagation=SUPPORTS,
               readOnly=true)
List<Layout> getLayouts(long groupId,
                                                                 boolean privateLayout)
                        throws SystemException
Returns all the layouts belonging to the group.

Parameters:
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
Returns:
the matching layouts, or null if no matches were found
Throws:
SystemException - if a system exception occurred

getLayouts

@Transactional(propagation=SUPPORTS,
               readOnly=true)
List<Layout> getLayouts(long groupId,
                                                                 boolean privateLayout,
                                                                 long parentLayoutId)
                        throws SystemException
Returns all the layouts belonging to the group that are children of the parent layout.

Parameters:
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
parentLayoutId - the primary key of the parent layout
Returns:
the matching layouts, or null if no matches were found
Throws:
SystemException - if a system exception occurred

getLayouts

@Transactional(propagation=SUPPORTS,
               readOnly=true)
List<Layout> getLayouts(long groupId,
                                                                 boolean privateLayout,
                                                                 long parentLayoutId,
                                                                 boolean incomplete,
                                                                 int start,
                                                                 int end)
                        throws SystemException
Returns a range of all the layouts belonging to the group that are children of the parent layout.

Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil.ALL_POS will return the full result set.

Parameters:
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
parentLayoutId - the primary key of the parent layout
incomplete - whether the layout is incomplete
start - the lower bound of the range of layouts
end - the upper bound of the range of layouts (not inclusive)
Returns:
the matching layouts, or null if no matches were found
Throws:
SystemException - if a system exception occurred

getLayouts

@Transactional(propagation=SUPPORTS,
               readOnly=true)
List<Layout> getLayouts(long groupId,
                                                                 boolean privateLayout,
                                                                 long[] layoutIds)
                        throws PortalException,
                               SystemException
Returns all the layouts that match the layout IDs and belong to the group.

Parameters:
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
layoutIds - the primary keys of the layouts
Returns:
the matching layouts, or an empty list if no matches were found
Throws:
PortalException - if a group or layout with the primary key could not be found
SystemException - if a system exception occurred

getLayouts

@Transactional(propagation=SUPPORTS,
               readOnly=true)
List<Layout> getLayouts(long groupId,
                                                                 boolean privateLayout,
                                                                 String type)
                        throws SystemException
Returns all the layouts that match the type and belong to the group.

Parameters:
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
type - the type of the layouts (optionally LayoutConstants.TYPE_PORTLET)
Returns:
the matching layouts, or null if no matches were found
Throws:
SystemException - if a system exception occurred

getLayouts

@Transactional(propagation=SUPPORTS,
               readOnly=true)
LayoutReference[] getLayouts(long companyId,
                                                                      String portletId,
                                                                      String preferencesKey,
                                                                      String preferencesValue)
                             throws SystemException
Returns the layout references for all the layouts that belong to the company and belong to the portlet that matches the preferences.

Parameters:
companyId - the primary key of the company
portletId - the primary key of the portlet
preferencesKey - the portlet's preference key
preferencesValue - the portlet's preference value
Returns:
the layout references of the matching layouts
Throws:
SystemException - if a system exception occurred

getLayoutsByLayoutPrototypeUuid

@Transactional(propagation=SUPPORTS,
               readOnly=true)
List<Layout> getLayoutsByLayoutPrototypeUuid(String layoutPrototypeUuid)
                                             throws SystemException
Throws:
SystemException

getLayoutsByLayoutPrototypeUuidCount

@Transactional(propagation=SUPPORTS,
               readOnly=true)
int getLayoutsByLayoutPrototypeUuidCount(String layoutPrototypeUuid)
                                         throws SystemException
Throws:
SystemException

getLayoutsCount

@Transactional(propagation=SUPPORTS,
               readOnly=true)
int getLayoutsCount(Group group,
                                                             boolean privateLayout)
                    throws PortalException,
                           SystemException
Throws:
PortalException
SystemException

getLayoutsCount

@Transactional(propagation=SUPPORTS,
               readOnly=true)
int getLayoutsCount(Group group,
                                                             boolean privateLayout,
                                                             boolean includeUserGroups)
                    throws PortalException,
                           SystemException
Throws:
PortalException
SystemException

getLayoutsCount

@Transactional(propagation=SUPPORTS,
               readOnly=true)
int getLayoutsCount(User user,
                                                             boolean privateLayout)
                    throws PortalException,
                           SystemException
Throws:
PortalException
SystemException

getLayoutsCount

@Transactional(propagation=SUPPORTS,
               readOnly=true)
int getLayoutsCount(User user,
                                                             boolean privateLayout,
                                                             boolean includeUserGroups)
                    throws PortalException,
                           SystemException
Throws:
PortalException
SystemException

getNextLayoutId

@Transactional(propagation=SUPPORTS,
               readOnly=true)
long getNextLayoutId(long groupId,
                                                              boolean privateLayout)
                     throws SystemException
Returns the primary key to use for the next layout.

Parameters:
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
Returns:
the primary key to use for the next layout
Throws:
SystemException - if a system exception occurred

getNoPermissionLayouts

@Transactional(propagation=SUPPORTS,
               readOnly=true)
List<Layout> getNoPermissionLayouts(long roleId)
                                    throws SystemException
Returns all the layouts without resource permissions

Parameters:
roleId - the primary key of the role
Returns:
all the layouts without resource permissions
Throws:
SystemException - if a system exception occurred

getNullFriendlyURLLayouts

@Transactional(propagation=SUPPORTS,
               readOnly=true)
List<Layout> getNullFriendlyURLLayouts()
                                       throws SystemException
Returns all the layouts whose friendly URLs are null

Returns:
all the layouts whose friendly URLs are null
Throws:
SystemException - if a system exception occurred

getParentLayout

@Transactional(propagation=SUPPORTS,
               readOnly=true)
Layout getParentLayout(Layout layout)
                       throws PortalException,
                              SystemException
Throws:
PortalException
SystemException

getScopeGroupLayouts

@Transactional(propagation=SUPPORTS,
               readOnly=true)
List<Layout> getScopeGroupLayouts(long groupId,
                                                                           boolean privateLayout)
                                  throws SystemException
Returns all the layouts within scope of the group

Parameters:
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
Returns:
the layouts within scope of the group
Throws:
SystemException - if a system exception occurred

hasLayouts

@Transactional(propagation=SUPPORTS,
               readOnly=true)
boolean hasLayouts(Group group,
                                                            boolean privateLayout)
                   throws PortalException,
                          SystemException
Throws:
PortalException
SystemException

hasLayouts

@Transactional(propagation=SUPPORTS,
               readOnly=true)
boolean hasLayouts(Group group,
                                                            boolean privateLayout,
                                                            boolean includeUserGroups)
                   throws PortalException,
                          SystemException
Throws:
PortalException
SystemException

hasLayouts

@Transactional(propagation=SUPPORTS,
               readOnly=true)
boolean hasLayouts(long groupId,
                                                            boolean privateLayout,
                                                            long parentLayoutId)
                   throws SystemException
Returns true if the group has any layouts; false otherwise.

Parameters:
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
parentLayoutId - the primary key of the parent layout
Returns:
true if the group has any layouts; false otherwise
Throws:
SystemException - if a system exception occurred

hasLayouts

@Transactional(propagation=SUPPORTS,
               readOnly=true)
boolean hasLayouts(User user,
                                                            boolean privateLayout)
                   throws PortalException,
                          SystemException
Throws:
PortalException
SystemException

hasLayouts

@Transactional(propagation=SUPPORTS,
               readOnly=true)
boolean hasLayouts(User user,
                                                            boolean privateLayout,
                                                            boolean includeUserGroups)
                   throws PortalException,
                          SystemException
Throws:
PortalException
SystemException

hasLayoutSetPrototypeLayout

@Transactional(propagation=SUPPORTS,
               readOnly=true)
boolean hasLayoutSetPrototypeLayout(long layoutSetPrototypeId,
                                                                             String layoutUuid)
                                    throws PortalException,
                                           SystemException
Throws:
PortalException
SystemException

hasLayoutSetPrototypeLayout

@Transactional(propagation=SUPPORTS,
               readOnly=true)
boolean hasLayoutSetPrototypeLayout(String layoutSetPrototypeUuid,
                                                                             long companyId,
                                                                             String layoutUuid)
                                    throws PortalException,
                                           SystemException
Throws:
PortalException
SystemException

importLayouts

void importLayouts(long userId,
                   long groupId,
                   boolean privateLayout,
                   Map<String,String[]> parameterMap,
                   byte[] bytes)
                   throws PortalException,
                          SystemException
Imports the layouts from the byte array.

Parameters:
userId - the primary key of the user
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
parameterMap - the mapping of parameters indicating which information will be imported. For information on the keys used in the map see PortletDataHandlerKeys.
bytes - the byte array with the data
Throws:
PortalException - if a group or user with the primary key could not be found, or if some other portal exception occurred
SystemException - if a system exception occurred
See Also:
LayoutImporter

importLayouts

void importLayouts(long userId,
                   long groupId,
                   boolean privateLayout,
                   Map<String,String[]> parameterMap,
                   File file)
                   throws PortalException,
                          SystemException
Imports the layouts from the file.

Parameters:
userId - the primary key of the user
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
parameterMap - the mapping of parameters indicating which information will be imported. For information on the keys used in the map see PortletDataHandlerKeys.
file - the LAR file with the data
Throws:
PortalException - if a group or user with the primary key could not be found, or if some other portal exception occurred
SystemException - if a system exception occurred
See Also:
LayoutImporter

importLayouts

void importLayouts(long userId,
                   long groupId,
                   boolean privateLayout,
                   Map<String,String[]> parameterMap,
                   InputStream is)
                   throws PortalException,
                          SystemException
Imports the layouts from the input stream.

Parameters:
userId - the primary key of the user
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
parameterMap - the mapping of parameters indicating which information will be imported. For information on the keys used in the map see PortletDataHandlerKeys.
is - the input stream
Throws:
PortalException - if a group or user with the primary key could not be found, or if some other portal exception occurred
SystemException - if a system exception occurred
See Also:
LayoutImporter

importLayoutsInBackground

long importLayoutsInBackground(long userId,
                               String taskName,
                               long groupId,
                               boolean privateLayout,
                               Map<String,String[]> parameterMap,
                               File file)
                               throws PortalException,
                                      SystemException
Throws:
PortalException
SystemException

importLayoutsInBackground

long importLayoutsInBackground(long userId,
                               String taskName,
                               long groupId,
                               boolean privateLayout,
                               Map<String,String[]> parameterMap,
                               InputStream is)
                               throws PortalException,
                                      SystemException
Throws:
PortalException
SystemException

importPortletInfo

void importPortletInfo(long userId,
                       long plid,
                       long groupId,
                       String portletId,
                       Map<String,String[]> parameterMap,
                       File file)
                       throws PortalException,
                              SystemException
Imports the portlet information (categories, permissions, ... etc.) from the file.

Parameters:
userId - the primary key of the user
plid - the primary key of the target layout
groupId - the primary key of the target group
portletId - the primary key of the portlet
parameterMap - the mapping of parameters indicating which information will be imported. For information on the keys used in the map see PortletDataHandlerKeys.
file - the LAR file with the data
Throws:
PortalException - if a group, layout, portlet or user with the primary key could not be found
SystemException - if a system exception occurred

importPortletInfo

void importPortletInfo(long userId,
                       long plid,
                       long groupId,
                       String portletId,
                       Map<String,String[]> parameterMap,
                       InputStream is)
                       throws PortalException,
                              SystemException
Imports the portlet information (categories, permissions, ... etc.) from the input stream.

Parameters:
userId - the primary key of the user
plid - the primary key of the layout
groupId - the primary key of the group
portletId - the primary key of the portlet
parameterMap - the mapping of parameters indicating which information will be imported. For information on the keys used in the map see PortletDataHandlerKeys.
is - the input stream
Throws:
PortalException - if a group, portlet, layout or user with the primary key could not be found
SystemException - if a system exception occurred

importPortletInfo

void importPortletInfo(long userId,
                       String portletId,
                       Map<String,String[]> parameterMap,
                       File file)
                       throws PortalException,
                              SystemException
Throws:
PortalException
SystemException

importPortletInfo

void importPortletInfo(long userId,
                       String portletId,
                       Map<String,String[]> parameterMap,
                       InputStream is)
                       throws PortalException,
                              SystemException
Throws:
PortalException
SystemException

importPortletInfoInBackground

long importPortletInfoInBackground(long userId,
                                   String taskName,
                                   long plid,
                                   long groupId,
                                   String portletId,
                                   Map<String,String[]> parameterMap,
                                   File file)
                                   throws PortalException,
                                          SystemException
Throws:
PortalException
SystemException

importPortletInfoInBackground

long importPortletInfoInBackground(long userId,
                                   String taskName,
                                   long plid,
                                   long groupId,
                                   String portletId,
                                   Map<String,String[]> parameterMap,
                                   InputStream is)
                                   throws PortalException,
                                          SystemException
Throws:
PortalException
SystemException

importPortletInfoInBackground

long importPortletInfoInBackground(long userId,
                                   String taskName,
                                   String portletId,
                                   Map<String,String[]> parameterMap,
                                   File file)
                                   throws PortalException,
                                          SystemException
Throws:
PortalException
SystemException

importPortletInfoInBackground

long importPortletInfoInBackground(long userId,
                                   String taskName,
                                   String portletId,
                                   Map<String,String[]> parameterMap,
                                   InputStream is)
                                   throws PortalException,
                                          SystemException
Throws:
PortalException
SystemException

setLayouts

void setLayouts(long groupId,
                boolean privateLayout,
                long parentLayoutId,
                long[] layoutIds,
                ServiceContext serviceContext)
                throws PortalException,
                       SystemException
Sets the layouts for the group, replacing and prioritizing all layouts of the parent layout.

Parameters:
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
parentLayoutId - the primary key of the parent layout
layoutIds - the primary keys of the layouts
serviceContext - the service context to be applied
Throws:
PortalException - if a group or layout with the primary key could not be found, if no layouts were specified, if the first layout was not page-able, if the first layout was hidden, or if some other portal exception occurred
SystemException - if a system exception occurred

updateFriendlyURL

Layout updateFriendlyURL(long plid,
                         String friendlyURL,
                         String languageId)
                         throws PortalException,
                                SystemException
Updates the friendly URL of the layout.

Parameters:
plid - the primary key of the layout
friendlyURL - the friendly URL to be assigned
languageId - the primary key of the language
Returns:
the updated layout
Throws:
PortalException - if a group or layout with the primary key could not be found
SystemException - if a system exception occurred

updateLayout

Layout updateLayout(long groupId,
                    boolean privateLayout,
                    long layoutId,
                    long parentLayoutId,
                    Map<Locale,String> nameMap,
                    Map<Locale,String> titleMap,
                    Map<Locale,String> descriptionMap,
                    Map<Locale,String> keywordsMap,
                    Map<Locale,String> robotsMap,
                    String type,
                    boolean hidden,
                    Map<Locale,String> friendlyURLMap,
                    Boolean iconImage,
                    byte[] iconBytes,
                    ServiceContext serviceContext)
                    throws PortalException,
                           SystemException
Updates the layout.

Parameters:
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
layoutId - the primary key of the layout
parentLayoutId - the primary key of the layout's new parent layout
nameMap - the locales and localized names to merge (optionally null)
titleMap - the locales and localized titles to merge (optionally null)
descriptionMap - the locales and localized descriptions to merge (optionally null)
keywordsMap - the locales and localized keywords to merge (optionally null)
robotsMap - the locales and localized robots to merge (optionally null)
type - the layout's new type (optionally LayoutConstants.TYPE_PORTLET)
hidden - whether the layout is hidden
friendlyURLMap - the layout's locales and localized friendly URLs. To see how the URL is normalized when accessed, see FriendlyURLNormalizerUtil.normalize( String).
iconImage - whether the icon image will be updated
iconBytes - the byte array of the layout's new icon image
serviceContext - the service context to be applied. Can set the modification date and expando bridge attributes for the layout. For layouts that are linked to a layout prototype, attributes named layoutPrototypeUuid and layoutPrototypeLinkedEnabled can be specified to provide the unique identifier of the source prototype and a boolean to determine whether a link to it should be enabled to activate propagation of changes made to the linked page in the prototype.
Returns:
the updated layout
Throws:
PortalException - if a group or layout with the primary key could not be found, if a unique friendly URL could not be generated, if a valid parent layout ID to use could not be found, if the layout parameters were invalid, or if a portal exception occurred
SystemException - if a system exception occurred

updateLayout

Layout updateLayout(long groupId,
                    boolean privateLayout,
                    long layoutId,
                    long parentLayoutId,
                    Map<Locale,String> nameMap,
                    Map<Locale,String> titleMap,
                    Map<Locale,String> descriptionMap,
                    Map<Locale,String> keywordsMap,
                    Map<Locale,String> robotsMap,
                    String type,
                    boolean hidden,
                    String friendlyURL,
                    Boolean iconImage,
                    byte[] iconBytes,
                    ServiceContext serviceContext)
                    throws PortalException,
                           SystemException
Deprecated. As of 6.2.0, replaced by updateLayout(long, boolean, long, long, Map, Map, Map, Map, Map, String, boolean, Map, Boolean, byte[], ServiceContext)

Updates the layout.

Parameters:
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
layoutId - the primary key of the layout
parentLayoutId - the primary key of the layout's new parent layout
nameMap - the locales and localized names to merge (optionally null)
titleMap - the locales and localized titles to merge (optionally null)
descriptionMap - the locales and localized descriptions to merge (optionally null)
keywordsMap - the locales and localized keywords to merge (optionally null)
robotsMap - the locales and localized robots to merge (optionally null)
type - the layout's new type (optionally LayoutConstants.TYPE_PORTLET)
hidden - whether the layout is hidden
friendlyURL - the layout's new friendly URL (optionally PropsValues.DEFAULT_USER_PRIVATE_LAYOUT_FRIENDLY_URL or PropsValues.DEFAULT_USER_PRIVATE_LAYOUT_FRIENDLY_URL). The default values can be overridden in portal-ext.properties by specifying new values for the corresponding properties defined in PropsValues. To see how the URL is normalized when accessed, see FriendlyURLNormalizerUtil.normalize( String).
iconImage - whether the icon image will be updated
iconBytes - the byte array of the layout's new icon image
serviceContext - the service context to be applied. Can set the modification date and expando bridge attributes for the layout. For layouts that are linked to a layout prototype, attributes named layoutPrototypeUuid and layoutPrototypeLinkedEnabled can be specified to provide the unique identifier of the source prototype and a boolean to determine whether a link to it should be enabled to activate propagation of changes made to the linked page in the prototype.
Returns:
the updated layout
Throws:
PortalException - if a group or layout with the primary key could not be found, if a unique friendly URL could not be generated, if a valid parent layout ID to use could not be found, if the layout parameters were invalid, or if a portal exception occurred
SystemException - if a system exception occurred

updateLayout

Layout updateLayout(long groupId,
                    boolean privateLayout,
                    long layoutId,
                    String typeSettings)
                    throws PortalException,
                           SystemException
Updates the layout replacing its type settings.

Parameters:
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
layoutId - the primary key of the layout
typeSettings - the settings to load the unicode properties object. See #fastLoad(String).
Returns:
the updated layout
Throws:
PortalException - if a matching layout could not be found or if a portal exception occurred
SystemException - if a system exception occurred

updateLookAndFeel

Layout updateLookAndFeel(long groupId,
                         boolean privateLayout,
                         long layoutId,
                         String themeId,
                         String colorSchemeId,
                         String css,
                         boolean wapTheme)
                         throws PortalException,
                                SystemException
Updates the look and feel of the layout.

Parameters:
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
layoutId - the primary key of the layout
themeId - the primary key of the layout's new theme
colorSchemeId - the primary key of the layout's new color scheme
css - the layout's new CSS
wapTheme - whether the theme is for WAP browsers
Returns:
the updated layout
Throws:
PortalException - if a matching layout could not be found
SystemException - if a system exception occurred

updateName

Layout updateName(Layout layout,
                  String name,
                  String languageId)
                  throws PortalException,
                         SystemException
Updates the name of the layout.

Parameters:
layout - the layout to be updated
name - the layout's new name
languageId - the primary key of the language. For more information see Locale.
Returns:
the updated layout
Throws:
PortalException - if the new name was null
SystemException - if a system exception occurred

updateName

Layout updateName(long groupId,
                  boolean privateLayout,
                  long layoutId,
                  String name,
                  String languageId)
                  throws PortalException,
                         SystemException
Updates the name of the layout matching the group, layout ID, and privacy.

Parameters:
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
layoutId - the primary key of the layout
name - the layout's new name
languageId - the primary key of the language. For more information see Locale.
Returns:
the updated layout
Throws:
PortalException - if a matching layout could not be found or if the new name was null
SystemException - if a system exception occurred

updateName

Layout updateName(long plid,
                  String name,
                  String languageId)
                  throws PortalException,
                         SystemException
Updates the name of the layout matching the primary key.

Parameters:
plid - the primary key of the layout
name - the name to be assigned
languageId - the primary key of the language. For more information see Locale.
Returns:
the updated layout
Throws:
PortalException - if a layout with the primary key could not be found or if the name was null
SystemException - if a system exception occurred

updateParentLayoutId

Layout updateParentLayoutId(long groupId,
                            boolean privateLayout,
                            long layoutId,
                            long parentLayoutId)
                            throws PortalException,
                                   SystemException
Updates the parent layout ID of the layout matching the group, layout ID, and privacy.

Parameters:
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
layoutId - the primary key of the layout
parentLayoutId - the primary key to be assigned to the parent layout
Returns:
the matching layout
Throws:
PortalException - if a valid parent layout ID to use could not be found or if a matching layout could not be found
SystemException - if a system exception occurred

updateParentLayoutId

Layout updateParentLayoutId(long plid,
                            long parentPlid)
                            throws PortalException,
                                   SystemException
Updates the parent layout ID of the layout matching the primary key. If a layout matching the parent primary key is found, the layout ID of that layout is assigned, otherwise LayoutConstants.DEFAULT_PARENT_LAYOUT_ID is assigned.

Parameters:
plid - the primary key of the layout
parentPlid - the primary key of the parent layout
Returns:
the layout matching the primary key
Throws:
PortalException - if a layout with the primary key could not be found or if a valid parent layout ID to use could not be found
SystemException - if a system exception occurred

updateParentLayoutIdAndPriority

Layout updateParentLayoutIdAndPriority(long plid,
                                       long parentPlid,
                                       int priority)
                                       throws PortalException,
                                              SystemException
Throws:
PortalException
SystemException

updatePriorities

void updatePriorities(long groupId,
                      boolean privateLayout)
                      throws PortalException,
                             SystemException
Updates the priorities of the layouts.

Parameters:
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
Throws:
PortalException - if a matching layout could not be found
SystemException - if a system exception occurred

updatePriority

Layout updatePriority(Layout layout,
                      int priority)
                      throws PortalException,
                             SystemException
Updates the priority of the layout.

Parameters:
layout - the layout to be updated
priority - the layout's new priority
Returns:
the updated layout
Throws:
PortalException - if a portal exception occurred
SystemException - if a system exception occurred

updatePriority

Layout updatePriority(long groupId,
                      boolean privateLayout,
                      long layoutId,
                      int priority)
                      throws PortalException,
                             SystemException
Updates the priority of the layout matching the group, layout ID, and privacy.

Parameters:
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
layoutId - the primary key of the layout
priority - the layout's new priority
Returns:
the updated layout
Throws:
PortalException - if a matching layout could not be found
SystemException - if a system exception occurred

updatePriority

Layout updatePriority(long groupId,
                      boolean privateLayout,
                      long layoutId,
                      long nextLayoutId,
                      long previousLayoutId)
                      throws PortalException,
                             SystemException
Updates the priority of the layout matching the group, layout ID, and privacy, setting the layout's priority based on the priorities of the next and previous layouts.

Parameters:
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
layoutId - the primary key of the layout
nextLayoutId - the primary key of the next layout
previousLayoutId - the primary key of the previous layout
Returns:
the updated layout
Throws:
PortalException - if a matching layout could not be found
SystemException - if a system exception occurred

updatePriority

Layout updatePriority(long plid,
                      int priority)
                      throws PortalException,
                             SystemException
Updates the priority of the layout matching the primary key.

Parameters:
plid - the primary key of the layout
priority - the layout's new priority
Returns:
the updated layout
Throws:
PortalException - if a layout with the primary key could not be found
SystemException - if a system exception occurred

updateScopedPortletNames

void updateScopedPortletNames(long groupId,
                              boolean privateLayout,
                              long layoutId,
                              Map<Locale,String> nameMap,
                              List<Locale> nameMapModifiedLocales)
                              throws PortalException,
                                     SystemException
Deprecated. As of 6.2.0, with no direct replacement

Throws:
PortalException
SystemException

updateScopedPortletNames

void updateScopedPortletNames(long groupId,
                              boolean privateLayout,
                              long layoutId,
                              String name,
                              String languageId)
                              throws PortalException,
                                     SystemException
Deprecated. As of 6.2.0, with no direct replacement

Updates the names of the portlets within scope of the group, the scope of the layout's UUID, and the privacy.

Parameters:
groupId - the primary key of the group
privateLayout - whether the layout is private to the group
layoutId - the primary key of the layout whose UUID to match
name - the new name for the portlets
languageId - the primary key of the language
Throws:
PortalException - if a matching layout could not be found
SystemException - if a system exception occurred
See Also:
com.liferay.portlet.portletconfiguration.action.EditScopeAction

validateImportLayoutsFile

MissingReferences validateImportLayoutsFile(long userId,
                                            long groupId,
                                            boolean privateLayout,
                                            Map<String,String[]> parameterMap,
                                            File file)
                                            throws PortalException,
                                                   SystemException
Throws:
PortalException
SystemException

validateImportLayoutsFile

MissingReferences validateImportLayoutsFile(long userId,
                                            long groupId,
                                            boolean privateLayout,
                                            Map<String,String[]> parameterMap,
                                            InputStream inputStream)
                                            throws PortalException,
                                                   SystemException
Throws:
PortalException
SystemException

validateImportPortletInfo

MissingReferences validateImportPortletInfo(long userId,
                                            long plid,
                                            long groupId,
                                            String portletId,
                                            Map<String,String[]> parameterMap,
                                            File file)
                                            throws PortalException,
                                                   SystemException
Throws:
PortalException
SystemException

validateImportPortletInfo

MissingReferences validateImportPortletInfo(long userId,
                                            long plid,
                                            long groupId,
                                            String portletId,
                                            Map<String,String[]> parameterMap,
                                            InputStream inputStream)
                                            throws PortalException,
                                                   SystemException
Throws:
PortalException
SystemException

Liferay 6.2-ce-ga5