@ProviderType
public class LayoutServiceSoap
extends Object
LayoutServiceUtil
service utility. The
static methods of this class calls the same methods of the service utility.
However, the signatures are different because it is difficult for SOAP to
support certain types.
ServiceBuilder follows certain rules in translating the methods. For example,
if the method in the service utility returns a List
, that
is translated to an array of LayoutSoap
.
If the method in the service utility returns a
Layout
, that is translated to a
LayoutSoap
. Methods that SOAP cannot
safely wire are skipped.
The benefits of using the SOAP utility is that it is cross platform compatible. SOAP allows different languages like Java, .NET, C++, PHP, and even Perl, to call the generated services. One drawback of SOAP is that it is slow because it needs to serialize all calls into a text format (XML).
You can see a list of services at http://localhost:8080/api/axis. Set the property axis.servlet.hosts.allowed in portal.properties to configure security.
The SOAP utility is only generated for remote services.
LayoutServiceHttp
,
LayoutSoap
,
LayoutServiceUtil
Constructor and Description |
---|
LayoutServiceSoap() |
Modifier and Type | Method and Description |
---|---|
static com.liferay.portal.kernel.model.LayoutSoap |
addLayout(long groupId,
boolean privateLayout,
long parentLayoutId,
String[] localeNamesMapLanguageIds,
String[] localeNamesMapValues,
String[] localeTitlesMapLanguageIds,
String[] localeTitlesMapValues,
String[] descriptionMapLanguageIds,
String[] descriptionMapValues,
String[] keywordsMapLanguageIds,
String[] keywordsMapValues,
String[] robotsMapLanguageIds,
String[] robotsMapValues,
String type,
String typeSettings,
boolean hidden,
String[] friendlyURLMapLanguageIds,
String[] friendlyURLMapValues,
com.liferay.portal.kernel.service.ServiceContext serviceContext)
Adds a layout with additional parameters.
|
static com.liferay.portal.kernel.model.LayoutSoap |
addLayout(long groupId,
boolean privateLayout,
long parentLayoutId,
String name,
String title,
String description,
String type,
boolean hidden,
String friendlyURL,
com.liferay.portal.kernel.service.ServiceContext serviceContext)
Adds a layout with single entry maps for name, title, and description to
the default locale.
|
static void |
deleteLayout(long groupId,
boolean privateLayout,
long layoutId,
com.liferay.portal.kernel.service.ServiceContext serviceContext)
Deletes the layout with the primary key, also deleting the layout's child
layouts, and associated resources.
|
static void |
deleteLayout(long plid,
com.liferay.portal.kernel.service.ServiceContext serviceContext)
Deletes the layout with the plid, also deleting the layout's child
layouts, and associated resources.
|
static void |
deleteTempFileEntry(long groupId,
String folderName,
String fileName) |
static long |
exportLayoutsAsFileInBackground(com.liferay.exportimport.kernel.model.ExportImportConfigurationSoap exportImportConfiguration)
Deprecated.
As of 7.0.0, replaced by
ExportImportService.exportLayoutsAsFileInBackground(
ExportImportConfiguration) |
static long |
exportLayoutsAsFileInBackground(long exportImportConfigurationId)
Deprecated.
As of 7.0.0, replaced by
ExportImportService.exportLayoutsAsFileInBackground(
long) |
static com.liferay.portal.kernel.model.LayoutSoap[] |
getAncestorLayouts(long plid)
Returns all the ancestor layouts of the layout.
|
static long |
getDefaultPlid(long groupId,
long scopeGroupId,
boolean privateLayout,
String portletId)
Returns the primary key of the default layout for the group.
|
static long |
getDefaultPlid(long groupId,
long scopeGroupId,
String portletId) |
static com.liferay.portal.kernel.model.LayoutSoap |
getLayoutByUuidAndGroupId(String uuid,
long groupId,
boolean privateLayout)
Returns the layout matching the UUID, group, and privacy.
|
static String |
getLayoutName(long groupId,
boolean privateLayout,
long layoutId,
String languageId)
Returns the name of the layout.
|
static com.liferay.portal.kernel.model.LayoutReference[] |
getLayoutReferences(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.
|
static com.liferay.portal.kernel.model.LayoutSoap[] |
getLayouts(long groupId,
boolean privateLayout) |
static com.liferay.portal.kernel.model.LayoutSoap[] |
getLayouts(long groupId,
boolean privateLayout,
long parentLayoutId) |
static com.liferay.portal.kernel.model.LayoutSoap[] |
getLayouts(long groupId,
boolean privateLayout,
long parentLayoutId,
boolean incomplete,
int start,
int end) |
static int |
getLayoutsCount(long groupId,
boolean privateLayout,
long parentLayoutId) |
static int |
getLayoutsCount(long groupId,
boolean privateLayout,
long parentLayoutId,
int priority) |
static String[] |
getTempFileNames(long groupId,
String folderName) |
static void |
setLayouts(long groupId,
boolean privateLayout,
long parentLayoutId,
long[] layoutIds,
com.liferay.portal.kernel.service.ServiceContext serviceContext)
Sets the layouts for the group, replacing and prioritizing all layouts of
the parent layout.
|
static void |
unschedulePublishToLive(long groupId,
String jobName,
String groupName)
Deletes the job from the scheduler's queue.
|
static void |
unschedulePublishToRemote(long groupId,
String jobName,
String groupName)
Deletes the job from the scheduler's persistent queue.
|
static com.liferay.portal.kernel.model.LayoutSoap |
updateIconImage(long plid,
byte[] bytes) |
static com.liferay.portal.kernel.model.LayoutSoap |
updateLayout(long groupId,
boolean privateLayout,
long layoutId,
long parentLayoutId,
String[] localeNamesMapLanguageIds,
String[] localeNamesMapValues,
String[] localeTitlesMapLanguageIds,
String[] localeTitlesMapValues,
String[] descriptionMapLanguageIds,
String[] descriptionMapValues,
String[] keywordsMapLanguageIds,
String[] keywordsMapValues,
String[] robotsMapLanguageIds,
String[] robotsMapValues,
String type,
boolean hidden,
String[] friendlyURLMapLanguageIds,
String[] friendlyURLMapValues,
boolean iconImage,
byte[] iconBytes,
com.liferay.portal.kernel.service.ServiceContext serviceContext)
Updates the layout with additional parameters.
|
static com.liferay.portal.kernel.model.LayoutSoap |
updateLayout(long groupId,
boolean privateLayout,
long layoutId,
String typeSettings)
Updates the layout replacing its type settings.
|
static com.liferay.portal.kernel.model.LayoutSoap |
updateLookAndFeel(long groupId,
boolean privateLayout,
long layoutId,
String themeId,
String colorSchemeId,
String css)
Updates the look and feel of the layout.
|
static com.liferay.portal.kernel.model.LayoutSoap |
updateName(long groupId,
boolean privateLayout,
long layoutId,
String name,
String languageId)
Updates the name of the layout matching the group, layout ID, and
privacy.
|
static com.liferay.portal.kernel.model.LayoutSoap |
updateName(long plid,
String name,
String languageId)
Updates the name of the layout matching the primary key.
|
static com.liferay.portal.kernel.model.LayoutSoap |
updateParentLayoutId(long groupId,
boolean privateLayout,
long layoutId,
long parentLayoutId)
Updates the parent layout ID of the layout matching the group, layout ID,
and privacy.
|
static com.liferay.portal.kernel.model.LayoutSoap |
updateParentLayoutId(long plid,
long parentPlid)
Updates the parent layout ID of the layout matching the primary key.
|
static com.liferay.portal.kernel.model.LayoutSoap |
updateParentLayoutIdAndPriority(long plid,
long parentPlid,
int priority)
Updates the parent layout ID and priority of the layout.
|
static com.liferay.portal.kernel.model.LayoutSoap |
updatePriority(long groupId,
boolean privateLayout,
long layoutId,
int priority)
Updates the priority of the layout matching the group, layout ID, and
privacy.
|
static com.liferay.portal.kernel.model.LayoutSoap |
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.
|
static com.liferay.portal.kernel.model.LayoutSoap |
updatePriority(long plid,
int priority)
Updates the priority of the layout matching the primary key.
|
public static com.liferay.portal.kernel.model.LayoutSoap addLayout(long groupId, boolean privateLayout, long parentLayoutId, String[] localeNamesMapLanguageIds, String[] localeNamesMapValues, String[] localeTitlesMapLanguageIds, String[] localeTitlesMapValues, String[] descriptionMapLanguageIds, String[] descriptionMapValues, String[] keywordsMapLanguageIds, String[] keywordsMapValues, String[] robotsMapLanguageIds, String[] robotsMapValues, String type, String typeSettings, boolean hidden, String[] friendlyURLMapLanguageIds, String[] friendlyURLMapValues, com.liferay.portal.kernel.service.ServiceContext serviceContext) throws RemoteException
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.
groupId
- the primary key of the groupprivateLayout
- whether the layout is private to the groupparentLayoutId
- the primary key of the parent layout (optionally
LayoutConstants#DEFAULT_PARENT_LAYOUT_ID
)localeNamesMap
- the layout's locales and localized nameslocaleTitlesMap
- the layout's locales and localized titlesdescriptionMap
- the layout's locales and localized descriptionskeywordsMap
- the layout's locales and localized keywordsrobotsMap
- the layout's locales and localized robotstype
- 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 hiddenfriendlyURLMap
- 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 used to specify whether site
administrators can modify this page within their site.RemoteException
public static com.liferay.portal.kernel.model.LayoutSoap addLayout(long groupId, boolean privateLayout, long parentLayoutId, String name, String title, String description, String type, boolean hidden, String friendlyURL, com.liferay.portal.kernel.service.ServiceContext serviceContext) throws RemoteException
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.
groupId
- the primary key of the groupprivateLayout
- whether the layout is private to the groupparentLayoutId
- the primary key of the parent layout (optionally
LayoutConstants#DEFAULT_PARENT_LAYOUT_ID
)name
- the layout's locales and localized namestitle
- the layout's locales and localized titlesdescription
- the layout's locales and localized descriptionstype
- the layout's type (optionally LayoutConstants#TYPE_PORTLET
). The possible types can be found
in LayoutConstants
.hidden
- whether the layout is hiddenfriendlyURL
- 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 specify 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 used to specify whether site
administrators can modify this page within their site.RemoteException
public static void deleteLayout(long groupId, boolean privateLayout, long layoutId, com.liferay.portal.kernel.service.ServiceContext serviceContext) throws RemoteException
groupId
- the primary key of the groupprivateLayout
- whether the layout is private to the grouplayoutId
- the primary key of the layoutserviceContext
- the service context to be appliedRemoteException
public static void deleteLayout(long plid, com.liferay.portal.kernel.service.ServiceContext serviceContext) throws RemoteException
plid
- the primary key of the layoutserviceContext
- the service context to be appliedRemoteException
public static void deleteTempFileEntry(long groupId, String folderName, String fileName) throws RemoteException
RemoteException
@Deprecated public static long exportLayoutsAsFileInBackground(com.liferay.exportimport.kernel.model.ExportImportConfigurationSoap exportImportConfiguration) throws RemoteException
ExportImportService.exportLayoutsAsFileInBackground(
ExportImportConfiguration)
RemoteException
@Deprecated public static long exportLayoutsAsFileInBackground(long exportImportConfigurationId) throws RemoteException
ExportImportService.exportLayoutsAsFileInBackground(
long)
RemoteException
public static com.liferay.portal.kernel.model.LayoutSoap[] getAncestorLayouts(long plid) throws RemoteException
plid
- the primary key of the layoutRemoteException
public static long getDefaultPlid(long groupId, long scopeGroupId, boolean privateLayout, String portletId) throws RemoteException
groupId
- the primary key of the groupscopeGroupId
- the primary key of the scope group. See ServiceContext#getScopeGroupId()
.privateLayout
- whether the layout is private to the groupportletId
- the primary key of the portletLayoutConstants#DEFAULT_PLID
otherwiseRemoteException
public static long getDefaultPlid(long groupId, long scopeGroupId, String portletId) throws RemoteException
RemoteException
public static com.liferay.portal.kernel.model.LayoutSoap getLayoutByUuidAndGroupId(String uuid, long groupId, boolean privateLayout) throws RemoteException
uuid
- the layout's UUIDgroupId
- the primary key of the groupprivateLayout
- whether the layout is private to the groupRemoteException
public static String getLayoutName(long groupId, boolean privateLayout, long layoutId, String languageId) throws RemoteException
groupId
- the primary key of the groupprivateLayout
- whether the layout is private to the grouplayoutId
- the primary key of the layoutlanguageId
- the primary key of the language. For more information
See Locale
.RemoteException
public static com.liferay.portal.kernel.model.LayoutReference[] getLayoutReferences(long companyId, String portletId, String preferencesKey, String preferencesValue) throws RemoteException
companyId
- the primary key of the companyportletId
- the primary key of the portletpreferencesKey
- the portlet's preference keypreferencesValue
- the portlet's preference valueRemoteException
public static com.liferay.portal.kernel.model.LayoutSoap[] getLayouts(long groupId, boolean privateLayout) throws RemoteException
RemoteException
public static com.liferay.portal.kernel.model.LayoutSoap[] getLayouts(long groupId, boolean privateLayout, long parentLayoutId) throws RemoteException
RemoteException
public static com.liferay.portal.kernel.model.LayoutSoap[] getLayouts(long groupId, boolean privateLayout, long parentLayoutId, boolean incomplete, int start, int end) throws RemoteException
RemoteException
public static int getLayoutsCount(long groupId, boolean privateLayout, long parentLayoutId) throws RemoteException
RemoteException
public static int getLayoutsCount(long groupId, boolean privateLayout, long parentLayoutId, int priority) throws RemoteException
RemoteException
public static String[] getTempFileNames(long groupId, String folderName) throws RemoteException
RemoteException
public static void setLayouts(long groupId, boolean privateLayout, long parentLayoutId, long[] layoutIds, com.liferay.portal.kernel.service.ServiceContext serviceContext) throws RemoteException
groupId
- the primary key of the groupprivateLayout
- whether the layout is private to the groupparentLayoutId
- the primary key of the parent layoutlayoutIds
- the primary keys of the layoutsserviceContext
- the service context to be appliedRemoteException
public static void unschedulePublishToLive(long groupId, String jobName, String groupName) throws RemoteException
groupId
- the primary key of the groupjobName
- the job namegroupName
- the group name (optionally DestinationNames#LAYOUTS_LOCAL_PUBLISHER
). See DestinationNames
.RemoteException
public static void unschedulePublishToRemote(long groupId, String jobName, String groupName) throws RemoteException
groupId
- the primary key of the groupjobName
- the job namegroupName
- the group name (optionally DestinationNames#LAYOUTS_LOCAL_PUBLISHER
). See DestinationNames
.RemoteException
public static com.liferay.portal.kernel.model.LayoutSoap updateIconImage(long plid, byte[] bytes) throws RemoteException
RemoteException
public static com.liferay.portal.kernel.model.LayoutSoap updateLayout(long groupId, boolean privateLayout, long layoutId, long parentLayoutId, String[] localeNamesMapLanguageIds, String[] localeNamesMapValues, String[] localeTitlesMapLanguageIds, String[] localeTitlesMapValues, String[] descriptionMapLanguageIds, String[] descriptionMapValues, String[] keywordsMapLanguageIds, String[] keywordsMapValues, String[] robotsMapLanguageIds, String[] robotsMapValues, String type, boolean hidden, String[] friendlyURLMapLanguageIds, String[] friendlyURLMapValues, boolean iconImage, byte[] iconBytes, com.liferay.portal.kernel.service.ServiceContext serviceContext) throws RemoteException
groupId
- the primary key of the groupprivateLayout
- whether the layout is private to the grouplayoutId
- the primary key of the layoutparentLayoutId
- the primary key of the layout's new parent layoutlocaleNamesMap
- the layout's locales and localized nameslocaleTitlesMap
- the layout's locales and localized titlesdescriptionMap
- 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 hiddenfriendlyURLMap
- 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 updatediconBytes
- the byte array of the layout's new icon imageserviceContext
- the service context to be applied. Can set the
modification date and expando bridge attributes for the layout.RemoteException
public static com.liferay.portal.kernel.model.LayoutSoap updateLayout(long groupId, boolean privateLayout, long layoutId, String typeSettings) throws RemoteException
groupId
- the primary key of the groupprivateLayout
- whether the layout is private to the grouplayoutId
- the primary key of the layouttypeSettings
- the settings to load the unicode properties object.
See #fastLoad(String)
.RemoteException
public static com.liferay.portal.kernel.model.LayoutSoap updateLookAndFeel(long groupId, boolean privateLayout, long layoutId, String themeId, String colorSchemeId, String css) throws RemoteException
groupId
- the primary key of the groupprivateLayout
- whether the layout is private to the grouplayoutId
- the primary key of the layoutthemeId
- the primary key of the layout's new themecolorSchemeId
- the primary key of the layout's new color schemecss
- the layout's new CSSRemoteException
public static com.liferay.portal.kernel.model.LayoutSoap updateName(long groupId, boolean privateLayout, long layoutId, String name, String languageId) throws RemoteException
groupId
- the primary key of the groupprivateLayout
- whether the layout is private to the grouplayoutId
- the primary key of the layoutname
- the layout's new namelanguageId
- the primary key of the language. For more information
see Locale
.RemoteException
public static com.liferay.portal.kernel.model.LayoutSoap updateName(long plid, String name, String languageId) throws RemoteException
plid
- the primary key of the layoutname
- the name to be assignedlanguageId
- the primary key of the language. For more information
see Locale
.RemoteException
public static com.liferay.portal.kernel.model.LayoutSoap updateParentLayoutId(long groupId, boolean privateLayout, long layoutId, long parentLayoutId) throws RemoteException
groupId
- the primary key of the groupprivateLayout
- whether the layout is private to the grouplayoutId
- the primary key of the layoutparentLayoutId
- the primary key to be assigned to the parent
layoutRemoteException
public static com.liferay.portal.kernel.model.LayoutSoap updateParentLayoutId(long plid, long parentPlid) throws RemoteException
LayoutConstants#DEFAULT_PARENT_LAYOUT_ID
is assigned.plid
- the primary key of the layoutparentPlid
- the primary key of the parent layoutRemoteException
public static com.liferay.portal.kernel.model.LayoutSoap updateParentLayoutIdAndPriority(long plid, long parentPlid, int priority) throws RemoteException
plid
- the primary key of the layoutparentPlid
- the primary key of the parent layoutpriority
- the layout's new priorityRemoteException
public static com.liferay.portal.kernel.model.LayoutSoap updatePriority(long groupId, boolean privateLayout, long layoutId, int priority) throws RemoteException
groupId
- the primary key of the groupprivateLayout
- whether the layout is private to the grouplayoutId
- the primary key of the layoutpriority
- the layout's new priorityRemoteException
public static com.liferay.portal.kernel.model.LayoutSoap updatePriority(long groupId, boolean privateLayout, long layoutId, long nextLayoutId, long previousLayoutId) throws RemoteException
groupId
- the primary key of the groupprivateLayout
- whether the layout is private to the grouplayoutId
- the primary key of the layoutnextLayoutId
- the primary key of the next layoutpreviousLayoutId
- the primary key of the previous layoutRemoteException
public static com.liferay.portal.kernel.model.LayoutSoap updatePriority(long plid, int priority) throws RemoteException
plid
- the primary key of the layoutpriority
- the layout's new priorityRemoteException