com.liferay.portlet.social.service.base

Class SocialActivityLocalServiceBaseImpl

java.lang.Object

com.liferay.portal.kernel.service.BaseLocalServiceImpl

com.liferay.portlet.social.service.base.SocialActivityLocalServiceBaseImpl

All Implemented Interfaces:

com.liferay.portal.kernel.module.framework.service.IdentifiableOSGiService, com.liferay.portal.kernel.service.BaseLocalService, com.liferay.portal.kernel.service.change.tracking.CTService<com.liferay.social.kernel.model.SocialActivity>, com.liferay.portal.kernel.service.PersistedModelLocalService, com.liferay.social.kernel.service.SocialActivityLocalService

Direct Known Subclasses:

SocialActivityLocalServiceImpl

public abstract class SocialActivityLocalServiceBaseImpl
extends com.liferay.portal.kernel.service.BaseLocalServiceImpl
implements com.liferay.portal.kernel.module.framework.service.IdentifiableOSGiService, com.liferay.social.kernel.service.SocialActivityLocalService

Provides the base implementation for the social activity local service.

This implementation exists only as a container for the default service methods generated by ServiceBuilder. All custom service methods should be put in SocialActivityLocalServiceImpl.

Author:

Brian Wing Shun Chan

See Also:

SocialActivityLocalServiceImpl

Generated:

Field Summary

Fields

Modifier and Type	Field and Description
protected com.liferay.counter.kernel.service.CounterLocalService	counterLocalService
protected com.liferay.portal.kernel.service.PersistedModelLocalServiceRegistry	persistedModelLocalServiceRegistry
protected com.liferay.social.kernel.service.persistence.SocialActivityFinder	socialActivityFinder
protected com.liferay.social.kernel.service.SocialActivityLocalService	socialActivityLocalService
protected com.liferay.social.kernel.service.persistence.SocialActivityPersistence	socialActivityPersistence

Constructor Summary

Constructors

Constructor and Description
SocialActivityLocalServiceBaseImpl()

Method Summary

Modifier and Type	Method and Description
com.liferay.social.kernel.model.SocialActivity	addSocialActivity(com.liferay.social.kernel.model.SocialActivity socialActivity) Adds the social activity to the database.
void	afterPropertiesSet()
com.liferay.portal.kernel.model.PersistedModel	createPersistedModel(java.io.Serializable primaryKeyObj)
com.liferay.social.kernel.model.SocialActivity	createSocialActivity(long activityId) Creates a new social activity with the primary key.
com.liferay.portal.kernel.model.PersistedModel	deletePersistedModel(com.liferay.portal.kernel.model.PersistedModel persistedModel)
com.liferay.social.kernel.model.SocialActivity	deleteSocialActivity(long activityId) Deletes the social activity with the primary key from the database.
com.liferay.social.kernel.model.SocialActivity	deleteSocialActivity(com.liferay.social.kernel.model.SocialActivity socialActivity) Deletes the social activity from the database.
void	destroy()
<T> T	dslQuery(com.liferay.petra.sql.dsl.query.DSLQuery dslQuery)
int	dslQueryCount(com.liferay.petra.sql.dsl.query.DSLQuery dslQuery)
com.liferay.portal.kernel.dao.orm.DynamicQuery	dynamicQuery()
<T> java.util.List<T>	dynamicQuery(com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery) Performs a dynamic query on the database and returns the matching rows.
<T> java.util.List<T>	dynamicQuery(com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery, int start, int end) Performs a dynamic query on the database and returns a range of the matching rows.
<T> java.util.List<T>	dynamicQuery(com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery, int start, int end, com.liferay.portal.kernel.util.OrderByComparator<T> orderByComparator) Performs a dynamic query on the database and returns an ordered range of the matching rows.
long	dynamicQueryCount(com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery) Returns the number of rows matching the dynamic query.
long	dynamicQueryCount(com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery, com.liferay.portal.kernel.dao.orm.Projection projection) Returns the number of rows matching the dynamic query.
com.liferay.social.kernel.model.SocialActivity	fetchSocialActivity(long activityId)
com.liferay.portal.kernel.dao.orm.ActionableDynamicQuery	getActionableDynamicQuery()
com.liferay.portal.kernel.service.persistence.BasePersistence<com.liferay.social.kernel.model.SocialActivity>	getBasePersistence()
com.liferay.counter.kernel.service.CounterLocalService	getCounterLocalService() Returns the counter local service.
com.liferay.portal.kernel.service.persistence.change.tracking.CTPersistence<com.liferay.social.kernel.model.SocialActivity>	getCTPersistence()
com.liferay.portal.kernel.dao.orm.IndexableActionableDynamicQuery	getIndexableActionableDynamicQuery()
java.lang.Class<com.liferay.social.kernel.model.SocialActivity>	getModelClass()
protected java.lang.String	getModelClassName()
java.lang.String	getOSGiServiceIdentifier() Returns the OSGi service identifier.
com.liferay.portal.kernel.model.PersistedModel	getPersistedModel(java.io.Serializable primaryKeyObj)
java.util.List<com.liferay.social.kernel.model.SocialActivity>	getSocialActivities(int start, int end) Returns a range of all the social activities.
int	getSocialActivitiesCount() Returns the number of social activities.
com.liferay.social.kernel.model.SocialActivity	getSocialActivity(long activityId) Returns the social activity with the primary key.
com.liferay.social.kernel.service.persistence.SocialActivityFinder	getSocialActivityFinder() Returns the social activity finder.
com.liferay.social.kernel.service.SocialActivityLocalService	getSocialActivityLocalService() Returns the social activity local service.
com.liferay.social.kernel.service.persistence.SocialActivityPersistence	getSocialActivityPersistence() Returns the social activity persistence.
protected void	initActionableDynamicQuery(com.liferay.portal.kernel.dao.orm.ActionableDynamicQuery actionableDynamicQuery)
protected void	runSQL(java.lang.String sql) Performs a SQL query.
void	setCounterLocalService(com.liferay.counter.kernel.service.CounterLocalService counterLocalService) Sets the counter local service.
void	setSocialActivityFinder(com.liferay.social.kernel.service.persistence.SocialActivityFinder socialActivityFinder) Sets the social activity finder.
void	setSocialActivityLocalService(com.liferay.social.kernel.service.SocialActivityLocalService socialActivityLocalService) Sets the social activity local service.
void	setSocialActivityPersistence(com.liferay.social.kernel.service.persistence.SocialActivityPersistence socialActivityPersistence) Sets the social activity persistence.
com.liferay.social.kernel.model.SocialActivity	updateSocialActivity(com.liferay.social.kernel.model.SocialActivity socialActivity) Updates the social activity in the database or adds it if it does not yet exist.
<R,E extends java.lang.Throwable> R	updateWithUnsafeFunction(com.liferay.petra.function.UnsafeFunction<com.liferay.portal.kernel.service.persistence.change.tracking.CTPersistence<com.liferay.social.kernel.model.SocialActivity>,R,E> updateUnsafeFunction)

Methods inherited from class com.liferay.portal.kernel.service.BaseLocalServiceImpl

getClassLoader, getLocalizationMap

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.liferay.social.kernel.service.SocialActivityLocalService

addActivity, addActivity, addActivity, addUniqueActivity, addUniqueActivity, deleteActivities, deleteActivities, deleteActivities, deleteActivity, deleteActivity, deleteUserActivities, fetchFirstActivity, getActivities, getActivities, getActivities, getActivities, getActivitiesCount, getActivitiesCount, getActivitiesCount, getActivitiesCount, getActivitiesCount, getActivity, getActivitySetActivities, getGroupActivities, getGroupActivitiesCount, getGroupUsersActivities, getGroupUsersActivitiesCount, getMirrorActivity, getOrganizationActivities, getOrganizationActivitiesCount, getOrganizationUsersActivities, getOrganizationUsersActivitiesCount, getRelationActivities, getRelationActivities, getRelationActivitiesCount, getRelationActivitiesCount, getUserActivities, getUserActivitiesCount, getUserGroupsActivities, getUserGroupsActivitiesCount, getUserGroupsAndOrganizationsActivities, getUserGroupsAndOrganizationsActivitiesCount, getUserOrganizationsActivities, getUserOrganizationsActivitiesCount

Field Detail

socialActivityLocalService

@BeanReference(type=com.liferay.social.kernel.service.SocialActivityLocalService.class)
protected com.liferay.social.kernel.service.SocialActivityLocalService socialActivityLocalService

socialActivityPersistence

@BeanReference(type=com.liferay.social.kernel.service.persistence.SocialActivityPersistence.class)
protected com.liferay.social.kernel.service.persistence.SocialActivityPersistence socialActivityPersistence

socialActivityFinder

@BeanReference(type=com.liferay.social.kernel.service.persistence.SocialActivityFinder.class)
protected com.liferay.social.kernel.service.persistence.SocialActivityFinder socialActivityFinder

counterLocalService

@BeanReference(type=com.liferay.counter.kernel.service.CounterLocalService.class)
protected com.liferay.counter.kernel.service.CounterLocalService counterLocalService

persistedModelLocalServiceRegistry

@BeanReference(type=com.liferay.portal.kernel.service.PersistedModelLocalServiceRegistry.class)
protected com.liferay.portal.kernel.service.PersistedModelLocalServiceRegistry persistedModelLocalServiceRegistry

Constructor Detail

SocialActivityLocalServiceBaseImpl

public SocialActivityLocalServiceBaseImpl()

Method Detail

addSocialActivity

@Indexable(type=REINDEX)
public com.liferay.social.kernel.model.SocialActivity addSocialActivity(com.liferay.social.kernel.model.SocialActivity socialActivity)

Adds the social activity to the database. Also notifies the appropriate model listeners.

Important: Inspect SocialActivityLocalServiceImpl for overloaded versions of the method. If provided, use these entry points to the API, as the implementation logic may require the additional parameters defined there.

Specified by:

addSocialActivity in interface com.liferay.social.kernel.service.SocialActivityLocalService

Parameters:

socialActivity - the social activity

Returns:

the social activity that was added

createSocialActivity

@Transactional(enabled=false)
public com.liferay.social.kernel.model.SocialActivity createSocialActivity(long activityId)

Creates a new social activity with the primary key. Does not add the social activity to the database.

Specified by:

createSocialActivity in interface com.liferay.social.kernel.service.SocialActivityLocalService

Parameters:

activityId - the primary key for the new social activity

Returns:

the new social activity

deleteSocialActivity

@Indexable(type=DELETE)
public com.liferay.social.kernel.model.SocialActivity deleteSocialActivity(long activityId)
                                                                                            throws com.liferay.portal.kernel.exception.PortalException

Deletes the social activity with the primary key from the database. Also notifies the appropriate model listeners.

Important: Inspect SocialActivityLocalServiceImpl for overloaded versions of the method. If provided, use these entry points to the API, as the implementation logic may require the additional parameters defined there.

Specified by:

deleteSocialActivity in interface com.liferay.social.kernel.service.SocialActivityLocalService

Parameters:

activityId - the primary key of the social activity

Returns:

the social activity that was removed

Throws:

com.liferay.portal.kernel.exception.PortalException - if a social activity with the primary key could not be found

deleteSocialActivity

@Indexable(type=DELETE)
public com.liferay.social.kernel.model.SocialActivity deleteSocialActivity(com.liferay.social.kernel.model.SocialActivity socialActivity)

Deletes the social activity from the database. Also notifies the appropriate model listeners.

Important: Inspect SocialActivityLocalServiceImpl for overloaded versions of the method. If provided, use these entry points to the API, as the implementation logic may require the additional parameters defined there.

Specified by:

deleteSocialActivity in interface com.liferay.social.kernel.service.SocialActivityLocalService

Parameters:

socialActivity - the social activity

Returns:

the social activity that was removed

dslQuery

public <T> T dslQuery(com.liferay.petra.sql.dsl.query.DSLQuery dslQuery)

Specified by:

dslQuery in interface com.liferay.portal.kernel.service.PersistedModelLocalService

Specified by:

dslQuery in interface com.liferay.social.kernel.service.SocialActivityLocalService

dslQueryCount

public int dslQueryCount(com.liferay.petra.sql.dsl.query.DSLQuery dslQuery)

Specified by:

dslQueryCount in interface com.liferay.portal.kernel.service.PersistedModelLocalService

Specified by:

dslQueryCount in interface com.liferay.social.kernel.service.SocialActivityLocalService

dynamicQuery

public com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery()

Specified by:

dynamicQuery in interface com.liferay.social.kernel.service.SocialActivityLocalService

dynamicQuery

public <T> java.util.List<T> dynamicQuery(com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery)

Performs a dynamic query on the database and returns the matching rows.

Specified by:

dynamicQuery in interface com.liferay.social.kernel.service.SocialActivityLocalService

Parameters:

dynamicQuery - the dynamic query

Returns:

the matching rows

dynamicQuery

public <T> java.util.List<T> dynamicQuery(com.liferay.portal.kernel.dao.orm.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 com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS will return the full result set. If orderByComparator is specified, then the query will include the given ORDER BY logic. If orderByComparator is absent, then the query will include the default ORDER BY logic from com.liferay.portlet.social.model.impl.SocialActivityModelImpl.

Specified by:

dynamicQuery in interface com.liferay.social.kernel.service.SocialActivityLocalService

Parameters:

dynamicQuery - the dynamic query

start - the lower bound of the range of model instances

end - the upper bound of the range of model instances (not inclusive)

Returns:

the range of matching rows

dynamicQuery

public <T> java.util.List<T> dynamicQuery(com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery,
                                          int start,
                                          int end,
                                          com.liferay.portal.kernel.util.OrderByComparator<T> 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 com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS will return the full result set. If orderByComparator is specified, then the query will include the given ORDER BY logic. If orderByComparator is absent, then the query will include the default ORDER BY logic from com.liferay.portlet.social.model.impl.SocialActivityModelImpl.

Specified by:

dynamicQuery in interface com.liferay.social.kernel.service.SocialActivityLocalService

Parameters:

dynamicQuery - the dynamic query

start - the lower bound of the range of model instances

end - the upper bound of the range of model instances (not inclusive)

orderByComparator - the comparator to order the results by (optionally null)

Returns:

the ordered range of matching rows

dynamicQueryCount

public long dynamicQueryCount(com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery)

Returns the number of rows matching the dynamic query.

Specified by:

dynamicQueryCount in interface com.liferay.social.kernel.service.SocialActivityLocalService

Parameters:

dynamicQuery - the dynamic query

Returns:

the number of rows matching the dynamic query

dynamicQueryCount

public long dynamicQueryCount(com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery,
                              com.liferay.portal.kernel.dao.orm.Projection projection)

Returns the number of rows matching the dynamic query.

Specified by:

dynamicQueryCount in interface com.liferay.social.kernel.service.SocialActivityLocalService

Parameters:

dynamicQuery - the dynamic query

projection - the projection to apply to the query

Returns:

the number of rows matching the dynamic query

fetchSocialActivity

public com.liferay.social.kernel.model.SocialActivity fetchSocialActivity(long activityId)

Specified by:

fetchSocialActivity in interface com.liferay.social.kernel.service.SocialActivityLocalService

getSocialActivity

public com.liferay.social.kernel.model.SocialActivity getSocialActivity(long activityId)
                                                                 throws com.liferay.portal.kernel.exception.PortalException

Returns the social activity with the primary key.

Specified by:

getSocialActivity in interface com.liferay.social.kernel.service.SocialActivityLocalService

Parameters:

activityId - the primary key of the social activity

Returns:

the social activity

Throws:

com.liferay.portal.kernel.exception.PortalException - if a social activity with the primary key could not be found

getActionableDynamicQuery

public com.liferay.portal.kernel.dao.orm.ActionableDynamicQuery getActionableDynamicQuery()

Specified by:

getActionableDynamicQuery in interface com.liferay.social.kernel.service.SocialActivityLocalService

getIndexableActionableDynamicQuery

public com.liferay.portal.kernel.dao.orm.IndexableActionableDynamicQuery getIndexableActionableDynamicQuery()

Specified by:

getIndexableActionableDynamicQuery in interface com.liferay.social.kernel.service.SocialActivityLocalService

initActionableDynamicQuery

protected void initActionableDynamicQuery(com.liferay.portal.kernel.dao.orm.ActionableDynamicQuery actionableDynamicQuery)

createPersistedModel

public com.liferay.portal.kernel.model.PersistedModel createPersistedModel(java.io.Serializable primaryKeyObj)
                                                                    throws com.liferay.portal.kernel.exception.PortalException

Specified by:

createPersistedModel in interface com.liferay.portal.kernel.service.PersistedModelLocalService

Specified by:

createPersistedModel in interface com.liferay.social.kernel.service.SocialActivityLocalService

Throws:

com.liferay.portal.kernel.exception.PortalException

deletePersistedModel

public com.liferay.portal.kernel.model.PersistedModel deletePersistedModel(com.liferay.portal.kernel.model.PersistedModel persistedModel)
                                                                    throws com.liferay.portal.kernel.exception.PortalException

Specified by:

deletePersistedModel in interface com.liferay.portal.kernel.service.PersistedModelLocalService

Specified by:

deletePersistedModel in interface com.liferay.social.kernel.service.SocialActivityLocalService

Throws:

com.liferay.portal.kernel.exception.PortalException

getBasePersistence

public com.liferay.portal.kernel.service.persistence.BasePersistence<com.liferay.social.kernel.model.SocialActivity> getBasePersistence()

Specified by:

getBasePersistence in interface com.liferay.portal.kernel.service.PersistedModelLocalService

getPersistedModel

public com.liferay.portal.kernel.model.PersistedModel getPersistedModel(java.io.Serializable primaryKeyObj)
                                                                 throws com.liferay.portal.kernel.exception.PortalException

Specified by:

getPersistedModel in interface com.liferay.portal.kernel.service.PersistedModelLocalService

Specified by:

getPersistedModel in interface com.liferay.social.kernel.service.SocialActivityLocalService

Throws:

com.liferay.portal.kernel.exception.PortalException

getSocialActivities

public java.util.List<com.liferay.social.kernel.model.SocialActivity> getSocialActivities(int start,
                                                                                          int end)

Returns a range of all the social activities.

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 com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS will return the full result set. If orderByComparator is specified, then the query will include the given ORDER BY logic. If orderByComparator is absent, then the query will include the default ORDER BY logic from com.liferay.portlet.social.model.impl.SocialActivityModelImpl.

Specified by:

getSocialActivities in interface com.liferay.social.kernel.service.SocialActivityLocalService

Parameters:

start - the lower bound of the range of social activities

end - the upper bound of the range of social activities (not inclusive)

Returns:

the range of social activities

getSocialActivitiesCount

public int getSocialActivitiesCount()

Returns the number of social activities.

Specified by:

getSocialActivitiesCount in interface com.liferay.social.kernel.service.SocialActivityLocalService

Returns:

the number of social activities

updateSocialActivity

@Indexable(type=REINDEX)
public com.liferay.social.kernel.model.SocialActivity updateSocialActivity(com.liferay.social.kernel.model.SocialActivity socialActivity)

Updates the social activity in the database or adds it if it does not yet exist. Also notifies the appropriate model listeners.

Important: Inspect SocialActivityLocalServiceImpl for overloaded versions of the method. If provided, use these entry points to the API, as the implementation logic may require the additional parameters defined there.

Specified by:

updateSocialActivity in interface com.liferay.social.kernel.service.SocialActivityLocalService

Parameters:

socialActivity - the social activity

Returns:

the social activity that was updated

getSocialActivityLocalService

public com.liferay.social.kernel.service.SocialActivityLocalService getSocialActivityLocalService()

Returns the social activity local service.

Returns:

the social activity local service

setSocialActivityLocalService

public void setSocialActivityLocalService(com.liferay.social.kernel.service.SocialActivityLocalService socialActivityLocalService)

Sets the social activity local service.

Parameters:

socialActivityLocalService - the social activity local service

getSocialActivityPersistence

public com.liferay.social.kernel.service.persistence.SocialActivityPersistence getSocialActivityPersistence()

Returns the social activity persistence.

Returns:

the social activity persistence

setSocialActivityPersistence

public void setSocialActivityPersistence(com.liferay.social.kernel.service.persistence.SocialActivityPersistence socialActivityPersistence)

Sets the social activity persistence.

Parameters:

socialActivityPersistence - the social activity persistence

getSocialActivityFinder

public com.liferay.social.kernel.service.persistence.SocialActivityFinder getSocialActivityFinder()

Returns the social activity finder.

Returns:

the social activity finder

setSocialActivityFinder

public void setSocialActivityFinder(com.liferay.social.kernel.service.persistence.SocialActivityFinder socialActivityFinder)

Sets the social activity finder.

Parameters:

socialActivityFinder - the social activity finder

getCounterLocalService

public com.liferay.counter.kernel.service.CounterLocalService getCounterLocalService()

Returns the counter local service.

Returns:

the counter local service

setCounterLocalService

public void setCounterLocalService(com.liferay.counter.kernel.service.CounterLocalService counterLocalService)

Sets the counter local service.

Parameters:

counterLocalService - the counter local service

afterPropertiesSet

public void afterPropertiesSet()

destroy

public void destroy()

getOSGiServiceIdentifier

public java.lang.String getOSGiServiceIdentifier()

Returns the OSGi service identifier.

Specified by:

getOSGiServiceIdentifier in interface com.liferay.portal.kernel.module.framework.service.IdentifiableOSGiService

Specified by:

getOSGiServiceIdentifier in interface com.liferay.social.kernel.service.SocialActivityLocalService

Returns:

the OSGi service identifier

getCTPersistence

public com.liferay.portal.kernel.service.persistence.change.tracking.CTPersistence<com.liferay.social.kernel.model.SocialActivity> getCTPersistence()

Specified by:

getCTPersistence in interface com.liferay.portal.kernel.service.change.tracking.CTService<com.liferay.social.kernel.model.SocialActivity>

Specified by:

getCTPersistence in interface com.liferay.social.kernel.service.SocialActivityLocalService

getModelClass

public java.lang.Class<com.liferay.social.kernel.model.SocialActivity> getModelClass()

Specified by:

getModelClass in interface com.liferay.portal.kernel.service.change.tracking.CTService<com.liferay.social.kernel.model.SocialActivity>

Specified by:

getModelClass in interface com.liferay.social.kernel.service.SocialActivityLocalService

updateWithUnsafeFunction

public <R,E extends java.lang.Throwable> R updateWithUnsafeFunction(com.liferay.petra.function.UnsafeFunction<com.liferay.portal.kernel.service.persistence.change.tracking.CTPersistence<com.liferay.social.kernel.model.SocialActivity>,R,E> updateUnsafeFunction)
                                                             throws E extends java.lang.Throwable

Specified by:

updateWithUnsafeFunction in interface com.liferay.portal.kernel.service.change.tracking.CTService<com.liferay.social.kernel.model.SocialActivity>

Specified by:

updateWithUnsafeFunction in interface com.liferay.social.kernel.service.SocialActivityLocalService

Throws:

E extends java.lang.Throwable

getModelClassName

protected java.lang.String getModelClassName()

runSQL

protected void runSQL(java.lang.String sql)

Performs a SQL query.

Parameters:

sql - the sql query