Interface SocialRelationLocalService
- All Superinterfaces:
BaseLocalService
,CTService<SocialRelation>
,PersistedModelLocalService
- All Known Implementing Classes:
SocialRelationLocalServiceWrapper
- Author:
- Brian Wing Shun Chan
- See Also:
- {$generated.description}
-
Method Summary
Modifier and TypeMethodDescriptionaddRelation
(long userId1, long userId2, int type) Adds a social relation between the two users to the database.addSocialRelation
(SocialRelation socialRelation) Adds the social relation to the database.createPersistedModel
(Serializable primaryKeyObj) createSocialRelation
(long relationId) Creates a new social relation with the primary key.deletePersistedModel
(PersistedModel persistedModel) void
deleteRelation
(long relationId) Removes the relation (and its inverse in case of a bidirectional relation) from the database.void
deleteRelation
(long userId1, long userId2, int type) Removes the matching relation (and its inverse in case of a bidirectional relation) from the database.void
deleteRelation
(SocialRelation relation) Removes the relation (and its inverse in case of a bidirectional relation) from the database.void
deleteRelations
(long userId) Removes all relations involving the user from the database.void
deleteRelations
(long userId1, long userId2) Removes all relations between User1 and User2.deleteSocialRelation
(long relationId) Deletes the social relation with the primary key from the database.deleteSocialRelation
(SocialRelation socialRelation) Deletes the social relation from the database.<T> T
dslQuery
(com.liferay.petra.sql.dsl.query.DSLQuery dslQuery) int
dslQueryCount
(com.liferay.petra.sql.dsl.query.DSLQuery dslQuery) <T> List<T>
dynamicQuery
(DynamicQuery dynamicQuery) Performs a dynamic query on the database and returns the matching rows.<T> List<T>
dynamicQuery
(DynamicQuery dynamicQuery, int start, int end) Performs a dynamic query on the database and returns a range of the matching rows.<T> List<T>
dynamicQuery
(DynamicQuery dynamicQuery, int start, int end, OrderByComparator<T> orderByComparator) Performs a dynamic query on the database and returns an ordered range of the matching rows.long
dynamicQueryCount
(DynamicQuery dynamicQuery) Returns the number of rows matching the dynamic query.long
dynamicQueryCount
(DynamicQuery dynamicQuery, Projection projection) Returns the number of rows matching the dynamic query.fetchSocialRelation
(long relationId) fetchSocialRelationByUuidAndCompanyId
(String uuid, long companyId) Returns the social relation with the matching UUID and company.getInverseRelations
(long userId, int type, int start, int end) Returns a range of all the inverse relations of the given type for which the user is User2 of the relation.int
getInverseRelationsCount
(long userId, int type) Returns the number of inverse relations of the given type for which the user is User2 of the relation.Returns the OSGi service identifier.getPersistedModel
(Serializable primaryKeyObj) getRelation
(long relationId) Returns the relation identified by its primary key.getRelation
(long userId1, long userId2, int type) Returns the relation of the given type between User1 and User2.getRelations
(long userId, int type, int start, int end) Returns a range of all the relations of the given type where the user is the subject of the relation.getRelations
(long userId1, long userId2, int start, int end) Returns a range of all the relations between User1 and User2.int
getRelationsCount
(long userId, int type) Returns the number of relations of the given type where the user is the subject of the relation.int
getRelationsCount
(long userId1, long userId2) Returns the number of relations between User1 and User2.getSocialRelation
(long relationId) Returns the social relation with the primary key.getSocialRelationByUuidAndCompanyId
(String uuid, long companyId) Returns the social relation with the matching UUID and company.getSocialRelations
(int start, int end) Returns a range of all the social relations.int
Returns the number of social relations.boolean
hasRelation
(long userId1, long userId2, int type) Returnstrue
if a relation of the given type exists where the user with primary keyuserId1
is User1 of the relation and the user with the primary keyuserId2
is User2 of the relation.boolean
isRelatable
(long userId1, long userId2, int type) Returnstrue
if the users can be in a relation of the given type where the user with primary keyuserId1
is User1 of the relation and the user with the primary keyuserId2
is User2 of the relation.updateSocialRelation
(SocialRelation socialRelation) Updates the social relation in the database or adds it if it does not yet exist.<R,
E extends Throwable>
RupdateWithUnsafeFunction
(com.liferay.petra.function.UnsafeFunction<CTPersistence<SocialRelation>, R, E> updateUnsafeFunction) Methods inherited from interface com.liferay.portal.kernel.service.PersistedModelLocalService
fetchPersistedModel, getBasePersistence
-
Method Details
-
addRelation
Adds a social relation between the two users to the database.- Parameters:
userId1
- the user that is the subject of the relationuserId2
- the user at the other end of the relationtype
- the type of the relation- Returns:
- the social relation
- Throws:
PortalException
-
addSocialRelation
Adds the social relation to the database. Also notifies the appropriate model listeners.Important: Inspect SocialRelationLocalServiceImpl 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.
- Parameters:
socialRelation
- the social relation- Returns:
- the social relation that was added
-
createPersistedModel
- Specified by:
createPersistedModel
in interfacePersistedModelLocalService
- Throws:
PortalException
-
createSocialRelation
Creates a new social relation with the primary key. Does not add the social relation to the database.- Parameters:
relationId
- the primary key for the new social relation- Returns:
- the new social relation
-
deletePersistedModel
- Specified by:
deletePersistedModel
in interfacePersistedModelLocalService
- Throws:
PortalException
-
deleteRelation
Removes the relation (and its inverse in case of a bidirectional relation) from the database.- Parameters:
relationId
- the primary key of the relation- Throws:
PortalException
-
deleteRelation
Removes the matching relation (and its inverse in case of a bidirectional relation) from the database.- Parameters:
userId1
- the user that is the subject of the relationuserId2
- the user at the other end of the relationtype
- the relation's type- Throws:
PortalException
-
deleteRelation
Removes the relation (and its inverse in case of a bidirectional relation) from the database.- Parameters:
relation
- the relation to be removed- Throws:
PortalException
-
deleteRelations
void deleteRelations(long userId) Removes all relations involving the user from the database.- Parameters:
userId
- the primary key of the user
-
deleteRelations
Removes all relations between User1 and User2.- Parameters:
userId1
- the user that is the subject of the relationuserId2
- the user at the other end of the relation- Throws:
PortalException
-
deleteSocialRelation
Deletes the social relation with the primary key from the database. Also notifies the appropriate model listeners.Important: Inspect SocialRelationLocalServiceImpl 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.
- Parameters:
relationId
- the primary key of the social relation- Returns:
- the social relation that was removed
- Throws:
PortalException
- if a social relation with the primary key could not be found
-
deleteSocialRelation
Deletes the social relation from the database. Also notifies the appropriate model listeners.Important: Inspect SocialRelationLocalServiceImpl 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.
- Parameters:
socialRelation
- the social relation- Returns:
- the social relation that was removed
-
dslQuery
@Transactional(propagation=SUPPORTS, readOnly=true) <T> T dslQuery(com.liferay.petra.sql.dsl.query.DSLQuery dslQuery) - Specified by:
dslQuery
in interfacePersistedModelLocalService
-
dslQueryCount
@Transactional(propagation=SUPPORTS, readOnly=true) int dslQueryCount(com.liferay.petra.sql.dsl.query.DSLQuery dslQuery) - Specified by:
dslQueryCount
in interfacePersistedModelLocalService
-
dynamicQuery
-
dynamicQuery
@Transactional(propagation=SUPPORTS, readOnly=true) <T> List<T> dynamicQuery(DynamicQuery dynamicQuery) Performs a dynamic query on the database and returns the matching rows.- Parameters:
dynamicQuery
- the dynamic query- Returns:
- the matching rows
-
dynamicQuery
@Transactional(propagation=SUPPORTS, readOnly=true) <T> List<T> dynamicQuery(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
andend
are not primary keys, they are indexes in the result set. Thus,0
refers to the first result in the set. Setting bothstart
andend
tocom.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS
will return the full result set. IforderByComparator
is specified, then the query will include the given ORDER BY logic. IforderByComparator
is absent, then the query will include the default ORDER BY logic fromcom.liferay.portlet.social.model.impl.SocialRelationModelImpl
.- Parameters:
dynamicQuery
- the dynamic querystart
- the lower bound of the range of model instancesend
- the upper bound of the range of model instances (not inclusive)- Returns:
- the range of matching rows
-
dynamicQuery
@Transactional(propagation=SUPPORTS, readOnly=true) <T> List<T> dynamicQuery(DynamicQuery dynamicQuery, int start, int end, 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
andend
are not primary keys, they are indexes in the result set. Thus,0
refers to the first result in the set. Setting bothstart
andend
tocom.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS
will return the full result set. IforderByComparator
is specified, then the query will include the given ORDER BY logic. IforderByComparator
is absent, then the query will include the default ORDER BY logic fromcom.liferay.portlet.social.model.impl.SocialRelationModelImpl
.- Parameters:
dynamicQuery
- the dynamic querystart
- the lower bound of the range of model instancesend
- the upper bound of the range of model instances (not inclusive)orderByComparator
- the comparator to order the results by (optionallynull
)- Returns:
- the ordered range of matching rows
-
dynamicQueryCount
@Transactional(propagation=SUPPORTS, readOnly=true) long dynamicQueryCount(DynamicQuery dynamicQuery) Returns the number of rows matching the dynamic query.- Parameters:
dynamicQuery
- the dynamic query- Returns:
- the number of rows matching the dynamic query
-
dynamicQueryCount
@Transactional(propagation=SUPPORTS, readOnly=true) long dynamicQueryCount(DynamicQuery dynamicQuery, Projection projection) Returns the number of rows matching the dynamic query.- Parameters:
dynamicQuery
- the dynamic queryprojection
- the projection to apply to the query- Returns:
- the number of rows matching the dynamic query
-
fetchSocialRelation
@Transactional(propagation=SUPPORTS, readOnly=true) SocialRelation fetchSocialRelation(long relationId) -
fetchSocialRelationByUuidAndCompanyId
@Transactional(propagation=SUPPORTS, readOnly=true) SocialRelation fetchSocialRelationByUuidAndCompanyId(String uuid, long companyId) Returns the social relation with the matching UUID and company.- Parameters:
uuid
- the social relation's UUIDcompanyId
- the primary key of the company- Returns:
- the matching social relation, or
null
if a matching social relation could not be found
-
getActionableDynamicQuery
@Transactional(propagation=SUPPORTS, readOnly=true) ActionableDynamicQuery getActionableDynamicQuery() -
getIndexableActionableDynamicQuery
@Transactional(propagation=SUPPORTS, readOnly=true) IndexableActionableDynamicQuery getIndexableActionableDynamicQuery() -
getInverseRelations
@Transactional(propagation=SUPPORTS, readOnly=true) List<SocialRelation> getInverseRelations(long userId, int type, int start, int end) Returns a range of all the inverse relations of the given type for which the user is User2 of the relation.Useful when paginating results. Returns a maximum of
end - start
instances.start
andend
are not primary keys, they are indexes in the result set. Thus,0
refers to the first result in the set. Setting bothstart
andend
toQueryUtil.ALL_POS
will return the full result set.- Parameters:
userId
- the primary key of the usertype
- the relation's typestart
- the lower bound of the range of resultsend
- the upper bound of the range of results (not inclusive)- Returns:
- the range of matching relations
-
getInverseRelationsCount
@Transactional(propagation=SUPPORTS, readOnly=true) int getInverseRelationsCount(long userId, int type) Returns the number of inverse relations of the given type for which the user is User2 of the relation.- Parameters:
userId
- the primary key of the usertype
- the relation's type- Returns:
- the number of matching relations
-
getOSGiServiceIdentifier
String getOSGiServiceIdentifier()Returns the OSGi service identifier.- Returns:
- the OSGi service identifier
-
getPersistedModel
@Transactional(propagation=SUPPORTS, readOnly=true) PersistedModel getPersistedModel(Serializable primaryKeyObj) throws PortalException - Specified by:
getPersistedModel
in interfacePersistedModelLocalService
- Throws:
PortalException
-
getRelation
@Transactional(propagation=SUPPORTS, readOnly=true) SocialRelation getRelation(long relationId) throws PortalException Returns the relation identified by its primary key.- Parameters:
relationId
- the primary key of the relation- Returns:
- Returns the relation
- Throws:
PortalException
-
getRelation
@Transactional(propagation=SUPPORTS, readOnly=true) SocialRelation getRelation(long userId1, long userId2, int type) throws PortalException Returns the relation of the given type between User1 and User2.- Parameters:
userId1
- the user that is the subject of the relationuserId2
- the user at the other end of the relationtype
- the relation's type- Returns:
- Returns the relation
- Throws:
PortalException
-
getRelations
@Transactional(propagation=SUPPORTS, readOnly=true) List<SocialRelation> getRelations(long userId, int type, int start, int end) Returns a range of all the relations of the given type where the user is the subject of the relation.Useful when paginating results. Returns a maximum of
end - start
instances.start
andend
are not primary keys, they are indexes in the result set. Thus,0
refers to the first result in the set. Setting bothstart
andend
toQueryUtil.ALL_POS
will return the full result set.- Parameters:
userId
- the primary key of the usertype
- the relation's typestart
- the lower bound of the range of resultsend
- the upper bound of the range of results (not inclusive)- Returns:
- the range of relations
-
getRelations
@Transactional(propagation=SUPPORTS, readOnly=true) List<SocialRelation> getRelations(long userId1, long userId2, int start, int end) Returns a range of all the relations between User1 and User2.Useful when paginating results. Returns a maximum of
end - start
instances.start
andend
are not primary keys, they are indexes in the result set. Thus,0
refers to the first result in the set. Setting bothstart
andend
toQueryUtil.ALL_POS
will return the full result set.- Parameters:
userId1
- the user that is the subject of the relationuserId2
- the user at the other end of the relationstart
- the lower bound of the range of resultsend
- the upper bound of the range of results (not inclusive)- Returns:
- the range of relations
-
getRelationsCount
Returns the number of relations of the given type where the user is the subject of the relation.- Parameters:
userId
- the primary key of the usertype
- the relation's type- Returns:
- the number of relations
-
getRelationsCount
@Transactional(propagation=SUPPORTS, readOnly=true) int getRelationsCount(long userId1, long userId2) Returns the number of relations between User1 and User2.- Parameters:
userId1
- the user that is the subject of the relationuserId2
- the user at the other end of the relation- Returns:
- the number of relations
-
getSocialRelation
@Transactional(propagation=SUPPORTS, readOnly=true) SocialRelation getSocialRelation(long relationId) throws PortalException Returns the social relation with the primary key.- Parameters:
relationId
- the primary key of the social relation- Returns:
- the social relation
- Throws:
PortalException
- if a social relation with the primary key could not be found
-
getSocialRelationByUuidAndCompanyId
@Transactional(propagation=SUPPORTS, readOnly=true) SocialRelation getSocialRelationByUuidAndCompanyId(String uuid, long companyId) throws PortalException Returns the social relation with the matching UUID and company.- Parameters:
uuid
- the social relation's UUIDcompanyId
- the primary key of the company- Returns:
- the matching social relation
- Throws:
PortalException
- if a matching social relation could not be found
-
getSocialRelations
@Transactional(propagation=SUPPORTS, readOnly=true) List<SocialRelation> getSocialRelations(int start, int end) Returns a range of all the social relations.Useful when paginating results. Returns a maximum of
end - start
instances.start
andend
are not primary keys, they are indexes in the result set. Thus,0
refers to the first result in the set. Setting bothstart
andend
tocom.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS
will return the full result set. IforderByComparator
is specified, then the query will include the given ORDER BY logic. IforderByComparator
is absent, then the query will include the default ORDER BY logic fromcom.liferay.portlet.social.model.impl.SocialRelationModelImpl
.- Parameters:
start
- the lower bound of the range of social relationsend
- the upper bound of the range of social relations (not inclusive)- Returns:
- the range of social relations
-
getSocialRelationsCount
Returns the number of social relations.- Returns:
- the number of social relations
-
hasRelation
@Transactional(propagation=SUPPORTS, readOnly=true) boolean hasRelation(long userId1, long userId2, int type) Returnstrue
if a relation of the given type exists where the user with primary keyuserId1
is User1 of the relation and the user with the primary keyuserId2
is User2 of the relation.- Parameters:
userId1
- the user that is the subject of the relationuserId2
- the user at the other end of the relationtype
- the relation's type- Returns:
true
if the relation exists;false
otherwise
-
isRelatable
@Transactional(propagation=SUPPORTS, readOnly=true) boolean isRelatable(long userId1, long userId2, int type) Returnstrue
if the users can be in a relation of the given type where the user with primary keyuserId1
is User1 of the relation and the user with the primary keyuserId2
is User2 of the relation.This method returns
false
if User1 and User2 are the same, if either user is the default user, or if a matching relation already exists.- Parameters:
userId1
- the user that is the subject of the relationuserId2
- the user at the other end of the relationtype
- the relation's type- Returns:
true
if the two users can be in a new relation of the given type;false
otherwise
-
updateSocialRelation
Updates the social relation in the database or adds it if it does not yet exist. Also notifies the appropriate model listeners.Important: Inspect SocialRelationLocalServiceImpl 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.
- Parameters:
socialRelation
- the social relation- Returns:
- the social relation that was updated
-
getCTPersistence
- Specified by:
getCTPersistence
in interfaceCTService<SocialRelation>
-
getModelClass
- Specified by:
getModelClass
in interfaceCTService<SocialRelation>
-
updateWithUnsafeFunction
@Transactional(rollbackFor=java.lang.Throwable.class) <R,E extends Throwable> R updateWithUnsafeFunction(com.liferay.petra.function.UnsafeFunction<CTPersistence<SocialRelation>, R, throws EE> updateUnsafeFunction) - Specified by:
updateWithUnsafeFunction
in interfaceCTService<SocialRelation>
- Throws:
E extends Throwable
-