001    /**
002     * Copyright (c) 2000-2011 Liferay, Inc. All rights reserved.
003     *
004     * The contents of this file are subject to the terms of the Liferay Enterprise
005     * Subscription License ("License"). You may not use this file except in
006     * compliance with the License. You can obtain a copy of the License by
007     * contacting Liferay, Inc. See the License for the specific language governing
008     * permissions and limitations under the License, including but not limited to
009     * distribution rights of the Software.
010     *
011     *
012     *
013     */
014    
015    package com.liferay.portal.service.persistence;
016    
017    import com.liferay.portal.kernel.exception.SystemException;
018    import com.liferay.portal.model.Role;
019    
020    /**
021     * The persistence interface for the role service.
022     *
023     * <p>
024     * Caching information and settings can be found in <code>portal.properties</code>
025     * </p>
026     *
027     * @author Brian Wing Shun Chan
028     * @see RolePersistenceImpl
029     * @see RoleUtil
030     * @generated
031     */
032    public interface RolePersistence extends BasePersistence<Role> {
033            /*
034             * NOTE FOR DEVELOPERS:
035             *
036             * Never modify or reference this interface directly. Always use {@link RoleUtil} to access the role persistence. Modify <code>service.xml</code> and rerun ServiceBuilder to regenerate this interface.
037             */
038    
039            /**
040            * Caches the role in the entity cache if it is enabled.
041            *
042            * @param role the role to cache
043            */
044            public void cacheResult(com.liferay.portal.model.Role role);
045    
046            /**
047            * Caches the roles in the entity cache if it is enabled.
048            *
049            * @param roles the roles to cache
050            */
051            public void cacheResult(java.util.List<com.liferay.portal.model.Role> roles);
052    
053            /**
054            * Creates a new role with the primary key. Does not add the role to the database.
055            *
056            * @param roleId the primary key for the new role
057            * @return the new role
058            */
059            public com.liferay.portal.model.Role create(long roleId);
060    
061            /**
062            * Removes the role with the primary key from the database. Also notifies the appropriate model listeners.
063            *
064            * @param roleId the primary key of the role to remove
065            * @return the role that was removed
066            * @throws com.liferay.portal.NoSuchRoleException if a role with the primary key could not be found
067            * @throws SystemException if a system exception occurred
068            */
069            public com.liferay.portal.model.Role remove(long roleId)
070                    throws com.liferay.portal.NoSuchRoleException,
071                            com.liferay.portal.kernel.exception.SystemException;
072    
073            public com.liferay.portal.model.Role updateImpl(
074                    com.liferay.portal.model.Role role, boolean merge)
075                    throws com.liferay.portal.kernel.exception.SystemException;
076    
077            /**
078            * Finds the role with the primary key or throws a {@link com.liferay.portal.NoSuchRoleException} if it could not be found.
079            *
080            * @param roleId the primary key of the role to find
081            * @return the role
082            * @throws com.liferay.portal.NoSuchRoleException if a role with the primary key could not be found
083            * @throws SystemException if a system exception occurred
084            */
085            public com.liferay.portal.model.Role findByPrimaryKey(long roleId)
086                    throws com.liferay.portal.NoSuchRoleException,
087                            com.liferay.portal.kernel.exception.SystemException;
088    
089            /**
090            * Finds the role with the primary key or returns <code>null</code> if it could not be found.
091            *
092            * @param roleId the primary key of the role to find
093            * @return the role, or <code>null</code> if a role with the primary key could not be found
094            * @throws SystemException if a system exception occurred
095            */
096            public com.liferay.portal.model.Role fetchByPrimaryKey(long roleId)
097                    throws com.liferay.portal.kernel.exception.SystemException;
098    
099            /**
100            * Finds all the roles where companyId = &#63;.
101            *
102            * @param companyId the company ID to search with
103            * @return the matching roles
104            * @throws SystemException if a system exception occurred
105            */
106            public java.util.List<com.liferay.portal.model.Role> findByCompanyId(
107                    long companyId)
108                    throws com.liferay.portal.kernel.exception.SystemException;
109    
110            /**
111            * Finds a range of all the roles where companyId = &#63;.
112            *
113            * <p>
114            * 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.
115            * </p>
116            *
117            * @param companyId the company ID to search with
118            * @param start the lower bound of the range of roles to return
119            * @param end the upper bound of the range of roles to return (not inclusive)
120            * @return the range of matching roles
121            * @throws SystemException if a system exception occurred
122            */
123            public java.util.List<com.liferay.portal.model.Role> findByCompanyId(
124                    long companyId, int start, int end)
125                    throws com.liferay.portal.kernel.exception.SystemException;
126    
127            /**
128            * Finds an ordered range of all the roles where companyId = &#63;.
129            *
130            * <p>
131            * 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.
132            * </p>
133            *
134            * @param companyId the company ID to search with
135            * @param start the lower bound of the range of roles to return
136            * @param end the upper bound of the range of roles to return (not inclusive)
137            * @param orderByComparator the comparator to order the results by
138            * @return the ordered range of matching roles
139            * @throws SystemException if a system exception occurred
140            */
141            public java.util.List<com.liferay.portal.model.Role> findByCompanyId(
142                    long companyId, int start, int end,
143                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
144                    throws com.liferay.portal.kernel.exception.SystemException;
145    
146            /**
147            * Finds the first role in the ordered set where companyId = &#63;.
148            *
149            * <p>
150            * 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.
151            * </p>
152            *
153            * @param companyId the company ID to search with
154            * @param orderByComparator the comparator to order the set by
155            * @return the first matching role
156            * @throws com.liferay.portal.NoSuchRoleException if a matching role could not be found
157            * @throws SystemException if a system exception occurred
158            */
159            public com.liferay.portal.model.Role findByCompanyId_First(long companyId,
160                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
161                    throws com.liferay.portal.NoSuchRoleException,
162                            com.liferay.portal.kernel.exception.SystemException;
163    
164            /**
165            * Finds the last role in the ordered set where companyId = &#63;.
166            *
167            * <p>
168            * 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.
169            * </p>
170            *
171            * @param companyId the company ID to search with
172            * @param orderByComparator the comparator to order the set by
173            * @return the last matching role
174            * @throws com.liferay.portal.NoSuchRoleException if a matching role could not be found
175            * @throws SystemException if a system exception occurred
176            */
177            public com.liferay.portal.model.Role findByCompanyId_Last(long companyId,
178                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
179                    throws com.liferay.portal.NoSuchRoleException,
180                            com.liferay.portal.kernel.exception.SystemException;
181    
182            /**
183            * Finds the roles before and after the current role in the ordered set where companyId = &#63;.
184            *
185            * <p>
186            * 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.
187            * </p>
188            *
189            * @param roleId the primary key of the current role
190            * @param companyId the company ID to search with
191            * @param orderByComparator the comparator to order the set by
192            * @return the previous, current, and next role
193            * @throws com.liferay.portal.NoSuchRoleException if a role with the primary key could not be found
194            * @throws SystemException if a system exception occurred
195            */
196            public com.liferay.portal.model.Role[] findByCompanyId_PrevAndNext(
197                    long roleId, long companyId,
198                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
199                    throws com.liferay.portal.NoSuchRoleException,
200                            com.liferay.portal.kernel.exception.SystemException;
201    
202            /**
203            * Filters by the user's permissions and finds all the roles where companyId = &#63;.
204            *
205            * @param companyId the company ID to search with
206            * @return the matching roles that the user has permission to view
207            * @throws SystemException if a system exception occurred
208            */
209            public java.util.List<com.liferay.portal.model.Role> filterFindByCompanyId(
210                    long companyId)
211                    throws com.liferay.portal.kernel.exception.SystemException;
212    
213            /**
214            * Filters by the user's permissions and finds a range of all the roles where companyId = &#63;.
215            *
216            * <p>
217            * 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.
218            * </p>
219            *
220            * @param companyId the company ID to search with
221            * @param start the lower bound of the range of roles to return
222            * @param end the upper bound of the range of roles to return (not inclusive)
223            * @return the range of matching roles that the user has permission to view
224            * @throws SystemException if a system exception occurred
225            */
226            public java.util.List<com.liferay.portal.model.Role> filterFindByCompanyId(
227                    long companyId, int start, int end)
228                    throws com.liferay.portal.kernel.exception.SystemException;
229    
230            /**
231            * Filters by the user's permissions and finds an ordered range of all the roles where companyId = &#63;.
232            *
233            * <p>
234            * 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.
235            * </p>
236            *
237            * @param companyId the company ID to search with
238            * @param start the lower bound of the range of roles to return
239            * @param end the upper bound of the range of roles to return (not inclusive)
240            * @param orderByComparator the comparator to order the results by
241            * @return the ordered range of matching roles that the user has permission to view
242            * @throws SystemException if a system exception occurred
243            */
244            public java.util.List<com.liferay.portal.model.Role> filterFindByCompanyId(
245                    long companyId, int start, int end,
246                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
247                    throws com.liferay.portal.kernel.exception.SystemException;
248    
249            /**
250            * Filters the roles before and after the current role in the ordered set where companyId = &#63;.
251            *
252            * <p>
253            * 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.
254            * </p>
255            *
256            * @param roleId the primary key of the current role
257            * @param companyId the company ID to search with
258            * @param orderByComparator the comparator to order the set by
259            * @return the previous, current, and next role
260            * @throws com.liferay.portal.NoSuchRoleException if a role with the primary key could not be found
261            * @throws SystemException if a system exception occurred
262            */
263            public com.liferay.portal.model.Role[] filterFindByCompanyId_PrevAndNext(
264                    long roleId, long companyId,
265                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
266                    throws com.liferay.portal.NoSuchRoleException,
267                            com.liferay.portal.kernel.exception.SystemException;
268    
269            /**
270            * Finds all the roles where name = &#63;.
271            *
272            * @param name the name to search with
273            * @return the matching roles
274            * @throws SystemException if a system exception occurred
275            */
276            public java.util.List<com.liferay.portal.model.Role> findByName(
277                    java.lang.String name)
278                    throws com.liferay.portal.kernel.exception.SystemException;
279    
280            /**
281            * Finds a range of all the roles where name = &#63;.
282            *
283            * <p>
284            * 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.
285            * </p>
286            *
287            * @param name the name to search with
288            * @param start the lower bound of the range of roles to return
289            * @param end the upper bound of the range of roles to return (not inclusive)
290            * @return the range of matching roles
291            * @throws SystemException if a system exception occurred
292            */
293            public java.util.List<com.liferay.portal.model.Role> findByName(
294                    java.lang.String name, int start, int end)
295                    throws com.liferay.portal.kernel.exception.SystemException;
296    
297            /**
298            * Finds an ordered range of all the roles where name = &#63;.
299            *
300            * <p>
301            * 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.
302            * </p>
303            *
304            * @param name the name to search with
305            * @param start the lower bound of the range of roles to return
306            * @param end the upper bound of the range of roles to return (not inclusive)
307            * @param orderByComparator the comparator to order the results by
308            * @return the ordered range of matching roles
309            * @throws SystemException if a system exception occurred
310            */
311            public java.util.List<com.liferay.portal.model.Role> findByName(
312                    java.lang.String name, int start, int end,
313                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
314                    throws com.liferay.portal.kernel.exception.SystemException;
315    
316            /**
317            * Finds the first role in the ordered set where name = &#63;.
318            *
319            * <p>
320            * 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.
321            * </p>
322            *
323            * @param name the name to search with
324            * @param orderByComparator the comparator to order the set by
325            * @return the first matching role
326            * @throws com.liferay.portal.NoSuchRoleException if a matching role could not be found
327            * @throws SystemException if a system exception occurred
328            */
329            public com.liferay.portal.model.Role findByName_First(
330                    java.lang.String name,
331                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
332                    throws com.liferay.portal.NoSuchRoleException,
333                            com.liferay.portal.kernel.exception.SystemException;
334    
335            /**
336            * Finds the last role in the ordered set where name = &#63;.
337            *
338            * <p>
339            * 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.
340            * </p>
341            *
342            * @param name the name to search with
343            * @param orderByComparator the comparator to order the set by
344            * @return the last matching role
345            * @throws com.liferay.portal.NoSuchRoleException if a matching role could not be found
346            * @throws SystemException if a system exception occurred
347            */
348            public com.liferay.portal.model.Role findByName_Last(
349                    java.lang.String name,
350                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
351                    throws com.liferay.portal.NoSuchRoleException,
352                            com.liferay.portal.kernel.exception.SystemException;
353    
354            /**
355            * Finds the roles before and after the current role in the ordered set where name = &#63;.
356            *
357            * <p>
358            * 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.
359            * </p>
360            *
361            * @param roleId the primary key of the current role
362            * @param name the name to search with
363            * @param orderByComparator the comparator to order the set by
364            * @return the previous, current, and next role
365            * @throws com.liferay.portal.NoSuchRoleException if a role with the primary key could not be found
366            * @throws SystemException if a system exception occurred
367            */
368            public com.liferay.portal.model.Role[] findByName_PrevAndNext(long roleId,
369                    java.lang.String name,
370                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
371                    throws com.liferay.portal.NoSuchRoleException,
372                            com.liferay.portal.kernel.exception.SystemException;
373    
374            /**
375            * Filters by the user's permissions and finds all the roles where name = &#63;.
376            *
377            * @param name the name to search with
378            * @return the matching roles that the user has permission to view
379            * @throws SystemException if a system exception occurred
380            */
381            public java.util.List<com.liferay.portal.model.Role> filterFindByName(
382                    java.lang.String name)
383                    throws com.liferay.portal.kernel.exception.SystemException;
384    
385            /**
386            * Filters by the user's permissions and finds a range of all the roles where name = &#63;.
387            *
388            * <p>
389            * 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.
390            * </p>
391            *
392            * @param name the name to search with
393            * @param start the lower bound of the range of roles to return
394            * @param end the upper bound of the range of roles to return (not inclusive)
395            * @return the range of matching roles that the user has permission to view
396            * @throws SystemException if a system exception occurred
397            */
398            public java.util.List<com.liferay.portal.model.Role> filterFindByName(
399                    java.lang.String name, int start, int end)
400                    throws com.liferay.portal.kernel.exception.SystemException;
401    
402            /**
403            * Filters by the user's permissions and finds an ordered range of all the roles where name = &#63;.
404            *
405            * <p>
406            * 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.
407            * </p>
408            *
409            * @param name the name to search with
410            * @param start the lower bound of the range of roles to return
411            * @param end the upper bound of the range of roles to return (not inclusive)
412            * @param orderByComparator the comparator to order the results by
413            * @return the ordered range of matching roles that the user has permission to view
414            * @throws SystemException if a system exception occurred
415            */
416            public java.util.List<com.liferay.portal.model.Role> filterFindByName(
417                    java.lang.String name, int start, int end,
418                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
419                    throws com.liferay.portal.kernel.exception.SystemException;
420    
421            /**
422            * Filters the roles before and after the current role in the ordered set where name = &#63;.
423            *
424            * <p>
425            * 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.
426            * </p>
427            *
428            * @param roleId the primary key of the current role
429            * @param name the name to search with
430            * @param orderByComparator the comparator to order the set by
431            * @return the previous, current, and next role
432            * @throws com.liferay.portal.NoSuchRoleException if a role with the primary key could not be found
433            * @throws SystemException if a system exception occurred
434            */
435            public com.liferay.portal.model.Role[] filterFindByName_PrevAndNext(
436                    long roleId, java.lang.String name,
437                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
438                    throws com.liferay.portal.NoSuchRoleException,
439                            com.liferay.portal.kernel.exception.SystemException;
440    
441            /**
442            * Finds all the roles where subtype = &#63;.
443            *
444            * @param subtype the subtype to search with
445            * @return the matching roles
446            * @throws SystemException if a system exception occurred
447            */
448            public java.util.List<com.liferay.portal.model.Role> findBySubtype(
449                    java.lang.String subtype)
450                    throws com.liferay.portal.kernel.exception.SystemException;
451    
452            /**
453            * Finds a range of all the roles where subtype = &#63;.
454            *
455            * <p>
456            * 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.
457            * </p>
458            *
459            * @param subtype the subtype to search with
460            * @param start the lower bound of the range of roles to return
461            * @param end the upper bound of the range of roles to return (not inclusive)
462            * @return the range of matching roles
463            * @throws SystemException if a system exception occurred
464            */
465            public java.util.List<com.liferay.portal.model.Role> findBySubtype(
466                    java.lang.String subtype, int start, int end)
467                    throws com.liferay.portal.kernel.exception.SystemException;
468    
469            /**
470            * Finds an ordered range of all the roles where subtype = &#63;.
471            *
472            * <p>
473            * 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.
474            * </p>
475            *
476            * @param subtype the subtype to search with
477            * @param start the lower bound of the range of roles to return
478            * @param end the upper bound of the range of roles to return (not inclusive)
479            * @param orderByComparator the comparator to order the results by
480            * @return the ordered range of matching roles
481            * @throws SystemException if a system exception occurred
482            */
483            public java.util.List<com.liferay.portal.model.Role> findBySubtype(
484                    java.lang.String subtype, int start, int end,
485                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
486                    throws com.liferay.portal.kernel.exception.SystemException;
487    
488            /**
489            * Finds the first role in the ordered set where subtype = &#63;.
490            *
491            * <p>
492            * 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.
493            * </p>
494            *
495            * @param subtype the subtype to search with
496            * @param orderByComparator the comparator to order the set by
497            * @return the first matching role
498            * @throws com.liferay.portal.NoSuchRoleException if a matching role could not be found
499            * @throws SystemException if a system exception occurred
500            */
501            public com.liferay.portal.model.Role findBySubtype_First(
502                    java.lang.String subtype,
503                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
504                    throws com.liferay.portal.NoSuchRoleException,
505                            com.liferay.portal.kernel.exception.SystemException;
506    
507            /**
508            * Finds the last role in the ordered set where subtype = &#63;.
509            *
510            * <p>
511            * 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.
512            * </p>
513            *
514            * @param subtype the subtype to search with
515            * @param orderByComparator the comparator to order the set by
516            * @return the last matching role
517            * @throws com.liferay.portal.NoSuchRoleException if a matching role could not be found
518            * @throws SystemException if a system exception occurred
519            */
520            public com.liferay.portal.model.Role findBySubtype_Last(
521                    java.lang.String subtype,
522                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
523                    throws com.liferay.portal.NoSuchRoleException,
524                            com.liferay.portal.kernel.exception.SystemException;
525    
526            /**
527            * Finds the roles before and after the current role in the ordered set where subtype = &#63;.
528            *
529            * <p>
530            * 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.
531            * </p>
532            *
533            * @param roleId the primary key of the current role
534            * @param subtype the subtype to search with
535            * @param orderByComparator the comparator to order the set by
536            * @return the previous, current, and next role
537            * @throws com.liferay.portal.NoSuchRoleException if a role with the primary key could not be found
538            * @throws SystemException if a system exception occurred
539            */
540            public com.liferay.portal.model.Role[] findBySubtype_PrevAndNext(
541                    long roleId, java.lang.String subtype,
542                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
543                    throws com.liferay.portal.NoSuchRoleException,
544                            com.liferay.portal.kernel.exception.SystemException;
545    
546            /**
547            * Filters by the user's permissions and finds all the roles where subtype = &#63;.
548            *
549            * @param subtype the subtype to search with
550            * @return the matching roles that the user has permission to view
551            * @throws SystemException if a system exception occurred
552            */
553            public java.util.List<com.liferay.portal.model.Role> filterFindBySubtype(
554                    java.lang.String subtype)
555                    throws com.liferay.portal.kernel.exception.SystemException;
556    
557            /**
558            * Filters by the user's permissions and finds a range of all the roles where subtype = &#63;.
559            *
560            * <p>
561            * 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.
562            * </p>
563            *
564            * @param subtype the subtype to search with
565            * @param start the lower bound of the range of roles to return
566            * @param end the upper bound of the range of roles to return (not inclusive)
567            * @return the range of matching roles that the user has permission to view
568            * @throws SystemException if a system exception occurred
569            */
570            public java.util.List<com.liferay.portal.model.Role> filterFindBySubtype(
571                    java.lang.String subtype, int start, int end)
572                    throws com.liferay.portal.kernel.exception.SystemException;
573    
574            /**
575            * Filters by the user's permissions and finds an ordered range of all the roles where subtype = &#63;.
576            *
577            * <p>
578            * 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.
579            * </p>
580            *
581            * @param subtype the subtype to search with
582            * @param start the lower bound of the range of roles to return
583            * @param end the upper bound of the range of roles to return (not inclusive)
584            * @param orderByComparator the comparator to order the results by
585            * @return the ordered range of matching roles that the user has permission to view
586            * @throws SystemException if a system exception occurred
587            */
588            public java.util.List<com.liferay.portal.model.Role> filterFindBySubtype(
589                    java.lang.String subtype, int start, int end,
590                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
591                    throws com.liferay.portal.kernel.exception.SystemException;
592    
593            /**
594            * Filters the roles before and after the current role in the ordered set where subtype = &#63;.
595            *
596            * <p>
597            * 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.
598            * </p>
599            *
600            * @param roleId the primary key of the current role
601            * @param subtype the subtype to search with
602            * @param orderByComparator the comparator to order the set by
603            * @return the previous, current, and next role
604            * @throws com.liferay.portal.NoSuchRoleException if a role with the primary key could not be found
605            * @throws SystemException if a system exception occurred
606            */
607            public com.liferay.portal.model.Role[] filterFindBySubtype_PrevAndNext(
608                    long roleId, java.lang.String subtype,
609                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
610                    throws com.liferay.portal.NoSuchRoleException,
611                            com.liferay.portal.kernel.exception.SystemException;
612    
613            /**
614            * Finds the role where companyId = &#63; and name = &#63; or throws a {@link com.liferay.portal.NoSuchRoleException} if it could not be found.
615            *
616            * @param companyId the company ID to search with
617            * @param name the name to search with
618            * @return the matching role
619            * @throws com.liferay.portal.NoSuchRoleException if a matching role could not be found
620            * @throws SystemException if a system exception occurred
621            */
622            public com.liferay.portal.model.Role findByC_N(long companyId,
623                    java.lang.String name)
624                    throws com.liferay.portal.NoSuchRoleException,
625                            com.liferay.portal.kernel.exception.SystemException;
626    
627            /**
628            * Finds the role where companyId = &#63; and name = &#63; or returns <code>null</code> if it could not be found. Uses the finder cache.
629            *
630            * @param companyId the company ID to search with
631            * @param name the name to search with
632            * @return the matching role, or <code>null</code> if a matching role could not be found
633            * @throws SystemException if a system exception occurred
634            */
635            public com.liferay.portal.model.Role fetchByC_N(long companyId,
636                    java.lang.String name)
637                    throws com.liferay.portal.kernel.exception.SystemException;
638    
639            /**
640            * Finds the role where companyId = &#63; and name = &#63; or returns <code>null</code> if it could not be found, optionally using the finder cache.
641            *
642            * @param companyId the company ID to search with
643            * @param name the name to search with
644            * @return the matching role, or <code>null</code> if a matching role could not be found
645            * @throws SystemException if a system exception occurred
646            */
647            public com.liferay.portal.model.Role fetchByC_N(long companyId,
648                    java.lang.String name, boolean retrieveFromCache)
649                    throws com.liferay.portal.kernel.exception.SystemException;
650    
651            /**
652            * Finds all the roles where type = &#63; and subtype = &#63;.
653            *
654            * @param type the type to search with
655            * @param subtype the subtype to search with
656            * @return the matching roles
657            * @throws SystemException if a system exception occurred
658            */
659            public java.util.List<com.liferay.portal.model.Role> findByT_S(int type,
660                    java.lang.String subtype)
661                    throws com.liferay.portal.kernel.exception.SystemException;
662    
663            /**
664            * Finds a range of all the roles where type = &#63; and subtype = &#63;.
665            *
666            * <p>
667            * 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.
668            * </p>
669            *
670            * @param type the type to search with
671            * @param subtype the subtype to search with
672            * @param start the lower bound of the range of roles to return
673            * @param end the upper bound of the range of roles to return (not inclusive)
674            * @return the range of matching roles
675            * @throws SystemException if a system exception occurred
676            */
677            public java.util.List<com.liferay.portal.model.Role> findByT_S(int type,
678                    java.lang.String subtype, int start, int end)
679                    throws com.liferay.portal.kernel.exception.SystemException;
680    
681            /**
682            * Finds an ordered range of all the roles where type = &#63; and subtype = &#63;.
683            *
684            * <p>
685            * 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.
686            * </p>
687            *
688            * @param type the type to search with
689            * @param subtype the subtype to search with
690            * @param start the lower bound of the range of roles to return
691            * @param end the upper bound of the range of roles to return (not inclusive)
692            * @param orderByComparator the comparator to order the results by
693            * @return the ordered range of matching roles
694            * @throws SystemException if a system exception occurred
695            */
696            public java.util.List<com.liferay.portal.model.Role> findByT_S(int type,
697                    java.lang.String subtype, int start, int end,
698                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
699                    throws com.liferay.portal.kernel.exception.SystemException;
700    
701            /**
702            * Finds the first role in the ordered set where type = &#63; and subtype = &#63;.
703            *
704            * <p>
705            * 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.
706            * </p>
707            *
708            * @param type the type to search with
709            * @param subtype the subtype to search with
710            * @param orderByComparator the comparator to order the set by
711            * @return the first matching role
712            * @throws com.liferay.portal.NoSuchRoleException if a matching role could not be found
713            * @throws SystemException if a system exception occurred
714            */
715            public com.liferay.portal.model.Role findByT_S_First(int type,
716                    java.lang.String subtype,
717                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
718                    throws com.liferay.portal.NoSuchRoleException,
719                            com.liferay.portal.kernel.exception.SystemException;
720    
721            /**
722            * Finds the last role in the ordered set where type = &#63; and subtype = &#63;.
723            *
724            * <p>
725            * 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.
726            * </p>
727            *
728            * @param type the type to search with
729            * @param subtype the subtype to search with
730            * @param orderByComparator the comparator to order the set by
731            * @return the last matching role
732            * @throws com.liferay.portal.NoSuchRoleException if a matching role could not be found
733            * @throws SystemException if a system exception occurred
734            */
735            public com.liferay.portal.model.Role findByT_S_Last(int type,
736                    java.lang.String subtype,
737                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
738                    throws com.liferay.portal.NoSuchRoleException,
739                            com.liferay.portal.kernel.exception.SystemException;
740    
741            /**
742            * Finds the roles before and after the current role in the ordered set where type = &#63; and subtype = &#63;.
743            *
744            * <p>
745            * 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.
746            * </p>
747            *
748            * @param roleId the primary key of the current role
749            * @param type the type to search with
750            * @param subtype the subtype to search with
751            * @param orderByComparator the comparator to order the set by
752            * @return the previous, current, and next role
753            * @throws com.liferay.portal.NoSuchRoleException if a role with the primary key could not be found
754            * @throws SystemException if a system exception occurred
755            */
756            public com.liferay.portal.model.Role[] findByT_S_PrevAndNext(long roleId,
757                    int type, java.lang.String subtype,
758                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
759                    throws com.liferay.portal.NoSuchRoleException,
760                            com.liferay.portal.kernel.exception.SystemException;
761    
762            /**
763            * Filters by the user's permissions and finds all the roles where type = &#63; and subtype = &#63;.
764            *
765            * @param type the type to search with
766            * @param subtype the subtype to search with
767            * @return the matching roles that the user has permission to view
768            * @throws SystemException if a system exception occurred
769            */
770            public java.util.List<com.liferay.portal.model.Role> filterFindByT_S(
771                    int type, java.lang.String subtype)
772                    throws com.liferay.portal.kernel.exception.SystemException;
773    
774            /**
775            * Filters by the user's permissions and finds a range of all the roles where type = &#63; and subtype = &#63;.
776            *
777            * <p>
778            * 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.
779            * </p>
780            *
781            * @param type the type to search with
782            * @param subtype the subtype to search with
783            * @param start the lower bound of the range of roles to return
784            * @param end the upper bound of the range of roles to return (not inclusive)
785            * @return the range of matching roles that the user has permission to view
786            * @throws SystemException if a system exception occurred
787            */
788            public java.util.List<com.liferay.portal.model.Role> filterFindByT_S(
789                    int type, java.lang.String subtype, int start, int end)
790                    throws com.liferay.portal.kernel.exception.SystemException;
791    
792            /**
793            * Filters by the user's permissions and finds an ordered range of all the roles where type = &#63; and subtype = &#63;.
794            *
795            * <p>
796            * 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.
797            * </p>
798            *
799            * @param type the type to search with
800            * @param subtype the subtype to search with
801            * @param start the lower bound of the range of roles to return
802            * @param end the upper bound of the range of roles to return (not inclusive)
803            * @param orderByComparator the comparator to order the results by
804            * @return the ordered range of matching roles that the user has permission to view
805            * @throws SystemException if a system exception occurred
806            */
807            public java.util.List<com.liferay.portal.model.Role> filterFindByT_S(
808                    int type, java.lang.String subtype, int start, int end,
809                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
810                    throws com.liferay.portal.kernel.exception.SystemException;
811    
812            /**
813            * Filters the roles before and after the current role in the ordered set where type = &#63; and subtype = &#63;.
814            *
815            * <p>
816            * 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.
817            * </p>
818            *
819            * @param roleId the primary key of the current role
820            * @param type the type to search with
821            * @param subtype the subtype to search with
822            * @param orderByComparator the comparator to order the set by
823            * @return the previous, current, and next role
824            * @throws com.liferay.portal.NoSuchRoleException if a role with the primary key could not be found
825            * @throws SystemException if a system exception occurred
826            */
827            public com.liferay.portal.model.Role[] filterFindByT_S_PrevAndNext(
828                    long roleId, int type, java.lang.String subtype,
829                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
830                    throws com.liferay.portal.NoSuchRoleException,
831                            com.liferay.portal.kernel.exception.SystemException;
832    
833            /**
834            * Finds the role where companyId = &#63; and classNameId = &#63; and classPK = &#63; or throws a {@link com.liferay.portal.NoSuchRoleException} if it could not be found.
835            *
836            * @param companyId the company ID to search with
837            * @param classNameId the class name ID to search with
838            * @param classPK the class p k to search with
839            * @return the matching role
840            * @throws com.liferay.portal.NoSuchRoleException if a matching role could not be found
841            * @throws SystemException if a system exception occurred
842            */
843            public com.liferay.portal.model.Role findByC_C_C(long companyId,
844                    long classNameId, long classPK)
845                    throws com.liferay.portal.NoSuchRoleException,
846                            com.liferay.portal.kernel.exception.SystemException;
847    
848            /**
849            * Finds the role where companyId = &#63; and classNameId = &#63; and classPK = &#63; or returns <code>null</code> if it could not be found. Uses the finder cache.
850            *
851            * @param companyId the company ID to search with
852            * @param classNameId the class name ID to search with
853            * @param classPK the class p k to search with
854            * @return the matching role, or <code>null</code> if a matching role could not be found
855            * @throws SystemException if a system exception occurred
856            */
857            public com.liferay.portal.model.Role fetchByC_C_C(long companyId,
858                    long classNameId, long classPK)
859                    throws com.liferay.portal.kernel.exception.SystemException;
860    
861            /**
862            * Finds the role where companyId = &#63; and classNameId = &#63; and classPK = &#63; or returns <code>null</code> if it could not be found, optionally using the finder cache.
863            *
864            * @param companyId the company ID to search with
865            * @param classNameId the class name ID to search with
866            * @param classPK the class p k to search with
867            * @return the matching role, or <code>null</code> if a matching role could not be found
868            * @throws SystemException if a system exception occurred
869            */
870            public com.liferay.portal.model.Role fetchByC_C_C(long companyId,
871                    long classNameId, long classPK, boolean retrieveFromCache)
872                    throws com.liferay.portal.kernel.exception.SystemException;
873    
874            /**
875            * Finds all the roles.
876            *
877            * @return the roles
878            * @throws SystemException if a system exception occurred
879            */
880            public java.util.List<com.liferay.portal.model.Role> findAll()
881                    throws com.liferay.portal.kernel.exception.SystemException;
882    
883            /**
884            * Finds a range of all the roles.
885            *
886            * <p>
887            * 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.
888            * </p>
889            *
890            * @param start the lower bound of the range of roles to return
891            * @param end the upper bound of the range of roles to return (not inclusive)
892            * @return the range of roles
893            * @throws SystemException if a system exception occurred
894            */
895            public java.util.List<com.liferay.portal.model.Role> findAll(int start,
896                    int end) throws com.liferay.portal.kernel.exception.SystemException;
897    
898            /**
899            * Finds an ordered range of all the roles.
900            *
901            * <p>
902            * 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.
903            * </p>
904            *
905            * @param start the lower bound of the range of roles to return
906            * @param end the upper bound of the range of roles to return (not inclusive)
907            * @param orderByComparator the comparator to order the results by
908            * @return the ordered range of roles
909            * @throws SystemException if a system exception occurred
910            */
911            public java.util.List<com.liferay.portal.model.Role> findAll(int start,
912                    int end,
913                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
914                    throws com.liferay.portal.kernel.exception.SystemException;
915    
916            /**
917            * Removes all the roles where companyId = &#63; from the database.
918            *
919            * @param companyId the company ID to search with
920            * @throws SystemException if a system exception occurred
921            */
922            public void removeByCompanyId(long companyId)
923                    throws com.liferay.portal.kernel.exception.SystemException;
924    
925            /**
926            * Removes all the roles where name = &#63; from the database.
927            *
928            * @param name the name to search with
929            * @throws SystemException if a system exception occurred
930            */
931            public void removeByName(java.lang.String name)
932                    throws com.liferay.portal.kernel.exception.SystemException;
933    
934            /**
935            * Removes all the roles where subtype = &#63; from the database.
936            *
937            * @param subtype the subtype to search with
938            * @throws SystemException if a system exception occurred
939            */
940            public void removeBySubtype(java.lang.String subtype)
941                    throws com.liferay.portal.kernel.exception.SystemException;
942    
943            /**
944            * Removes the role where companyId = &#63; and name = &#63; from the database.
945            *
946            * @param companyId the company ID to search with
947            * @param name the name to search with
948            * @throws SystemException if a system exception occurred
949            */
950            public void removeByC_N(long companyId, java.lang.String name)
951                    throws com.liferay.portal.NoSuchRoleException,
952                            com.liferay.portal.kernel.exception.SystemException;
953    
954            /**
955            * Removes all the roles where type = &#63; and subtype = &#63; from the database.
956            *
957            * @param type the type to search with
958            * @param subtype the subtype to search with
959            * @throws SystemException if a system exception occurred
960            */
961            public void removeByT_S(int type, java.lang.String subtype)
962                    throws com.liferay.portal.kernel.exception.SystemException;
963    
964            /**
965            * Removes the role where companyId = &#63; and classNameId = &#63; and classPK = &#63; from the database.
966            *
967            * @param companyId the company ID to search with
968            * @param classNameId the class name ID to search with
969            * @param classPK the class p k to search with
970            * @throws SystemException if a system exception occurred
971            */
972            public void removeByC_C_C(long companyId, long classNameId, long classPK)
973                    throws com.liferay.portal.NoSuchRoleException,
974                            com.liferay.portal.kernel.exception.SystemException;
975    
976            /**
977            * Removes all the roles from the database.
978            *
979            * @throws SystemException if a system exception occurred
980            */
981            public void removeAll()
982                    throws com.liferay.portal.kernel.exception.SystemException;
983    
984            /**
985            * Counts all the roles where companyId = &#63;.
986            *
987            * @param companyId the company ID to search with
988            * @return the number of matching roles
989            * @throws SystemException if a system exception occurred
990            */
991            public int countByCompanyId(long companyId)
992                    throws com.liferay.portal.kernel.exception.SystemException;
993    
994            /**
995            * Filters by the user's permissions and counts all the roles where companyId = &#63;.
996            *
997            * @param companyId the company ID to search with
998            * @return the number of matching roles that the user has permission to view
999            * @throws SystemException if a system exception occurred
1000            */
1001            public int filterCountByCompanyId(long companyId)
1002                    throws com.liferay.portal.kernel.exception.SystemException;
1003    
1004            /**
1005            * Counts all the roles where name = &#63;.
1006            *
1007            * @param name the name to search with
1008            * @return the number of matching roles
1009            * @throws SystemException if a system exception occurred
1010            */
1011            public int countByName(java.lang.String name)
1012                    throws com.liferay.portal.kernel.exception.SystemException;
1013    
1014            /**
1015            * Filters by the user's permissions and counts all the roles where name = &#63;.
1016            *
1017            * @param name the name to search with
1018            * @return the number of matching roles that the user has permission to view
1019            * @throws SystemException if a system exception occurred
1020            */
1021            public int filterCountByName(java.lang.String name)
1022                    throws com.liferay.portal.kernel.exception.SystemException;
1023    
1024            /**
1025            * Counts all the roles where subtype = &#63;.
1026            *
1027            * @param subtype the subtype to search with
1028            * @return the number of matching roles
1029            * @throws SystemException if a system exception occurred
1030            */
1031            public int countBySubtype(java.lang.String subtype)
1032                    throws com.liferay.portal.kernel.exception.SystemException;
1033    
1034            /**
1035            * Filters by the user's permissions and counts all the roles where subtype = &#63;.
1036            *
1037            * @param subtype the subtype to search with
1038            * @return the number of matching roles that the user has permission to view
1039            * @throws SystemException if a system exception occurred
1040            */
1041            public int filterCountBySubtype(java.lang.String subtype)
1042                    throws com.liferay.portal.kernel.exception.SystemException;
1043    
1044            /**
1045            * Counts all the roles where companyId = &#63; and name = &#63;.
1046            *
1047            * @param companyId the company ID to search with
1048            * @param name the name to search with
1049            * @return the number of matching roles
1050            * @throws SystemException if a system exception occurred
1051            */
1052            public int countByC_N(long companyId, java.lang.String name)
1053                    throws com.liferay.portal.kernel.exception.SystemException;
1054    
1055            /**
1056            * Counts all the roles where type = &#63; and subtype = &#63;.
1057            *
1058            * @param type the type to search with
1059            * @param subtype the subtype to search with
1060            * @return the number of matching roles
1061            * @throws SystemException if a system exception occurred
1062            */
1063            public int countByT_S(int type, java.lang.String subtype)
1064                    throws com.liferay.portal.kernel.exception.SystemException;
1065    
1066            /**
1067            * Filters by the user's permissions and counts all the roles where type = &#63; and subtype = &#63;.
1068            *
1069            * @param type the type to search with
1070            * @param subtype the subtype to search with
1071            * @return the number of matching roles that the user has permission to view
1072            * @throws SystemException if a system exception occurred
1073            */
1074            public int filterCountByT_S(int type, java.lang.String subtype)
1075                    throws com.liferay.portal.kernel.exception.SystemException;
1076    
1077            /**
1078            * Counts all the roles where companyId = &#63; and classNameId = &#63; and classPK = &#63;.
1079            *
1080            * @param companyId the company ID to search with
1081            * @param classNameId the class name ID to search with
1082            * @param classPK the class p k to search with
1083            * @return the number of matching roles
1084            * @throws SystemException if a system exception occurred
1085            */
1086            public int countByC_C_C(long companyId, long classNameId, long classPK)
1087                    throws com.liferay.portal.kernel.exception.SystemException;
1088    
1089            /**
1090            * Counts all the roles.
1091            *
1092            * @return the number of roles
1093            * @throws SystemException if a system exception occurred
1094            */
1095            public int countAll()
1096                    throws com.liferay.portal.kernel.exception.SystemException;
1097    
1098            /**
1099            * Gets all the groups associated with the role.
1100            *
1101            * @param pk the primary key of the role to get the associated groups for
1102            * @return the groups associated with the role
1103            * @throws SystemException if a system exception occurred
1104            */
1105            public java.util.List<com.liferay.portal.model.Group> getGroups(long pk)
1106                    throws com.liferay.portal.kernel.exception.SystemException;
1107    
1108            /**
1109            * Gets a range of all the groups associated with the role.
1110            *
1111            * <p>
1112            * 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.
1113            * </p>
1114            *
1115            * @param pk the primary key of the role to get the associated groups for
1116            * @param start the lower bound of the range of roles to return
1117            * @param end the upper bound of the range of roles to return (not inclusive)
1118            * @return the range of groups associated with the role
1119            * @throws SystemException if a system exception occurred
1120            */
1121            public java.util.List<com.liferay.portal.model.Group> getGroups(long pk,
1122                    int start, int end)
1123                    throws com.liferay.portal.kernel.exception.SystemException;
1124    
1125            /**
1126            * Gets an ordered range of all the groups associated with the role.
1127            *
1128            * <p>
1129            * 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.
1130            * </p>
1131            *
1132            * @param pk the primary key of the role to get the associated groups for
1133            * @param start the lower bound of the range of roles to return
1134            * @param end the upper bound of the range of roles to return (not inclusive)
1135            * @param orderByComparator the comparator to order the results by
1136            * @return the ordered range of groups associated with the role
1137            * @throws SystemException if a system exception occurred
1138            */
1139            public java.util.List<com.liferay.portal.model.Group> getGroups(long pk,
1140                    int start, int end,
1141                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
1142                    throws com.liferay.portal.kernel.exception.SystemException;
1143    
1144            /**
1145            * Gets the number of groups associated with the role.
1146            *
1147            * @param pk the primary key of the role to get the number of associated groups for
1148            * @return the number of groups associated with the role
1149            * @throws SystemException if a system exception occurred
1150            */
1151            public int getGroupsSize(long pk)
1152                    throws com.liferay.portal.kernel.exception.SystemException;
1153    
1154            /**
1155            * Determines if the group is associated with the role.
1156            *
1157            * @param pk the primary key of the role
1158            * @param groupPK the primary key of the group
1159            * @return <code>true</code> if the group is associated with the role; <code>false</code> otherwise
1160            * @throws SystemException if a system exception occurred
1161            */
1162            public boolean containsGroup(long pk, long groupPK)
1163                    throws com.liferay.portal.kernel.exception.SystemException;
1164    
1165            /**
1166            * Determines if the role has any groups associated with it.
1167            *
1168            * @param pk the primary key of the role to check for associations with groups
1169            * @return <code>true</code> if the role has any groups associated with it; <code>false</code> otherwise
1170            * @throws SystemException if a system exception occurred
1171            */
1172            public boolean containsGroups(long pk)
1173                    throws com.liferay.portal.kernel.exception.SystemException;
1174    
1175            /**
1176            * Adds an association between the role and the group. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1177            *
1178            * @param pk the primary key of the role
1179            * @param groupPK the primary key of the group
1180            * @throws SystemException if a system exception occurred
1181            */
1182            public void addGroup(long pk, long groupPK)
1183                    throws com.liferay.portal.kernel.exception.SystemException;
1184    
1185            /**
1186            * Adds an association between the role and the group. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1187            *
1188            * @param pk the primary key of the role
1189            * @param group the group
1190            * @throws SystemException if a system exception occurred
1191            */
1192            public void addGroup(long pk, com.liferay.portal.model.Group group)
1193                    throws com.liferay.portal.kernel.exception.SystemException;
1194    
1195            /**
1196            * Adds an association between the role and the groups. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1197            *
1198            * @param pk the primary key of the role
1199            * @param groupPKs the primary keys of the groups
1200            * @throws SystemException if a system exception occurred
1201            */
1202            public void addGroups(long pk, long[] groupPKs)
1203                    throws com.liferay.portal.kernel.exception.SystemException;
1204    
1205            /**
1206            * Adds an association between the role and the groups. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1207            *
1208            * @param pk the primary key of the role
1209            * @param groups the groups
1210            * @throws SystemException if a system exception occurred
1211            */
1212            public void addGroups(long pk,
1213                    java.util.List<com.liferay.portal.model.Group> groups)
1214                    throws com.liferay.portal.kernel.exception.SystemException;
1215    
1216            /**
1217            * Clears all associations between the role and its groups. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1218            *
1219            * @param pk the primary key of the role to clear the associated groups from
1220            * @throws SystemException if a system exception occurred
1221            */
1222            public void clearGroups(long pk)
1223                    throws com.liferay.portal.kernel.exception.SystemException;
1224    
1225            /**
1226            * Removes the association between the role and the group. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1227            *
1228            * @param pk the primary key of the role
1229            * @param groupPK the primary key of the group
1230            * @throws SystemException if a system exception occurred
1231            */
1232            public void removeGroup(long pk, long groupPK)
1233                    throws com.liferay.portal.kernel.exception.SystemException;
1234    
1235            /**
1236            * Removes the association between the role and the group. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1237            *
1238            * @param pk the primary key of the role
1239            * @param group the group
1240            * @throws SystemException if a system exception occurred
1241            */
1242            public void removeGroup(long pk, com.liferay.portal.model.Group group)
1243                    throws com.liferay.portal.kernel.exception.SystemException;
1244    
1245            /**
1246            * Removes the association between the role and the groups. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1247            *
1248            * @param pk the primary key of the role
1249            * @param groupPKs the primary keys of the groups
1250            * @throws SystemException if a system exception occurred
1251            */
1252            public void removeGroups(long pk, long[] groupPKs)
1253                    throws com.liferay.portal.kernel.exception.SystemException;
1254    
1255            /**
1256            * Removes the association between the role and the groups. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1257            *
1258            * @param pk the primary key of the role
1259            * @param groups the groups
1260            * @throws SystemException if a system exception occurred
1261            */
1262            public void removeGroups(long pk,
1263                    java.util.List<com.liferay.portal.model.Group> groups)
1264                    throws com.liferay.portal.kernel.exception.SystemException;
1265    
1266            /**
1267            * Sets the groups associated with the role, removing and adding associations as necessary. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1268            *
1269            * @param pk the primary key of the role to set the associations for
1270            * @param groupPKs the primary keys of the groups to be associated with the role
1271            * @throws SystemException if a system exception occurred
1272            */
1273            public void setGroups(long pk, long[] groupPKs)
1274                    throws com.liferay.portal.kernel.exception.SystemException;
1275    
1276            /**
1277            * Sets the groups associated with the role, removing and adding associations as necessary. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1278            *
1279            * @param pk the primary key of the role to set the associations for
1280            * @param groups the groups to be associated with the role
1281            * @throws SystemException if a system exception occurred
1282            */
1283            public void setGroups(long pk,
1284                    java.util.List<com.liferay.portal.model.Group> groups)
1285                    throws com.liferay.portal.kernel.exception.SystemException;
1286    
1287            /**
1288            * Gets all the permissions associated with the role.
1289            *
1290            * @param pk the primary key of the role to get the associated permissions for
1291            * @return the permissions associated with the role
1292            * @throws SystemException if a system exception occurred
1293            */
1294            public java.util.List<com.liferay.portal.model.Permission> getPermissions(
1295                    long pk) throws com.liferay.portal.kernel.exception.SystemException;
1296    
1297            /**
1298            * Gets a range of all the permissions associated with the role.
1299            *
1300            * <p>
1301            * 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.
1302            * </p>
1303            *
1304            * @param pk the primary key of the role to get the associated permissions for
1305            * @param start the lower bound of the range of roles to return
1306            * @param end the upper bound of the range of roles to return (not inclusive)
1307            * @return the range of permissions associated with the role
1308            * @throws SystemException if a system exception occurred
1309            */
1310            public java.util.List<com.liferay.portal.model.Permission> getPermissions(
1311                    long pk, int start, int end)
1312                    throws com.liferay.portal.kernel.exception.SystemException;
1313    
1314            /**
1315            * Gets an ordered range of all the permissions associated with the role.
1316            *
1317            * <p>
1318            * 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.
1319            * </p>
1320            *
1321            * @param pk the primary key of the role to get the associated permissions for
1322            * @param start the lower bound of the range of roles to return
1323            * @param end the upper bound of the range of roles to return (not inclusive)
1324            * @param orderByComparator the comparator to order the results by
1325            * @return the ordered range of permissions associated with the role
1326            * @throws SystemException if a system exception occurred
1327            */
1328            public java.util.List<com.liferay.portal.model.Permission> getPermissions(
1329                    long pk, int start, int end,
1330                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
1331                    throws com.liferay.portal.kernel.exception.SystemException;
1332    
1333            /**
1334            * Gets the number of permissions associated with the role.
1335            *
1336            * @param pk the primary key of the role to get the number of associated permissions for
1337            * @return the number of permissions associated with the role
1338            * @throws SystemException if a system exception occurred
1339            */
1340            public int getPermissionsSize(long pk)
1341                    throws com.liferay.portal.kernel.exception.SystemException;
1342    
1343            /**
1344            * Determines if the permission is associated with the role.
1345            *
1346            * @param pk the primary key of the role
1347            * @param permissionPK the primary key of the permission
1348            * @return <code>true</code> if the permission is associated with the role; <code>false</code> otherwise
1349            * @throws SystemException if a system exception occurred
1350            */
1351            public boolean containsPermission(long pk, long permissionPK)
1352                    throws com.liferay.portal.kernel.exception.SystemException;
1353    
1354            /**
1355            * Determines if the role has any permissions associated with it.
1356            *
1357            * @param pk the primary key of the role to check for associations with permissions
1358            * @return <code>true</code> if the role has any permissions associated with it; <code>false</code> otherwise
1359            * @throws SystemException if a system exception occurred
1360            */
1361            public boolean containsPermissions(long pk)
1362                    throws com.liferay.portal.kernel.exception.SystemException;
1363    
1364            /**
1365            * Adds an association between the role and the permission. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1366            *
1367            * @param pk the primary key of the role
1368            * @param permissionPK the primary key of the permission
1369            * @throws SystemException if a system exception occurred
1370            */
1371            public void addPermission(long pk, long permissionPK)
1372                    throws com.liferay.portal.kernel.exception.SystemException;
1373    
1374            /**
1375            * Adds an association between the role and the permission. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1376            *
1377            * @param pk the primary key of the role
1378            * @param permission the permission
1379            * @throws SystemException if a system exception occurred
1380            */
1381            public void addPermission(long pk,
1382                    com.liferay.portal.model.Permission permission)
1383                    throws com.liferay.portal.kernel.exception.SystemException;
1384    
1385            /**
1386            * Adds an association between the role and the permissions. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1387            *
1388            * @param pk the primary key of the role
1389            * @param permissionPKs the primary keys of the permissions
1390            * @throws SystemException if a system exception occurred
1391            */
1392            public void addPermissions(long pk, long[] permissionPKs)
1393                    throws com.liferay.portal.kernel.exception.SystemException;
1394    
1395            /**
1396            * Adds an association between the role and the permissions. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1397            *
1398            * @param pk the primary key of the role
1399            * @param permissions the permissions
1400            * @throws SystemException if a system exception occurred
1401            */
1402            public void addPermissions(long pk,
1403                    java.util.List<com.liferay.portal.model.Permission> permissions)
1404                    throws com.liferay.portal.kernel.exception.SystemException;
1405    
1406            /**
1407            * Clears all associations between the role and its permissions. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1408            *
1409            * @param pk the primary key of the role to clear the associated permissions from
1410            * @throws SystemException if a system exception occurred
1411            */
1412            public void clearPermissions(long pk)
1413                    throws com.liferay.portal.kernel.exception.SystemException;
1414    
1415            /**
1416            * Removes the association between the role and the permission. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1417            *
1418            * @param pk the primary key of the role
1419            * @param permissionPK the primary key of the permission
1420            * @throws SystemException if a system exception occurred
1421            */
1422            public void removePermission(long pk, long permissionPK)
1423                    throws com.liferay.portal.kernel.exception.SystemException;
1424    
1425            /**
1426            * Removes the association between the role and the permission. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1427            *
1428            * @param pk the primary key of the role
1429            * @param permission the permission
1430            * @throws SystemException if a system exception occurred
1431            */
1432            public void removePermission(long pk,
1433                    com.liferay.portal.model.Permission permission)
1434                    throws com.liferay.portal.kernel.exception.SystemException;
1435    
1436            /**
1437            * Removes the association between the role and the permissions. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1438            *
1439            * @param pk the primary key of the role
1440            * @param permissionPKs the primary keys of the permissions
1441            * @throws SystemException if a system exception occurred
1442            */
1443            public void removePermissions(long pk, long[] permissionPKs)
1444                    throws com.liferay.portal.kernel.exception.SystemException;
1445    
1446            /**
1447            * Removes the association between the role and the permissions. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1448            *
1449            * @param pk the primary key of the role
1450            * @param permissions the permissions
1451            * @throws SystemException if a system exception occurred
1452            */
1453            public void removePermissions(long pk,
1454                    java.util.List<com.liferay.portal.model.Permission> permissions)
1455                    throws com.liferay.portal.kernel.exception.SystemException;
1456    
1457            /**
1458            * Sets the permissions associated with the role, removing and adding associations as necessary. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1459            *
1460            * @param pk the primary key of the role to set the associations for
1461            * @param permissionPKs the primary keys of the permissions to be associated with the role
1462            * @throws SystemException if a system exception occurred
1463            */
1464            public void setPermissions(long pk, long[] permissionPKs)
1465                    throws com.liferay.portal.kernel.exception.SystemException;
1466    
1467            /**
1468            * Sets the permissions associated with the role, removing and adding associations as necessary. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1469            *
1470            * @param pk the primary key of the role to set the associations for
1471            * @param permissions the permissions to be associated with the role
1472            * @throws SystemException if a system exception occurred
1473            */
1474            public void setPermissions(long pk,
1475                    java.util.List<com.liferay.portal.model.Permission> permissions)
1476                    throws com.liferay.portal.kernel.exception.SystemException;
1477    
1478            /**
1479            * Gets all the users associated with the role.
1480            *
1481            * @param pk the primary key of the role to get the associated users for
1482            * @return the users associated with the role
1483            * @throws SystemException if a system exception occurred
1484            */
1485            public java.util.List<com.liferay.portal.model.User> getUsers(long pk)
1486                    throws com.liferay.portal.kernel.exception.SystemException;
1487    
1488            /**
1489            * Gets a range of all the users associated with the role.
1490            *
1491            * <p>
1492            * 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.
1493            * </p>
1494            *
1495            * @param pk the primary key of the role to get the associated users for
1496            * @param start the lower bound of the range of roles to return
1497            * @param end the upper bound of the range of roles to return (not inclusive)
1498            * @return the range of users associated with the role
1499            * @throws SystemException if a system exception occurred
1500            */
1501            public java.util.List<com.liferay.portal.model.User> getUsers(long pk,
1502                    int start, int end)
1503                    throws com.liferay.portal.kernel.exception.SystemException;
1504    
1505            /**
1506            * Gets an ordered range of all the users associated with the role.
1507            *
1508            * <p>
1509            * 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.
1510            * </p>
1511            *
1512            * @param pk the primary key of the role to get the associated users for
1513            * @param start the lower bound of the range of roles to return
1514            * @param end the upper bound of the range of roles to return (not inclusive)
1515            * @param orderByComparator the comparator to order the results by
1516            * @return the ordered range of users associated with the role
1517            * @throws SystemException if a system exception occurred
1518            */
1519            public java.util.List<com.liferay.portal.model.User> getUsers(long pk,
1520                    int start, int end,
1521                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
1522                    throws com.liferay.portal.kernel.exception.SystemException;
1523    
1524            /**
1525            * Gets the number of users associated with the role.
1526            *
1527            * @param pk the primary key of the role to get the number of associated users for
1528            * @return the number of users associated with the role
1529            * @throws SystemException if a system exception occurred
1530            */
1531            public int getUsersSize(long pk)
1532                    throws com.liferay.portal.kernel.exception.SystemException;
1533    
1534            /**
1535            * Determines if the user is associated with the role.
1536            *
1537            * @param pk the primary key of the role
1538            * @param userPK the primary key of the user
1539            * @return <code>true</code> if the user is associated with the role; <code>false</code> otherwise
1540            * @throws SystemException if a system exception occurred
1541            */
1542            public boolean containsUser(long pk, long userPK)
1543                    throws com.liferay.portal.kernel.exception.SystemException;
1544    
1545            /**
1546            * Determines if the role has any users associated with it.
1547            *
1548            * @param pk the primary key of the role to check for associations with users
1549            * @return <code>true</code> if the role has any users associated with it; <code>false</code> otherwise
1550            * @throws SystemException if a system exception occurred
1551            */
1552            public boolean containsUsers(long pk)
1553                    throws com.liferay.portal.kernel.exception.SystemException;
1554    
1555            /**
1556            * Adds an association between the role and the user. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1557            *
1558            * @param pk the primary key of the role
1559            * @param userPK the primary key of the user
1560            * @throws SystemException if a system exception occurred
1561            */
1562            public void addUser(long pk, long userPK)
1563                    throws com.liferay.portal.kernel.exception.SystemException;
1564    
1565            /**
1566            * Adds an association between the role and the user. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1567            *
1568            * @param pk the primary key of the role
1569            * @param user the user
1570            * @throws SystemException if a system exception occurred
1571            */
1572            public void addUser(long pk, com.liferay.portal.model.User user)
1573                    throws com.liferay.portal.kernel.exception.SystemException;
1574    
1575            /**
1576            * Adds an association between the role and the users. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1577            *
1578            * @param pk the primary key of the role
1579            * @param userPKs the primary keys of the users
1580            * @throws SystemException if a system exception occurred
1581            */
1582            public void addUsers(long pk, long[] userPKs)
1583                    throws com.liferay.portal.kernel.exception.SystemException;
1584    
1585            /**
1586            * Adds an association between the role and the users. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1587            *
1588            * @param pk the primary key of the role
1589            * @param users the users
1590            * @throws SystemException if a system exception occurred
1591            */
1592            public void addUsers(long pk,
1593                    java.util.List<com.liferay.portal.model.User> users)
1594                    throws com.liferay.portal.kernel.exception.SystemException;
1595    
1596            /**
1597            * Clears all associations between the role and its users. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1598            *
1599            * @param pk the primary key of the role to clear the associated users from
1600            * @throws SystemException if a system exception occurred
1601            */
1602            public void clearUsers(long pk)
1603                    throws com.liferay.portal.kernel.exception.SystemException;
1604    
1605            /**
1606            * Removes the association between the role and the user. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1607            *
1608            * @param pk the primary key of the role
1609            * @param userPK the primary key of the user
1610            * @throws SystemException if a system exception occurred
1611            */
1612            public void removeUser(long pk, long userPK)
1613                    throws com.liferay.portal.kernel.exception.SystemException;
1614    
1615            /**
1616            * Removes the association between the role and the user. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1617            *
1618            * @param pk the primary key of the role
1619            * @param user the user
1620            * @throws SystemException if a system exception occurred
1621            */
1622            public void removeUser(long pk, com.liferay.portal.model.User user)
1623                    throws com.liferay.portal.kernel.exception.SystemException;
1624    
1625            /**
1626            * Removes the association between the role and the users. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1627            *
1628            * @param pk the primary key of the role
1629            * @param userPKs the primary keys of the users
1630            * @throws SystemException if a system exception occurred
1631            */
1632            public void removeUsers(long pk, long[] userPKs)
1633                    throws com.liferay.portal.kernel.exception.SystemException;
1634    
1635            /**
1636            * Removes the association between the role and the users. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1637            *
1638            * @param pk the primary key of the role
1639            * @param users the users
1640            * @throws SystemException if a system exception occurred
1641            */
1642            public void removeUsers(long pk,
1643                    java.util.List<com.liferay.portal.model.User> users)
1644                    throws com.liferay.portal.kernel.exception.SystemException;
1645    
1646            /**
1647            * Sets the users associated with the role, removing and adding associations as necessary. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1648            *
1649            * @param pk the primary key of the role to set the associations for
1650            * @param userPKs the primary keys of the users to be associated with the role
1651            * @throws SystemException if a system exception occurred
1652            */
1653            public void setUsers(long pk, long[] userPKs)
1654                    throws com.liferay.portal.kernel.exception.SystemException;
1655    
1656            /**
1657            * Sets the users associated with the role, removing and adding associations as necessary. Also notifies the appropriate model listeners and clears the mapping table finder cache.
1658            *
1659            * @param pk the primary key of the role to set the associations for
1660            * @param users the users to be associated with the role
1661            * @throws SystemException if a system exception occurred
1662            */
1663            public void setUsers(long pk,
1664                    java.util.List<com.liferay.portal.model.User> users)
1665                    throws com.liferay.portal.kernel.exception.SystemException;
1666    
1667            public Role remove(Role role) throws SystemException;
1668    }