public class LayoutServiceSoap
extends java.lang.Object
LayoutServiceUtil
service
utility. The static methods of this class call 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 java.util.List
,
that is translated to an array of
com.liferay.portal.kernel.model.LayoutSoap
. If the method in the
service utility returns a
com.liferay.portal.kernel.model.Layout
, that is translated to a
com.liferay.portal.kernel.model.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
Constructor and Description |
---|
LayoutServiceSoap() |
Modifier and Type | Method and Description |
---|---|
static LayoutSoap |
addLayout(long groupId,
boolean privateLayout,
long parentLayoutId,
java.lang.String[] localeNamesMapLanguageIds,
java.lang.String[] localeNamesMapValues,
java.lang.String[] localeTitlesMapLanguageIds,
java.lang.String[] localeTitlesMapValues,
java.lang.String[] descriptionMapLanguageIds,
java.lang.String[] descriptionMapValues,
java.lang.String[] keywordsMapLanguageIds,
java.lang.String[] keywordsMapValues,
java.lang.String[] robotsMapLanguageIds,
java.lang.String[] robotsMapValues,
java.lang.String type,
java.lang.String typeSettings,
boolean hidden,
java.lang.String[] friendlyURLMapLanguageIds,
java.lang.String[] friendlyURLMapValues,
ServiceContext serviceContext)
Adds a layout with additional parameters.
|
static LayoutSoap |
addLayout(long groupId,
boolean privateLayout,
long parentLayoutId,
java.lang.String name,
java.lang.String title,
java.lang.String description,
java.lang.String type,
boolean hidden,
java.lang.String friendlyURL,
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,
ServiceContext serviceContext)
Deletes the layout with the primary key, also deleting the layout's child
layouts, and associated resources.
|
static void |
deleteLayout(long plid,
ServiceContext serviceContext)
Deletes the layout with the plid, also deleting the layout's child
layouts, and associated resources.
|
static void |
deleteTempFileEntry(long groupId,
java.lang.String folderName,
java.lang.String fileName) |
static long |
exportLayoutsAsFileInBackground(ExportImportConfigurationSoap exportImportConfiguration)
Deprecated.
As of Wilberforce (7.0.x), replaced by
ExportImportService.exportLayoutsAsFileInBackground(
ExportImportConfiguration) |
static long |
exportLayoutsAsFileInBackground(long exportImportConfigurationId)
Deprecated.
As of Wilberforce (7.0.x), replaced by
ExportImportService.exportLayoutsAsFileInBackground(
long) |
static LayoutSoap[] |
getAncestorLayouts(long plid)
Returns all the ancestor layouts of the layout.
|
static long |
getDefaultPlid(long groupId,
long scopeGroupId,
boolean privateLayout,
java.lang.String portletId)
Returns the primary key of the default layout for the group.
|
static long |
getDefaultPlid(long groupId,
long scopeGroupId,
java.lang.String portletId) |
static LayoutSoap |
getLayoutByUuidAndGroupId(java.lang.String uuid,
long groupId,
boolean privateLayout)
Returns the layout matching the UUID, group, and privacy.
|
static java.lang.String |
getLayoutName(long groupId,
boolean privateLayout,
long layoutId,
java.lang.String languageId)
Returns the name of the layout.
|
static LayoutReference[] |
getLayoutReferences(long companyId,
java.lang.String portletId,
java.lang.String preferencesKey,
java.lang.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 LayoutSoap[] |
getLayouts(long groupId,
boolean privateLayout) |
static LayoutSoap[] |
getLayouts(long groupId,
boolean privateLayout,
long parentLayoutId) |
static LayoutSoap[] |
getLayouts(long groupId,
boolean privateLayout,
long parentLayoutId,
boolean incomplete,
int start,
int end) |
static LayoutSoap[] |
getLayouts(long groupId,
boolean privateLayout,
java.lang.String type) |
static int |
getLayoutsCount(long groupId,
boolean privateLayout,
long parentLayoutId) |
static int |
getLayoutsCount(long groupId,
boolean privateLayout,
long parentLayoutId,
int priority) |
static java.lang.String[] |
getTempFileNames(long groupId,
java.lang.String folderName) |
static 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.
|
static void |
unschedulePublishToLive(long groupId,
java.lang.String jobName,
java.lang.String groupName)
Deletes the job from the scheduler's queue.
|
static void |
unschedulePublishToRemote(long groupId,
java.lang.String jobName,
java.lang.String groupName)
Deletes the job from the scheduler's persistent queue.
|
static LayoutSoap |
updateIconImage(long plid,
byte[] bytes) |
static LayoutSoap |
updateLayout(long groupId,
boolean privateLayout,
long layoutId,
long parentLayoutId,
java.lang.String[] localeNamesMapLanguageIds,
java.lang.String[] localeNamesMapValues,
java.lang.String[] localeTitlesMapLanguageIds,
java.lang.String[] localeTitlesMapValues,
java.lang.String[] descriptionMapLanguageIds,
java.lang.String[] descriptionMapValues,
java.lang.String[] keywordsMapLanguageIds,
java.lang.String[] keywordsMapValues,
java.lang.String[] robotsMapLanguageIds,
java.lang.String[] robotsMapValues,
java.lang.String type,
boolean hidden,
java.lang.String[] friendlyURLMapLanguageIds,
java.lang.String[] friendlyURLMapValues,
boolean iconImage,
byte[] iconBytes,
ServiceContext serviceContext)
Updates the layout with additional parameters.
|
static LayoutSoap |
updateLayout(long groupId,
boolean privateLayout,
long layoutId,
java.lang.String typeSettings)
Updates the layout replacing its type settings.
|
static LayoutSoap |
updateLookAndFeel(long groupId,
boolean privateLayout,
long layoutId,
java.lang.String themeId,
java.lang.String colorSchemeId,
java.lang.String css)
Updates the look and feel of the layout.
|
static LayoutSoap |
updateName(long groupId,
boolean privateLayout,
long layoutId,
java.lang.String name,
java.lang.String languageId)
Updates the name of the layout matching the group, layout ID, and
privacy.
|
static LayoutSoap |
updateName(long plid,
java.lang.String name,
java.lang.String languageId)
Updates the name of the layout matching the primary key.
|
static 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 LayoutSoap |
updateParentLayoutId(long plid,
long parentPlid)
Updates the parent layout ID of the layout matching the primary key.
|
static LayoutSoap |
updateParentLayoutIdAndPriority(long plid,
long parentPlid,
int priority)
Updates the parent layout ID and priority of the layout.
|
static LayoutSoap |
updatePriority(long groupId,
boolean privateLayout,
long layoutId,
int priority)
Updates the priority of the layout matching the group, layout ID, and
privacy.
|
static 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 LayoutSoap |
updatePriority(long plid,
int priority)
Updates the priority of the layout matching the primary key.
|
public static LayoutSoap addLayout(long groupId, boolean privateLayout, long parentLayoutId, java.lang.String[] localeNamesMapLanguageIds, java.lang.String[] localeNamesMapValues, java.lang.String[] localeTitlesMapLanguageIds, java.lang.String[] localeTitlesMapValues, java.lang.String[] descriptionMapLanguageIds, java.lang.String[] descriptionMapValues, java.lang.String[] keywordsMapLanguageIds, java.lang.String[] keywordsMapValues, java.lang.String[] robotsMapLanguageIds, java.lang.String[] robotsMapValues, java.lang.String type, java.lang.String typeSettings, boolean hidden, java.lang.String[] friendlyURLMapLanguageIds, java.lang.String[] friendlyURLMapValues, ServiceContext serviceContext) throws java.rmi.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.java.rmi.RemoteException
public static LayoutSoap addLayout(long groupId, boolean privateLayout, long parentLayoutId, java.lang.String name, java.lang.String title, java.lang.String description, java.lang.String type, boolean hidden, java.lang.String friendlyURL, ServiceContext serviceContext) throws java.rmi.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.java.rmi.RemoteException
public static void deleteLayout(long groupId, boolean privateLayout, long layoutId, ServiceContext serviceContext) throws java.rmi.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 appliedjava.rmi.RemoteException
public static void deleteLayout(long plid, ServiceContext serviceContext) throws java.rmi.RemoteException
plid
- the primary key of the layoutserviceContext
- the service context to be appliedjava.rmi.RemoteException
public static void deleteTempFileEntry(long groupId, java.lang.String folderName, java.lang.String fileName) throws java.rmi.RemoteException
java.rmi.RemoteException
@Deprecated public static long exportLayoutsAsFileInBackground(ExportImportConfigurationSoap exportImportConfiguration) throws java.rmi.RemoteException
ExportImportService.exportLayoutsAsFileInBackground(
ExportImportConfiguration)
java.rmi.RemoteException
@Deprecated public static long exportLayoutsAsFileInBackground(long exportImportConfigurationId) throws java.rmi.RemoteException
ExportImportService.exportLayoutsAsFileInBackground(
long)
java.rmi.RemoteException
public static LayoutSoap[] getAncestorLayouts(long plid) throws java.rmi.RemoteException
plid
- the primary key of the layoutjava.rmi.RemoteException
public static long getDefaultPlid(long groupId, long scopeGroupId, boolean privateLayout, java.lang.String portletId) throws java.rmi.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
otherwisejava.rmi.RemoteException
public static long getDefaultPlid(long groupId, long scopeGroupId, java.lang.String portletId) throws java.rmi.RemoteException
java.rmi.RemoteException
public static LayoutSoap getLayoutByUuidAndGroupId(java.lang.String uuid, long groupId, boolean privateLayout) throws java.rmi.RemoteException
uuid
- the layout's UUIDgroupId
- the primary key of the groupprivateLayout
- whether the layout is private to the groupjava.rmi.RemoteException
public static java.lang.String getLayoutName(long groupId, boolean privateLayout, long layoutId, java.lang.String languageId) throws java.rmi.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
.java.rmi.RemoteException
public static LayoutReference[] getLayoutReferences(long companyId, java.lang.String portletId, java.lang.String preferencesKey, java.lang.String preferencesValue) throws java.rmi.RemoteException
companyId
- the primary key of the companyportletId
- the primary key of the portletpreferencesKey
- the portlet's preference keypreferencesValue
- the portlet's preference valuejava.rmi.RemoteException
public static LayoutSoap[] getLayouts(long groupId, boolean privateLayout) throws java.rmi.RemoteException
java.rmi.RemoteException
public static LayoutSoap[] getLayouts(long groupId, boolean privateLayout, long parentLayoutId) throws java.rmi.RemoteException
java.rmi.RemoteException
public static LayoutSoap[] getLayouts(long groupId, boolean privateLayout, long parentLayoutId, boolean incomplete, int start, int end) throws java.rmi.RemoteException
java.rmi.RemoteException
public static LayoutSoap[] getLayouts(long groupId, boolean privateLayout, java.lang.String type) throws java.rmi.RemoteException
java.rmi.RemoteException
public static int getLayoutsCount(long groupId, boolean privateLayout, long parentLayoutId) throws java.rmi.RemoteException
java.rmi.RemoteException
public static int getLayoutsCount(long groupId, boolean privateLayout, long parentLayoutId, int priority) throws java.rmi.RemoteException
java.rmi.RemoteException
public static java.lang.String[] getTempFileNames(long groupId, java.lang.String folderName) throws java.rmi.RemoteException
java.rmi.RemoteException
public static void setLayouts(long groupId, boolean privateLayout, long parentLayoutId, long[] layoutIds, ServiceContext serviceContext) throws java.rmi.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 appliedjava.rmi.RemoteException
public static void unschedulePublishToLive(long groupId, java.lang.String jobName, java.lang.String groupName) throws java.rmi.RemoteException
groupId
- the primary key of the groupjobName
- the job namegroupName
- the group name (optionally DestinationNames#LAYOUTS_LOCAL_PUBLISHER
). See DestinationNames
.java.rmi.RemoteException
public static void unschedulePublishToRemote(long groupId, java.lang.String jobName, java.lang.String groupName) throws java.rmi.RemoteException
groupId
- the primary key of the groupjobName
- the job namegroupName
- the group name (optionally DestinationNames#LAYOUTS_LOCAL_PUBLISHER
). See DestinationNames
.java.rmi.RemoteException
public static LayoutSoap updateIconImage(long plid, byte[] bytes) throws java.rmi.RemoteException
java.rmi.RemoteException
public static LayoutSoap updateLayout(long groupId, boolean privateLayout, long layoutId, long parentLayoutId, java.lang.String[] localeNamesMapLanguageIds, java.lang.String[] localeNamesMapValues, java.lang.String[] localeTitlesMapLanguageIds, java.lang.String[] localeTitlesMapValues, java.lang.String[] descriptionMapLanguageIds, java.lang.String[] descriptionMapValues, java.lang.String[] keywordsMapLanguageIds, java.lang.String[] keywordsMapValues, java.lang.String[] robotsMapLanguageIds, java.lang.String[] robotsMapValues, java.lang.String type, boolean hidden, java.lang.String[] friendlyURLMapLanguageIds, java.lang.String[] friendlyURLMapValues, boolean iconImage, byte[] iconBytes, ServiceContext serviceContext) throws java.rmi.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.java.rmi.RemoteException
public static LayoutSoap updateLayout(long groupId, boolean privateLayout, long layoutId, java.lang.String typeSettings) throws java.rmi.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)
.java.rmi.RemoteException
public static LayoutSoap updateLookAndFeel(long groupId, boolean privateLayout, long layoutId, java.lang.String themeId, java.lang.String colorSchemeId, java.lang.String css) throws java.rmi.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 CSSjava.rmi.RemoteException
public static LayoutSoap updateName(long groupId, boolean privateLayout, long layoutId, java.lang.String name, java.lang.String languageId) throws java.rmi.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
.java.rmi.RemoteException
public static LayoutSoap updateName(long plid, java.lang.String name, java.lang.String languageId) throws java.rmi.RemoteException
plid
- the primary key of the layoutname
- the name to be assignedlanguageId
- the primary key of the language. For more information
see Locale
.java.rmi.RemoteException
public static LayoutSoap updateParentLayoutId(long groupId, boolean privateLayout, long layoutId, long parentLayoutId) throws java.rmi.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
layoutjava.rmi.RemoteException
public static LayoutSoap updateParentLayoutId(long plid, long parentPlid) throws java.rmi.RemoteException
LayoutConstants#DEFAULT_PARENT_LAYOUT_ID
is assigned.plid
- the primary key of the layoutparentPlid
- the primary key of the parent layoutjava.rmi.RemoteException
public static LayoutSoap updateParentLayoutIdAndPriority(long plid, long parentPlid, int priority) throws java.rmi.RemoteException
plid
- the primary key of the layoutparentPlid
- the primary key of the parent layoutpriority
- the layout's new priorityjava.rmi.RemoteException
public static LayoutSoap updatePriority(long groupId, boolean privateLayout, long layoutId, int priority) throws java.rmi.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 priorityjava.rmi.RemoteException
public static LayoutSoap updatePriority(long groupId, boolean privateLayout, long layoutId, long nextLayoutId, long previousLayoutId) throws java.rmi.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 layoutjava.rmi.RemoteException
public static LayoutSoap updatePriority(long plid, int priority) throws java.rmi.RemoteException
plid
- the primary key of the layoutpriority
- the layout's new priorityjava.rmi.RemoteException