com.liferay.portlet.dynamicdatamapping.service
Class DDMStructureServiceUtil

java.lang.Object
  com.liferay.portlet.dynamicdatamapping.service.DDMStructureServiceUtil

@ProviderType
public class DDMStructureServiceUtil
extends Object

Provides the remote service utility for DDMStructure. This utility wraps com.liferay.portlet.dynamicdatamapping.service.impl.DDMStructureServiceImpl and is the primary access point for service operations in application layer code running on a remote server. Methods of this service are expected to have security checks based on the propagated JAAS credentials because this service can be accessed remotely.

See Also:

DDMStructureService, com.liferay.portlet.dynamicdatamapping.service.base.DDMStructureServiceBaseImpl, com.liferay.portlet.dynamicdatamapping.service.impl.DDMStructureServiceImpl

Constructor Summary

DDMStructureServiceUtil()

Method Summary

static DDMStructure	addStructure(long userId, long groupId, long classNameId, Map<Locale,String> nameMap, Map<Locale,String> descriptionMap, String xsd, ServiceContext serviceContext) Adds a structure referencing a default parent structure, using the portal property dynamic.data.lists.storage.type storage type and default structure type.
static DDMStructure	addStructure(long groupId, long parentStructureId, long classNameId, String structureKey, Map<Locale,String> nameMap, Map<Locale,String> descriptionMap, String xsd, String storageType, int type, ServiceContext serviceContext) Adds a structure referencing its parent structure.
static DDMStructure	addStructure(long userId, long groupId, String parentStructureKey, long classNameId, String structureKey, Map<Locale,String> nameMap, Map<Locale,String> descriptionMap, String xsd, String storageType, int type, ServiceContext serviceContext) Adds a structure referencing the parent structure by its structure key.
static DDMStructure	copyStructure(long structureId, Map<Locale,String> nameMap, Map<Locale,String> descriptionMap, ServiceContext serviceContext) Copies a structure, creating a new structure with all the values extracted from the original one.
static DDMStructure	copyStructure(long structureId, ServiceContext serviceContext)
static void	deleteStructure(long structureId) Deletes the structure and its resources.
static DDMStructure	fetchStructure(long groupId, long classNameId, String structureKey) Returns the structure matching the class name ID, structure key, and group.
static DDMStructure	fetchStructure(long groupId, long classNameId, String structureKey, boolean includeAncestorStructures)
static String	getBeanIdentifier() Returns the Spring bean ID for this bean.
static DDMStructureService	getService()
static DDMStructure	getStructure(long structureId) Returns the structure with the ID.
static DDMStructure	getStructure(long groupId, long classNameId, String structureKey) Returns the structure matching the class name ID, structure key, and group.
static DDMStructure	getStructure(long groupId, long classNameId, String structureKey, boolean includeGlobalStructures) Returns the structure matching the class name ID, structure key, and group, optionally in the global scope.
static List<DDMStructure>	getStructures(long groupId) Returns all the structures in the group that the user has permission to view.
static List<DDMStructure>	getStructures(long[] groupIds) Returns all the structures in the groups that the user has permission to view.
static List<DDMStructure>	getStructures(long[] groupIds, long classNameId)
static List<DDMStructure>	getStructures(long[] groupIds, long classNameId, int start, int end)
static List<DDMStructure>	search(long companyId, long[] groupIds, long[] classNameIds, String keywords, int start, int end, OrderByComparator orderByComparator) Returns an ordered range of all the structures matching the groups and class name IDs, and matching the keywords in the structure names and descriptions.
static List<DDMStructure>	search(long companyId, long[] groupIds, long[] classNameIds, String name, String description, String storageType, int type, boolean andOperator, int start, int end, OrderByComparator orderByComparator) Returns an ordered range of all the structures matching the groups, class name IDs, name keyword, description keyword, storage type, and type.
static int	searchCount(long companyId, long[] groupIds, long[] classNameIds, String keywords) Returns the number of structures matching the groups and class name IDs, and matching the keywords in the structure names and descriptions.
static int	searchCount(long companyId, long[] groupIds, long[] classNameIds, String name, String description, String storageType, int type, boolean andOperator) Returns the number of structures matching the groups, class name IDs, name keyword, description keyword, storage type, and type
static void	setBeanIdentifier(String beanIdentifier) Sets the Spring bean ID for this bean.
void	setService(DDMStructureService service) Deprecated. As of 6.2.0
static DDMStructure	updateStructure(long groupId, long parentStructureId, long classNameId, String structureKey, Map<Locale,String> nameMap, Map<Locale,String> descriptionMap, String xsd, ServiceContext serviceContext) Updates the structure matching the class name ID, structure key, and group, replacing its old parent structure, name map, description map, and XSD with new ones.
static DDMStructure	updateStructure(long structureId, long parentStructureId, Map<Locale,String> nameMap, Map<Locale,String> descriptionMap, String xsd, ServiceContext serviceContext) Updates the structure matching the structure ID, replacing the old parent structure ID, name map, description map, and XSD with the new values.

Methods inherited from class java.lang.Object

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

Constructor Detail

DDMStructureServiceUtil

public DDMStructureServiceUtil()

Method Detail

getBeanIdentifier

public static String getBeanIdentifier()

Returns the Spring bean ID for this bean.

Returns:

the Spring bean ID for this bean

setBeanIdentifier

public static void setBeanIdentifier(String beanIdentifier)

Sets the Spring bean ID for this bean.

Parameters:

beanIdentifier - the Spring bean ID for this bean

addStructure

public static DDMStructure addStructure(long userId,
                                        long groupId,
                                        long classNameId,
                                        Map<Locale,String> nameMap,
                                        Map<Locale,String> descriptionMap,
                                        String xsd,
                                        ServiceContext serviceContext)
                                 throws PortalException,
                                        SystemException

Adds a structure referencing a default parent structure, using the portal property dynamic.data.lists.storage.type storage type and default structure type.

Parameters:

userId - the primary key of the structure's creator/owner

groupId - the primary key of the group

classNameId - the primary key of the class name for the structure's related model

nameMap - the structure's locales and localized names

descriptionMap - the structure's locales and localized descriptions

xsd - the structure's XML schema definition

serviceContext - the service context to be applied. Can set the UUID, creation date, modification date, guest permissions, and group permissions for the structure.

Returns:

the structure

Throws:

PortalException - if a user with the primary key could not be found, if the user did not have permission to add the structure, if the XSD was not well-formed, or if a portal exception occurred

SystemException - if a system exception occurred

addStructure

public static DDMStructure addStructure(long groupId,
                                        long parentStructureId,
                                        long classNameId,
                                        String structureKey,
                                        Map<Locale,String> nameMap,
                                        Map<Locale,String> descriptionMap,
                                        String xsd,
                                        String storageType,
                                        int type,
                                        ServiceContext serviceContext)
                                 throws PortalException,
                                        SystemException

Adds a structure referencing its parent structure.

Parameters:

groupId - the primary key of the group

parentStructureId - the primary key of the parent structure (optionally DDMStructureConstants.DEFAULT_PARENT_STRUCTURE_ID)

classNameId - the primary key of the class name for the structure's related model

structureKey - the unique string identifying the structure (optionally null)

nameMap - the structure's locales and localized names

descriptionMap - the structure's locales and localized descriptions

xsd - the structure's XML schema definition

storageType - the structure's storage type. It can be "xml" or "expando". For more information, see StorageType.

type - the structure's type. For more information, see DDMStructureConstants.

serviceContext - the service context to be applied. Can set the UUID, creation date, modification date, guest permissions, and group permissions for the structure.

Returns:

the structure

Throws:

PortalException - if the user did not have permission to add the structure, if the XSD is not well formed, or if a portal exception occurred

SystemException - if a system exception occurred

addStructure

public static DDMStructure addStructure(long userId,
                                        long groupId,
                                        String parentStructureKey,
                                        long classNameId,
                                        String structureKey,
                                        Map<Locale,String> nameMap,
                                        Map<Locale,String> descriptionMap,
                                        String xsd,
                                        String storageType,
                                        int type,
                                        ServiceContext serviceContext)
                                 throws PortalException,
                                        SystemException

Adds a structure referencing the parent structure by its structure key. In case the parent structure is not found, it uses the default parent structure ID.

Parameters:

userId - the primary key of the structure's creator/owner

groupId - the primary key of the group

parentStructureKey - the unique string identifying the structure

classNameId - the primary key of the class name for the structure's related model

structureKey - unique string identifying the structure (optionally null)

nameMap - the structure's locales and localized names

descriptionMap - the structure's locales and localized descriptions

xsd - the XML schema definition of the structure

storageType - the storage type of the structure. It can be XML or expando. For more information, see StorageType.

type - the structure's type. For more information, see DDMStructureConstants.

serviceContext - the service context to be applied. Must have the ddmResource attribute to check permissions. Can set the UUID, creation date, modification date, guest permissions, and group permissions for the structure.

Returns:

the structure

Throws:

PortalException - if a user with the primary key could not be found, if the user did not have permission to add the structure, if the XSD was not well-formed, or if a portal exception occurred

SystemException - if a system exception occurred

copyStructure

public static DDMStructure copyStructure(long structureId,
                                         Map<Locale,String> nameMap,
                                         Map<Locale,String> descriptionMap,
                                         ServiceContext serviceContext)
                                  throws PortalException,
                                         SystemException

Copies a structure, creating a new structure with all the values extracted from the original one. The new structure supports a new name and description.

Parameters:

structureId - the primary key of the structure to be copied

nameMap - the new structure's locales and localized names

descriptionMap - the new structure's locales and localized descriptions

serviceContext - the service context to be applied. Can set the UUID, creation date, modification date, guest permissions, and group permissions for the structure.

Returns:

the new structure

Throws:

PortalException - if the user did not have permission to add the structure or if a portal exception occurred

SystemException - if a system exception occurred

copyStructure

public static DDMStructure copyStructure(long structureId,
                                         ServiceContext serviceContext)
                                  throws PortalException,
                                         SystemException

Throws:

PortalException

SystemException

deleteStructure

public static void deleteStructure(long structureId)
                            throws PortalException,
                                   SystemException

Deletes the structure and its resources.

Before deleting the structure, the system verifies whether the structure is required by another entity. If it is needed, an exception is thrown.

Parameters:

structureId - the primary key of the structure to be deleted

Throws:

PortalException - if the user did not have permission to delete the structure or if a portal exception occurred

SystemException - if a system exception occurred

fetchStructure

public static DDMStructure fetchStructure(long groupId,
                                          long classNameId,
                                          String structureKey)
                                   throws PortalException,
                                          SystemException

Returns the structure matching the class name ID, structure key, and group.

Parameters:

groupId - the primary key of the group

classNameId - the primary key of the class name for the structure's related model

structureKey - the unique string identifying the structure

Returns:

the matching structure, or null if a matching structure could not be found

Throws:

PortalException - if the user did not have permission to view the structure or if a portal exception occurred

SystemException - if a system exception occurred

fetchStructure

public static DDMStructure fetchStructure(long groupId,
                                          long classNameId,
                                          String structureKey,
                                          boolean includeAncestorStructures)
                                   throws PortalException,
                                          SystemException

Throws:

PortalException

SystemException

getStructure

public static DDMStructure getStructure(long structureId)
                                 throws PortalException,
                                        SystemException

Returns the structure with the ID.

Parameters:

structureId - the primary key of the structure

Returns:

the structure with the ID

Throws:

PortalException - if the user did not have permission to view the structure or if a structure with the ID could not be found

SystemException - if a system exception occurred

getStructure

public static DDMStructure getStructure(long groupId,
                                        long classNameId,
                                        String structureKey)
                                 throws PortalException,
                                        SystemException

Returns the structure matching the class name ID, structure key, and group.

Parameters:

groupId - the primary key of the structure's group

classNameId - the primary key of the class name for the structure's related model

structureKey - the unique string identifying the structure

Returns:

the matching structure

Throws:

PortalException - if the user did not have permission to view the structure or if a matching structure could not be found

SystemException - if a system exception occurred

getStructure

public static DDMStructure getStructure(long groupId,
                                        long classNameId,
                                        String structureKey,
                                        boolean includeGlobalStructures)
                                 throws PortalException,
                                        SystemException

Returns the structure matching the class name ID, structure key, and group, optionally in the global scope.

This method first searches in the group. If the structure is still not found and includeGlobalStructures is set to true, this method searches the global group.

Parameters:

groupId - the primary key of the structure's group

classNameId - the primary key of the class name for the structure's related model

structureKey - the unique string identifying the structure

includeGlobalStructures - whether to include the global scope in the search

Returns:

the matching structure

Throws:

PortalException - if the user did not have permission to view the structure or if a matching structure could not be found

SystemException - if a system exception occurred

getStructures

public static List<DDMStructure> getStructures(long groupId)
                                        throws SystemException

Returns all the structures in the group that the user has permission to view.

Parameters:

groupId - the primary key of the group

Returns:

the structures in the group that the user has permission to view

Throws:

SystemException - if a system exception occurred

getStructures

public static List<DDMStructure> getStructures(long[] groupIds)
                                        throws SystemException

Returns all the structures in the groups that the user has permission to view.

Parameters:

groupIds - the primary key of the groups

Returns:

the structures in the groups that the user has permission to view

Throws:

SystemException - if a system exception occurred

getStructures

public static List<DDMStructure> getStructures(long[] groupIds,
                                               long classNameId)
                                        throws SystemException

Throws:

SystemException

getStructures

public static List<DDMStructure> getStructures(long[] groupIds,
                                               long classNameId,
                                               int start,
                                               int end)
                                        throws SystemException

Throws:

SystemException

search

public static List<DDMStructure> search(long companyId,
                                        long[] groupIds,
                                        long[] classNameIds,
                                        String keywords,
                                        int start,
                                        int end,
                                        OrderByComparator orderByComparator)
                                 throws SystemException

Returns an ordered range of all the structures matching the groups and class name IDs, and matching the keywords in the structure names and descriptions.

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:

companyId - the primary key of the structure's company

groupIds - the primary keys of the groups

classNameIds - the primary keys of the class names of the models the structures are related to

keywords - the keywords (space separated), which may occur in the structure's name or description (optionally null)

start - the lower bound of the range of structures to return

end - the upper bound of the range of structures to return (not inclusive)

orderByComparator - the comparator to order the structures (optionally null)

Returns:

the range of matching structures ordered by the comparator

Throws:

SystemException - if a system exception occurred

search

public static List<DDMStructure> search(long companyId,
                                        long[] groupIds,
                                        long[] classNameIds,
                                        String name,
                                        String description,
                                        String storageType,
                                        int type,
                                        boolean andOperator,
                                        int start,
                                        int end,
                                        OrderByComparator orderByComparator)
                                 throws SystemException

Returns an ordered range of all the structures matching the groups, class name IDs, name keyword, description keyword, storage type, and type.

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:

companyId - the primary key of the structure's company

groupIds - the primary keys of the groups

classNameIds - the primary keys of the class names of the models the structures are related to

name - the name keywords

description - the description keywords

storageType - the structure's storage type. It can be "xml" or "expando". For more information, see StorageType.

type - the structure's type. For more information, see DDMStructureConstants.

andOperator - whether every field must match its keywords, or just one field

start - the lower bound of the range of structures to return

end - the upper bound of the range of structures to return (not inclusive)

orderByComparator - the comparator to order the structures (optionally null)

Returns:

the range of matching structures ordered by the comparator

Throws:

SystemException - if a system exception occurred

searchCount

public static int searchCount(long companyId,
                              long[] groupIds,
                              long[] classNameIds,
                              String keywords)
                       throws SystemException

Returns the number of structures matching the groups and class name IDs, and matching the keywords in the structure names and descriptions.

Parameters:

companyId - the primary key of the structure's company

groupIds - the primary keys of the groups

classNameIds - the primary keys of the class names of the models the structures are related to

keywords - the keywords (space separated), which may occur in the structure's name or description (optionally null)

Returns:

the number of matching structures

Throws:

SystemException - if a system exception occurred

searchCount

public static int searchCount(long companyId,
                              long[] groupIds,
                              long[] classNameIds,
                              String name,
                              String description,
                              String storageType,
                              int type,
                              boolean andOperator)
                       throws SystemException

Returns the number of structures matching the groups, class name IDs, name keyword, description keyword, storage type, and type

Parameters:

companyId - the primary key of the structure's company

groupIds - the primary keys of the groups

classNameIds - the primary keys of the class names of the models the structure's are related to

name - the name keywords

description - the description keywords

storageType - the structure's storage type. It can be "xml" or "expando". For more information, see StorageType.

type - the structure's type. For more information, see DDMStructureConstants.

andOperator - whether every field must match its keywords, or just one field

Returns:

the number of matching structures

Throws:

SystemException - if a system exception occurred

updateStructure

public static DDMStructure updateStructure(long groupId,
                                           long parentStructureId,
                                           long classNameId,
                                           String structureKey,
                                           Map<Locale,String> nameMap,
                                           Map<Locale,String> descriptionMap,
                                           String xsd,
                                           ServiceContext serviceContext)
                                    throws PortalException,
                                           SystemException

Updates the structure matching the class name ID, structure key, and group, replacing its old parent structure, name map, description map, and XSD with new ones.

Parameters:

groupId - the primary key of the group

parentStructureId - the primary key of the new parent structure

classNameId - the primary key of the class name for the structure's related model

structureKey - the unique string identifying the structure

nameMap - the structure's new locales and localized names

descriptionMap - the structure's new locales and localized description

xsd - the structure's new XML schema definition

serviceContext - the service context to be applied. Can set the modification date.

Returns:

the updated structure

Throws:

PortalException - if the user did not have permission to update the structure or if a portal exception occurred

SystemException - if a system exception occurred

updateStructure

public static DDMStructure updateStructure(long structureId,
                                           long parentStructureId,
                                           Map<Locale,String> nameMap,
                                           Map<Locale,String> descriptionMap,
                                           String xsd,
                                           ServiceContext serviceContext)
                                    throws PortalException,
                                           SystemException

Updates the structure matching the structure ID, replacing the old parent structure ID, name map, description map, and XSD with the new values.

Parameters:

structureId - the primary key of the structure

parentStructureId - the new parent structure primary key

nameMap - the structure's new locales and localized names

descriptionMap - the structure's new locales and localized description

xsd - the new XML schema definition of the structure

serviceContext - the service context to be applied. Can set the modification date.

Returns:

the updated structure

Throws:

PortalException - if the user did not have permission to update the structure or if a portal exception occurred

SystemException - if a system exception occurred

getService

public static DDMStructureService getService()

setService

public void setService(DDMStructureService service)

Deprecated. As of 6.2.0