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.softwarecatalog.service;
016    
017    import com.liferay.portal.kernel.exception.PortalException;
018    import com.liferay.portal.kernel.exception.SystemException;
019    import com.liferay.portal.kernel.transaction.Isolation;
020    import com.liferay.portal.kernel.transaction.Propagation;
021    import com.liferay.portal.kernel.transaction.Transactional;
022    import com.liferay.portal.service.BaseLocalService;
023    import com.liferay.portal.service.PersistedModelLocalService;
024    
025    /**
026     * Provides the local service interface for SCProductEntry. Methods of this
027     * service will not have security checks based on the propagated JAAS
028     * credentials because this service can only be accessed from within the same
029     * VM.
030     *
031     * @author Brian Wing Shun Chan
032     * @see SCProductEntryLocalServiceUtil
033     * @see com.liferay.portlet.softwarecatalog.service.base.SCProductEntryLocalServiceBaseImpl
034     * @see com.liferay.portlet.softwarecatalog.service.impl.SCProductEntryLocalServiceImpl
035     * @generated
036     */
037    @Transactional(isolation = Isolation.PORTAL, rollbackFor =  {
038            PortalException.class, SystemException.class})
039    public interface SCProductEntryLocalService extends BaseLocalService,
040            PersistedModelLocalService {
041            /*
042             * NOTE FOR DEVELOPERS:
043             *
044             * Never modify or reference this interface directly. Always use {@link SCProductEntryLocalServiceUtil} to access the s c product entry local service. Add custom service methods to {@link com.liferay.portlet.softwarecatalog.service.impl.SCProductEntryLocalServiceImpl} and rerun ServiceBuilder to automatically copy the method declarations to this interface.
045             */
046    
047            /**
048            * Adds the s c product entry to the database. Also notifies the appropriate model listeners.
049            *
050            * @param scProductEntry the s c product entry
051            * @return the s c product entry that was added
052            * @throws SystemException if a system exception occurred
053            */
054            public com.liferay.portlet.softwarecatalog.model.SCProductEntry addSCProductEntry(
055                    com.liferay.portlet.softwarecatalog.model.SCProductEntry scProductEntry)
056                    throws com.liferay.portal.kernel.exception.SystemException;
057    
058            /**
059            * Creates a new s c product entry with the primary key. Does not add the s c product entry to the database.
060            *
061            * @param productEntryId the primary key for the new s c product entry
062            * @return the new s c product entry
063            */
064            public com.liferay.portlet.softwarecatalog.model.SCProductEntry createSCProductEntry(
065                    long productEntryId);
066    
067            /**
068            * Deletes the s c product entry with the primary key from the database. Also notifies the appropriate model listeners.
069            *
070            * @param productEntryId the primary key of the s c product entry
071            * @return the s c product entry that was removed
072            * @throws PortalException if a s c product entry with the primary key could not be found
073            * @throws SystemException if a system exception occurred
074            */
075            public com.liferay.portlet.softwarecatalog.model.SCProductEntry deleteSCProductEntry(
076                    long productEntryId)
077                    throws com.liferay.portal.kernel.exception.PortalException,
078                            com.liferay.portal.kernel.exception.SystemException;
079    
080            /**
081            * Deletes the s c product entry from the database. Also notifies the appropriate model listeners.
082            *
083            * @param scProductEntry the s c product entry
084            * @return the s c product entry that was removed
085            * @throws SystemException if a system exception occurred
086            */
087            public com.liferay.portlet.softwarecatalog.model.SCProductEntry deleteSCProductEntry(
088                    com.liferay.portlet.softwarecatalog.model.SCProductEntry scProductEntry)
089                    throws com.liferay.portal.kernel.exception.SystemException;
090    
091            public com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery();
092    
093            /**
094            * Performs a dynamic query on the database and returns the matching rows.
095            *
096            * @param dynamicQuery the dynamic query
097            * @return the matching rows
098            * @throws SystemException if a system exception occurred
099            */
100            @SuppressWarnings("rawtypes")
101            public java.util.List dynamicQuery(
102                    com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery)
103                    throws com.liferay.portal.kernel.exception.SystemException;
104    
105            /**
106            * Performs a dynamic query on the database and returns a range of the matching rows.
107            *
108            * <p>
109            * Useful when paginating results. Returns a maximum of <code>end - start</code> instances. <code>start</code> and <code>end</code> are not primary keys, they are indexes in the result set. Thus, <code>0</code> refers to the first result in the set. Setting both <code>start</code> and <code>end</code> to {@link com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full result set. If <code>orderByComparator</code> is specified, then the query will include the given ORDER BY logic. If <code>orderByComparator</code> is absent and pagination is required (<code>start</code> and <code>end</code> are not {@link com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS}), then the query will include the default ORDER BY logic from {@link com.liferay.portlet.softwarecatalog.model.impl.SCProductEntryModelImpl}. If both <code>orderByComparator</code> and pagination are absent, for performance reasons, the query will not have an ORDER BY clause and the returned result set will be sorted on by the primary key in an ascending order.
110            * </p>
111            *
112            * @param dynamicQuery the dynamic query
113            * @param start the lower bound of the range of model instances
114            * @param end the upper bound of the range of model instances (not inclusive)
115            * @return the range of matching rows
116            * @throws SystemException if a system exception occurred
117            */
118            @SuppressWarnings("rawtypes")
119            public java.util.List dynamicQuery(
120                    com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery, int start,
121                    int end) throws com.liferay.portal.kernel.exception.SystemException;
122    
123            /**
124            * Performs a dynamic query on the database and returns an ordered range of the matching rows.
125            *
126            * <p>
127            * Useful when paginating results. Returns a maximum of <code>end - start</code> instances. <code>start</code> and <code>end</code> are not primary keys, they are indexes in the result set. Thus, <code>0</code> refers to the first result in the set. Setting both <code>start</code> and <code>end</code> to {@link com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full result set. If <code>orderByComparator</code> is specified, then the query will include the given ORDER BY logic. If <code>orderByComparator</code> is absent and pagination is required (<code>start</code> and <code>end</code> are not {@link com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS}), then the query will include the default ORDER BY logic from {@link com.liferay.portlet.softwarecatalog.model.impl.SCProductEntryModelImpl}. If both <code>orderByComparator</code> and pagination are absent, for performance reasons, the query will not have an ORDER BY clause and the returned result set will be sorted on by the primary key in an ascending order.
128            * </p>
129            *
130            * @param dynamicQuery the dynamic query
131            * @param start the lower bound of the range of model instances
132            * @param end the upper bound of the range of model instances (not inclusive)
133            * @param orderByComparator the comparator to order the results by (optionally <code>null</code>)
134            * @return the ordered range of matching rows
135            * @throws SystemException if a system exception occurred
136            */
137            @SuppressWarnings("rawtypes")
138            public java.util.List dynamicQuery(
139                    com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery, int start,
140                    int end,
141                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
142                    throws com.liferay.portal.kernel.exception.SystemException;
143    
144            /**
145            * Returns the number of rows that match the dynamic query.
146            *
147            * @param dynamicQuery the dynamic query
148            * @return the number of rows that match the dynamic query
149            * @throws SystemException if a system exception occurred
150            */
151            public long dynamicQueryCount(
152                    com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery)
153                    throws com.liferay.portal.kernel.exception.SystemException;
154    
155            /**
156            * Returns the number of rows that match the dynamic query.
157            *
158            * @param dynamicQuery the dynamic query
159            * @param projection the projection to apply to the query
160            * @return the number of rows that match the dynamic query
161            * @throws SystemException if a system exception occurred
162            */
163            public long dynamicQueryCount(
164                    com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery,
165                    com.liferay.portal.kernel.dao.orm.Projection projection)
166                    throws com.liferay.portal.kernel.exception.SystemException;
167    
168            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
169            public com.liferay.portlet.softwarecatalog.model.SCProductEntry fetchSCProductEntry(
170                    long productEntryId)
171                    throws com.liferay.portal.kernel.exception.SystemException;
172    
173            /**
174            * Returns the s c product entry with the primary key.
175            *
176            * @param productEntryId the primary key of the s c product entry
177            * @return the s c product entry
178            * @throws PortalException if a s c product entry with the primary key could not be found
179            * @throws SystemException if a system exception occurred
180            */
181            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
182            public com.liferay.portlet.softwarecatalog.model.SCProductEntry getSCProductEntry(
183                    long productEntryId)
184                    throws com.liferay.portal.kernel.exception.PortalException,
185                            com.liferay.portal.kernel.exception.SystemException;
186    
187            @Override
188            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
189            public com.liferay.portal.model.PersistedModel getPersistedModel(
190                    java.io.Serializable primaryKeyObj)
191                    throws com.liferay.portal.kernel.exception.PortalException,
192                            com.liferay.portal.kernel.exception.SystemException;
193    
194            /**
195            * Returns a range of all the s c product entries.
196            *
197            * <p>
198            * Useful when paginating results. Returns a maximum of <code>end - start</code> instances. <code>start</code> and <code>end</code> are not primary keys, they are indexes in the result set. Thus, <code>0</code> refers to the first result in the set. Setting both <code>start</code> and <code>end</code> to {@link com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full result set. If <code>orderByComparator</code> is specified, then the query will include the given ORDER BY logic. If <code>orderByComparator</code> is absent and pagination is required (<code>start</code> and <code>end</code> are not {@link com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS}), then the query will include the default ORDER BY logic from {@link com.liferay.portlet.softwarecatalog.model.impl.SCProductEntryModelImpl}. If both <code>orderByComparator</code> and pagination are absent, for performance reasons, the query will not have an ORDER BY clause and the returned result set will be sorted on by the primary key in an ascending order.
199            * </p>
200            *
201            * @param start the lower bound of the range of s c product entries
202            * @param end the upper bound of the range of s c product entries (not inclusive)
203            * @return the range of s c product entries
204            * @throws SystemException if a system exception occurred
205            */
206            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
207            public java.util.List<com.liferay.portlet.softwarecatalog.model.SCProductEntry> getSCProductEntries(
208                    int start, int end)
209                    throws com.liferay.portal.kernel.exception.SystemException;
210    
211            /**
212            * Returns the number of s c product entries.
213            *
214            * @return the number of s c product entries
215            * @throws SystemException if a system exception occurred
216            */
217            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
218            public int getSCProductEntriesCount()
219                    throws com.liferay.portal.kernel.exception.SystemException;
220    
221            /**
222            * Updates the s c product entry in the database or adds it if it does not yet exist. Also notifies the appropriate model listeners.
223            *
224            * @param scProductEntry the s c product entry
225            * @return the s c product entry that was updated
226            * @throws SystemException if a system exception occurred
227            */
228            public com.liferay.portlet.softwarecatalog.model.SCProductEntry updateSCProductEntry(
229                    com.liferay.portlet.softwarecatalog.model.SCProductEntry scProductEntry)
230                    throws com.liferay.portal.kernel.exception.SystemException;
231    
232            /**
233            * @throws SystemException if a system exception occurred
234            */
235            public void addSCLicenseSCProductEntry(long licenseId, long productEntryId)
236                    throws com.liferay.portal.kernel.exception.SystemException;
237    
238            /**
239            * @throws SystemException if a system exception occurred
240            */
241            public void addSCLicenseSCProductEntry(long licenseId,
242                    com.liferay.portlet.softwarecatalog.model.SCProductEntry scProductEntry)
243                    throws com.liferay.portal.kernel.exception.SystemException;
244    
245            /**
246            * @throws SystemException if a system exception occurred
247            */
248            public void addSCLicenseSCProductEntries(long licenseId,
249                    long[] productEntryIds)
250                    throws com.liferay.portal.kernel.exception.SystemException;
251    
252            /**
253            * @throws SystemException if a system exception occurred
254            */
255            public void addSCLicenseSCProductEntries(long licenseId,
256                    java.util.List<com.liferay.portlet.softwarecatalog.model.SCProductEntry> SCProductEntries)
257                    throws com.liferay.portal.kernel.exception.SystemException;
258    
259            /**
260            * @throws SystemException if a system exception occurred
261            */
262            public void clearSCLicenseSCProductEntries(long licenseId)
263                    throws com.liferay.portal.kernel.exception.SystemException;
264    
265            /**
266            * @throws SystemException if a system exception occurred
267            */
268            public void deleteSCLicenseSCProductEntry(long licenseId,
269                    long productEntryId)
270                    throws com.liferay.portal.kernel.exception.SystemException;
271    
272            /**
273            * @throws SystemException if a system exception occurred
274            */
275            public void deleteSCLicenseSCProductEntry(long licenseId,
276                    com.liferay.portlet.softwarecatalog.model.SCProductEntry scProductEntry)
277                    throws com.liferay.portal.kernel.exception.SystemException;
278    
279            /**
280            * @throws SystemException if a system exception occurred
281            */
282            public void deleteSCLicenseSCProductEntries(long licenseId,
283                    long[] productEntryIds)
284                    throws com.liferay.portal.kernel.exception.SystemException;
285    
286            /**
287            * @throws SystemException if a system exception occurred
288            */
289            public void deleteSCLicenseSCProductEntries(long licenseId,
290                    java.util.List<com.liferay.portlet.softwarecatalog.model.SCProductEntry> SCProductEntries)
291                    throws com.liferay.portal.kernel.exception.SystemException;
292    
293            /**
294            * @throws SystemException if a system exception occurred
295            */
296            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
297            public java.util.List<com.liferay.portlet.softwarecatalog.model.SCProductEntry> getSCLicenseSCProductEntries(
298                    long licenseId)
299                    throws com.liferay.portal.kernel.exception.SystemException;
300    
301            /**
302            * @throws SystemException if a system exception occurred
303            */
304            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
305            public java.util.List<com.liferay.portlet.softwarecatalog.model.SCProductEntry> getSCLicenseSCProductEntries(
306                    long licenseId, int start, int end)
307                    throws com.liferay.portal.kernel.exception.SystemException;
308    
309            /**
310            * @throws SystemException if a system exception occurred
311            */
312            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
313            public java.util.List<com.liferay.portlet.softwarecatalog.model.SCProductEntry> getSCLicenseSCProductEntries(
314                    long licenseId, int start, int end,
315                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
316                    throws com.liferay.portal.kernel.exception.SystemException;
317    
318            /**
319            * @throws SystemException if a system exception occurred
320            */
321            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
322            public int getSCLicenseSCProductEntriesCount(long licenseId)
323                    throws com.liferay.portal.kernel.exception.SystemException;
324    
325            /**
326            * @throws SystemException if a system exception occurred
327            */
328            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
329            public boolean hasSCLicenseSCProductEntry(long licenseId,
330                    long productEntryId)
331                    throws com.liferay.portal.kernel.exception.SystemException;
332    
333            /**
334            * @throws SystemException if a system exception occurred
335            */
336            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
337            public boolean hasSCLicenseSCProductEntries(long licenseId)
338                    throws com.liferay.portal.kernel.exception.SystemException;
339    
340            /**
341            * @throws SystemException if a system exception occurred
342            */
343            public void setSCLicenseSCProductEntries(long licenseId,
344                    long[] productEntryIds)
345                    throws com.liferay.portal.kernel.exception.SystemException;
346    
347            /**
348            * Returns the Spring bean ID for this bean.
349            *
350            * @return the Spring bean ID for this bean
351            */
352            public java.lang.String getBeanIdentifier();
353    
354            /**
355            * Sets the Spring bean ID for this bean.
356            *
357            * @param beanIdentifier the Spring bean ID for this bean
358            */
359            public void setBeanIdentifier(java.lang.String beanIdentifier);
360    
361            public com.liferay.portlet.softwarecatalog.model.SCProductEntry addProductEntry(
362                    long userId, java.lang.String name, java.lang.String type,
363                    java.lang.String tags, java.lang.String shortDescription,
364                    java.lang.String longDescription, java.lang.String pageURL,
365                    java.lang.String author, java.lang.String repoGroupId,
366                    java.lang.String repoArtifactId, long[] licenseIds,
367                    java.util.List<byte[]> thumbnails, java.util.List<byte[]> fullImages,
368                    com.liferay.portal.service.ServiceContext serviceContext)
369                    throws com.liferay.portal.kernel.exception.PortalException,
370                            com.liferay.portal.kernel.exception.SystemException;
371    
372            public void addProductEntryResources(long productEntryId,
373                    boolean addGroupPermissions, boolean addGuestPermissions)
374                    throws com.liferay.portal.kernel.exception.PortalException,
375                            com.liferay.portal.kernel.exception.SystemException;
376    
377            public void addProductEntryResources(long productEntryId,
378                    java.lang.String[] groupPermissions, java.lang.String[] guestPermissions)
379                    throws com.liferay.portal.kernel.exception.PortalException,
380                            com.liferay.portal.kernel.exception.SystemException;
381    
382            public void addProductEntryResources(
383                    com.liferay.portlet.softwarecatalog.model.SCProductEntry productEntry,
384                    boolean addGroupPermissions, boolean addGuestPermissions)
385                    throws com.liferay.portal.kernel.exception.PortalException,
386                            com.liferay.portal.kernel.exception.SystemException;
387    
388            public void addProductEntryResources(
389                    com.liferay.portlet.softwarecatalog.model.SCProductEntry productEntry,
390                    java.lang.String[] groupPermissions, java.lang.String[] guestPermissions)
391                    throws com.liferay.portal.kernel.exception.PortalException,
392                            com.liferay.portal.kernel.exception.SystemException;
393    
394            public void deleteProductEntries(long groupId)
395                    throws com.liferay.portal.kernel.exception.PortalException,
396                            com.liferay.portal.kernel.exception.SystemException;
397    
398            public com.liferay.portlet.softwarecatalog.model.SCProductEntry deleteProductEntry(
399                    long productEntryId)
400                    throws com.liferay.portal.kernel.exception.PortalException,
401                            com.liferay.portal.kernel.exception.SystemException;
402    
403            public com.liferay.portlet.softwarecatalog.model.SCProductEntry deleteProductEntry(
404                    com.liferay.portlet.softwarecatalog.model.SCProductEntry productEntry)
405                    throws com.liferay.portal.kernel.exception.PortalException,
406                            com.liferay.portal.kernel.exception.SystemException;
407    
408            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
409            public java.util.List<com.liferay.portlet.softwarecatalog.model.SCProductEntry> getCompanyProductEntries(
410                    long companyId, int start, int end)
411                    throws com.liferay.portal.kernel.exception.SystemException;
412    
413            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
414            public int getCompanyProductEntriesCount(long companyId)
415                    throws com.liferay.portal.kernel.exception.SystemException;
416    
417            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
418            public java.util.List<com.liferay.portlet.softwarecatalog.model.SCProductEntry> getProductEntries(
419                    long groupId, int start, int end)
420                    throws com.liferay.portal.kernel.exception.SystemException;
421    
422            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
423            public java.util.List<com.liferay.portlet.softwarecatalog.model.SCProductEntry> getProductEntries(
424                    long groupId, int start, int end,
425                    com.liferay.portal.kernel.util.OrderByComparator obc)
426                    throws com.liferay.portal.kernel.exception.SystemException;
427    
428            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
429            public java.util.List<com.liferay.portlet.softwarecatalog.model.SCProductEntry> getProductEntries(
430                    long groupId, long userId, int start, int end)
431                    throws com.liferay.portal.kernel.exception.SystemException;
432    
433            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
434            public java.util.List<com.liferay.portlet.softwarecatalog.model.SCProductEntry> getProductEntries(
435                    long groupId, long userId, int start, int end,
436                    com.liferay.portal.kernel.util.OrderByComparator obc)
437                    throws com.liferay.portal.kernel.exception.SystemException;
438    
439            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
440            public int getProductEntriesCount(long groupId)
441                    throws com.liferay.portal.kernel.exception.SystemException;
442    
443            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
444            public int getProductEntriesCount(long groupId, long userId)
445                    throws com.liferay.portal.kernel.exception.SystemException;
446    
447            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
448            public com.liferay.portlet.softwarecatalog.model.SCProductEntry getProductEntry(
449                    long productEntryId)
450                    throws com.liferay.portal.kernel.exception.PortalException,
451                            com.liferay.portal.kernel.exception.SystemException;
452    
453            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
454            public java.lang.String getRepositoryXML(long groupId,
455                    java.lang.String baseImageURL, java.util.Date oldestDate,
456                    int maxNumOfVersions, java.util.Properties repoSettings)
457                    throws com.liferay.portal.kernel.exception.SystemException;
458    
459            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
460            public java.lang.String getRepositoryXML(long groupId,
461                    java.lang.String version, java.lang.String baseImageURL,
462                    java.util.Date oldestDate, int maxNumOfVersions,
463                    java.util.Properties repoSettings)
464                    throws com.liferay.portal.kernel.exception.SystemException;
465    
466            public com.liferay.portlet.softwarecatalog.model.SCProductEntry updateProductEntry(
467                    long productEntryId, java.lang.String name, java.lang.String type,
468                    java.lang.String tags, java.lang.String shortDescription,
469                    java.lang.String longDescription, java.lang.String pageURL,
470                    java.lang.String author, java.lang.String repoGroupId,
471                    java.lang.String repoArtifactId, long[] licenseIds,
472                    java.util.List<byte[]> thumbnails, java.util.List<byte[]> fullImages)
473                    throws com.liferay.portal.kernel.exception.PortalException,
474                            com.liferay.portal.kernel.exception.SystemException;
475    }