001    /**
002     * Copyright (c) 2000-2013 Liferay, Inc. All rights reserved.
003     *
004     * This library is free software; you can redistribute it and/or modify it under
005     * the terms of the GNU Lesser General Public License as published by the Free
006     * Software Foundation; either version 2.1 of the License, or (at your option)
007     * any later version.
008     *
009     * This library is distributed in the hope that it will be useful, but WITHOUT
010     * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
011     * FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
012     * details.
013     */
014    
015    package com.liferay.portal.service;
016    
017    import com.liferay.portal.kernel.bean.PortalBeanLocatorUtil;
018    import com.liferay.portal.kernel.util.ReferenceRegistry;
019    
020    /**
021     * The utility for the portlet local service. This utility wraps {@link com.liferay.portal.service.impl.PortletLocalServiceImpl} and is the primary access point for service operations in application layer code running on the local server.
022     *
023     * <p>
024     * This is a local service. Methods of this service will not have security checks based on the propagated JAAS credentials because this service can only be accessed from within the same VM.
025     * </p>
026     *
027     * @author Brian Wing Shun Chan
028     * @see PortletLocalService
029     * @see com.liferay.portal.service.base.PortletLocalServiceBaseImpl
030     * @see com.liferay.portal.service.impl.PortletLocalServiceImpl
031     * @generated
032     */
033    public class PortletLocalServiceUtil {
034            /*
035             * NOTE FOR DEVELOPERS:
036             *
037             * Never modify this class directly. Add custom service methods to {@link com.liferay.portal.service.impl.PortletLocalServiceImpl} and rerun ServiceBuilder to regenerate this class.
038             */
039    
040            /**
041            * Adds the portlet to the database. Also notifies the appropriate model listeners.
042            *
043            * @param portlet the portlet
044            * @return the portlet that was added
045            * @throws SystemException if a system exception occurred
046            */
047            public static com.liferay.portal.model.Portlet addPortlet(
048                    com.liferay.portal.model.Portlet portlet)
049                    throws com.liferay.portal.kernel.exception.SystemException {
050                    return getService().addPortlet(portlet);
051            }
052    
053            /**
054            * Creates a new portlet with the primary key. Does not add the portlet to the database.
055            *
056            * @param id the primary key for the new portlet
057            * @return the new portlet
058            */
059            public static com.liferay.portal.model.Portlet createPortlet(long id) {
060                    return getService().createPortlet(id);
061            }
062    
063            /**
064            * Deletes the portlet with the primary key from the database. Also notifies the appropriate model listeners.
065            *
066            * @param id the primary key of the portlet
067            * @return the portlet that was removed
068            * @throws PortalException if a portlet with the primary key could not be found
069            * @throws SystemException if a system exception occurred
070            */
071            public static com.liferay.portal.model.Portlet deletePortlet(long id)
072                    throws com.liferay.portal.kernel.exception.PortalException,
073                            com.liferay.portal.kernel.exception.SystemException {
074                    return getService().deletePortlet(id);
075            }
076    
077            /**
078            * Deletes the portlet from the database. Also notifies the appropriate model listeners.
079            *
080            * @param portlet the portlet
081            * @return the portlet that was removed
082            * @throws SystemException if a system exception occurred
083            */
084            public static com.liferay.portal.model.Portlet deletePortlet(
085                    com.liferay.portal.model.Portlet portlet)
086                    throws com.liferay.portal.kernel.exception.SystemException {
087                    return getService().deletePortlet(portlet);
088            }
089    
090            public static com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery() {
091                    return getService().dynamicQuery();
092            }
093    
094            /**
095            * Performs a dynamic query on the database and returns the matching rows.
096            *
097            * @param dynamicQuery the dynamic query
098            * @return the matching rows
099            * @throws SystemException if a system exception occurred
100            */
101            @SuppressWarnings("rawtypes")
102            public static java.util.List dynamicQuery(
103                    com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery)
104                    throws com.liferay.portal.kernel.exception.SystemException {
105                    return getService().dynamicQuery(dynamicQuery);
106            }
107    
108            /**
109            * Performs a dynamic query on the database and returns a range of the matching rows.
110            *
111            * <p>
112            * 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.
113            * </p>
114            *
115            * @param dynamicQuery the dynamic query
116            * @param start the lower bound of the range of model instances
117            * @param end the upper bound of the range of model instances (not inclusive)
118            * @return the range of matching rows
119            * @throws SystemException if a system exception occurred
120            */
121            @SuppressWarnings("rawtypes")
122            public static java.util.List dynamicQuery(
123                    com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery, int start,
124                    int end) throws com.liferay.portal.kernel.exception.SystemException {
125                    return getService().dynamicQuery(dynamicQuery, start, end);
126            }
127    
128            /**
129            * Performs a dynamic query on the database and returns an ordered range of the matching rows.
130            *
131            * <p>
132            * 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.
133            * </p>
134            *
135            * @param dynamicQuery the dynamic query
136            * @param start the lower bound of the range of model instances
137            * @param end the upper bound of the range of model instances (not inclusive)
138            * @param orderByComparator the comparator to order the results by (optionally <code>null</code>)
139            * @return the ordered range of matching rows
140            * @throws SystemException if a system exception occurred
141            */
142            @SuppressWarnings("rawtypes")
143            public static java.util.List dynamicQuery(
144                    com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery, int start,
145                    int end,
146                    com.liferay.portal.kernel.util.OrderByComparator orderByComparator)
147                    throws com.liferay.portal.kernel.exception.SystemException {
148                    return getService()
149                                       .dynamicQuery(dynamicQuery, start, end, orderByComparator);
150            }
151    
152            /**
153            * Returns the number of rows that match the dynamic query.
154            *
155            * @param dynamicQuery the dynamic query
156            * @return the number of rows that match the dynamic query
157            * @throws SystemException if a system exception occurred
158            */
159            public static long dynamicQueryCount(
160                    com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery)
161                    throws com.liferay.portal.kernel.exception.SystemException {
162                    return getService().dynamicQueryCount(dynamicQuery);
163            }
164    
165            public static com.liferay.portal.model.Portlet fetchPortlet(long id)
166                    throws com.liferay.portal.kernel.exception.SystemException {
167                    return getService().fetchPortlet(id);
168            }
169    
170            /**
171            * Returns the portlet with the primary key.
172            *
173            * @param id the primary key of the portlet
174            * @return the portlet
175            * @throws PortalException if a portlet with the primary key could not be found
176            * @throws SystemException if a system exception occurred
177            */
178            public static com.liferay.portal.model.Portlet getPortlet(long id)
179                    throws com.liferay.portal.kernel.exception.PortalException,
180                            com.liferay.portal.kernel.exception.SystemException {
181                    return getService().getPortlet(id);
182            }
183    
184            public static com.liferay.portal.model.PersistedModel getPersistedModel(
185                    java.io.Serializable primaryKeyObj)
186                    throws com.liferay.portal.kernel.exception.PortalException,
187                            com.liferay.portal.kernel.exception.SystemException {
188                    return getService().getPersistedModel(primaryKeyObj);
189            }
190    
191            /**
192            * Returns a range of all the portlets.
193            *
194            * <p>
195            * 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.
196            * </p>
197            *
198            * @param start the lower bound of the range of portlets
199            * @param end the upper bound of the range of portlets (not inclusive)
200            * @return the range of portlets
201            * @throws SystemException if a system exception occurred
202            */
203            public static java.util.List<com.liferay.portal.model.Portlet> getPortlets(
204                    int start, int end)
205                    throws com.liferay.portal.kernel.exception.SystemException {
206                    return getService().getPortlets(start, end);
207            }
208    
209            /**
210            * Returns the number of portlets.
211            *
212            * @return the number of portlets
213            * @throws SystemException if a system exception occurred
214            */
215            public static int getPortletsCount()
216                    throws com.liferay.portal.kernel.exception.SystemException {
217                    return getService().getPortletsCount();
218            }
219    
220            /**
221            * Updates the portlet in the database or adds it if it does not yet exist. Also notifies the appropriate model listeners.
222            *
223            * @param portlet the portlet
224            * @return the portlet that was updated
225            * @throws SystemException if a system exception occurred
226            */
227            public static com.liferay.portal.model.Portlet updatePortlet(
228                    com.liferay.portal.model.Portlet portlet)
229                    throws com.liferay.portal.kernel.exception.SystemException {
230                    return getService().updatePortlet(portlet);
231            }
232    
233            /**
234            * Updates the portlet in the database or adds it if it does not yet exist. Also notifies the appropriate model listeners.
235            *
236            * @param portlet the portlet
237            * @param merge whether to merge the portlet with the current session. See {@link com.liferay.portal.service.persistence.BatchSession#update(com.liferay.portal.kernel.dao.orm.Session, com.liferay.portal.model.BaseModel, boolean)} for an explanation.
238            * @return the portlet that was updated
239            * @throws SystemException if a system exception occurred
240            */
241            public static com.liferay.portal.model.Portlet updatePortlet(
242                    com.liferay.portal.model.Portlet portlet, boolean merge)
243                    throws com.liferay.portal.kernel.exception.SystemException {
244                    return getService().updatePortlet(portlet, merge);
245            }
246    
247            /**
248            * Returns the Spring bean ID for this bean.
249            *
250            * @return the Spring bean ID for this bean
251            */
252            public static java.lang.String getBeanIdentifier() {
253                    return getService().getBeanIdentifier();
254            }
255    
256            /**
257            * Sets the Spring bean ID for this bean.
258            *
259            * @param beanIdentifier the Spring bean ID for this bean
260            */
261            public static void setBeanIdentifier(java.lang.String beanIdentifier) {
262                    getService().setBeanIdentifier(beanIdentifier);
263            }
264    
265            public static void addPortletCategory(long companyId,
266                    java.lang.String categoryName) {
267                    getService().addPortletCategory(companyId, categoryName);
268            }
269    
270            public static void checkPortlet(com.liferay.portal.model.Portlet portlet)
271                    throws com.liferay.portal.kernel.exception.PortalException,
272                            com.liferay.portal.kernel.exception.SystemException {
273                    getService().checkPortlet(portlet);
274            }
275    
276            public static void checkPortlets(long companyId)
277                    throws com.liferay.portal.kernel.exception.PortalException,
278                            com.liferay.portal.kernel.exception.SystemException {
279                    getService().checkPortlets(companyId);
280            }
281    
282            public static void clearCache() {
283                    getService().clearCache();
284            }
285    
286            public static void clearCompanyPortletsPool() {
287                    getService().clearCompanyPortletsPool();
288            }
289    
290            /**
291            * @deprecated {@link #clonePortlet(String)}
292            */
293            public static com.liferay.portal.model.Portlet clonePortlet(
294                    long companyId, java.lang.String portletId) {
295                    return getService().clonePortlet(companyId, portletId);
296            }
297    
298            public static com.liferay.portal.model.Portlet clonePortlet(
299                    java.lang.String portletId) {
300                    return getService().clonePortlet(portletId);
301            }
302    
303            public static void deletePortlet(long companyId,
304                    java.lang.String portletId, long plid)
305                    throws com.liferay.portal.kernel.exception.PortalException,
306                            com.liferay.portal.kernel.exception.SystemException {
307                    getService().deletePortlet(companyId, portletId, plid);
308            }
309    
310            public static void deletePortlets(long companyId,
311                    java.lang.String[] portletIds, long plid)
312                    throws com.liferay.portal.kernel.exception.PortalException,
313                            com.liferay.portal.kernel.exception.SystemException {
314                    getService().deletePortlets(companyId, portletIds, plid);
315            }
316    
317            public static com.liferay.portal.model.Portlet deployRemotePortlet(
318                    com.liferay.portal.model.Portlet portlet, java.lang.String categoryName)
319                    throws com.liferay.portal.kernel.exception.PortalException,
320                            com.liferay.portal.kernel.exception.SystemException {
321                    return getService().deployRemotePortlet(portlet, categoryName);
322            }
323    
324            public static com.liferay.portal.model.Portlet deployRemotePortlet(
325                    com.liferay.portal.model.Portlet portlet,
326                    java.lang.String[] categoryNames)
327                    throws com.liferay.portal.kernel.exception.PortalException,
328                            com.liferay.portal.kernel.exception.SystemException {
329                    return getService().deployRemotePortlet(portlet, categoryNames);
330            }
331    
332            public static void destroyPortlet(com.liferay.portal.model.Portlet portlet) {
333                    getService().destroyPortlet(portlet);
334            }
335    
336            public static void destroyRemotePortlet(
337                    com.liferay.portal.model.Portlet portlet) {
338                    getService().destroyRemotePortlet(portlet);
339            }
340    
341            public static java.util.List<com.liferay.portlet.expando.model.CustomAttributesDisplay> getCustomAttributesDisplays() {
342                    return getService().getCustomAttributesDisplays();
343            }
344    
345            public static com.liferay.portal.model.PortletCategory getEARDisplay(
346                    java.lang.String xml)
347                    throws com.liferay.portal.kernel.exception.SystemException {
348                    return getService().getEARDisplay(xml);
349            }
350    
351            public static java.util.List<com.liferay.portal.model.Portlet> getFriendlyURLMapperPortlets() {
352                    return getService().getFriendlyURLMapperPortlets();
353            }
354    
355            public static java.util.List<com.liferay.portal.kernel.portlet.FriendlyURLMapper> getFriendlyURLMappers() {
356                    return getService().getFriendlyURLMappers();
357            }
358    
359            public static com.liferay.portal.model.PortletApp getPortletApp(
360                    java.lang.String servletContextName) {
361                    return getService().getPortletApp(servletContextName);
362            }
363    
364            public static com.liferay.portal.model.Portlet getPortletById(
365                    long companyId, java.lang.String portletId)
366                    throws com.liferay.portal.kernel.exception.SystemException {
367                    return getService().getPortletById(companyId, portletId);
368            }
369    
370            public static com.liferay.portal.model.Portlet getPortletById(
371                    java.lang.String portletId) {
372                    return getService().getPortletById(portletId);
373            }
374    
375            public static com.liferay.portal.model.Portlet getPortletByStrutsPath(
376                    long companyId, java.lang.String strutsPath)
377                    throws com.liferay.portal.kernel.exception.SystemException {
378                    return getService().getPortletByStrutsPath(companyId, strutsPath);
379            }
380    
381            public static java.util.List<com.liferay.portal.model.Portlet> getPortlets() {
382                    return getService().getPortlets();
383            }
384    
385            public static java.util.List<com.liferay.portal.model.Portlet> getPortlets(
386                    long companyId)
387                    throws com.liferay.portal.kernel.exception.SystemException {
388                    return getService().getPortlets(companyId);
389            }
390    
391            public static java.util.List<com.liferay.portal.model.Portlet> getPortlets(
392                    long companyId, boolean showSystem, boolean showPortal)
393                    throws com.liferay.portal.kernel.exception.SystemException {
394                    return getService().getPortlets(companyId, showSystem, showPortal);
395            }
396    
397            public static java.util.List<com.liferay.portal.model.Portlet> getScopablePortlets() {
398                    return getService().getScopablePortlets();
399            }
400    
401            public static com.liferay.portal.model.PortletCategory getWARDisplay(
402                    java.lang.String servletContextName, java.lang.String xml)
403                    throws com.liferay.portal.kernel.exception.SystemException {
404                    return getService().getWARDisplay(servletContextName, xml);
405            }
406    
407            public static boolean hasPortlet(long companyId, java.lang.String portletId)
408                    throws com.liferay.portal.kernel.exception.SystemException {
409                    return getService().hasPortlet(companyId, portletId);
410            }
411    
412            public static void initEAR(javax.servlet.ServletContext servletContext,
413                    java.lang.String[] xmls,
414                    com.liferay.portal.kernel.plugin.PluginPackage pluginPackage) {
415                    getService().initEAR(servletContext, xmls, pluginPackage);
416            }
417    
418            public static java.util.List<com.liferay.portal.model.Portlet> initWAR(
419                    java.lang.String servletContextName,
420                    javax.servlet.ServletContext servletContext, java.lang.String[] xmls,
421                    com.liferay.portal.kernel.plugin.PluginPackage pluginPackage) {
422                    return getService()
423                                       .initWAR(servletContextName, servletContext, xmls,
424                            pluginPackage);
425            }
426    
427            public static java.util.Map<java.lang.String, com.liferay.portal.model.Portlet> loadGetPortletsPool(
428                    long companyId)
429                    throws com.liferay.portal.kernel.exception.SystemException {
430                    return getService().loadGetPortletsPool(companyId);
431            }
432    
433            public static void removeCompanyPortletsPool(long companyId) {
434                    getService().removeCompanyPortletsPool(companyId);
435            }
436    
437            public static com.liferay.portal.model.Portlet updatePortlet(
438                    long companyId, java.lang.String portletId, java.lang.String roles,
439                    boolean active)
440                    throws com.liferay.portal.kernel.exception.SystemException {
441                    return getService().updatePortlet(companyId, portletId, roles, active);
442            }
443    
444            public static PortletLocalService getService() {
445                    if (_service == null) {
446                            _service = (PortletLocalService)PortalBeanLocatorUtil.locate(PortletLocalService.class.getName());
447    
448                            ReferenceRegistry.registerReference(PortletLocalServiceUtil.class,
449                                    "_service");
450                    }
451    
452                    return _service;
453            }
454    
455            /**
456             * @deprecated
457             */
458            public void setService(PortletLocalService service) {
459            }
460    
461            private static PortletLocalService _service;
462    }