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.persistence;
016    
017    import com.liferay.portal.service.persistence.BasePersistence;
018    
019    import com.liferay.portlet.asset.model.AssetTag;
020    
021    /**
022     * The persistence interface for the asset tag service.
023     *
024     * <p>
025     * Caching information and settings can be found in <code>portal.properties</code>
026     * </p>
027     *
028     * @author Brian Wing Shun Chan
029     * @see AssetTagPersistenceImpl
030     * @see AssetTagUtil
031     * @generated
032     */
033    public interface AssetTagPersistence extends BasePersistence<AssetTag> {
034            /*
035             * NOTE FOR DEVELOPERS:
036             *
037             * Never modify or reference this interface directly. Always use {@link AssetTagUtil} to access the asset tag persistence. Modify <code>service.xml</code> and rerun ServiceBuilder to regenerate this interface.
038             */
039    
040            /**
041            * Returns all the asset tags where groupId = &#63;.
042            *
043            * @param groupId the group ID
044            * @return the matching asset tags
045            * @throws SystemException if a system exception occurred
046            */
047            public java.util.List<com.liferay.portlet.asset.model.AssetTag> findByGroupId(
048                    long groupId)
049                    throws com.liferay.portal.kernel.exception.SystemException;
050    
051            /**
052            * Returns a range of all the asset tags where groupId = &#63;.
053            *
054            * <p>
055            * 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.asset.model.impl.AssetTagModelImpl}. 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.
056            * </p>
057            *
058            * @param groupId the group ID
059            * @param start the lower bound of the range of asset tags
060            * @param end the upper bound of the range of asset tags (not inclusive)
061            * @return the range of matching asset tags
062            * @throws SystemException if a system exception occurred
063            */
064            public java.util.List<com.liferay.portlet.asset.model.AssetTag> findByGroupId(
065                    long groupId, int start, int end)
066                    throws com.liferay.portal.kernel.exception.SystemException;
067    
068            /**
069            * Returns an ordered range of all the asset tags where groupId = &#63;.
070            *
071            * <p>
072            * 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.asset.model.impl.AssetTagModelImpl}. 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.
073            * </p>
074            *
075            * @param groupId the group ID
076            * @param start the lower bound of the range of asset tags
077            * @param end the upper bound of the range of asset tags (not inclusive)
078            * @param orderByComparator the comparator to order the results by (optionally <code>null</code>)
079            * @return the ordered range of matching asset tags
080            * @throws SystemException if a system exception occurred
081            */
082            public java.util.List<com.liferay.portlet.asset.model.AssetTag> findByGroupId(
083                    long groupId, int start, int end,
084                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
085                    throws com.liferay.portal.kernel.exception.SystemException;
086    
087            /**
088            * Returns the first asset tag in the ordered set where groupId = &#63;.
089            *
090            * @param groupId the group ID
091            * @param orderByComparator the comparator to order the set by (optionally <code>null</code>)
092            * @return the first matching asset tag
093            * @throws com.liferay.portlet.asset.NoSuchTagException if a matching asset tag could not be found
094            * @throws SystemException if a system exception occurred
095            */
096            public com.liferay.portlet.asset.model.AssetTag findByGroupId_First(
097                    long groupId,
098                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
099                    throws com.liferay.portal.kernel.exception.SystemException,
100                            com.liferay.portlet.asset.NoSuchTagException;
101    
102            /**
103            * Returns the first asset tag in the ordered set where groupId = &#63;.
104            *
105            * @param groupId the group ID
106            * @param orderByComparator the comparator to order the set by (optionally <code>null</code>)
107            * @return the first matching asset tag, or <code>null</code> if a matching asset tag could not be found
108            * @throws SystemException if a system exception occurred
109            */
110            public com.liferay.portlet.asset.model.AssetTag fetchByGroupId_First(
111                    long groupId,
112                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
113                    throws com.liferay.portal.kernel.exception.SystemException;
114    
115            /**
116            * Returns the last asset tag in the ordered set where groupId = &#63;.
117            *
118            * @param groupId the group ID
119            * @param orderByComparator the comparator to order the set by (optionally <code>null</code>)
120            * @return the last matching asset tag
121            * @throws com.liferay.portlet.asset.NoSuchTagException if a matching asset tag could not be found
122            * @throws SystemException if a system exception occurred
123            */
124            public com.liferay.portlet.asset.model.AssetTag findByGroupId_Last(
125                    long groupId,
126                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
127                    throws com.liferay.portal.kernel.exception.SystemException,
128                            com.liferay.portlet.asset.NoSuchTagException;
129    
130            /**
131            * Returns the last asset tag in the ordered set where groupId = &#63;.
132            *
133            * @param groupId the group ID
134            * @param orderByComparator the comparator to order the set by (optionally <code>null</code>)
135            * @return the last matching asset tag, or <code>null</code> if a matching asset tag could not be found
136            * @throws SystemException if a system exception occurred
137            */
138            public com.liferay.portlet.asset.model.AssetTag fetchByGroupId_Last(
139                    long groupId,
140                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
141                    throws com.liferay.portal.kernel.exception.SystemException;
142    
143            /**
144            * Returns the asset tags before and after the current asset tag in the ordered set where groupId = &#63;.
145            *
146            * @param tagId the primary key of the current asset tag
147            * @param groupId the group ID
148            * @param orderByComparator the comparator to order the set by (optionally <code>null</code>)
149            * @return the previous, current, and next asset tag
150            * @throws com.liferay.portlet.asset.NoSuchTagException if a asset tag with the primary key could not be found
151            * @throws SystemException if a system exception occurred
152            */
153            public com.liferay.portlet.asset.model.AssetTag[] findByGroupId_PrevAndNext(
154                    long tagId, long groupId,
155                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
156                    throws com.liferay.portal.kernel.exception.SystemException,
157                            com.liferay.portlet.asset.NoSuchTagException;
158    
159            /**
160            * Returns all the asset tags that the user has permission to view where groupId = &#63;.
161            *
162            * @param groupId the group ID
163            * @return the matching asset tags that the user has permission to view
164            * @throws SystemException if a system exception occurred
165            */
166            public java.util.List<com.liferay.portlet.asset.model.AssetTag> filterFindByGroupId(
167                    long groupId)
168                    throws com.liferay.portal.kernel.exception.SystemException;
169    
170            /**
171            * Returns a range of all the asset tags that the user has permission to view where groupId = &#63;.
172            *
173            * <p>
174            * 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.asset.model.impl.AssetTagModelImpl}. 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.
175            * </p>
176            *
177            * @param groupId the group ID
178            * @param start the lower bound of the range of asset tags
179            * @param end the upper bound of the range of asset tags (not inclusive)
180            * @return the range of matching asset tags that the user has permission to view
181            * @throws SystemException if a system exception occurred
182            */
183            public java.util.List<com.liferay.portlet.asset.model.AssetTag> filterFindByGroupId(
184                    long groupId, int start, int end)
185                    throws com.liferay.portal.kernel.exception.SystemException;
186    
187            /**
188            * Returns an ordered range of all the asset tags that the user has permissions to view where groupId = &#63;.
189            *
190            * <p>
191            * 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.asset.model.impl.AssetTagModelImpl}. 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.
192            * </p>
193            *
194            * @param groupId the group ID
195            * @param start the lower bound of the range of asset tags
196            * @param end the upper bound of the range of asset tags (not inclusive)
197            * @param orderByComparator the comparator to order the results by (optionally <code>null</code>)
198            * @return the ordered range of matching asset tags that the user has permission to view
199            * @throws SystemException if a system exception occurred
200            */
201            public java.util.List<com.liferay.portlet.asset.model.AssetTag> filterFindByGroupId(
202                    long groupId, int start, int end,
203                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
204                    throws com.liferay.portal.kernel.exception.SystemException;
205    
206            /**
207            * Returns the asset tags before and after the current asset tag in the ordered set of asset tags that the user has permission to view where groupId = &#63;.
208            *
209            * @param tagId the primary key of the current asset tag
210            * @param groupId the group ID
211            * @param orderByComparator the comparator to order the set by (optionally <code>null</code>)
212            * @return the previous, current, and next asset tag
213            * @throws com.liferay.portlet.asset.NoSuchTagException if a asset tag with the primary key could not be found
214            * @throws SystemException if a system exception occurred
215            */
216            public com.liferay.portlet.asset.model.AssetTag[] filterFindByGroupId_PrevAndNext(
217                    long tagId, long groupId,
218                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
219                    throws com.liferay.portal.kernel.exception.SystemException,
220                            com.liferay.portlet.asset.NoSuchTagException;
221    
222            /**
223            * Removes all the asset tags where groupId = &#63; from the database.
224            *
225            * @param groupId the group ID
226            * @throws SystemException if a system exception occurred
227            */
228            public void removeByGroupId(long groupId)
229                    throws com.liferay.portal.kernel.exception.SystemException;
230    
231            /**
232            * Returns the number of asset tags where groupId = &#63;.
233            *
234            * @param groupId the group ID
235            * @return the number of matching asset tags
236            * @throws SystemException if a system exception occurred
237            */
238            public int countByGroupId(long groupId)
239                    throws com.liferay.portal.kernel.exception.SystemException;
240    
241            /**
242            * Returns the number of asset tags that the user has permission to view where groupId = &#63;.
243            *
244            * @param groupId the group ID
245            * @return the number of matching asset tags that the user has permission to view
246            * @throws SystemException if a system exception occurred
247            */
248            public int filterCountByGroupId(long groupId)
249                    throws com.liferay.portal.kernel.exception.SystemException;
250    
251            /**
252            * Returns the asset tag where groupId = &#63; and name = &#63; or throws a {@link com.liferay.portlet.asset.NoSuchTagException} if it could not be found.
253            *
254            * @param groupId the group ID
255            * @param name the name
256            * @return the matching asset tag
257            * @throws com.liferay.portlet.asset.NoSuchTagException if a matching asset tag could not be found
258            * @throws SystemException if a system exception occurred
259            */
260            public com.liferay.portlet.asset.model.AssetTag findByG_N(long groupId,
261                    java.lang.String name)
262                    throws com.liferay.portal.kernel.exception.SystemException,
263                            com.liferay.portlet.asset.NoSuchTagException;
264    
265            /**
266            * Returns the asset tag where groupId = &#63; and name = &#63; or returns <code>null</code> if it could not be found. Uses the finder cache.
267            *
268            * @param groupId the group ID
269            * @param name the name
270            * @return the matching asset tag, or <code>null</code> if a matching asset tag could not be found
271            * @throws SystemException if a system exception occurred
272            */
273            public com.liferay.portlet.asset.model.AssetTag fetchByG_N(long groupId,
274                    java.lang.String name)
275                    throws com.liferay.portal.kernel.exception.SystemException;
276    
277            /**
278            * Returns the asset tag where groupId = &#63; and name = &#63; or returns <code>null</code> if it could not be found, optionally using the finder cache.
279            *
280            * @param groupId the group ID
281            * @param name the name
282            * @param retrieveFromCache whether to use the finder cache
283            * @return the matching asset tag, or <code>null</code> if a matching asset tag could not be found
284            * @throws SystemException if a system exception occurred
285            */
286            public com.liferay.portlet.asset.model.AssetTag fetchByG_N(long groupId,
287                    java.lang.String name, boolean retrieveFromCache)
288                    throws com.liferay.portal.kernel.exception.SystemException;
289    
290            /**
291            * Removes the asset tag where groupId = &#63; and name = &#63; from the database.
292            *
293            * @param groupId the group ID
294            * @param name the name
295            * @return the asset tag that was removed
296            * @throws SystemException if a system exception occurred
297            */
298            public com.liferay.portlet.asset.model.AssetTag removeByG_N(long groupId,
299                    java.lang.String name)
300                    throws com.liferay.portal.kernel.exception.SystemException,
301                            com.liferay.portlet.asset.NoSuchTagException;
302    
303            /**
304            * Returns the number of asset tags where groupId = &#63; and name = &#63;.
305            *
306            * @param groupId the group ID
307            * @param name the name
308            * @return the number of matching asset tags
309            * @throws SystemException if a system exception occurred
310            */
311            public int countByG_N(long groupId, java.lang.String name)
312                    throws com.liferay.portal.kernel.exception.SystemException;
313    
314            /**
315            * Caches the asset tag in the entity cache if it is enabled.
316            *
317            * @param assetTag the asset tag
318            */
319            public void cacheResult(com.liferay.portlet.asset.model.AssetTag assetTag);
320    
321            /**
322            * Caches the asset tags in the entity cache if it is enabled.
323            *
324            * @param assetTags the asset tags
325            */
326            public void cacheResult(
327                    java.util.List<com.liferay.portlet.asset.model.AssetTag> assetTags);
328    
329            /**
330            * Creates a new asset tag with the primary key. Does not add the asset tag to the database.
331            *
332            * @param tagId the primary key for the new asset tag
333            * @return the new asset tag
334            */
335            public com.liferay.portlet.asset.model.AssetTag create(long tagId);
336    
337            /**
338            * Removes the asset tag with the primary key from the database. Also notifies the appropriate model listeners.
339            *
340            * @param tagId the primary key of the asset tag
341            * @return the asset tag that was removed
342            * @throws com.liferay.portlet.asset.NoSuchTagException if a asset tag with the primary key could not be found
343            * @throws SystemException if a system exception occurred
344            */
345            public com.liferay.portlet.asset.model.AssetTag remove(long tagId)
346                    throws com.liferay.portal.kernel.exception.SystemException,
347                            com.liferay.portlet.asset.NoSuchTagException;
348    
349            public com.liferay.portlet.asset.model.AssetTag updateImpl(
350                    com.liferay.portlet.asset.model.AssetTag assetTag)
351                    throws com.liferay.portal.kernel.exception.SystemException;
352    
353            /**
354            * Returns the asset tag with the primary key or throws a {@link com.liferay.portlet.asset.NoSuchTagException} if it could not be found.
355            *
356            * @param tagId the primary key of the asset tag
357            * @return the asset tag
358            * @throws com.liferay.portlet.asset.NoSuchTagException if a asset tag with the primary key could not be found
359            * @throws SystemException if a system exception occurred
360            */
361            public com.liferay.portlet.asset.model.AssetTag findByPrimaryKey(long tagId)
362                    throws com.liferay.portal.kernel.exception.SystemException,
363                            com.liferay.portlet.asset.NoSuchTagException;
364    
365            /**
366            * Returns the asset tag with the primary key or returns <code>null</code> if it could not be found.
367            *
368            * @param tagId the primary key of the asset tag
369            * @return the asset tag, or <code>null</code> if a asset tag with the primary key could not be found
370            * @throws SystemException if a system exception occurred
371            */
372            public com.liferay.portlet.asset.model.AssetTag fetchByPrimaryKey(
373                    long tagId) throws com.liferay.portal.kernel.exception.SystemException;
374    
375            /**
376            * Returns all the asset tags.
377            *
378            * @return the asset tags
379            * @throws SystemException if a system exception occurred
380            */
381            public java.util.List<com.liferay.portlet.asset.model.AssetTag> findAll()
382                    throws com.liferay.portal.kernel.exception.SystemException;
383    
384            /**
385            * Returns a range of all the asset tags.
386            *
387            * <p>
388            * 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.asset.model.impl.AssetTagModelImpl}. 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.
389            * </p>
390            *
391            * @param start the lower bound of the range of asset tags
392            * @param end the upper bound of the range of asset tags (not inclusive)
393            * @return the range of asset tags
394            * @throws SystemException if a system exception occurred
395            */
396            public java.util.List<com.liferay.portlet.asset.model.AssetTag> findAll(
397                    int start, int end)
398                    throws com.liferay.portal.kernel.exception.SystemException;
399    
400            /**
401            * Returns an ordered range of all the asset tags.
402            *
403            * <p>
404            * 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.asset.model.impl.AssetTagModelImpl}. 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.
405            * </p>
406            *
407            * @param start the lower bound of the range of asset tags
408            * @param end the upper bound of the range of asset tags (not inclusive)
409            * @param orderByComparator the comparator to order the results by (optionally <code>null</code>)
410            * @return the ordered range of asset tags
411            * @throws SystemException if a system exception occurred
412            */
413            public java.util.List<com.liferay.portlet.asset.model.AssetTag> findAll(
414                    int start, int end,
415                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
416                    throws com.liferay.portal.kernel.exception.SystemException;
417    
418            /**
419            * Removes all the asset tags from the database.
420            *
421            * @throws SystemException if a system exception occurred
422            */
423            public void removeAll()
424                    throws com.liferay.portal.kernel.exception.SystemException;
425    
426            /**
427            * Returns the number of asset tags.
428            *
429            * @return the number of asset tags
430            * @throws SystemException if a system exception occurred
431            */
432            public int countAll()
433                    throws com.liferay.portal.kernel.exception.SystemException;
434    
435            /**
436            * Returns all the asset entries associated with the asset tag.
437            *
438            * @param pk the primary key of the asset tag
439            * @return the asset entries associated with the asset tag
440            * @throws SystemException if a system exception occurred
441            */
442            public java.util.List<com.liferay.portlet.asset.model.AssetEntry> getAssetEntries(
443                    long pk) throws com.liferay.portal.kernel.exception.SystemException;
444    
445            /**
446            * Returns a range of all the asset entries associated with the asset tag.
447            *
448            * <p>
449            * 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.asset.model.impl.AssetTagModelImpl}. 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.
450            * </p>
451            *
452            * @param pk the primary key of the asset tag
453            * @param start the lower bound of the range of asset tags
454            * @param end the upper bound of the range of asset tags (not inclusive)
455            * @return the range of asset entries associated with the asset tag
456            * @throws SystemException if a system exception occurred
457            */
458            public java.util.List<com.liferay.portlet.asset.model.AssetEntry> getAssetEntries(
459                    long pk, int start, int end)
460                    throws com.liferay.portal.kernel.exception.SystemException;
461    
462            /**
463            * Returns an ordered range of all the asset entries associated with the asset tag.
464            *
465            * <p>
466            * 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.asset.model.impl.AssetTagModelImpl}. 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.
467            * </p>
468            *
469            * @param pk the primary key of the asset tag
470            * @param start the lower bound of the range of asset tags
471            * @param end the upper bound of the range of asset tags (not inclusive)
472            * @param orderByComparator the comparator to order the results by (optionally <code>null</code>)
473            * @return the ordered range of asset entries associated with the asset tag
474            * @throws SystemException if a system exception occurred
475            */
476            public java.util.List<com.liferay.portlet.asset.model.AssetEntry> getAssetEntries(
477                    long pk, int start, int end,
478                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
479                    throws com.liferay.portal.kernel.exception.SystemException;
480    
481            /**
482            * Returns the number of asset entries associated with the asset tag.
483            *
484            * @param pk the primary key of the asset tag
485            * @return the number of asset entries associated with the asset tag
486            * @throws SystemException if a system exception occurred
487            */
488            public int getAssetEntriesSize(long pk)
489                    throws com.liferay.portal.kernel.exception.SystemException;
490    
491            /**
492            * Returns <code>true</code> if the asset entry is associated with the asset tag.
493            *
494            * @param pk the primary key of the asset tag
495            * @param assetEntryPK the primary key of the asset entry
496            * @return <code>true</code> if the asset entry is associated with the asset tag; <code>false</code> otherwise
497            * @throws SystemException if a system exception occurred
498            */
499            public boolean containsAssetEntry(long pk, long assetEntryPK)
500                    throws com.liferay.portal.kernel.exception.SystemException;
501    
502            /**
503            * Returns <code>true</code> if the asset tag has any asset entries associated with it.
504            *
505            * @param pk the primary key of the asset tag to check for associations with asset entries
506            * @return <code>true</code> if the asset tag has any asset entries associated with it; <code>false</code> otherwise
507            * @throws SystemException if a system exception occurred
508            */
509            public boolean containsAssetEntries(long pk)
510                    throws com.liferay.portal.kernel.exception.SystemException;
511    
512            /**
513            * Adds an association between the asset tag and the asset entry. Also notifies the appropriate model listeners and clears the mapping table finder cache.
514            *
515            * @param pk the primary key of the asset tag
516            * @param assetEntryPK the primary key of the asset entry
517            * @throws SystemException if a system exception occurred
518            */
519            public void addAssetEntry(long pk, long assetEntryPK)
520                    throws com.liferay.portal.kernel.exception.SystemException;
521    
522            /**
523            * Adds an association between the asset tag and the asset entry. Also notifies the appropriate model listeners and clears the mapping table finder cache.
524            *
525            * @param pk the primary key of the asset tag
526            * @param assetEntry the asset entry
527            * @throws SystemException if a system exception occurred
528            */
529            public void addAssetEntry(long pk,
530                    com.liferay.portlet.asset.model.AssetEntry assetEntry)
531                    throws com.liferay.portal.kernel.exception.SystemException;
532    
533            /**
534            * Adds an association between the asset tag and the asset entries. Also notifies the appropriate model listeners and clears the mapping table finder cache.
535            *
536            * @param pk the primary key of the asset tag
537            * @param assetEntryPKs the primary keys of the asset entries
538            * @throws SystemException if a system exception occurred
539            */
540            public void addAssetEntries(long pk, long[] assetEntryPKs)
541                    throws com.liferay.portal.kernel.exception.SystemException;
542    
543            /**
544            * Adds an association between the asset tag and the asset entries. Also notifies the appropriate model listeners and clears the mapping table finder cache.
545            *
546            * @param pk the primary key of the asset tag
547            * @param assetEntries the asset entries
548            * @throws SystemException if a system exception occurred
549            */
550            public void addAssetEntries(long pk,
551                    java.util.List<com.liferay.portlet.asset.model.AssetEntry> assetEntries)
552                    throws com.liferay.portal.kernel.exception.SystemException;
553    
554            /**
555            * Clears all associations between the asset tag and its asset entries. Also notifies the appropriate model listeners and clears the mapping table finder cache.
556            *
557            * @param pk the primary key of the asset tag to clear the associated asset entries from
558            * @throws SystemException if a system exception occurred
559            */
560            public void clearAssetEntries(long pk)
561                    throws com.liferay.portal.kernel.exception.SystemException;
562    
563            /**
564            * Removes the association between the asset tag and the asset entry. Also notifies the appropriate model listeners and clears the mapping table finder cache.
565            *
566            * @param pk the primary key of the asset tag
567            * @param assetEntryPK the primary key of the asset entry
568            * @throws SystemException if a system exception occurred
569            */
570            public void removeAssetEntry(long pk, long assetEntryPK)
571                    throws com.liferay.portal.kernel.exception.SystemException;
572    
573            /**
574            * Removes the association between the asset tag and the asset entry. Also notifies the appropriate model listeners and clears the mapping table finder cache.
575            *
576            * @param pk the primary key of the asset tag
577            * @param assetEntry the asset entry
578            * @throws SystemException if a system exception occurred
579            */
580            public void removeAssetEntry(long pk,
581                    com.liferay.portlet.asset.model.AssetEntry assetEntry)
582                    throws com.liferay.portal.kernel.exception.SystemException;
583    
584            /**
585            * Removes the association between the asset tag and the asset entries. Also notifies the appropriate model listeners and clears the mapping table finder cache.
586            *
587            * @param pk the primary key of the asset tag
588            * @param assetEntryPKs the primary keys of the asset entries
589            * @throws SystemException if a system exception occurred
590            */
591            public void removeAssetEntries(long pk, long[] assetEntryPKs)
592                    throws com.liferay.portal.kernel.exception.SystemException;
593    
594            /**
595            * Removes the association between the asset tag and the asset entries. Also notifies the appropriate model listeners and clears the mapping table finder cache.
596            *
597            * @param pk the primary key of the asset tag
598            * @param assetEntries the asset entries
599            * @throws SystemException if a system exception occurred
600            */
601            public void removeAssetEntries(long pk,
602                    java.util.List<com.liferay.portlet.asset.model.AssetEntry> assetEntries)
603                    throws com.liferay.portal.kernel.exception.SystemException;
604    
605            /**
606            * Sets the asset entries associated with the asset tag, removing and adding associations as necessary. Also notifies the appropriate model listeners and clears the mapping table finder cache.
607            *
608            * @param pk the primary key of the asset tag
609            * @param assetEntryPKs the primary keys of the asset entries to be associated with the asset tag
610            * @throws SystemException if a system exception occurred
611            */
612            public void setAssetEntries(long pk, long[] assetEntryPKs)
613                    throws com.liferay.portal.kernel.exception.SystemException;
614    
615            /**
616            * Sets the asset entries associated with the asset tag, removing and adding associations as necessary. Also notifies the appropriate model listeners and clears the mapping table finder cache.
617            *
618            * @param pk the primary key of the asset tag
619            * @param assetEntries the asset entries to be associated with the asset tag
620            * @throws SystemException if a system exception occurred
621            */
622            public void setAssetEntries(long pk,
623                    java.util.List<com.liferay.portlet.asset.model.AssetEntry> assetEntries)
624                    throws com.liferay.portal.kernel.exception.SystemException;
625    }