1   /**
2    * Copyright (c) 2000-2008 Liferay, Inc. All rights reserved.
3    *
4    * Permission is hereby granted, free of charge, to any person obtaining a copy
5    * of this software and associated documentation files (the "Software"), to deal
6    * in the Software without restriction, including without limitation the rights
7    * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
8    * copies of the Software, and to permit persons to whom the Software is
9    * furnished to do so, subject to the following conditions:
10   *
11   * The above copyright notice and this permission notice shall be included in
12   * all copies or substantial portions of the Software.
13   *
14   * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15   * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16   * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
17   * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18   * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
19   * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
20   * SOFTWARE.
21   */
22  
23  package com.liferay.portal.service.persistence;
24  
25  /**
26   * <a href="ContactPersistence.java.html"><b><i>View Source</i></b></a>
27   *
28   * @author Brian Wing Shun Chan
29   *
30   */
31  public interface ContactPersistence {
32      public com.liferay.portal.model.Contact create(long contactId);
33  
34      public com.liferay.portal.model.Contact remove(long contactId)
35          throws com.liferay.portal.NoSuchContactException,
36              com.liferay.portal.SystemException;
37  
38      public com.liferay.portal.model.Contact remove(
39          com.liferay.portal.model.Contact contact)
40          throws com.liferay.portal.SystemException;
41  
42      /**
43       * @deprecated Use <code>update(Contact contact, boolean merge)</code>.
44       */
45      public com.liferay.portal.model.Contact update(
46          com.liferay.portal.model.Contact contact)
47          throws com.liferay.portal.SystemException;
48  
49      /**
50       * Add, update, or merge, the entity. This method also calls the model
51       * listeners to trigger the proper events associated with adding, deleting,
52       * or updating an entity.
53       *
54       * @param        contact the entity to add, update, or merge
55       * @param        merge boolean value for whether to merge the entity. The
56       *                default value is false. Setting merge to true is more
57       *                expensive and should only be true when contact is
58       *                transient. See LEP-5473 for a detailed discussion of this
59       *                method.
60       * @return        true if the portlet can be displayed via Ajax
61       */
62      public com.liferay.portal.model.Contact update(
63          com.liferay.portal.model.Contact contact, boolean merge)
64          throws com.liferay.portal.SystemException;
65  
66      public com.liferay.portal.model.Contact updateImpl(
67          com.liferay.portal.model.Contact contact, boolean merge)
68          throws com.liferay.portal.SystemException;
69  
70      public com.liferay.portal.model.Contact findByPrimaryKey(long contactId)
71          throws com.liferay.portal.NoSuchContactException,
72              com.liferay.portal.SystemException;
73  
74      public com.liferay.portal.model.Contact fetchByPrimaryKey(long contactId)
75          throws com.liferay.portal.SystemException;
76  
77      public java.util.List<com.liferay.portal.model.Contact> findByCompanyId(
78          long companyId) throws com.liferay.portal.SystemException;
79  
80      public java.util.List<com.liferay.portal.model.Contact> findByCompanyId(
81          long companyId, int start, int end)
82          throws com.liferay.portal.SystemException;
83  
84      public java.util.List<com.liferay.portal.model.Contact> findByCompanyId(
85          long companyId, int start, int end,
86          com.liferay.portal.kernel.util.OrderByComparator obc)
87          throws com.liferay.portal.SystemException;
88  
89      public com.liferay.portal.model.Contact findByCompanyId_First(
90          long companyId, com.liferay.portal.kernel.util.OrderByComparator obc)
91          throws com.liferay.portal.NoSuchContactException,
92              com.liferay.portal.SystemException;
93  
94      public com.liferay.portal.model.Contact findByCompanyId_Last(
95          long companyId, com.liferay.portal.kernel.util.OrderByComparator obc)
96          throws com.liferay.portal.NoSuchContactException,
97              com.liferay.portal.SystemException;
98  
99      public com.liferay.portal.model.Contact[] findByCompanyId_PrevAndNext(
100         long contactId, long companyId,
101         com.liferay.portal.kernel.util.OrderByComparator obc)
102         throws com.liferay.portal.NoSuchContactException,
103             com.liferay.portal.SystemException;
104 
105     public java.util.List<Object> findWithDynamicQuery(
106         com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery)
107         throws com.liferay.portal.SystemException;
108 
109     public java.util.List<Object> findWithDynamicQuery(
110         com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery, int start,
111         int end) throws com.liferay.portal.SystemException;
112 
113     public java.util.List<com.liferay.portal.model.Contact> findAll()
114         throws com.liferay.portal.SystemException;
115 
116     public java.util.List<com.liferay.portal.model.Contact> findAll(int start,
117         int end) throws com.liferay.portal.SystemException;
118 
119     public java.util.List<com.liferay.portal.model.Contact> findAll(int start,
120         int end, com.liferay.portal.kernel.util.OrderByComparator obc)
121         throws com.liferay.portal.SystemException;
122 
123     public void removeByCompanyId(long companyId)
124         throws com.liferay.portal.SystemException;
125 
126     public void removeAll() throws com.liferay.portal.SystemException;
127 
128     public int countByCompanyId(long companyId)
129         throws com.liferay.portal.SystemException;
130 
131     public int countAll() throws com.liferay.portal.SystemException;
132 
133     public void registerListener(
134         com.liferay.portal.model.ModelListener listener);
135 
136     public void unregisterListener(
137         com.liferay.portal.model.ModelListener listener);
138 }