001    /**
002     * Copyright (c) 2000-2013 Liferay, Inc. All rights reserved.
003     *
004     * This library is free software; you can redistribute it and/or modify it under
005     * the terms of the GNU Lesser General Public License as published by the Free
006     * Software Foundation; either version 2.1 of the License, or (at your option)
007     * any later version.
008     *
009     * This library is distributed in the hope that it will be useful, but WITHOUT
010     * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
011     * FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
012     * details.
013     */
014    
015    package com.liferay.portlet.journal.service.http;
016    
017    import com.liferay.portal.kernel.log.Log;
018    import com.liferay.portal.kernel.log.LogFactoryUtil;
019    import com.liferay.portal.kernel.util.ListUtil;
020    import com.liferay.portal.kernel.util.LocalizationUtil;
021    
022    import com.liferay.portlet.journal.service.JournalArticleServiceUtil;
023    
024    import java.rmi.RemoteException;
025    
026    import java.util.Locale;
027    import java.util.Map;
028    
029    /**
030     * <p>
031     * This class provides a SOAP utility for the
032     * {@link com.liferay.portlet.journal.service.JournalArticleServiceUtil} service utility. The
033     * static methods of this class calls the same methods of the service utility.
034     * However, the signatures are different because it is difficult for SOAP to
035     * support certain types.
036     * </p>
037     *
038     * <p>
039     * ServiceBuilder follows certain rules in translating the methods. For example,
040     * if the method in the service utility returns a {@link java.util.List}, that
041     * is translated to an array of {@link com.liferay.portlet.journal.model.JournalArticleSoap}.
042     * If the method in the service utility returns a
043     * {@link com.liferay.portlet.journal.model.JournalArticle}, that is translated to a
044     * {@link com.liferay.portlet.journal.model.JournalArticleSoap}. Methods that SOAP cannot
045     * safely wire are skipped.
046     * </p>
047     *
048     * <p>
049     * The benefits of using the SOAP utility is that it is cross platform
050     * compatible. SOAP allows different languages like Java, .NET, C++, PHP, and
051     * even Perl, to call the generated services. One drawback of SOAP is that it is
052     * slow because it needs to serialize all calls into a text format (XML).
053     * </p>
054     *
055     * <p>
056     * You can see a list of services at http://localhost:8080/api/axis. Set the
057     * property <b>axis.servlet.hosts.allowed</b> in portal.properties to configure
058     * security.
059     * </p>
060     *
061     * <p>
062     * The SOAP utility is only generated for remote services.
063     * </p>
064     *
065     * @author    Brian Wing Shun Chan
066     * @see       JournalArticleServiceHttp
067     * @see       com.liferay.portlet.journal.model.JournalArticleSoap
068     * @see       com.liferay.portlet.journal.service.JournalArticleServiceUtil
069     * @generated
070     */
071    public class JournalArticleServiceSoap {
072            /**
073            * Adds a web content article without any images.
074            *
075            * @param groupId the primary key of the web content article's group
076            * @param folderId the primary key of the web content article folder
077            * @param classNameId the primary key of the DDMStructure class if the web
078            content article is related to a DDM structure, the primary key of
079            the class name associated with the article, or {@link
080            JournalArticleConstants#CLASSNAME_ID_DEFAULT} otherwise
081            * @param classPK the primary key of the DDM structure, if the primary key
082            of the DDMStructure class is given as the
083            <code>classNameId</code> parameter, the primary key of the class
084            associated with the web content article, or <code>0</code>
085            otherwise
086            * @param articleId the primary key of the web content article
087            * @param autoArticleId whether to auto generate the web content article ID
088            * @param titleMap the web content article's locales and localized titles
089            * @param descriptionMap the web content article's locales and localized
090            descriptions
091            * @param content the HTML content wrapped in XML. For more information,
092            see the content example in the class description for {@link
093            JournalArticleLocalServiceImpl}.
094            * @param type the structure's type, if the web content article is related
095            to a DDM structure. For more information, see {@link
096            com.liferay.portlet.dynamicdatamapping.model.DDMStructureConstants}.
097            * @param ddmStructureKey the primary key of the web content article's DDM
098            structure, if the article is related to a DDM structure, or
099            <code>null</code> otherwise
100            * @param ddmTemplateKey the primary key of the web content article's DDM
101            template (optionally <code>null</code>). If the article is
102            related to a DDM structure, the template's structure must match
103            it.
104            * @param layoutUuid the unique string identifying the web content
105            article's display page
106            * @param displayDateMonth the month the web content article is set to
107            display
108            * @param displayDateDay the calendar day the web content article is set to
109            display
110            * @param displayDateYear the year the web content article is set to
111            display
112            * @param displayDateHour the hour the web content article is set to
113            display
114            * @param displayDateMinute the minute the web content article is set to
115            display
116            * @param expirationDateMonth the month the web content article is set to
117            expire
118            * @param expirationDateDay the calendar day the web content article is set
119            to expire
120            * @param expirationDateYear the year the web content article is set to
121            expire
122            * @param expirationDateHour the hour the web content article is set to
123            expire
124            * @param expirationDateMinute the minute the web content article is set to
125            expire
126            * @param neverExpire whether the web content article is not set to auto
127            expire
128            * @param reviewDateMonth the month the web content article is set for
129            review
130            * @param reviewDateDay the calendar day the web content article is set for
131            review
132            * @param reviewDateYear the year the web content article is set for review
133            * @param reviewDateHour the hour the web content article is set for review
134            * @param reviewDateMinute the minute the web content article is set for
135            review
136            * @param neverReview whether the web content article is not set for review
137            * @param indexable whether the web content article is searchable
138            * @param articleURL the web content article's accessible URL
139            * @param serviceContext the service context to be applied. Can set the
140            UUID, creation date, modification date, expando bridge
141            attributes, guest permissions, group permissions, asset category
142            IDs, asset tag names, asset link entry IDs, the "urlTitle"
143            attribute, and workflow actions for the web content article. Can
144            also set whether to add the default guest and group permissions.
145            * @return the web content article
146            * @throws PortalException if the user did not have permission to add the
147            web content article or if a portal exception occurred
148            * @throws SystemException if a system exception occurred
149            */
150            public static com.liferay.portlet.journal.model.JournalArticleSoap addArticle(
151                    long groupId, long folderId, long classNameId, long classPK,
152                    java.lang.String articleId, boolean autoArticleId,
153                    java.lang.String[] titleMapLanguageIds,
154                    java.lang.String[] titleMapValues,
155                    java.lang.String[] descriptionMapLanguageIds,
156                    java.lang.String[] descriptionMapValues, java.lang.String content,
157                    java.lang.String type, java.lang.String ddmStructureKey,
158                    java.lang.String ddmTemplateKey, java.lang.String layoutUuid,
159                    int displayDateMonth, int displayDateDay, int displayDateYear,
160                    int displayDateHour, int displayDateMinute, int expirationDateMonth,
161                    int expirationDateDay, int expirationDateYear, int expirationDateHour,
162                    int expirationDateMinute, boolean neverExpire, int reviewDateMonth,
163                    int reviewDateDay, int reviewDateYear, int reviewDateHour,
164                    int reviewDateMinute, boolean neverReview, boolean indexable,
165                    java.lang.String articleURL,
166                    com.liferay.portal.service.ServiceContext serviceContext)
167                    throws RemoteException {
168                    try {
169                            Map<Locale, String> titleMap = LocalizationUtil.getLocalizationMap(titleMapLanguageIds,
170                                            titleMapValues);
171                            Map<Locale, String> descriptionMap = LocalizationUtil.getLocalizationMap(descriptionMapLanguageIds,
172                                            descriptionMapValues);
173    
174                            com.liferay.portlet.journal.model.JournalArticle returnValue = JournalArticleServiceUtil.addArticle(groupId,
175                                            folderId, classNameId, classPK, articleId, autoArticleId,
176                                            titleMap, descriptionMap, content, type, ddmStructureKey,
177                                            ddmTemplateKey, layoutUuid, displayDateMonth,
178                                            displayDateDay, displayDateYear, displayDateHour,
179                                            displayDateMinute, expirationDateMonth, expirationDateDay,
180                                            expirationDateYear, expirationDateHour,
181                                            expirationDateMinute, neverExpire, reviewDateMonth,
182                                            reviewDateDay, reviewDateYear, reviewDateHour,
183                                            reviewDateMinute, neverReview, indexable, articleURL,
184                                            serviceContext);
185    
186                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModel(returnValue);
187                    }
188                    catch (Exception e) {
189                            _log.error(e, e);
190    
191                            throw new RemoteException(e.getMessage());
192                    }
193            }
194    
195            /**
196            * Copies the web content article matching the group, article ID, and
197            * version. This method creates a new article, extracting all the values
198            * from the old one and updating its article ID.
199            *
200            * @param groupId the primary key of the web content article's group
201            * @param oldArticleId the primary key of the old web content article
202            * @param newArticleId the primary key of the new web content article
203            * @param autoArticleId whether to auto-generate the web content article ID
204            * @param version the web content article's version
205            * @return the new web content article
206            * @throws PortalException if the user did not have permission to add the
207            copy the web content article, if a matching web content article
208            could not be found, or if a portal exception occurred
209            * @throws SystemException if a system exception occurred
210            */
211            public static com.liferay.portlet.journal.model.JournalArticleSoap copyArticle(
212                    long groupId, java.lang.String oldArticleId,
213                    java.lang.String newArticleId, boolean autoArticleId, double version)
214                    throws RemoteException {
215                    try {
216                            com.liferay.portlet.journal.model.JournalArticle returnValue = JournalArticleServiceUtil.copyArticle(groupId,
217                                            oldArticleId, newArticleId, autoArticleId, version);
218    
219                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModel(returnValue);
220                    }
221                    catch (Exception e) {
222                            _log.error(e, e);
223    
224                            throw new RemoteException(e.getMessage());
225                    }
226            }
227    
228            /**
229            * Deletes the web content article and its resources matching the group,
230            * article ID, and version, optionally sending email notifying denial of the
231            * web content article if it had not yet been approved.
232            *
233            * @param groupId the primary key of the web content article's group
234            * @param articleId the primary key of the web content article
235            * @param version the web content article's version
236            * @param articleURL the web content article's accessible URL
237            * @param serviceContext the service context to be applied. Can set the
238            portlet preferences that include email information to notify
239            recipients of the unapproved web content article's denial.
240            * @throws PortalException if the user did not have permission to delete the
241            web content article, if a matching web content article could not
242            be found, or if a portal exception occurred
243            * @throws SystemException if a system exception occurred
244            */
245            public static void deleteArticle(long groupId, java.lang.String articleId,
246                    double version, java.lang.String articleURL,
247                    com.liferay.portal.service.ServiceContext serviceContext)
248                    throws RemoteException {
249                    try {
250                            JournalArticleServiceUtil.deleteArticle(groupId, articleId,
251                                    version, articleURL, serviceContext);
252                    }
253                    catch (Exception e) {
254                            _log.error(e, e);
255    
256                            throw new RemoteException(e.getMessage());
257                    }
258            }
259    
260            /**
261            * Deletes all web content articles and their resources matching the group
262            * and article ID, optionally sending email notifying denial of article if
263            * it had not yet been approved.
264            *
265            * @param groupId the primary key of the web content article's group
266            * @param articleId the primary key of the web content article
267            * @param articleURL the web content article's accessible URL
268            * @param serviceContext the service context to be applied. Can set the
269            portlet preferences that include email information to notify
270            recipients of the unapproved web content article's denial.
271            * @throws PortalException if the user did not have permission to delete the
272            web content article or if a portal exception occurred
273            * @throws SystemException if a system exception occurred
274            */
275            public static void deleteArticle(long groupId, java.lang.String articleId,
276                    java.lang.String articleURL,
277                    com.liferay.portal.service.ServiceContext serviceContext)
278                    throws RemoteException {
279                    try {
280                            JournalArticleServiceUtil.deleteArticle(groupId, articleId,
281                                    articleURL, serviceContext);
282                    }
283                    catch (Exception e) {
284                            _log.error(e, e);
285    
286                            throw new RemoteException(e.getMessage());
287                    }
288            }
289    
290            /**
291            * Expires the web content article matching the group, article ID, and
292            * version.
293            *
294            * @param groupId the primary key of the web content article's group
295            * @param articleId the primary key of the web content article
296            * @param version the web content article's version
297            * @param articleURL the web content article's accessible URL
298            * @param serviceContext the service context to be applied. Can set the
299            modification date, status date, portlet preferences, and can set
300            whether to add the default command update for the web content
301            article. With respect to social activities, by setting the
302            service context's command to {@link
303            com.liferay.portal.kernel.util.Constants#UPDATE}, the invocation
304            is considered a web content update activity; otherwise it is
305            considered a web content add activity.
306            * @return the web content article
307            * @throws PortalException if the user did not have permission to expire the
308            web content article, if a matching web content article could not
309            be found, or if a portal exception occurred
310            * @throws SystemException if a system exception occurred
311            */
312            public static com.liferay.portlet.journal.model.JournalArticleSoap expireArticle(
313                    long groupId, java.lang.String articleId, double version,
314                    java.lang.String articleURL,
315                    com.liferay.portal.service.ServiceContext serviceContext)
316                    throws RemoteException {
317                    try {
318                            com.liferay.portlet.journal.model.JournalArticle returnValue = JournalArticleServiceUtil.expireArticle(groupId,
319                                            articleId, version, articleURL, serviceContext);
320    
321                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModel(returnValue);
322                    }
323                    catch (Exception e) {
324                            _log.error(e, e);
325    
326                            throw new RemoteException(e.getMessage());
327                    }
328            }
329    
330            /**
331            * Expires the web content article matching the group and article ID,
332            * expiring all of its versions if the
333            * <code>journal.article.expire.all.versions</code> portal property is
334            * <code>true</code>, otherwise expiring only its latest approved version.
335            *
336            * @param groupId the primary key of the web content article's group
337            * @param articleId the primary key of the web content article
338            * @param articleURL the web content article's accessible URL
339            * @param serviceContext the service context to be applied. Can set the
340            modification date, status date, portlet preferences, and can set
341            whether to add the default command update for the web content
342            article. With respect to social activities, by setting the
343            service context's command to {@link
344            com.liferay.portal.kernel.util.Constants#UPDATE}, the invocation
345            is considered a web content update activity; otherwise it is
346            considered a web content add activity.
347            * @throws PortalException if the user did not have permission to expire the
348            web content article, if a matching web content article could not
349            be found, or if a portal exception occurred
350            * @throws SystemException if a system exception occurred
351            */
352            public static void expireArticle(long groupId, java.lang.String articleId,
353                    java.lang.String articleURL,
354                    com.liferay.portal.service.ServiceContext serviceContext)
355                    throws RemoteException {
356                    try {
357                            JournalArticleServiceUtil.expireArticle(groupId, articleId,
358                                    articleURL, serviceContext);
359                    }
360                    catch (Exception e) {
361                            _log.error(e, e);
362    
363                            throw new RemoteException(e.getMessage());
364                    }
365            }
366    
367            /**
368            * Returns the web content article with the ID.
369            *
370            * @param id the primary key of the web content article
371            * @return the web content article with the ID
372            * @throws PortalException if a matching web content article could not be
373            found or if the user did not have permission to view the web
374            content article
375            * @throws SystemException if a system exception occurred
376            */
377            public static com.liferay.portlet.journal.model.JournalArticleSoap getArticle(
378                    long id) throws RemoteException {
379                    try {
380                            com.liferay.portlet.journal.model.JournalArticle returnValue = JournalArticleServiceUtil.getArticle(id);
381    
382                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModel(returnValue);
383                    }
384                    catch (Exception e) {
385                            _log.error(e, e);
386    
387                            throw new RemoteException(e.getMessage());
388                    }
389            }
390    
391            /**
392            * Returns the latest approved web content article, or the latest unapproved
393            * article if none are approved. Both approved and unapproved articles must
394            * match the group and article ID.
395            *
396            * @param groupId the primary key of the web content article's group
397            * @param articleId the primary key of the web content article
398            * @return the matching web content article
399            * @throws PortalException if the user did not have permission to view the
400            web content article or if a matching web content article could
401            not be found
402            * @throws SystemException if a system exception occurred
403            */
404            public static com.liferay.portlet.journal.model.JournalArticleSoap getArticle(
405                    long groupId, java.lang.String articleId) throws RemoteException {
406                    try {
407                            com.liferay.portlet.journal.model.JournalArticle returnValue = JournalArticleServiceUtil.getArticle(groupId,
408                                            articleId);
409    
410                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModel(returnValue);
411                    }
412                    catch (Exception e) {
413                            _log.error(e, e);
414    
415                            throw new RemoteException(e.getMessage());
416                    }
417            }
418    
419            /**
420            * Returns the web content article matching the group, article ID, and
421            * version.
422            *
423            * @param groupId the primary key of the web content article's group
424            * @param articleId the primary key of the web content article
425            * @param version the web content article's version
426            * @return the matching web content article
427            * @throws PortalException if the user did not have permission to view the
428            web content article or if a matching web content article could
429            not be found
430            * @throws SystemException if a system exception occurred
431            */
432            public static com.liferay.portlet.journal.model.JournalArticleSoap getArticle(
433                    long groupId, java.lang.String articleId, double version)
434                    throws RemoteException {
435                    try {
436                            com.liferay.portlet.journal.model.JournalArticle returnValue = JournalArticleServiceUtil.getArticle(groupId,
437                                            articleId, version);
438    
439                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModel(returnValue);
440                    }
441                    catch (Exception e) {
442                            _log.error(e, e);
443    
444                            throw new RemoteException(e.getMessage());
445                    }
446            }
447    
448            /**
449            * Returns the web content article matching the group, class name, and class
450            * PK.
451            *
452            * @param groupId the primary key of the web content article's group
453            * @param className the DDMStructure class name if the web content article
454            is related to a DDM structure, the primary key of the class name
455            associated with the article, or {@link
456            JournalArticleConstants#CLASSNAME_ID_DEFAULT} otherwise
457            * @param classPK the primary key of the DDM structure, if the the
458            DDMStructure class name is given as the <code>className</code>
459            parameter, the primary key of the class associated with the web
460            content article, or <code>0</code> otherwise
461            * @return the matching web content article
462            * @throws PortalException if a matching web content article could not be
463            found or if the user did not have permission to view the web
464            content article
465            * @throws SystemException if a system exception occurred
466            */
467            public static com.liferay.portlet.journal.model.JournalArticleSoap getArticle(
468                    long groupId, java.lang.String className, long classPK)
469                    throws RemoteException {
470                    try {
471                            com.liferay.portlet.journal.model.JournalArticle returnValue = JournalArticleServiceUtil.getArticle(groupId,
472                                            className, classPK);
473    
474                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModel(returnValue);
475                    }
476                    catch (Exception e) {
477                            _log.error(e, e);
478    
479                            throw new RemoteException(e.getMessage());
480                    }
481            }
482    
483            /**
484            * Returns the latest web content article that is approved, or the latest
485            * unapproved article if none are approved. Both approved and unapproved
486            * articles must match the group and URL title.
487            *
488            * @param groupId the primary key of the web content article's group
489            * @param urlTitle the web content article's accessible URL title
490            * @return the matching web content article
491            * @throws PortalException if the user did not have permission to view the
492            web content article or if a portal exception occurred
493            * @throws SystemException if a system exception occurred
494            */
495            public static com.liferay.portlet.journal.model.JournalArticleSoap getArticleByUrlTitle(
496                    long groupId, java.lang.String urlTitle) throws RemoteException {
497                    try {
498                            com.liferay.portlet.journal.model.JournalArticle returnValue = JournalArticleServiceUtil.getArticleByUrlTitle(groupId,
499                                            urlTitle);
500    
501                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModel(returnValue);
502                    }
503                    catch (Exception e) {
504                            _log.error(e, e);
505    
506                            throw new RemoteException(e.getMessage());
507                    }
508            }
509    
510            /**
511            * Returns all the web content articles matching the group and folder.
512            *
513            * @param groupId the primary key of the web content article's group
514            * @param folderId the primary key of the web content article folder
515            * @return the matching web content articles
516            * @throws SystemException if a system exception occurred
517            */
518            public static com.liferay.portlet.journal.model.JournalArticleSoap[] getArticles(
519                    long groupId, long folderId) throws RemoteException {
520                    try {
521                            java.util.List<com.liferay.portlet.journal.model.JournalArticle> returnValue =
522                                    JournalArticleServiceUtil.getArticles(groupId, folderId);
523    
524                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModels(returnValue);
525                    }
526                    catch (Exception e) {
527                            _log.error(e, e);
528    
529                            throw new RemoteException(e.getMessage());
530                    }
531            }
532    
533            /**
534            * Returns an ordered range of all the web content articles matching the
535            * group and folder.
536            *
537            * <p>
538            * Useful when paginating results. Returns a maximum of <code>end -
539            * start</code> instances. <code>start</code> and <code>end</code> are not
540            * primary keys, they are indexes in the result set. Thus, <code>0</code>
541            * refers to the first result in the set. Setting both <code>start</code>
542            * and <code>end</code> to {@link
543            * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full
544            * result set.
545            * </p>
546            *
547            * @param groupId the primary key of the web content article's group
548            * @param folderId the primary key of the web content article folder
549            * @param start the lower bound of the range of web content articles to
550            return
551            * @param end the upper bound of the range of web content articles to
552            return (not inclusive)
553            * @param obc the comparator to order the web content articles
554            * @return the matching web content articles
555            * @throws SystemException if a system exception occurred
556            */
557            public static com.liferay.portlet.journal.model.JournalArticleSoap[] getArticles(
558                    long groupId, long folderId, int start, int end,
559                    com.liferay.portal.kernel.util.OrderByComparator obc)
560                    throws RemoteException {
561                    try {
562                            java.util.List<com.liferay.portlet.journal.model.JournalArticle> returnValue =
563                                    JournalArticleServiceUtil.getArticles(groupId, folderId, start,
564                                            end, obc);
565    
566                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModels(returnValue);
567                    }
568                    catch (Exception e) {
569                            _log.error(e, e);
570    
571                            throw new RemoteException(e.getMessage());
572                    }
573            }
574    
575            /**
576            * Returns an ordered range of all the web content articles matching the
577            * group and article ID.
578            *
579            * <p>
580            * Useful when paginating results. Returns a maximum of <code>end -
581            * start</code> instances. <code>start</code> and <code>end</code> are not
582            * primary keys, they are indexes in the result set. Thus, <code>0</code>
583            * refers to the first result in the set. Setting both <code>start</code>
584            * and <code>end</code> to {@link
585            * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full
586            * result set.
587            * </p>
588            *
589            * @param groupId the primary key of the web content article's group
590            * @param articleId the primary key of the web content article
591            * @param start the lower bound of the range of web content articles to
592            return
593            * @param end the upper bound of the range of web content articles to
594            return (not inclusive)
595            * @param obc the comparator to order the web content articles
596            * @return the range of matching web content articles ordered by the
597            comparator
598            * @throws SystemException if a system exception occurred
599            */
600            public static com.liferay.portlet.journal.model.JournalArticleSoap[] getArticlesByArticleId(
601                    long groupId, java.lang.String articleId, int start, int end,
602                    com.liferay.portal.kernel.util.OrderByComparator obc)
603                    throws RemoteException {
604                    try {
605                            java.util.List<com.liferay.portlet.journal.model.JournalArticle> returnValue =
606                                    JournalArticleServiceUtil.getArticlesByArticleId(groupId,
607                                            articleId, start, end, obc);
608    
609                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModels(returnValue);
610                    }
611                    catch (Exception e) {
612                            _log.error(e, e);
613    
614                            throw new RemoteException(e.getMessage());
615                    }
616            }
617    
618            /**
619            * Returns all the web content articles matching the group and layout UUID.
620            *
621            * @param groupId the primary key of the web content article's group
622            * @param layoutUuid the unique string identifying the web content
623            article's display page
624            * @return the matching web content articles
625            * @throws SystemException if a system exception occurred
626            */
627            public static com.liferay.portlet.journal.model.JournalArticleSoap[] getArticlesByLayoutUuid(
628                    long groupId, java.lang.String layoutUuid) throws RemoteException {
629                    try {
630                            java.util.List<com.liferay.portlet.journal.model.JournalArticle> returnValue =
631                                    JournalArticleServiceUtil.getArticlesByLayoutUuid(groupId,
632                                            layoutUuid);
633    
634                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModels(returnValue);
635                    }
636                    catch (Exception e) {
637                            _log.error(e, e);
638    
639                            throw new RemoteException(e.getMessage());
640                    }
641            }
642    
643            /**
644            * Returns an ordered range of all the web content articles matching the
645            * group, class name ID, DDM structure key, and workflow status.
646            *
647            * <p>
648            * Useful when paginating results. Returns a maximum of <code>end -
649            * start</code> instances. <code>start</code> and <code>end</code> are not
650            * primary keys, they are indexes in the result set. Thus, <code>0</code>
651            * refers to the first result in the set. Setting both <code>start</code>
652            * and <code>end</code> to {@link
653            * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full
654            * result set.
655            * </p>
656            *
657            * @param groupId the primary key of the web content article's group
658            * @param classNameId the primary key of the DDMStructure class if the web
659            content article is related to a DDM structure, the primary key of
660            the class name associated with the article, or {@link
661            JournalArticleConstants#CLASSNAME_ID_DEFAULT} otherwise
662            * @param ddmStructureKey the primary key of the web content article's DDM
663            structure
664            * @param status the web content article's workflow status. For more
665            information see {@link WorkflowConstants} for constants starting
666            with the "STATUS_" prefix.
667            * @param start the lower bound of the range of web content articles to
668            return
669            * @param end the upper bound of the range of web content articles to
670            return (not inclusive)
671            * @param obc the comparator to order the web content articles
672            * @return the range of matching web content articles ordered by the
673            comparator
674            * @throws SystemException if a system exception occurred
675            */
676            public static com.liferay.portlet.journal.model.JournalArticleSoap[] getArticlesByStructureId(
677                    long groupId, long classNameId, java.lang.String ddmStructureKey,
678                    int status, int start, int end,
679                    com.liferay.portal.kernel.util.OrderByComparator obc)
680                    throws RemoteException {
681                    try {
682                            java.util.List<com.liferay.portlet.journal.model.JournalArticle> returnValue =
683                                    JournalArticleServiceUtil.getArticlesByStructureId(groupId,
684                                            classNameId, ddmStructureKey, status, start, end, obc);
685    
686                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModels(returnValue);
687                    }
688                    catch (Exception e) {
689                            _log.error(e, e);
690    
691                            throw new RemoteException(e.getMessage());
692                    }
693            }
694    
695            /**
696            * Returns an ordered range of all the web content articles matching the
697            * group, default class name ID, and DDM structure key.
698            *
699            * <p>
700            * Useful when paginating results. Returns a maximum of <code>end -
701            * start</code> instances. <code>start</code> and <code>end</code> are not
702            * primary keys, they are indexes in the result set. Thus, <code>0</code>
703            * refers to the first result in the set. Setting both <code>start</code>
704            * and <code>end</code> to {@link
705            * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full
706            * result set.
707            * </p>
708            *
709            * @param groupId the primary key of the web content article's group
710            * @param ddmStructureKey the primary key of the web content article's DDM
711            structure
712            * @param start the lower bound of the range of web content articles to
713            return
714            * @param end the upper bound of the range of web content articles to
715            return (not inclusive)
716            * @param obc the comparator to order the web content articles
717            * @return the range of matching web content articles ordered by the
718            comparator
719            * @throws SystemException if a system exception occurred
720            */
721            public static com.liferay.portlet.journal.model.JournalArticleSoap[] getArticlesByStructureId(
722                    long groupId, java.lang.String ddmStructureKey, int start, int end,
723                    com.liferay.portal.kernel.util.OrderByComparator obc)
724                    throws RemoteException {
725                    try {
726                            java.util.List<com.liferay.portlet.journal.model.JournalArticle> returnValue =
727                                    JournalArticleServiceUtil.getArticlesByStructureId(groupId,
728                                            ddmStructureKey, start, end, obc);
729    
730                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModels(returnValue);
731                    }
732                    catch (Exception e) {
733                            _log.error(e, e);
734    
735                            throw new RemoteException(e.getMessage());
736                    }
737            }
738    
739            /**
740            * Returns the number of web content articles matching the group and folder.
741            *
742            * @param groupId the primary key of the web content article's group
743            * @param folderId the primary key of the web content article folder
744            * @return the number of matching web content articles
745            * @throws SystemException if a system exception occurred
746            */
747            public static int getArticlesCount(long groupId, long folderId)
748                    throws RemoteException {
749                    try {
750                            int returnValue = JournalArticleServiceUtil.getArticlesCount(groupId,
751                                            folderId);
752    
753                            return returnValue;
754                    }
755                    catch (Exception e) {
756                            _log.error(e, e);
757    
758                            throw new RemoteException(e.getMessage());
759                    }
760            }
761    
762            /**
763            * Returns the number of web content articles matching the group and article
764            * ID.
765            *
766            * @param groupId the primary key of the web content article's group
767            * @param articleId the primary key of the web content article
768            * @return the number of matching web content articles
769            * @throws SystemException if a system exception occurred
770            */
771            public static int getArticlesCountByArticleId(long groupId,
772                    java.lang.String articleId) throws RemoteException {
773                    try {
774                            int returnValue = JournalArticleServiceUtil.getArticlesCountByArticleId(groupId,
775                                            articleId);
776    
777                            return returnValue;
778                    }
779                    catch (Exception e) {
780                            _log.error(e, e);
781    
782                            throw new RemoteException(e.getMessage());
783                    }
784            }
785    
786            /**
787            * Returns the number of web content articles matching the group, class name
788            * ID, DDM structure key, and workflow status.
789            *
790            * @param groupId the primary key of the web content article's group
791            * @param classNameId the primary key of the DDMStructure class if the web
792            content article is related to a DDM structure, the primary key of
793            the class name associated with the article, or {@link
794            JournalArticleConstants#CLASSNAME_ID_DEFAULT} otherwise
795            * @param ddmStructureKey the primary key of the web content article's DDM
796            structure
797            * @param status the web content article's workflow status. For more
798            information see {@link WorkflowConstants} for constants starting
799            with the "STATUS_" prefix.
800            * @return the number of matching web content articles
801            * @throws SystemException if a system exception occurred
802            */
803            public static int getArticlesCountByStructureId(long groupId,
804                    long classNameId, java.lang.String ddmStructureKey, int status)
805                    throws RemoteException {
806                    try {
807                            int returnValue = JournalArticleServiceUtil.getArticlesCountByStructureId(groupId,
808                                            classNameId, ddmStructureKey, status);
809    
810                            return returnValue;
811                    }
812                    catch (Exception e) {
813                            _log.error(e, e);
814    
815                            throw new RemoteException(e.getMessage());
816                    }
817            }
818    
819            /**
820            * Returns the number of web content articles matching the group, default
821            * class name ID, and DDM structure key.
822            *
823            * @param groupId the primary key of the web content article's group
824            * @param ddmStructureKey the primary key of the web content article's DDM
825            structure
826            * @return the number of matching web content articles
827            * @throws SystemException if a system exception occurred
828            */
829            public static int getArticlesCountByStructureId(long groupId,
830                    java.lang.String ddmStructureKey) throws RemoteException {
831                    try {
832                            int returnValue = JournalArticleServiceUtil.getArticlesCountByStructureId(groupId,
833                                            ddmStructureKey);
834    
835                            return returnValue;
836                    }
837                    catch (Exception e) {
838                            _log.error(e, e);
839    
840                            throw new RemoteException(e.getMessage());
841                    }
842            }
843    
844            /**
845            * Returns the web content article matching the URL title that is currently
846            * displayed or next to be displayed if no article is currently displayed.
847            *
848            * @param groupId the primary key of the web content article's group
849            * @param urlTitle the web content article's accessible URL title
850            * @return the web content article matching the URL title that is currently
851            displayed, or next one to be displayed if no version of the
852            article is currently displayed
853            * @throws PortalException if the user did not have permission to view the
854            web content article or if no approved matching web content
855            articles could be found
856            * @throws SystemException if a system exception occurred
857            */
858            public static com.liferay.portlet.journal.model.JournalArticleSoap getDisplayArticleByUrlTitle(
859                    long groupId, java.lang.String urlTitle) throws RemoteException {
860                    try {
861                            com.liferay.portlet.journal.model.JournalArticle returnValue = JournalArticleServiceUtil.getDisplayArticleByUrlTitle(groupId,
862                                            urlTitle);
863    
864                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModel(returnValue);
865                    }
866                    catch (Exception e) {
867                            _log.error(e, e);
868    
869                            throw new RemoteException(e.getMessage());
870                    }
871            }
872    
873            /**
874            * Returns the number of folders containing web content articles belonging
875            * to the group.
876            *
877            * @param groupId the primary key of the web content article's group
878            * @param folderIds the primary keys of the web content article folders
879            (optionally {@link java.util.Collections#EMPTY_LIST})
880            * @return the number of matching folders containing web content articles
881            * @throws SystemException if a system exception occurred
882            */
883            public static int getFoldersAndArticlesCount(long groupId, Long[] folderIds)
884                    throws RemoteException {
885                    try {
886                            int returnValue = JournalArticleServiceUtil.getFoldersAndArticlesCount(groupId,
887                                            ListUtil.toList(folderIds));
888    
889                            return returnValue;
890                    }
891                    catch (Exception e) {
892                            _log.error(e, e);
893    
894                            throw new RemoteException(e.getMessage());
895                    }
896            }
897    
898            /**
899            * Returns an ordered range of all the web content articles matching the
900            * group, user, the root folder or any of its subfolders.
901            *
902            * @param groupId the primary key of the web content article's group
903            * @param userId the primary key of the user (optionally <code>0</code>)
904            * @param rootFolderId the primary key of the root folder to begin the
905            search
906            * @param start the lower bound of the range of web content articles to
907            return
908            * @param end the upper bound of the range of web content articles to
909            return (not inclusive)
910            * @param orderByComparator the comparator to order the web content
911            articles
912            * @return the range of matching web content articles ordered by the
913            comparator
914            * @throws PortalException if the root folder could not be found, if the
915            current user did not have permission to view the root folder, or
916            if a portal exception occurred
917            * @throws SystemException if a system exception occurred
918            */
919            public static com.liferay.portlet.journal.model.JournalArticleSoap[] getGroupArticles(
920                    long groupId, long userId, long rootFolderId, int start, int end,
921                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
922                    throws RemoteException {
923                    try {
924                            java.util.List<com.liferay.portlet.journal.model.JournalArticle> returnValue =
925                                    JournalArticleServiceUtil.getGroupArticles(groupId, userId,
926                                            rootFolderId, start, end, orderByComparator);
927    
928                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModels(returnValue);
929                    }
930                    catch (Exception e) {
931                            _log.error(e, e);
932    
933                            throw new RemoteException(e.getMessage());
934                    }
935            }
936    
937            /**
938            * Returns the number of web content articles matching the group, user, and
939            * the root folder or any of its subfolders.
940            *
941            * @param groupId the primary key of the web content article's group
942            * @param userId the primary key of the user (optionally <code>0</code>)
943            * @param rootFolderId the primary key of the root folder to begin the
944            search
945            * @return the number of matching web content articles
946            * @throws PortalException if the root folder could not be found, if the
947            current user did not have permission to view the root folder, or
948            if a portal exception occurred
949            * @throws SystemException if a system exception occurred
950            */
951            public static int getGroupArticlesCount(long groupId, long userId,
952                    long rootFolderId) throws RemoteException {
953                    try {
954                            int returnValue = JournalArticleServiceUtil.getGroupArticlesCount(groupId,
955                                            userId, rootFolderId);
956    
957                            return returnValue;
958                    }
959                    catch (Exception e) {
960                            _log.error(e, e);
961    
962                            throw new RemoteException(e.getMessage());
963                    }
964            }
965    
966            /**
967            * Returns the latest web content article matching the resource primary key,
968            * preferring articles with approved workflow status.
969            *
970            * @param resourcePrimKey the primary key of the resource instance
971            * @return the latest web content article matching the resource primary key,
972            preferring articles with approved workflow status
973            * @throws PortalException if the user did not have permission to view the
974            web content article or if a matching web content article could
975            not be found
976            * @throws SystemException if a system exception occurred
977            */
978            public static com.liferay.portlet.journal.model.JournalArticleSoap getLatestArticle(
979                    long resourcePrimKey) throws RemoteException {
980                    try {
981                            com.liferay.portlet.journal.model.JournalArticle returnValue = JournalArticleServiceUtil.getLatestArticle(resourcePrimKey);
982    
983                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModel(returnValue);
984                    }
985                    catch (Exception e) {
986                            _log.error(e, e);
987    
988                            throw new RemoteException(e.getMessage());
989                    }
990            }
991    
992            /**
993            * Returns the latest web content article matching the group, article ID,
994            * and workflow status.
995            *
996            * @param groupId the primary key of the web content article's group
997            * @param articleId the primary key of the web content article
998            * @param status the web content article's workflow status. For more
999            information see {@link WorkflowConstants} for constants starting
1000            with the "STATUS_" prefix.
1001            * @return the latest matching web content article
1002            * @throws PortalException if the user did not have permission to view the
1003            web content article or if a matching web content article could
1004            not be found
1005            * @throws SystemException if a system exception occurred
1006            */
1007            public static com.liferay.portlet.journal.model.JournalArticleSoap getLatestArticle(
1008                    long groupId, java.lang.String articleId, int status)
1009                    throws RemoteException {
1010                    try {
1011                            com.liferay.portlet.journal.model.JournalArticle returnValue = JournalArticleServiceUtil.getLatestArticle(groupId,
1012                                            articleId, status);
1013    
1014                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModel(returnValue);
1015                    }
1016                    catch (Exception e) {
1017                            _log.error(e, e);
1018    
1019                            throw new RemoteException(e.getMessage());
1020                    }
1021            }
1022    
1023            /**
1024            * Returns the latest web content article matching the group, class name ID,
1025            * and class PK.
1026            *
1027            * @param groupId the primary key of the web content article's group
1028            * @param className the DDMStructure class name if the web content article
1029            is related to a DDM structure, the class name associated with the
1030            article, or {@link JournalArticleConstants#CLASSNAME_ID_DEFAULT}
1031            otherwise
1032            * @param classPK the primary key of the DDM structure, if the DDMStructure
1033            class name is given as the <code>className</code> parameter, the
1034            primary key of the class associated with the web content article,
1035            or <code>0</code> otherwise
1036            * @return the latest matching web content article
1037            * @throws PortalException if a matching web content article could not be
1038            found or if the user did not have permission to view the web
1039            content article
1040            * @throws SystemException if a system exception occurred
1041            */
1042            public static com.liferay.portlet.journal.model.JournalArticleSoap getLatestArticle(
1043                    long groupId, java.lang.String className, long classPK)
1044                    throws RemoteException {
1045                    try {
1046                            com.liferay.portlet.journal.model.JournalArticle returnValue = JournalArticleServiceUtil.getLatestArticle(groupId,
1047                                            className, classPK);
1048    
1049                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModel(returnValue);
1050                    }
1051                    catch (Exception e) {
1052                            _log.error(e, e);
1053    
1054                            throw new RemoteException(e.getMessage());
1055                    }
1056            }
1057    
1058            /**
1059            * Moves all versions of the the web content article matching the group and
1060            * article ID to the folder.
1061            *
1062            * @param groupId the primary key of the web content article's group
1063            * @param articleId the primary key of the web content article
1064            * @param newFolderId the primary key of the web content article's new
1065            folder
1066            * @throws PortalException if the user did not have permission to update any
1067            one of the versions of the web content article or if any one of
1068            the versions of the web content article could not be moved to the
1069            folder
1070            * @throws SystemException if a system exception occurred
1071            */
1072            public static void moveArticle(long groupId, java.lang.String articleId,
1073                    long newFolderId) throws RemoteException {
1074                    try {
1075                            JournalArticleServiceUtil.moveArticle(groupId, articleId,
1076                                    newFolderId);
1077                    }
1078                    catch (Exception e) {
1079                            _log.error(e, e);
1080    
1081                            throw new RemoteException(e.getMessage());
1082                    }
1083            }
1084    
1085            /**
1086            * Moves the web content article from the Recycle Bin to the folder.
1087            *
1088            * @param groupId the primary key of the web content article's group
1089            * @param resourcePrimKey the primary key of the resource instance
1090            * @param newFolderId the primary key of the web content article's new
1091            folder
1092            * @param serviceContext the service context to be applied. Can set the
1093            modification date, portlet preferences, and can set whether to
1094            add the default command update for the web content article. With
1095            respect to social activities, by setting the service context's
1096            command to {@link
1097            com.liferay.portal.kernel.util.Constants#UPDATE}, the invocation
1098            is considered a web content update activity; otherwise it is
1099            considered a web content add activity.
1100            * @return the updated web content article, which was moved from the Recycle
1101            Bin to the folder
1102            * @throws PortalException if the user did not have permission to view or
1103            update the web content article, if a matching trashed web content
1104            article could not be found, or if a portal exception occurred
1105            * @throws SystemException if a system exception occurred
1106            */
1107            public static com.liferay.portlet.journal.model.JournalArticleSoap moveArticleFromTrash(
1108                    long groupId, long resourcePrimKey, long newFolderId,
1109                    com.liferay.portal.service.ServiceContext serviceContext)
1110                    throws RemoteException {
1111                    try {
1112                            com.liferay.portlet.journal.model.JournalArticle returnValue = JournalArticleServiceUtil.moveArticleFromTrash(groupId,
1113                                            resourcePrimKey, newFolderId, serviceContext);
1114    
1115                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModel(returnValue);
1116                    }
1117                    catch (Exception e) {
1118                            _log.error(e, e);
1119    
1120                            throw new RemoteException(e.getMessage());
1121                    }
1122            }
1123    
1124            /**
1125            * Moves the web content article from the Recycle Bin to the folder.
1126            *
1127            * @param groupId the primary key of the web content article's group
1128            * @param articleId the primary key of the web content article
1129            * @param newFolderId the primary key of the web content article's new
1130            folder
1131            * @param serviceContext the service context to be applied. Can set the
1132            modification date, portlet preferences, and can set whether to
1133            add the default command update for the web content article. With
1134            respect to social activities, by setting the service context's
1135            command to {@link
1136            com.liferay.portal.kernel.util.Constants#UPDATE}, the invocation
1137            is considered a web content update activity; otherwise it is
1138            considered a web content add activity.
1139            * @return the updated web content article, which was moved from the Recycle
1140            Bin to the folder
1141            * @throws PortalException if the user did not have permission to view or
1142            update the web content article, if a trashed web content article
1143            with the primary key could not be found, or if a portal exception
1144            occurred
1145            * @throws SystemException if a system exception occurred
1146            */
1147            public static com.liferay.portlet.journal.model.JournalArticleSoap moveArticleFromTrash(
1148                    long groupId, java.lang.String articleId, long newFolderId,
1149                    com.liferay.portal.service.ServiceContext serviceContext)
1150                    throws RemoteException {
1151                    try {
1152                            com.liferay.portlet.journal.model.JournalArticle returnValue = JournalArticleServiceUtil.moveArticleFromTrash(groupId,
1153                                            articleId, newFolderId, serviceContext);
1154    
1155                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModel(returnValue);
1156                    }
1157                    catch (Exception e) {
1158                            _log.error(e, e);
1159    
1160                            throw new RemoteException(e.getMessage());
1161                    }
1162            }
1163    
1164            /**
1165            * Moves the latest version of the web content article matching the group
1166            * and article ID to the recycle bin.
1167            *
1168            * @param groupId the primary key of the web content article's group
1169            * @param articleId the primary key of the web content article
1170            * @return the moved web content article or <code>null</code> if no matching
1171            article was found
1172            * @throws PortalException if the user did not have permission to move the
1173            article to the Recycle Bin or if a portal exception occurred
1174            * @throws SystemException if a system exception occurred
1175            */
1176            public static com.liferay.portlet.journal.model.JournalArticleSoap moveArticleToTrash(
1177                    long groupId, java.lang.String articleId) throws RemoteException {
1178                    try {
1179                            com.liferay.portlet.journal.model.JournalArticle returnValue = JournalArticleServiceUtil.moveArticleToTrash(groupId,
1180                                            articleId);
1181    
1182                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModel(returnValue);
1183                    }
1184                    catch (Exception e) {
1185                            _log.error(e, e);
1186    
1187                            throw new RemoteException(e.getMessage());
1188                    }
1189            }
1190    
1191            /**
1192            * Removes the web content of all the company's web content articles
1193            * matching the language.
1194            *
1195            * @param companyId the primary key of the web content article's company
1196            * @param languageId the primary key of the language locale to remove
1197            * @throws PortalException if the user did not have permission to update any
1198            one of the the web content articles or if web content matching
1199            the language could not be found for any one of the articles
1200            * @throws SystemException if a system exception occurred
1201            */
1202            public static void removeArticleLocale(long companyId,
1203                    java.lang.String languageId) throws RemoteException {
1204                    try {
1205                            JournalArticleServiceUtil.removeArticleLocale(companyId, languageId);
1206                    }
1207                    catch (Exception e) {
1208                            _log.error(e, e);
1209    
1210                            throw new RemoteException(e.getMessage());
1211                    }
1212            }
1213    
1214            /**
1215            * Removes the web content of the web content article matching the group,
1216            * article ID, and version, and language.
1217            *
1218            * @param groupId the primary key of the web content article's group
1219            * @param articleId the primary key of the web content article
1220            * @param version the web content article's version
1221            * @param languageId the primary key of the language locale to remove
1222            * @return the updated web content article with the locale removed
1223            * @throws PortalException if the user did not have permission to update the
1224            web content article or if a matching web content article could
1225            not be found
1226            * @throws SystemException if a system exception occurred
1227            */
1228            public static com.liferay.portlet.journal.model.JournalArticleSoap removeArticleLocale(
1229                    long groupId, java.lang.String articleId, double version,
1230                    java.lang.String languageId) throws RemoteException {
1231                    try {
1232                            com.liferay.portlet.journal.model.JournalArticle returnValue = JournalArticleServiceUtil.removeArticleLocale(groupId,
1233                                            articleId, version, languageId);
1234    
1235                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModel(returnValue);
1236                    }
1237                    catch (Exception e) {
1238                            _log.error(e, e);
1239    
1240                            throw new RemoteException(e.getMessage());
1241                    }
1242            }
1243    
1244            /**
1245            * Restores the web content article associated with the resource primary key
1246            * from the Recycle Bin.
1247            *
1248            * @param resourcePrimKey the primary key of the resource instance
1249            * @throws PortalException if a matching web content article could not be
1250            found in the Recycle Bin, if the user did not have permission to
1251            view or restore the article, or if a portal exception occurred
1252            * @throws SystemException if a system exception occurred
1253            */
1254            public static void restoreArticleFromTrash(long resourcePrimKey)
1255                    throws RemoteException {
1256                    try {
1257                            JournalArticleServiceUtil.restoreArticleFromTrash(resourcePrimKey);
1258                    }
1259                    catch (Exception e) {
1260                            _log.error(e, e);
1261    
1262                            throw new RemoteException(e.getMessage());
1263                    }
1264            }
1265    
1266            /**
1267            * Restores the web content article from the Recycle Bin.
1268            *
1269            * @param groupId the primary key of the web content article's group
1270            * @param articleId the primary key of the web content article
1271            * @throws PortalException if the web content article with the primary key
1272            could not be found in the Recycle Bin, if the user did not have
1273            permission to restore the article, or if a portal exception
1274            occurred
1275            * @throws SystemException if a system exception occurred
1276            */
1277            public static void restoreArticleFromTrash(long groupId,
1278                    java.lang.String articleId) throws RemoteException {
1279                    try {
1280                            JournalArticleServiceUtil.restoreArticleFromTrash(groupId, articleId);
1281                    }
1282                    catch (Exception e) {
1283                            _log.error(e, e);
1284    
1285                            throw new RemoteException(e.getMessage());
1286                    }
1287            }
1288    
1289            /**
1290            * Returns an ordered range of all the web content articles matching the
1291            * parameters, including a keywords parameter for matching with the
1292            * article's ID, title, description, and content, a DDM structure key
1293            * parameter, and a DDM template key parameter.
1294            *
1295            * <p>
1296            * Useful when paginating results. Returns a maximum of <code>end -
1297            * start</code> instances. <code>start</code> and <code>end</code> are not
1298            * primary keys, they are indexes in the result set. Thus, <code>0</code>
1299            * refers to the first result in the set. Setting both <code>start</code>
1300            * and <code>end</code> to {@link
1301            * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full
1302            * result set.
1303            * </p>
1304            *
1305            * @param companyId the primary key of the web content article's company
1306            * @param groupId the primary key of the group (optionally <code>0</code>)
1307            * @param folderIds the primary keys of the web content article folders
1308            (optionally {@link java.util.Collections#EMPTY_LIST})
1309            * @param classNameId the primary key of the DDMStructure class if the web
1310            content article is related to a DDM structure, the primary key of
1311            the class name associated with the article, or {@link
1312            JournalArticleConstants#CLASSNAME_ID_DEFAULT} otherwise
1313            * @param keywords the keywords (space separated), which may occur in the
1314            web content article ID, title, description, or content
1315            (optionally <code>null</code>). If the keywords value is not
1316            <code>null</code>, the search uses the OR operator in connecting
1317            query criteria; otherwise it uses the AND operator.
1318            * @param version the web content article's version (optionally
1319            <code>null</code>)
1320            * @param type the web content article's type (optionally
1321            <code>null</code>)
1322            * @param ddmStructureKey the primary key of the web content article's DDM
1323            structure, if the article is related to a DDM structure, or
1324            <code>null</code> otherwise
1325            * @param ddmTemplateKey the primary key of the web content article's DDM
1326            template (optionally <code>null</code>). If the article is
1327            related to a DDM structure, the template's structure must match
1328            it.
1329            * @param displayDateGT the date after which a matching web content
1330            article's display date must be after (optionally
1331            <code>null</code>)
1332            * @param displayDateLT the date before which a matching web content
1333            article's display date must be before (optionally
1334            <code>null</code>)
1335            * @param status the web content article's workflow status. For more
1336            information see {@link WorkflowConstants} for constants starting
1337            with the "STATUS_" prefix.
1338            * @param reviewDate the web content article's scheduled review date
1339            (optionally <code>null</code>)
1340            * @param start the lower bound of the range of web content articles to
1341            return
1342            * @param end the upper bound of the range of web content articles to
1343            return (not inclusive)
1344            * @param obc the comparator to order the web content articles
1345            * @return the range of matching web content articles ordered by the
1346            comparator
1347            * @throws SystemException if a system exception occurred
1348            */
1349            public static com.liferay.portlet.journal.model.JournalArticleSoap[] search(
1350                    long companyId, long groupId, Long[] folderIds, long classNameId,
1351                    java.lang.String keywords, java.lang.Double version,
1352                    java.lang.String type, java.lang.String ddmStructureKey,
1353                    java.lang.String ddmTemplateKey, java.util.Date displayDateGT,
1354                    java.util.Date displayDateLT, int status, java.util.Date reviewDate,
1355                    int start, int end, com.liferay.portal.kernel.util.OrderByComparator obc)
1356                    throws RemoteException {
1357                    try {
1358                            java.util.List<com.liferay.portlet.journal.model.JournalArticle> returnValue =
1359                                    JournalArticleServiceUtil.search(companyId, groupId,
1360                                            ListUtil.toList(folderIds), classNameId, keywords, version,
1361                                            type, ddmStructureKey, ddmTemplateKey, displayDateGT,
1362                                            displayDateLT, status, reviewDate, start, end, obc);
1363    
1364                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModels(returnValue);
1365                    }
1366                    catch (Exception e) {
1367                            _log.error(e, e);
1368    
1369                            throw new RemoteException(e.getMessage());
1370                    }
1371            }
1372    
1373            /**
1374            * Returns an ordered range of all the web content articles matching the
1375            * parameters, including keyword parameters for article ID, title,
1376            * description, and content, a DDM structure key parameter, a DDM template
1377            * key parameter, and an AND operator switch.
1378            *
1379            * <p>
1380            * Useful when paginating results. Returns a maximum of <code>end -
1381            * start</code> instances. <code>start</code> and <code>end</code> are not
1382            * primary keys, they are indexes in the result set. Thus, <code>0</code>
1383            * refers to the first result in the set. Setting both <code>start</code>
1384            * and <code>end</code> to {@link
1385            * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full
1386            * result set.
1387            * </p>
1388            *
1389            * @param companyId the primary key of the web content article's company
1390            * @param groupId the primary key of the group (optionally <code>0</code>)
1391            * @param folderIds the primary keys of the web content article folders
1392            (optionally {@link java.util.Collections#EMPTY_LIST})
1393            * @param classNameId the primary key of the DDMStructure class if the web
1394            content article is related to a DDM structure, the primary key of
1395            the class name associated with the article, or {@link
1396            JournalArticleConstants#CLASSNAME_ID_DEFAULT} otherwise
1397            * @param articleId the article ID keywords (space separated, optionally
1398            <code>null</code>)
1399            * @param version the web content article's version (optionally
1400            <code>null</code>)
1401            * @param title the title keywords (space separated, optionally
1402            <code>null</code>)
1403            * @param description the description keywords (space separated, optionally
1404            <code>null</code>)
1405            * @param content the content keywords (space separated, optionally
1406            <code>null</code>)
1407            * @param type the web content article's type (optionally
1408            <code>null</code>)
1409            * @param ddmStructureKey the primary key of the web content article's DDM
1410            structure, if the article is related to a DDM structure, or
1411            <code>null</code> otherwise
1412            * @param ddmTemplateKey the primary key of the web content article's DDM
1413            template (optionally <code>null</code>). If the article is
1414            related to a DDM structure, the template's structure must match
1415            it.
1416            * @param displayDateGT the date after which a matching web content
1417            article's display date must be after (optionally
1418            <code>null</code>)
1419            * @param displayDateLT the date before which a matching web content
1420            article's display date must be before (optionally
1421            <code>null</code>)
1422            * @param status the web content article's workflow status. For more
1423            information see {@link WorkflowConstants} for constants starting
1424            with the "STATUS_" prefix.
1425            * @param reviewDate the web content article's scheduled review date
1426            (optionally <code>null</code>)
1427            * @param andOperator whether every field must match its value or keywords,
1428            or just one field must match. Company, group, folder IDs, class
1429            name ID, and status must all match their values.
1430            * @param start the lower bound of the range of web content articles to
1431            return
1432            * @param end the upper bound of the range of web content articles to
1433            return (not inclusive)
1434            * @param obc the comparator to order the web content articles
1435            * @return the range of matching web content articles ordered by the
1436            comparator
1437            * @throws SystemException if a system exception occurred
1438            */
1439            public static com.liferay.portlet.journal.model.JournalArticleSoap[] search(
1440                    long companyId, long groupId, Long[] folderIds, long classNameId,
1441                    java.lang.String articleId, java.lang.Double version,
1442                    java.lang.String title, java.lang.String description,
1443                    java.lang.String content, java.lang.String type,
1444                    java.lang.String ddmStructureKey, java.lang.String ddmTemplateKey,
1445                    java.util.Date displayDateGT, java.util.Date displayDateLT, int status,
1446                    java.util.Date reviewDate, boolean andOperator, int start, int end,
1447                    com.liferay.portal.kernel.util.OrderByComparator obc)
1448                    throws RemoteException {
1449                    try {
1450                            java.util.List<com.liferay.portlet.journal.model.JournalArticle> returnValue =
1451                                    JournalArticleServiceUtil.search(companyId, groupId,
1452                                            ListUtil.toList(folderIds), classNameId, articleId,
1453                                            version, title, description, content, type,
1454                                            ddmStructureKey, ddmTemplateKey, displayDateGT,
1455                                            displayDateLT, status, reviewDate, andOperator, start, end,
1456                                            obc);
1457    
1458                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModels(returnValue);
1459                    }
1460                    catch (Exception e) {
1461                            _log.error(e, e);
1462    
1463                            throw new RemoteException(e.getMessage());
1464                    }
1465            }
1466    
1467            /**
1468            * Returns an ordered range of all the web content articles matching the
1469            * parameters, including keyword parameters for article ID, title,
1470            * description, and content, a DDM structure keys (plural) parameter, a DDM
1471            * template keys (plural) parameter, and an AND operator switch.
1472            *
1473            * <p>
1474            * Useful when paginating results. Returns a maximum of <code>end -
1475            * start</code> instances. <code>start</code> and <code>end</code> are not
1476            * primary keys, they are indexes in the result set. Thus, <code>0</code>
1477            * refers to the first result in the set. Setting both <code>start</code>
1478            * and <code>end</code> to {@link
1479            * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full
1480            * result set.
1481            * </p>
1482            *
1483            * @param companyId the primary key of the web content article's company
1484            * @param groupId the primary key of the group (optionally <code>0</code>)
1485            * @param folderIds the primary keys of the web content article folders
1486            (optionally {@link java.util.Collections#EMPTY_LIST})
1487            * @param classNameId the primary key of the DDMStructure class if the web
1488            content article is related to a DDM structure, the primary key of
1489            the class name associated with the article, or {@link
1490            JournalArticleConstants#CLASSNAME_ID_DEFAULT} otherwise
1491            * @param articleId the article ID keywords (space separated, optionally
1492            <code>null</code>)
1493            * @param version the web content article's version (optionally
1494            <code>null</code>)
1495            * @param title the title keywords (space separated, optionally
1496            <code>null</code>)
1497            * @param description the description keywords (space separated, optionally
1498            <code>null</code>)
1499            * @param content the content keywords (space separated, optionally
1500            <code>null</code>)
1501            * @param type the web content article's type (optionally
1502            <code>null</code>)
1503            * @param ddmStructureKeys the primary keys of the web content article's
1504            DDM structures, if the article is related to a DDM structure, or
1505            <code>null</code> otherwise
1506            * @param ddmTemplateKeys the primary keys of the web content article's DDM
1507            templates (originally <code>null</code>). If the articles are
1508            related to a DDM structure, the template's structure must match
1509            it.
1510            * @param displayDateGT the date after which a matching web content
1511            article's display date must be after (optionally
1512            <code>null</code>)
1513            * @param displayDateLT the date before which a matching web content
1514            article's display date must be before (optionally
1515            <code>null</code>)
1516            * @param status the web content article's workflow status. For more
1517            information see {@link WorkflowConstants} for constants starting
1518            with the "STATUS_" prefix.
1519            * @param reviewDate the web content article's scheduled review date
1520            (optionally <code>null</code>)
1521            * @param andOperator whether every field must match its value or keywords,
1522            or just one field must match.  Company, group, folder IDs, class
1523            name ID, and status must all match their values.
1524            * @param start the lower bound of the range of web content articles to
1525            return
1526            * @param end the upper bound of the range of web content articles to
1527            return (not inclusive)
1528            * @param obc the comparator to order the web content articles
1529            * @return the range of matching web content articles ordered by the
1530            comparator
1531            * @throws SystemException if a system exception occurred
1532            */
1533            public static com.liferay.portlet.journal.model.JournalArticleSoap[] search(
1534                    long companyId, long groupId, Long[] folderIds, long classNameId,
1535                    java.lang.String articleId, java.lang.Double version,
1536                    java.lang.String title, java.lang.String description,
1537                    java.lang.String content, java.lang.String type,
1538                    java.lang.String[] ddmStructureKeys,
1539                    java.lang.String[] ddmTemplateKeys, java.util.Date displayDateGT,
1540                    java.util.Date displayDateLT, int status, java.util.Date reviewDate,
1541                    boolean andOperator, int start, int end,
1542                    com.liferay.portal.kernel.util.OrderByComparator obc)
1543                    throws RemoteException {
1544                    try {
1545                            java.util.List<com.liferay.portlet.journal.model.JournalArticle> returnValue =
1546                                    JournalArticleServiceUtil.search(companyId, groupId,
1547                                            ListUtil.toList(folderIds), classNameId, articleId,
1548                                            version, title, description, content, type,
1549                                            ddmStructureKeys, ddmTemplateKeys, displayDateGT,
1550                                            displayDateLT, status, reviewDate, andOperator, start, end,
1551                                            obc);
1552    
1553                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModels(returnValue);
1554                    }
1555                    catch (Exception e) {
1556                            _log.error(e, e);
1557    
1558                            throw new RemoteException(e.getMessage());
1559                    }
1560            }
1561    
1562            /**
1563            * Returns the number of web content articles matching the parameters,
1564            * including a keywords parameter for matching with the article's ID, title,
1565            * description, and content, a DDM structure key parameter, and a DDM
1566            * template key parameter.
1567            *
1568            * @param companyId the primary key of the web content article's company
1569            * @param groupId the primary key of the group (optionally <code>0</code>)
1570            * @param folderIds the primary keys of the web content article folders
1571            (optionally {@link java.util.Collections#EMPTY_LIST})
1572            * @param classNameId the primary key of the DDMStructure class if the web
1573            content article is related to a DDM structure, the primary key of
1574            the class name associated with the article, or {@link
1575            JournalArticleConstants#CLASSNAME_ID_DEFAULT} otherwise
1576            * @param keywords the keywords (space separated), which may occur in the
1577            web content article ID, title, description, or content
1578            (optionally <code>null</code>). If the keywords value is not
1579            <code>null</code>, the search uses the OR operator in connecting
1580            query criteria; otherwise it uses the AND operator.
1581            * @param version the web content article's version (optionally
1582            <code>null</code>)
1583            * @param type the web content article's type (optionally
1584            <code>null</code>)
1585            * @param ddmStructureKey the primary key of the web content article's DDM
1586            structure, if the article is related to a DDM structure, or
1587            <code>null</code> otherwise
1588            * @param ddmTemplateKey the primary key of the web content article's DDM
1589            template (optionally <code>null</code>). If the article is
1590            related to a DDM structure, the template's structure must match
1591            it.
1592            * @param displayDateGT the date after which a matching web content
1593            article's display date must be after (optionally
1594            <code>null</code>)
1595            * @param displayDateLT the date before which a matching web content
1596            article's display date must be before (optionally
1597            <code>null</code>)
1598            * @param status the web content article's workflow status. For more
1599            information see {@link WorkflowConstants} for constants starting
1600            with the "STATUS_" prefix.
1601            * @param reviewDate the web content article's scheduled review date
1602            (optionally <code>null</code>)
1603            * @return the number of matching web content articles
1604            * @throws SystemException if a system exception occurred
1605            */
1606            public static int searchCount(long companyId, long groupId,
1607                    Long[] folderIds, long classNameId, java.lang.String keywords,
1608                    java.lang.Double version, java.lang.String type,
1609                    java.lang.String ddmStructureKey, java.lang.String ddmTemplateKey,
1610                    java.util.Date displayDateGT, java.util.Date displayDateLT, int status,
1611                    java.util.Date reviewDate) throws RemoteException {
1612                    try {
1613                            int returnValue = JournalArticleServiceUtil.searchCount(companyId,
1614                                            groupId, ListUtil.toList(folderIds), classNameId, keywords,
1615                                            version, type, ddmStructureKey, ddmTemplateKey,
1616                                            displayDateGT, displayDateLT, status, reviewDate);
1617    
1618                            return returnValue;
1619                    }
1620                    catch (Exception e) {
1621                            _log.error(e, e);
1622    
1623                            throw new RemoteException(e.getMessage());
1624                    }
1625            }
1626    
1627            /**
1628            * Returns the number of web content articles matching the parameters,
1629            * including keyword parameters for article ID, title, description, and
1630            * content, a DDM structure key parameter, a DDM template key parameter, and
1631            * an AND operator switch.
1632            *
1633            * @param companyId the primary key of the web content article's company
1634            * @param groupId the primary key of the group (optionally <code>0</code>)
1635            * @param folderIds the primary keys of the web content article folders
1636            (optionally {@link java.util.Collections#EMPTY_LIST})
1637            * @param classNameId the primary key of the DDMStructure class if the web
1638            content article is related to a DDM structure, the primary key of
1639            the class name associated with the article, or {@link
1640            JournalArticleConstants#CLASSNAME_ID_DEFAULT} otherwise
1641            * @param articleId the article ID keywords (space separated, optionally
1642            <code>null</code>)
1643            * @param version the web content article's version (optionally
1644            <code>null</code>)
1645            * @param title the title keywords (space separated, optionally
1646            <code>null</code>)
1647            * @param description the description keywords (space separated, optionally
1648            <code>null</code>)
1649            * @param content the content keywords (space separated, optionally
1650            <code>null</code>)
1651            * @param type the web content article's type (optionally
1652            <code>null</code>)
1653            * @param ddmStructureKey the primary key of the web content article's DDM
1654            structure, if the article is related to a DDM structure, or
1655            <code>null</code> otherwise
1656            * @param ddmTemplateKey the primary key of the web content article's DDM
1657            template (optionally <code>null</code>). If the article is
1658            related to a DDM structure, the template's structure must match
1659            it.
1660            * @param displayDateGT the date after which a matching web content
1661            article's display date must be after (optionally
1662            <code>null</code>)
1663            * @param displayDateLT the date before which a matching web content
1664            article's display date must be before (optionally
1665            <code>null</code>)
1666            * @param status the web content article's workflow status. For more
1667            information see {@link WorkflowConstants} for constants starting
1668            with the "STATUS_" prefix.
1669            * @param reviewDate the web content article's scheduled review date
1670            (optionally <code>null</code>)
1671            * @param andOperator whether every field must match its value or keywords,
1672            or just one field must match. Group, folder IDs, class name ID,
1673            and status must all match their values.
1674            * @return the number of matching web content articles
1675            * @throws SystemException if a system exception occurred
1676            */
1677            public static int searchCount(long companyId, long groupId,
1678                    Long[] folderIds, long classNameId, java.lang.String articleId,
1679                    java.lang.Double version, java.lang.String title,
1680                    java.lang.String description, java.lang.String content,
1681                    java.lang.String type, java.lang.String ddmStructureKey,
1682                    java.lang.String ddmTemplateKey, java.util.Date displayDateGT,
1683                    java.util.Date displayDateLT, int status, java.util.Date reviewDate,
1684                    boolean andOperator) throws RemoteException {
1685                    try {
1686                            int returnValue = JournalArticleServiceUtil.searchCount(companyId,
1687                                            groupId, ListUtil.toList(folderIds), classNameId,
1688                                            articleId, version, title, description, content, type,
1689                                            ddmStructureKey, ddmTemplateKey, displayDateGT,
1690                                            displayDateLT, status, reviewDate, andOperator);
1691    
1692                            return returnValue;
1693                    }
1694                    catch (Exception e) {
1695                            _log.error(e, e);
1696    
1697                            throw new RemoteException(e.getMessage());
1698                    }
1699            }
1700    
1701            /**
1702            * Returns the number of web content articles matching the parameters,
1703            * including keyword parameters for article ID, title, description, and
1704            * content, a DDM structure keys (plural) parameter, a DDM template keys
1705            * (plural) parameter, and an AND operator switch.
1706            *
1707            * @param companyId the primary key of the web content article's company
1708            * @param groupId the primary key of the group (optionally <code>0</code>)
1709            * @param folderIds the primary keys of the web content article folders
1710            (optionally {@link java.util.Collections#EMPTY_LIST})
1711            * @param classNameId the primary key of the DDMStructure class if the web
1712            content article is related to a DDM structure, the primary key of
1713            the class name associated with the article, or {@link
1714            JournalArticleConstants#CLASSNAME_ID_DEFAULT} otherwise
1715            * @param articleId the article ID keywords (space separated, optionally
1716            <code>null</code>)
1717            * @param version the web content article's version (optionally
1718            <code>null</code>)
1719            * @param title the title keywords (space separated, optionally
1720            <code>null</code>)
1721            * @param description the description keywords (space separated, optionally
1722            <code>null</code>)
1723            * @param content the content keywords (space separated, optionally
1724            <code>null</code>)
1725            * @param type the web content article's type (optionally
1726            <code>null</code>)
1727            * @param ddmStructureKeys the primary keys of the web content article's
1728            DDM structures, if the article is related to a DDM structure, or
1729            <code>null</code> otherwise
1730            * @param ddmTemplateKeys the primary keys of the web content article's DDM
1731            templates (originally <code>null</code>). If the articles are
1732            related to a DDM structure, the template's structure must match
1733            it.
1734            * @param displayDateGT the date after which a matching web content
1735            article's display date must be after (optionally
1736            <code>null</code>)
1737            * @param displayDateLT the date before which a matching web content
1738            article's display date must be before (optionally
1739            <code>null</code>)
1740            * @param status the web content article's workflow status. For more
1741            information see {@link WorkflowConstants} for constants starting
1742            with the "STATUS_" prefix.
1743            * @param reviewDate the web content article's scheduled review date
1744            (optionally <code>null</code>)
1745            * @param andOperator whether every field must match its value or keywords,
1746            or just one field must match.  Group, folder IDs, class name ID,
1747            and status must all match their values.
1748            * @return the number of matching web content articles
1749            * @throws SystemException if a system exception occurred
1750            */
1751            public static int searchCount(long companyId, long groupId,
1752                    Long[] folderIds, long classNameId, java.lang.String articleId,
1753                    java.lang.Double version, java.lang.String title,
1754                    java.lang.String description, java.lang.String content,
1755                    java.lang.String type, java.lang.String[] ddmStructureKeys,
1756                    java.lang.String[] ddmTemplateKeys, java.util.Date displayDateGT,
1757                    java.util.Date displayDateLT, int status, java.util.Date reviewDate,
1758                    boolean andOperator) throws RemoteException {
1759                    try {
1760                            int returnValue = JournalArticleServiceUtil.searchCount(companyId,
1761                                            groupId, ListUtil.toList(folderIds), classNameId,
1762                                            articleId, version, title, description, content, type,
1763                                            ddmStructureKeys, ddmTemplateKeys, displayDateGT,
1764                                            displayDateLT, status, reviewDate, andOperator);
1765    
1766                            return returnValue;
1767                    }
1768                    catch (Exception e) {
1769                            _log.error(e, e);
1770    
1771                            throw new RemoteException(e.getMessage());
1772                    }
1773            }
1774    
1775            /**
1776            * Subscribes the user to notifications for the web content article matching
1777            * the group, notifying him the instant versions of the article are created,
1778            * deleted, or modified.
1779            *
1780            * @param groupId the primary key of the group
1781            * @throws PortalException if the user did not have permission to subscribe
1782            to the web content article or if a matching user or group could
1783            not be found
1784            * @throws SystemException if a system exception occurred
1785            */
1786            public static void subscribe(long groupId) throws RemoteException {
1787                    try {
1788                            JournalArticleServiceUtil.subscribe(groupId);
1789                    }
1790                    catch (Exception e) {
1791                            _log.error(e, e);
1792    
1793                            throw new RemoteException(e.getMessage());
1794                    }
1795            }
1796    
1797            /**
1798            * Unsubscribes the user from notifications for the web content article
1799            * matching the group.
1800            *
1801            * @param groupId the primary key of the group
1802            * @throws PortalException if the user did not have permission to subscribe
1803            to the web content article or if a matching user or subscription
1804            could not be found
1805            * @throws SystemException if a system exception occurred
1806            */
1807            public static void unsubscribe(long groupId) throws RemoteException {
1808                    try {
1809                            JournalArticleServiceUtil.unsubscribe(groupId);
1810                    }
1811                    catch (Exception e) {
1812                            _log.error(e, e);
1813    
1814                            throw new RemoteException(e.getMessage());
1815                    }
1816            }
1817    
1818            /**
1819            * Updates the web content article matching the version, replacing its
1820            * folder, title, description, content, and layout UUID.
1821            *
1822            * @param userId the primary key of the user updating the web content
1823            article
1824            * @param groupId the primary key of the web content article's group
1825            * @param folderId the primary key of the web content article folder
1826            * @param articleId the primary key of the web content article
1827            * @param version the web content article's version
1828            * @param titleMap the web content article's locales and localized titles
1829            * @param descriptionMap the web content article's locales and localized
1830            descriptions
1831            * @param content the HTML content wrapped in XML. For more information,
1832            see the content example in the class description for {@link
1833            JournalArticleLocalServiceImpl}.
1834            * @param layoutUuid the unique string identifying the web content
1835            article's display page
1836            * @param serviceContext the service context to be applied. Can set the
1837            modification date, expando bridge attributes, asset category IDs,
1838            asset tag names, asset link entry IDs, workflow actions, the
1839            "defaultLanguageId" and "urlTitle" attributes, and can set
1840            whether to add the default command update for the web content
1841            article. With respect to social activities, by setting the
1842            service context's command to {@link
1843            com.liferay.portal.kernel.util.Constants#UPDATE}, the invocation
1844            is considered a web content update activity; otherwise it is
1845            considered a web content add activity.
1846            * @return the updated web content article
1847            * @throws PortalException if a user with the primary key or a matching web
1848            content article could not be found, or if a portal exception
1849            occurred
1850            * @throws SystemException if a system exception occurred
1851            */
1852            public static com.liferay.portlet.journal.model.JournalArticleSoap updateArticle(
1853                    long userId, long groupId, long folderId, java.lang.String articleId,
1854                    double version, java.lang.String[] titleMapLanguageIds,
1855                    java.lang.String[] titleMapValues,
1856                    java.lang.String[] descriptionMapLanguageIds,
1857                    java.lang.String[] descriptionMapValues, java.lang.String content,
1858                    java.lang.String layoutUuid,
1859                    com.liferay.portal.service.ServiceContext serviceContext)
1860                    throws RemoteException {
1861                    try {
1862                            Map<Locale, String> titleMap = LocalizationUtil.getLocalizationMap(titleMapLanguageIds,
1863                                            titleMapValues);
1864                            Map<Locale, String> descriptionMap = LocalizationUtil.getLocalizationMap(descriptionMapLanguageIds,
1865                                            descriptionMapValues);
1866    
1867                            com.liferay.portlet.journal.model.JournalArticle returnValue = JournalArticleServiceUtil.updateArticle(userId,
1868                                            groupId, folderId, articleId, version, titleMap,
1869                                            descriptionMap, content, layoutUuid, serviceContext);
1870    
1871                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModel(returnValue);
1872                    }
1873                    catch (Exception e) {
1874                            _log.error(e, e);
1875    
1876                            throw new RemoteException(e.getMessage());
1877                    }
1878            }
1879    
1880            /**
1881            * Updates the web content article matching the version, replacing its
1882            * folder and content.
1883            *
1884            * @param groupId the primary key of the web content article's group
1885            * @param folderId the primary key of the web content article folder
1886            * @param articleId the primary key of the web content article
1887            * @param version the web content article's version
1888            * @param content the HTML content wrapped in XML. For more information,
1889            see the content example in the class description for {@link
1890            JournalArticleLocalServiceImpl}.
1891            * @param serviceContext the service context to be applied. Can set the
1892            modification date, expando bridge attributes, asset category IDs,
1893            asset tag names, asset link entry IDs, workflow actions, the
1894            "defaultLanguageId" and "urlTitle" attributes, and can set
1895            whether to add the default command update for the web content
1896            article. With respect to social activities, by setting the
1897            service context's command to {@link
1898            com.liferay.portal.kernel.util.Constants#UPDATE}, the invocation
1899            is considered a web content update activity; otherwise it is
1900            considered a web content add activity.
1901            * @return the updated web content article
1902            * @throws PortalException if the user did not have permission to update the
1903            web content article, if a user with the primary key or a matching
1904            web content article could not be found, or if a portal exception
1905            occurred
1906            * @throws SystemException if a system exception occurred
1907            */
1908            public static com.liferay.portlet.journal.model.JournalArticleSoap updateArticle(
1909                    long groupId, long folderId, java.lang.String articleId,
1910                    double version, java.lang.String content,
1911                    com.liferay.portal.service.ServiceContext serviceContext)
1912                    throws RemoteException {
1913                    try {
1914                            com.liferay.portlet.journal.model.JournalArticle returnValue = JournalArticleServiceUtil.updateArticle(groupId,
1915                                            folderId, articleId, version, content, serviceContext);
1916    
1917                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModel(returnValue);
1918                    }
1919                    catch (Exception e) {
1920                            _log.error(e, e);
1921    
1922                            throw new RemoteException(e.getMessage());
1923                    }
1924            }
1925    
1926            /**
1927            * Updates the web content article matching the group, article ID, and
1928            * version, replacing its content.
1929            *
1930            * @param groupId the primary key of the web content article's group
1931            * @param articleId the primary key of the web content article
1932            * @param version the web content article's version
1933            * @param content the HTML content wrapped in XML. For more information,
1934            see the content example in the class description for {@link
1935            JournalArticleLocalServiceImpl}.
1936            * @return the updated web content article
1937            * @throws PortalException if the user did not have permission to update the
1938            web content article or if a matching web content article could
1939            not be found
1940            * @throws SystemException if a system exception occurred
1941            */
1942            public static com.liferay.portlet.journal.model.JournalArticleSoap updateContent(
1943                    long groupId, java.lang.String articleId, double version,
1944                    java.lang.String content) throws RemoteException {
1945                    try {
1946                            com.liferay.portlet.journal.model.JournalArticle returnValue = JournalArticleServiceUtil.updateContent(groupId,
1947                                            articleId, version, content);
1948    
1949                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModel(returnValue);
1950                    }
1951                    catch (Exception e) {
1952                            _log.error(e, e);
1953    
1954                            throw new RemoteException(e.getMessage());
1955                    }
1956            }
1957    
1958            /**
1959            * Updates the workflow status of the web content article matching the
1960            * group, article ID, and version.
1961            *
1962            * @param groupId the primary key of the web content article's group
1963            * @param articleId the primary key of the web content article
1964            * @param version the web content article's version
1965            * @param status the web content article's workflow status. For more
1966            information see {@link WorkflowConstants} for constants starting
1967            with the "STATUS_" prefix.
1968            * @param articleURL the web content article's accessible URL
1969            * @param serviceContext the service context to be applied. Can set the
1970            modification date, portlet preferences, and can set whether to
1971            add the default command update for the web content article.
1972            * @return the updated web content article
1973            * @throws PortalException if the user did not have permission to update the
1974            web content article, if a matching web content article could not
1975            be found, or if a portal exception occurred
1976            * @throws SystemException if a system exception occurred
1977            */
1978            public static com.liferay.portlet.journal.model.JournalArticleSoap updateStatus(
1979                    long groupId, java.lang.String articleId, double version, int status,
1980                    java.lang.String articleURL,
1981                    com.liferay.portal.service.ServiceContext serviceContext)
1982                    throws RemoteException {
1983                    try {
1984                            com.liferay.portlet.journal.model.JournalArticle returnValue = JournalArticleServiceUtil.updateStatus(groupId,
1985                                            articleId, version, status, articleURL, serviceContext);
1986    
1987                            return com.liferay.portlet.journal.model.JournalArticleSoap.toSoapModel(returnValue);
1988                    }
1989                    catch (Exception e) {
1990                            _log.error(e, e);
1991    
1992                            throw new RemoteException(e.getMessage());
1993                    }
1994            }
1995    
1996            private static Log _log = LogFactoryUtil.getLog(JournalArticleServiceSoap.class);
1997    }