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