001    /**
002     * Copyright (c) 2000-present 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 aQute.bnd.annotation.ProviderType;
018    
019    import com.liferay.portal.model.Release;
020    
021    /**
022     * The persistence interface for the release service.
023     *
024     * <p>
025     * Caching information and settings can be found in <code>portal.properties</code>
026     * </p>
027     *
028     * @author Brian Wing Shun Chan
029     * @see com.liferay.portal.service.persistence.impl.ReleasePersistenceImpl
030     * @see ReleaseUtil
031     * @generated
032     */
033    @ProviderType
034    public interface ReleasePersistence extends BasePersistence<Release> {
035            /*
036             * NOTE FOR DEVELOPERS:
037             *
038             * Never modify or reference this interface directly. Always use {@link ReleaseUtil} to access the release persistence. Modify <code>service.xml</code> and rerun ServiceBuilder to regenerate this interface.
039             */
040    
041            /**
042            * Returns the release where servletContextName = &#63; or throws a {@link NoSuchReleaseException} if it could not be found.
043            *
044            * @param servletContextName the servlet context name
045            * @return the matching release
046            * @throws NoSuchReleaseException if a matching release could not be found
047            */
048            public Release findByServletContextName(java.lang.String servletContextName)
049                    throws com.liferay.portal.exception.NoSuchReleaseException;
050    
051            /**
052            * Returns the release where servletContextName = &#63; or returns <code>null</code> if it could not be found. Uses the finder cache.
053            *
054            * @param servletContextName the servlet context name
055            * @return the matching release, or <code>null</code> if a matching release could not be found
056            */
057            public Release fetchByServletContextName(
058                    java.lang.String servletContextName);
059    
060            /**
061            * Returns the release where servletContextName = &#63; or returns <code>null</code> if it could not be found, optionally using the finder cache.
062            *
063            * @param servletContextName the servlet context name
064            * @param retrieveFromCache whether to retrieve from the finder cache
065            * @return the matching release, or <code>null</code> if a matching release could not be found
066            */
067            public Release fetchByServletContextName(
068                    java.lang.String servletContextName, boolean retrieveFromCache);
069    
070            /**
071            * Removes the release where servletContextName = &#63; from the database.
072            *
073            * @param servletContextName the servlet context name
074            * @return the release that was removed
075            */
076            public Release removeByServletContextName(
077                    java.lang.String servletContextName)
078                    throws com.liferay.portal.exception.NoSuchReleaseException;
079    
080            /**
081            * Returns the number of releases where servletContextName = &#63;.
082            *
083            * @param servletContextName the servlet context name
084            * @return the number of matching releases
085            */
086            public int countByServletContextName(java.lang.String servletContextName);
087    
088            /**
089            * Caches the release in the entity cache if it is enabled.
090            *
091            * @param release the release
092            */
093            public void cacheResult(Release release);
094    
095            /**
096            * Caches the releases in the entity cache if it is enabled.
097            *
098            * @param releases the releases
099            */
100            public void cacheResult(java.util.List<Release> releases);
101    
102            /**
103            * Creates a new release with the primary key. Does not add the release to the database.
104            *
105            * @param releaseId the primary key for the new release
106            * @return the new release
107            */
108            public Release create(long releaseId);
109    
110            /**
111            * Removes the release with the primary key from the database. Also notifies the appropriate model listeners.
112            *
113            * @param releaseId the primary key of the release
114            * @return the release that was removed
115            * @throws NoSuchReleaseException if a release with the primary key could not be found
116            */
117            public Release remove(long releaseId)
118                    throws com.liferay.portal.exception.NoSuchReleaseException;
119    
120            public Release updateImpl(Release release);
121    
122            /**
123            * Returns the release with the primary key or throws a {@link NoSuchReleaseException} if it could not be found.
124            *
125            * @param releaseId the primary key of the release
126            * @return the release
127            * @throws NoSuchReleaseException if a release with the primary key could not be found
128            */
129            public Release findByPrimaryKey(long releaseId)
130                    throws com.liferay.portal.exception.NoSuchReleaseException;
131    
132            /**
133            * Returns the release with the primary key or returns <code>null</code> if it could not be found.
134            *
135            * @param releaseId the primary key of the release
136            * @return the release, or <code>null</code> if a release with the primary key could not be found
137            */
138            public Release fetchByPrimaryKey(long releaseId);
139    
140            @Override
141            public java.util.Map<java.io.Serializable, Release> fetchByPrimaryKeys(
142                    java.util.Set<java.io.Serializable> primaryKeys);
143    
144            /**
145            * Returns all the releases.
146            *
147            * @return the releases
148            */
149            public java.util.List<Release> findAll();
150    
151            /**
152            * Returns a range of all the releases.
153            *
154            * <p>
155            * 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 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 QueryUtil#ALL_POS}), then the query will include the default ORDER BY logic from {@link ReleaseModelImpl}. 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.
156            * </p>
157            *
158            * @param start the lower bound of the range of releases
159            * @param end the upper bound of the range of releases (not inclusive)
160            * @return the range of releases
161            */
162            public java.util.List<Release> findAll(int start, int end);
163    
164            /**
165            * Returns an ordered range of all the releases.
166            *
167            * <p>
168            * Useful when paginating results. Returns a maximum of <code>end - start</code> instances. <code>start</code> and <code>end</code> are not primary keys, they are indexes in the result set. Thus, <code>0</code> refers to the first result in the set. Setting both <code>start</code> and <code>end</code> to {@link 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 QueryUtil#ALL_POS}), then the query will include the default ORDER BY logic from {@link ReleaseModelImpl}. 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.
169            * </p>
170            *
171            * @param start the lower bound of the range of releases
172            * @param end the upper bound of the range of releases (not inclusive)
173            * @param orderByComparator the comparator to order the results by (optionally <code>null</code>)
174            * @return the ordered range of releases
175            */
176            public java.util.List<Release> findAll(int start, int end,
177                    com.liferay.portal.kernel.util.OrderByComparator<Release> orderByComparator);
178    
179            /**
180            * Returns an ordered range of all the releases.
181            *
182            * <p>
183            * 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 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 QueryUtil#ALL_POS}), then the query will include the default ORDER BY logic from {@link ReleaseModelImpl}. 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.
184            * </p>
185            *
186            * @param start the lower bound of the range of releases
187            * @param end the upper bound of the range of releases (not inclusive)
188            * @param orderByComparator the comparator to order the results by (optionally <code>null</code>)
189            * @param retrieveFromCache whether to retrieve from the finder cache
190            * @return the ordered range of releases
191            */
192            public java.util.List<Release> findAll(int start, int end,
193                    com.liferay.portal.kernel.util.OrderByComparator<Release> orderByComparator,
194                    boolean retrieveFromCache);
195    
196            /**
197            * Removes all the releases from the database.
198            */
199            public void removeAll();
200    
201            /**
202            * Returns the number of releases.
203            *
204            * @return the number of releases
205            */
206            public int countAll();
207    
208            @Override
209            public java.util.Set<java.lang.String> getBadColumnNames();
210    }