1   /**
2    * Copyright (c) 2000-2009 Liferay, Inc. All rights reserved.
3    *
4    * Permission is hereby granted, free of charge, to any person obtaining a copy
5    * of this software and associated documentation files (the "Software"), to deal
6    * in the Software without restriction, including without limitation the rights
7    * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
8    * copies of the Software, and to permit persons to whom the Software is
9    * furnished to do so, subject to the following conditions:
10   *
11   * The above copyright notice and this permission notice shall be included in
12   * all copies or substantial portions of the Software.
13   *
14   * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15   * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16   * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
17   * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18   * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
19   * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
20   * SOFTWARE.
21   */
22  
23  package com.liferay.portlet.journal.service;
24  
25  import com.liferay.portal.PortalException;
26  import com.liferay.portal.SystemException;
27  import com.liferay.portal.kernel.annotation.Propagation;
28  import com.liferay.portal.kernel.annotation.Transactional;
29  
30  /**
31   * <a href="JournalArticleService.java.html"><b><i>View Source</i></b></a>
32   *
33   * <p>
34   * ServiceBuilder generated this class. Modifications in this class will be
35   * overwritten the next time is generated.
36   * </p>
37   *
38   * <p>
39   * This interface defines the service. The default implementation is
40   * <code>com.liferay.portlet.journal.service.impl.JournalArticleServiceImpl</code>.
41   * Modify methods in that class and rerun ServiceBuilder to populate this class
42   * and all other generated classes.
43   * </p>
44   *
45   * <p>
46   * This is a remote service. Methods of this service are expected to have security checks based on the propagated JAAS credentials because this service can be accessed remotely.
47   * </p>
48   *
49   * @author Brian Wing Shun Chan
50   *
51   * @see com.liferay.portlet.journal.service.JournalArticleServiceUtil
52   *
53   */
54  @Transactional(rollbackFor =  {
55      PortalException.class, SystemException.class})
56  public interface JournalArticleService {
57      public com.liferay.portlet.journal.model.JournalArticle addArticle(
58          long groupId, java.lang.String articleId, boolean autoArticleId,
59          java.lang.String title, java.lang.String description,
60          java.lang.String content, java.lang.String type,
61          java.lang.String structureId, java.lang.String templateId,
62          int displayDateMonth, int displayDateDay, int displayDateYear,
63          int displayDateHour, int displayDateMinute, int expirationDateMonth,
64          int expirationDateDay, int expirationDateYear, int expirationDateHour,
65          int expirationDateMinute, boolean neverExpire, int reviewDateMonth,
66          int reviewDateDay, int reviewDateYear, int reviewDateHour,
67          int reviewDateMinute, boolean neverReview, boolean indexable,
68          java.lang.String articleURL, java.lang.String[] tagsCategories,
69          java.lang.String[] tagsEntries, boolean addCommunityPermissions,
70          boolean addGuestPermissions)
71          throws com.liferay.portal.PortalException,
72              com.liferay.portal.SystemException;
73  
74      public com.liferay.portlet.journal.model.JournalArticle addArticle(
75          long groupId, java.lang.String articleId, boolean autoArticleId,
76          java.lang.String title, java.lang.String description,
77          java.lang.String content, java.lang.String type,
78          java.lang.String structureId, java.lang.String templateId,
79          int displayDateMonth, int displayDateDay, int displayDateYear,
80          int displayDateHour, int displayDateMinute, int expirationDateMonth,
81          int expirationDateDay, int expirationDateYear, int expirationDateHour,
82          int expirationDateMinute, boolean neverExpire, int reviewDateMonth,
83          int reviewDateDay, int reviewDateYear, int reviewDateHour,
84          int reviewDateMinute, boolean neverReview, boolean indexable,
85          boolean smallImage, java.lang.String smallImageURL,
86          java.io.File smallFile, java.util.Map<String, byte[]> images,
87          java.lang.String articleURL,
88          javax.portlet.PortletPreferences preferences,
89          java.lang.String[] tagsCategories, java.lang.String[] tagsEntries,
90          boolean addCommunityPermissions, boolean addGuestPermissions)
91          throws com.liferay.portal.PortalException,
92              com.liferay.portal.SystemException;
93  
94      public com.liferay.portlet.journal.model.JournalArticle addArticle(
95          long groupId, java.lang.String articleId, boolean autoArticleId,
96          java.lang.String title, java.lang.String description,
97          java.lang.String content, java.lang.String type,
98          java.lang.String structureId, java.lang.String templateId,
99          int displayDateMonth, int displayDateDay, int displayDateYear,
100         int displayDateHour, int displayDateMinute, int expirationDateMonth,
101         int expirationDateDay, int expirationDateYear, int expirationDateHour,
102         int expirationDateMinute, boolean neverExpire, int reviewDateMonth,
103         int reviewDateDay, int reviewDateYear, int reviewDateHour,
104         int reviewDateMinute, boolean neverReview, boolean indexable,
105         java.lang.String articleURL, java.lang.String[] tagsCategories,
106         java.lang.String[] tagsEntries,
107         java.lang.String[] communityPermissions,
108         java.lang.String[] guestPermissions)
109         throws com.liferay.portal.PortalException,
110             com.liferay.portal.SystemException;
111 
112     public com.liferay.portlet.journal.model.JournalArticle addArticle(
113         long groupId, java.lang.String articleId, boolean autoArticleId,
114         java.lang.String title, java.lang.String description,
115         java.lang.String content, java.lang.String type,
116         java.lang.String structureId, java.lang.String templateId,
117         int displayDateMonth, int displayDateDay, int displayDateYear,
118         int displayDateHour, int displayDateMinute, int expirationDateMonth,
119         int expirationDateDay, int expirationDateYear, int expirationDateHour,
120         int expirationDateMinute, boolean neverExpire, int reviewDateMonth,
121         int reviewDateDay, int reviewDateYear, int reviewDateHour,
122         int reviewDateMinute, boolean neverReview, boolean indexable,
123         boolean smallImage, java.lang.String smallImageURL,
124         java.io.File smallFile, java.util.Map<String, byte[]> images,
125         java.lang.String articleURL,
126         javax.portlet.PortletPreferences preferences,
127         java.lang.String[] tagsCategories, java.lang.String[] tagsEntries,
128         java.lang.String[] communityPermissions,
129         java.lang.String[] guestPermissions)
130         throws com.liferay.portal.PortalException,
131             com.liferay.portal.SystemException;
132 
133     public com.liferay.portlet.journal.model.JournalArticle approveArticle(
134         long groupId, java.lang.String articleId, double version,
135         java.lang.String articleURL,
136         javax.portlet.PortletPreferences preferences)
137         throws com.liferay.portal.PortalException,
138             com.liferay.portal.SystemException;
139 
140     public com.liferay.portlet.journal.model.JournalArticle copyArticle(
141         long groupId, java.lang.String oldArticleId,
142         java.lang.String newArticleId, boolean autoArticleId, double version)
143         throws com.liferay.portal.PortalException,
144             com.liferay.portal.SystemException;
145 
146     @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
147     public com.liferay.portlet.journal.model.JournalArticle getArticle(
148         long groupId, java.lang.String articleId, double version)
149         throws com.liferay.portal.PortalException,
150             com.liferay.portal.SystemException;
151 
152     @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
153     public java.lang.String getArticleContent(long groupId,
154         java.lang.String articleId, java.lang.String languageId,
155         com.liferay.portal.theme.ThemeDisplay themeDisplay)
156         throws com.liferay.portal.PortalException,
157             com.liferay.portal.SystemException;
158 
159     @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
160     public java.lang.String getArticleContent(long groupId,
161         java.lang.String articleId, double version,
162         java.lang.String languageId,
163         com.liferay.portal.theme.ThemeDisplay themeDisplay)
164         throws com.liferay.portal.PortalException,
165             com.liferay.portal.SystemException;
166 
167     public void deleteArticle(long groupId, java.lang.String articleId,
168         double version, java.lang.String articleURL,
169         javax.portlet.PortletPreferences preferences)
170         throws com.liferay.portal.PortalException,
171             com.liferay.portal.SystemException;
172 
173     public void expireArticle(long groupId, java.lang.String articleId,
174         double version, java.lang.String articleURL,
175         javax.portlet.PortletPreferences preferences)
176         throws com.liferay.portal.PortalException,
177             com.liferay.portal.SystemException;
178 
179     public void removeArticleLocale(long companyId, java.lang.String languageId)
180         throws com.liferay.portal.PortalException,
181             com.liferay.portal.SystemException;
182 
183     public com.liferay.portlet.journal.model.JournalArticle removeArticleLocale(
184         long groupId, java.lang.String articleId, double version,
185         java.lang.String languageId)
186         throws com.liferay.portal.PortalException,
187             com.liferay.portal.SystemException;
188 
189     public com.liferay.portlet.journal.model.JournalArticle updateArticle(
190         long groupId, java.lang.String articleId, double version,
191         boolean incrementVersion, java.lang.String title,
192         java.lang.String description, java.lang.String content,
193         java.lang.String type, java.lang.String structureId,
194         java.lang.String templateId, int displayDateMonth, int displayDateDay,
195         int displayDateYear, int displayDateHour, int displayDateMinute,
196         int expirationDateMonth, int expirationDateDay, int expirationDateYear,
197         int expirationDateHour, int expirationDateMinute, boolean neverExpire,
198         int reviewDateMonth, int reviewDateDay, int reviewDateYear,
199         int reviewDateHour, int reviewDateMinute, boolean neverReview,
200         boolean indexable, boolean smallImage, java.lang.String smallImageURL,
201         java.io.File smallFile, java.util.Map<String, byte[]> images,
202         java.lang.String articleURL,
203         javax.portlet.PortletPreferences preferences,
204         java.lang.String[] tagsCategories, java.lang.String[] tagsEntries)
205         throws com.liferay.portal.PortalException,
206             com.liferay.portal.SystemException;
207 
208     public com.liferay.portlet.journal.model.JournalArticle updateContent(
209         long groupId, java.lang.String articleId, double version,
210         java.lang.String content)
211         throws com.liferay.portal.PortalException,
212             com.liferay.portal.SystemException;
213 }