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