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.asset.service;
016    
017    import com.liferay.portal.kernel.exception.PortalException;
018    import com.liferay.portal.kernel.exception.SystemException;
019    import com.liferay.portal.kernel.jsonwebservice.JSONWebService;
020    import com.liferay.portal.kernel.transaction.Isolation;
021    import com.liferay.portal.kernel.transaction.Propagation;
022    import com.liferay.portal.kernel.transaction.Transactional;
023    import com.liferay.portal.security.ac.AccessControlled;
024    import com.liferay.portal.service.BaseService;
025    
026    /**
027     * Provides the remote service interface for AssetCategory. Methods of this
028     * service are expected to have security checks based on the propagated JAAS
029     * credentials because this service can be accessed remotely.
030     *
031     * @author Brian Wing Shun Chan
032     * @see AssetCategoryServiceUtil
033     * @see com.liferay.portlet.asset.service.base.AssetCategoryServiceBaseImpl
034     * @see com.liferay.portlet.asset.service.impl.AssetCategoryServiceImpl
035     * @generated
036     */
037    @AccessControlled
038    @JSONWebService
039    @Transactional(isolation = Isolation.PORTAL, rollbackFor =  {
040            PortalException.class, SystemException.class})
041    public interface AssetCategoryService extends BaseService {
042            /*
043             * NOTE FOR DEVELOPERS:
044             *
045             * Never modify or reference this interface directly. Always use {@link AssetCategoryServiceUtil} to access the asset category remote service. Add custom service methods to {@link com.liferay.portlet.asset.service.impl.AssetCategoryServiceImpl} and rerun ServiceBuilder to automatically copy the method declarations to this interface.
046             */
047    
048            /**
049            * Returns the Spring bean ID for this bean.
050            *
051            * @return the Spring bean ID for this bean
052            */
053            public java.lang.String getBeanIdentifier();
054    
055            /**
056            * Sets the Spring bean ID for this bean.
057            *
058            * @param beanIdentifier the Spring bean ID for this bean
059            */
060            public void setBeanIdentifier(java.lang.String beanIdentifier);
061    
062            public com.liferay.portlet.asset.model.AssetCategory addCategory(
063                    long parentCategoryId,
064                    java.util.Map<java.util.Locale, java.lang.String> titleMap,
065                    java.util.Map<java.util.Locale, java.lang.String> descriptionMap,
066                    long vocabularyId, java.lang.String[] categoryProperties,
067                    com.liferay.portal.service.ServiceContext serviceContext)
068                    throws com.liferay.portal.kernel.exception.PortalException,
069                            com.liferay.portal.kernel.exception.SystemException;
070    
071            public com.liferay.portlet.asset.model.AssetCategory addCategory(
072                    java.lang.String title, long vocabularyId,
073                    com.liferay.portal.service.ServiceContext serviceContext)
074                    throws com.liferay.portal.kernel.exception.PortalException,
075                            com.liferay.portal.kernel.exception.SystemException;
076    
077            /**
078            * @deprecated As of 6.2.0, Replaced by {@link #deleteCategories(long[],
079            ServiceContext)}
080            */
081            public void deleteCategories(long[] categoryIds)
082                    throws com.liferay.portal.kernel.exception.PortalException,
083                            com.liferay.portal.kernel.exception.SystemException;
084    
085            public java.util.List<com.liferay.portlet.asset.model.AssetCategory> deleteCategories(
086                    long[] categoryIds,
087                    com.liferay.portal.service.ServiceContext serviceContext)
088                    throws com.liferay.portal.kernel.exception.PortalException,
089                            com.liferay.portal.kernel.exception.SystemException;
090    
091            public void deleteCategory(long categoryId)
092                    throws com.liferay.portal.kernel.exception.PortalException,
093                            com.liferay.portal.kernel.exception.SystemException;
094    
095            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
096            public java.util.List<com.liferay.portlet.asset.model.AssetCategory> getCategories(
097                    java.lang.String className, long classPK)
098                    throws com.liferay.portal.kernel.exception.PortalException,
099                            com.liferay.portal.kernel.exception.SystemException;
100    
101            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
102            public com.liferay.portlet.asset.model.AssetCategory getCategory(
103                    long categoryId)
104                    throws com.liferay.portal.kernel.exception.PortalException,
105                            com.liferay.portal.kernel.exception.SystemException;
106    
107            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
108            public java.util.List<com.liferay.portlet.asset.model.AssetCategory> getChildCategories(
109                    long parentCategoryId)
110                    throws com.liferay.portal.kernel.exception.PortalException,
111                            com.liferay.portal.kernel.exception.SystemException;
112    
113            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
114            public java.util.List<com.liferay.portlet.asset.model.AssetCategory> getChildCategories(
115                    long parentCategoryId, int start, int end,
116                    com.liferay.portal.kernel.util.OrderByComparator obc)
117                    throws com.liferay.portal.kernel.exception.PortalException,
118                            com.liferay.portal.kernel.exception.SystemException;
119    
120            /**
121            * @deprecated As of 6.2.0, replaced by {@link #search(long[], String,
122            long[], int, int)}
123            */
124            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
125            public com.liferay.portal.kernel.json.JSONArray getJSONSearch(
126                    long groupId, java.lang.String name, long[] vocabularyIds, int start,
127                    int end)
128                    throws com.liferay.portal.kernel.exception.PortalException,
129                            com.liferay.portal.kernel.exception.SystemException;
130    
131            /**
132            * @deprecated As of 6.2.0, replaced by {@link
133            #getVocabularyCategoriesDisplay(long, int, int,
134            OrderByComparator)}
135            */
136            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
137            public com.liferay.portal.kernel.json.JSONObject getJSONVocabularyCategories(
138                    long vocabularyId, int start, int end,
139                    com.liferay.portal.kernel.util.OrderByComparator obc)
140                    throws com.liferay.portal.kernel.exception.PortalException,
141                            com.liferay.portal.kernel.exception.SystemException;
142    
143            /**
144            * @deprecated As of 6.2.0, replaced by {@link
145            #getVocabularyCategoriesDisplay(long, String, long, int, int,
146            OrderByComparator)}
147            */
148            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
149            public com.liferay.portal.kernel.json.JSONObject getJSONVocabularyCategories(
150                    long groupId, java.lang.String name, long vocabularyId, int start,
151                    int end, com.liferay.portal.kernel.util.OrderByComparator obc)
152                    throws com.liferay.portal.kernel.exception.PortalException,
153                            com.liferay.portal.kernel.exception.SystemException;
154    
155            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
156            public java.util.List<com.liferay.portlet.asset.model.AssetCategory> getVocabularyCategories(
157                    long vocabularyId, int start, int end,
158                    com.liferay.portal.kernel.util.OrderByComparator obc)
159                    throws com.liferay.portal.kernel.exception.PortalException,
160                            com.liferay.portal.kernel.exception.SystemException;
161    
162            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
163            public java.util.List<com.liferay.portlet.asset.model.AssetCategory> getVocabularyCategories(
164                    long parentCategoryId, long vocabularyId, int start, int end,
165                    com.liferay.portal.kernel.util.OrderByComparator obc)
166                    throws com.liferay.portal.kernel.exception.PortalException,
167                            com.liferay.portal.kernel.exception.SystemException;
168    
169            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
170            public java.util.List<com.liferay.portlet.asset.model.AssetCategory> getVocabularyCategories(
171                    long groupId, java.lang.String name, long vocabularyId, int start,
172                    int end, com.liferay.portal.kernel.util.OrderByComparator obc)
173                    throws com.liferay.portal.kernel.exception.SystemException;
174    
175            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
176            public int getVocabularyCategoriesCount(long groupId, long vocabularyId)
177                    throws com.liferay.portal.kernel.exception.SystemException;
178    
179            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
180            public int getVocabularyCategoriesCount(long groupId,
181                    java.lang.String name, long vocabularyId)
182                    throws com.liferay.portal.kernel.exception.SystemException;
183    
184            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
185            public com.liferay.portlet.asset.model.AssetCategoryDisplay getVocabularyCategoriesDisplay(
186                    long vocabularyId, int start, int end,
187                    com.liferay.portal.kernel.util.OrderByComparator obc)
188                    throws com.liferay.portal.kernel.exception.PortalException,
189                            com.liferay.portal.kernel.exception.SystemException;
190    
191            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
192            public com.liferay.portlet.asset.model.AssetCategoryDisplay getVocabularyCategoriesDisplay(
193                    long groupId, java.lang.String name, long vocabularyId, int start,
194                    int end, com.liferay.portal.kernel.util.OrderByComparator obc)
195                    throws com.liferay.portal.kernel.exception.PortalException,
196                            com.liferay.portal.kernel.exception.SystemException;
197    
198            /**
199            * @deprecated As of 6.2.0, replaced by {@link
200            #getVocabularyRootCategories(long, long, int, int,
201            OrderByComparator)}
202            */
203            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
204            public java.util.List<com.liferay.portlet.asset.model.AssetCategory> getVocabularyRootCategories(
205                    long vocabularyId, int start, int end,
206                    com.liferay.portal.kernel.util.OrderByComparator obc)
207                    throws com.liferay.portal.kernel.exception.PortalException,
208                            com.liferay.portal.kernel.exception.SystemException;
209    
210            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
211            public java.util.List<com.liferay.portlet.asset.model.AssetCategory> getVocabularyRootCategories(
212                    long groupId, long vocabularyId, int start, int end,
213                    com.liferay.portal.kernel.util.OrderByComparator obc)
214                    throws com.liferay.portal.kernel.exception.SystemException;
215    
216            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
217            public int getVocabularyRootCategoriesCount(long groupId, long vocabularyId)
218                    throws com.liferay.portal.kernel.exception.SystemException;
219    
220            public com.liferay.portlet.asset.model.AssetCategory moveCategory(
221                    long categoryId, long parentCategoryId, long vocabularyId,
222                    com.liferay.portal.service.ServiceContext serviceContext)
223                    throws com.liferay.portal.kernel.exception.PortalException,
224                            com.liferay.portal.kernel.exception.SystemException;
225    
226            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
227            public java.util.List<com.liferay.portlet.asset.model.AssetCategory> search(
228                    long groupId, java.lang.String keywords, long vocabularyId, int start,
229                    int end, com.liferay.portal.kernel.util.OrderByComparator obc)
230                    throws com.liferay.portal.kernel.exception.SystemException;
231    
232            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
233            public com.liferay.portal.kernel.json.JSONArray search(long groupId,
234                    java.lang.String name, java.lang.String[] categoryProperties,
235                    int start, int end)
236                    throws com.liferay.portal.kernel.exception.PortalException,
237                            com.liferay.portal.kernel.exception.SystemException;
238    
239            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
240            public com.liferay.portal.kernel.json.JSONArray search(long[] groupIds,
241                    java.lang.String name, long[] vocabularyIds, int start, int end)
242                    throws com.liferay.portal.kernel.exception.PortalException,
243                            com.liferay.portal.kernel.exception.SystemException;
244    
245            public com.liferay.portlet.asset.model.AssetCategory updateCategory(
246                    long categoryId, long parentCategoryId,
247                    java.util.Map<java.util.Locale, java.lang.String> titleMap,
248                    java.util.Map<java.util.Locale, java.lang.String> descriptionMap,
249                    long vocabularyId, java.lang.String[] categoryProperties,
250                    com.liferay.portal.service.ServiceContext serviceContext)
251                    throws com.liferay.portal.kernel.exception.PortalException,
252                            com.liferay.portal.kernel.exception.SystemException;
253    }