Liferay 7.0-ce-b4

com.liferay.portal.service.persistence
Interface BasePersistence<T extends BaseModel<T>>

All Known Subinterfaces:
AccountPersistence, AddressPersistence, AnnouncementsDeliveryPersistence, AnnouncementsEntryPersistence, AnnouncementsFlagPersistence, AssetCategoryPersistence, AssetCategoryPropertyPersistence, AssetEntryPersistence, AssetLinkPersistence, AssetTagPersistence, AssetTagStatsPersistence, AssetVocabularyPersistence, BlogsEntryPersistence, BlogsStatsUserPersistence, BrowserTrackerPersistence, CalEventPersistence, ClassNamePersistence, ClusterGroupPersistence, CompanyPersistence, ContactPersistence, CounterPersistence, CountryPersistence, DLContentPersistence, DLFileEntryMetadataPersistence, DLFileEntryPersistence, DLFileEntryTypePersistence, DLFileRankPersistence, DLFileShortcutPersistence, DLFileVersionPersistence, DLFolderPersistence, DLSyncEventPersistence, EmailAddressPersistence, ExpandoColumnPersistence, ExpandoRowPersistence, ExpandoTablePersistence, ExpandoValuePersistence, ExportImportConfigurationPersistence, GroupPersistence, ImagePersistence, LayoutBranchPersistence, LayoutFriendlyURLPersistence, LayoutPersistence, LayoutPrototypePersistence, LayoutRevisionPersistence, LayoutSetBranchPersistence, LayoutSetPersistence, LayoutSetPrototypePersistence, ListTypePersistence, MBBanPersistence, MBCategoryPersistence, MBDiscussionPersistence, MBMailingListPersistence, MBMessagePersistence, MBStatsUserPersistence, MBThreadFlagPersistence, MBThreadPersistence, MembershipRequestPersistence, OrganizationPersistence, OrgGroupRolePersistence, OrgLaborPersistence, PasswordPolicyPersistence, PasswordPolicyRelPersistence, PasswordTrackerPersistence, PhonePersistence, PluginSettingPersistence, PortalPreferencesPersistence, PortletItemPersistence, PortletPersistence, PortletPreferencesPersistence, RatingsEntryPersistence, RatingsStatsPersistence, RecentLayoutBranchPersistence, RecentLayoutRevisionPersistence, RecentLayoutSetBranchPersistence, RegionPersistence, ReleasePersistence, RepositoryEntryPersistence, RepositoryPersistence, ResourceActionPersistence, ResourceBlockPermissionPersistence, ResourceBlockPersistence, ResourcePermissionPersistence, ResourceTypePermissionPersistence, RolePersistence, ServiceComponentPersistence, SocialActivityAchievementPersistence, SocialActivityCounterPersistence, SocialActivityLimitPersistence, SocialActivityPersistence, SocialActivitySetPersistence, SocialActivitySettingPersistence, SocialRelationPersistence, SocialRequestPersistence, SubscriptionPersistence, SystemEventPersistence, TeamPersistence, TicketPersistence, TrashEntryPersistence, TrashVersionPersistence, UserGroupGroupRolePersistence, UserGroupPersistence, UserGroupRolePersistence, UserIdMapperPersistence, UserNotificationDeliveryPersistence, UserNotificationEventPersistence, UserPersistence, UserTrackerPathPersistence, UserTrackerPersistence, VirtualHostPersistence, WebDAVPropsPersistence, WebsitePersistence, WorkflowDefinitionLinkPersistence, WorkflowInstanceLinkPersistence
All Known Implementing Classes:
AccountPersistenceImpl, AddressPersistenceImpl, AddressPersistenceImpl2, AnnouncementsDeliveryPersistenceImpl, AnnouncementsEntryFinderBaseImpl, AnnouncementsEntryFinderImpl, AnnouncementsEntryPersistenceImpl, AnnouncementsFlagPersistenceImpl, AssetCategoryFinderBaseImpl, AssetCategoryFinderImpl, AssetCategoryPersistenceImpl, AssetCategoryPropertyFinderBaseImpl, AssetCategoryPropertyFinderImpl, AssetCategoryPropertyPersistenceImpl, AssetEntryFinderBaseImpl, AssetEntryFinderImpl, AssetEntryPersistenceImpl, AssetLinkPersistenceImpl, AssetTagFinderBaseImpl, AssetTagFinderImpl, AssetTagPersistenceImpl, AssetTagStatsPersistenceImpl, AssetVocabularyFinderBaseImpl, AssetVocabularyFinderImpl, AssetVocabularyPersistenceImpl, BasePersistenceImpl, BlogsEntryFinderBaseImpl, BlogsEntryFinderImpl, BlogsEntryPersistenceImpl, BlogsStatsUserFinderBaseImpl, BlogsStatsUserFinderImpl, BlogsStatsUserPersistenceImpl, BrowserTrackerPersistenceImpl, CalEventFinderBaseImpl, CalEventFinderImpl, CalEventPersistenceImpl, ClassNamePersistenceImpl, ClusterGroupPersistenceImpl, CompanyPersistenceImpl, ContactPersistenceImpl, CounterFinderImpl, CounterPersistenceImpl, CountryPersistenceImpl, DLContentPersistenceImpl, DLFileEntryFinderBaseImpl, DLFileEntryFinderImpl, DLFileEntryMetadataFinderBaseImpl, DLFileEntryMetadataFinderImpl, DLFileEntryMetadataPersistenceImpl, DLFileEntryPersistenceImpl, DLFileEntryTypeFinderBaseImpl, DLFileEntryTypeFinderImpl, DLFileEntryTypePersistenceImpl, DLFileRankFinderBaseImpl, DLFileRankFinderImpl, DLFileRankPersistenceImpl, DLFileShortcutPersistenceImpl, DLFileVersionPersistenceImpl, DLFolderFinderBaseImpl, DLFolderFinderImpl, DLFolderPersistenceImpl, DLSyncEventPersistenceImpl, EmailAddressPersistenceImpl, ExpandoColumnPersistenceImpl, ExpandoRowPersistenceImpl, ExpandoTablePersistenceImpl, ExpandoValuePersistenceImpl, ExportImportConfigurationPersistenceImpl, GroupFinderBaseImpl, GroupFinderImpl, GroupPersistenceImpl, ImagePersistenceImpl, LayoutBranchPersistenceImpl, LayoutFinderBaseImpl, LayoutFinderImpl, LayoutFriendlyURLPersistenceImpl, LayoutPersistenceImpl, LayoutPrototypePersistenceImpl, LayoutRevisionPersistenceImpl, LayoutSetBranchPersistenceImpl, LayoutSetPersistenceImpl, LayoutSetPrototypePersistenceImpl, ListTypePersistenceImpl, MBBanPersistenceImpl, MBCategoryFinderBaseImpl, MBCategoryFinderImpl, MBCategoryPersistenceImpl, MBDiscussionPersistenceImpl, MBMailingListPersistenceImpl, MBMessageFinderBaseImpl, MBMessageFinderImpl, MBMessagePersistenceImpl, MBStatsUserPersistenceImpl, MBThreadFinderBaseImpl, MBThreadFinderImpl, MBThreadFlagPersistenceImpl, MBThreadPersistenceImpl, MembershipRequestPersistenceImpl, MultiDataCenterCounterFinderImpl, OrganizationFinderBaseImpl, OrganizationFinderImpl, OrganizationPersistenceImpl, OrgGroupRolePersistenceImpl, OrgLaborPersistenceImpl, PasswordPolicyFinderBaseImpl, PasswordPolicyFinderImpl, PasswordPolicyPersistenceImpl, PasswordPolicyRelPersistenceImpl, PasswordTrackerPersistenceImpl, PhonePersistenceImpl, PluginSettingPersistenceImpl, PortalPreferencesPersistenceImpl, PortletItemPersistenceImpl, PortletPersistenceImpl, PortletPreferencesFinderBaseImpl, PortletPreferencesFinderImpl, PortletPreferencesPersistenceImpl, RatingsEntryFinderBaseImpl, RatingsEntryFinderImpl, RatingsEntryPersistenceImpl, RatingsStatsFinderBaseImpl, RatingsStatsFinderImpl, RatingsStatsPersistenceImpl, RecentLayoutBranchPersistenceImpl, RecentLayoutRevisionPersistenceImpl, RecentLayoutSetBranchPersistenceImpl, RegionPersistenceImpl, ReleasePersistenceImpl, RepositoryEntryPersistenceImpl, RepositoryPersistenceImpl, ResourceActionPersistenceImpl, ResourceBlockFinderBaseImpl, ResourceBlockFinderImpl, ResourceBlockPermissionPersistenceImpl, ResourceBlockPersistenceImpl, ResourcePermissionFinderBaseImpl, ResourcePermissionFinderImpl, ResourcePermissionPersistenceImpl, ResourceTypePermissionFinderBaseImpl, ResourceTypePermissionFinderImpl, ResourceTypePermissionPersistenceImpl, RoleFinderBaseImpl, RoleFinderImpl, RolePersistenceImpl, ServiceComponentFinderBaseImpl, ServiceComponentFinderImpl, ServiceComponentPersistenceImpl, SocialActivityAchievementPersistenceImpl, SocialActivityCounterFinderBaseImpl, SocialActivityCounterFinderImpl, SocialActivityCounterPersistenceImpl, SocialActivityFinderBaseImpl, SocialActivityFinderImpl, SocialActivityLimitPersistenceImpl, SocialActivityPersistenceImpl, SocialActivitySetFinderBaseImpl, SocialActivitySetFinderImpl, SocialActivitySetPersistenceImpl, SocialActivitySettingPersistenceImpl, SocialRelationPersistenceImpl, SocialRequestPersistenceImpl, SubscriptionPersistenceImpl, SystemEventPersistenceImpl, TeamFinderBaseImpl, TeamFinderImpl, TeamPersistenceImpl, TicketPersistenceImpl, TrashEntryPersistenceImpl, TrashVersionPersistenceImpl, UserFinderBaseImpl, UserFinderImpl, UserGroupFinderBaseImpl, UserGroupFinderImpl, UserGroupGroupRoleFinderBaseImpl, UserGroupGroupRoleFinderImpl, UserGroupGroupRolePersistenceImpl, UserGroupPersistenceImpl, UserGroupRoleFinderBaseImpl, UserGroupRoleFinderImpl, UserGroupRolePersistenceImpl, UserIdMapperPersistenceImpl, UserNotificationDeliveryPersistenceImpl, UserNotificationEventPersistenceImpl, UserPersistenceImpl, UserTrackerPathPersistenceImpl, UserTrackerPersistenceImpl, VirtualHostPersistenceImpl, WebDAVPropsPersistenceImpl, WebsitePersistenceImpl, WorkflowDefinitionLinkPersistenceImpl, WorkflowInstanceLinkPersistenceImpl

public interface BasePersistence<T extends BaseModel<T>>

The base interface for all ServiceBuilder persistence classes. This interface should never need to be used directly.

Caching information and settings can be found in portal.properties

See Also:
BasePersistenceImpl

Method Summary
 void clearCache()
          Clears the cache for all instances of this model.
 void clearCache(List<T> modelList)
          Clears the cache for a List instances of this model.
 void clearCache(T model)
          Clears the cache for one instance of this model.
 void closeSession(Session session)
           
 long countWithDynamicQuery(DynamicQuery dynamicQuery)
          Returns the number of rows that match the dynamic query.
 long countWithDynamicQuery(DynamicQuery dynamicQuery, Projection projection)
          Returns the number of rows that match the dynamic query.
 T fetchByPrimaryKey(Serializable primaryKey)
          Returns the model instance with the primary key or returns null if it could not be found.
 Map<Serializable,T> fetchByPrimaryKeys(Set<Serializable> primaryKeys)
           
 T findByPrimaryKey(Serializable primaryKey)
          Returns the model instance with the primary key or throws a NoSuchModelException if it could not be found.
<V> List<V>
findWithDynamicQuery(DynamicQuery dynamicQuery)
          Performs a dynamic query on the database and returns the matching rows.
<V> List<V>
findWithDynamicQuery(DynamicQuery dynamicQuery, int start, int end)
          Performs a dynamic query on the database and returns a range of the matching rows.
<V> List<V>
findWithDynamicQuery(DynamicQuery dynamicQuery, int start, int end, OrderByComparator<V> orderByComparator)
          Performs a dynamic query on the database and returns an ordered range of the matching rows.
 void flush()
           
 Set<String> getBadColumnNames()
           
 Session getCurrentSession()
           
 DataSource getDataSource()
          Returns the data source for this model.
 ModelListener<T>[] getListeners()
          Returns the listeners registered for this model.
 Class<T> getModelClass()
           
 Session openSession()
           
 SystemException processException(Exception e)
           
 void registerListener(ModelListener<T> listener)
          Registers a new listener for this model.
 T remove(Serializable primaryKey)
          Removes the model instance with the primary key from the database.
 T remove(T model)
          Removes the model instance from the database.
 void setDataSource(DataSource dataSource)
          Sets the data source for this model.
 void unregisterListener(ModelListener<T> listener)
          Unregisters the model listener.
 T update(T model)
          Updates the model instance in the database or adds it if it does not yet exist.
 T update(T model, boolean merge)
          Deprecated. As of 6.2.0, replaced by update(BaseModel)}
 T update(T model, boolean merge, ServiceContext serviceContext)
          Deprecated. As of 6.2.0, replaced by update(BaseModel, ServiceContext)}
 T update(T model, ServiceContext serviceContext)
          Updates the model instance in the database or adds it if it does not yet exist, within a different service context.
 

Method Detail

clearCache

void clearCache()
Clears the cache for all instances of this model.

The EntityCache and FinderCache are both cleared by this method.


clearCache

void clearCache(List<T> modelList)
Clears the cache for a List instances of this model.

The EntityCache and FinderCache are both cleared by this method.

Parameters:
modelList - the List instances of this model to clear the cache for

clearCache

void clearCache(T model)
Clears the cache for one instance of this model.

The EntityCache and FinderCache are both cleared by this method.

Parameters:
model - the instance of this model to clear the cache for

closeSession

void closeSession(Session session)

countWithDynamicQuery

long countWithDynamicQuery(DynamicQuery dynamicQuery)
Returns the number of rows that match the dynamic query.

Parameters:
dynamicQuery - the dynamic query
Returns:
the number of rows that match the dynamic query

countWithDynamicQuery

long countWithDynamicQuery(DynamicQuery dynamicQuery,
                           Projection projection)
Returns the number of rows that match the dynamic query.

Parameters:
dynamicQuery - the dynamic query
projection - the projection to apply to the query
Returns:
the number of rows that match the dynamic query

fetchByPrimaryKey

T fetchByPrimaryKey(Serializable primaryKey)
Returns the model instance with the primary key or returns null if it could not be found.

Parameters:
primaryKey - the primary key of the model instance
Returns:
the model instance, or null if an instance of this model with the primary key could not be found

fetchByPrimaryKeys

Map<Serializable,T> fetchByPrimaryKeys(Set<Serializable> primaryKeys)

findByPrimaryKey

T findByPrimaryKey(Serializable primaryKey)
                                        throws NoSuchModelException
Returns the model instance with the primary key or throws a NoSuchModelException if it could not be found.

Parameters:
primaryKey - the primary key of the model instance
Returns:
the model instance
Throws:
NoSuchModelException

findWithDynamicQuery

<V> List<V> findWithDynamicQuery(DynamicQuery dynamicQuery)
Performs a dynamic query on the database and returns the matching rows.

Parameters:
dynamicQuery - the dynamic query
Returns:
the matching rows

findWithDynamicQuery

<V> List<V> findWithDynamicQuery(DynamicQuery dynamicQuery,
                                 int start,
                                 int end)
Performs a dynamic query on the database and returns a range of the matching rows.

Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil.ALL_POS will return the full result set.

Parameters:
dynamicQuery - the dynamic query
start - the lower bound of the range of matching rows
end - the upper bound of the range of matching rows (not inclusive)
Returns:
the range of matching rows
See Also:
QueryUtil.list( com.liferay.portal.kernel.dao.orm.Query, com.liferay.portal.kernel.dao.orm.Dialect, int, int)

findWithDynamicQuery

<V> List<V> findWithDynamicQuery(DynamicQuery dynamicQuery,
                                 int start,
                                 int end,
                                 OrderByComparator<V> orderByComparator)
Performs a dynamic query on the database and returns an ordered range of the matching rows.

Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil.ALL_POS will return the full result set.

Parameters:
dynamicQuery - the dynamic query
start - the lower bound of the range of matching rows
end - the upper bound of the range of matching rows (not inclusive)
orderByComparator - the comparator to order the results by (optionally null)
Returns:
the ordered range of matching rows

flush

void flush()

getBadColumnNames

Set<String> getBadColumnNames()

getCurrentSession

Session getCurrentSession()
                          throws ORMException
Throws:
ORMException

getDataSource

DataSource getDataSource()
Returns the data source for this model.

Returns:
the data source for this model
See Also:
setDataSource(DataSource)

getListeners

ModelListener<T>[] getListeners()
Returns the listeners registered for this model.

Returns:
the listeners registered for this model
See Also:
registerListener(ModelListener)

getModelClass

Class<T> getModelClass()

openSession

Session openSession()
                    throws ORMException
Throws:
ORMException

processException

SystemException processException(Exception e)

registerListener

void registerListener(ModelListener<T> listener)
Registers a new listener for this model.

A model listener is notified whenever a change is made to an instance of this model, such as when one is added, updated, or removed.

Parameters:
listener - the model listener to register

remove

T remove(Serializable primaryKey)
                              throws NoSuchModelException
Removes the model instance with the primary key from the database. Also notifies the appropriate model listeners.

Parameters:
primaryKey - the primary key of the model instance to remove
Returns:
the model instance that was removed
Throws:
NoSuchModelException

remove

T remove(T model)
Removes the model instance from the database. Also notifies the appropriate model listeners.

Parameters:
model - the model instance to remove
Returns:
the model instance that was removed

setDataSource

void setDataSource(DataSource dataSource)
Sets the data source for this model.

Parameters:
dataSource - the data source to use for this model

unregisterListener

void unregisterListener(ModelListener<T> listener)
Unregisters the model listener.

Parameters:
listener - the model listener to unregister
See Also:
registerListener(ModelListener)

update

T update(T model)
Updates the model instance in the database or adds it if it does not yet exist. Also notifies the appropriate model listeners.

Typically not called directly, use local service update model methods instead. For example, UserLocalServiceUtil.updateUser( com.liferay.portal.model.User).

Parameters:
model - the model instance to update
Returns:
the model instance that was updated

update

@Deprecated
T update(T model,
                    boolean merge)
Deprecated. As of 6.2.0, replaced by update(BaseModel)}


update

@Deprecated
T update(T model,
                    boolean merge,
                    ServiceContext serviceContext)
Deprecated. As of 6.2.0, replaced by update(BaseModel, ServiceContext)}


update

T update(T model,
         ServiceContext serviceContext)
Updates the model instance in the database or adds it if it does not yet exist, within a different service context. Also notifies the appropriate model listeners.

Parameters:
model - the model instance to update
serviceContext - the service context to be applied
Returns:
the model instance that was updated

Liferay 7.0-ce-b4