001 /** 002 * Copyright (c) 2000-2012 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.portlet.social.service; 016 017 import com.liferay.portal.kernel.exception.PortalException; 018 import com.liferay.portal.kernel.exception.SystemException; 019 import com.liferay.portal.kernel.transaction.Isolation; 020 import com.liferay.portal.kernel.transaction.Propagation; 021 import com.liferay.portal.kernel.transaction.Transactional; 022 import com.liferay.portal.service.BaseLocalService; 023 import com.liferay.portal.service.PersistedModelLocalService; 024 025 /** 026 * The interface for the social activity local service. 027 * 028 * <p> 029 * This is a local service. Methods of this service will not have security checks based on the propagated JAAS credentials because this service can only be accessed from within the same VM. 030 * </p> 031 * 032 * @author Brian Wing Shun Chan 033 * @see SocialActivityLocalServiceUtil 034 * @see com.liferay.portlet.social.service.base.SocialActivityLocalServiceBaseImpl 035 * @see com.liferay.portlet.social.service.impl.SocialActivityLocalServiceImpl 036 * @generated 037 */ 038 @Transactional(isolation = Isolation.PORTAL, rollbackFor = { 039 PortalException.class, SystemException.class}) 040 public interface SocialActivityLocalService extends BaseLocalService, 041 PersistedModelLocalService { 042 /* 043 * NOTE FOR DEVELOPERS: 044 * 045 * Never modify or reference this interface directly. Always use {@link SocialActivityLocalServiceUtil} to access the social activity local service. Add custom service methods to {@link com.liferay.portlet.social.service.impl.SocialActivityLocalServiceImpl} and rerun ServiceBuilder to automatically copy the method declarations to this interface. 046 */ 047 048 /** 049 * Adds the social activity to the database. Also notifies the appropriate model listeners. 050 * 051 * @param socialActivity the social activity 052 * @return the social activity that was added 053 * @throws SystemException if a system exception occurred 054 */ 055 public com.liferay.portlet.social.model.SocialActivity addSocialActivity( 056 com.liferay.portlet.social.model.SocialActivity socialActivity) 057 throws com.liferay.portal.kernel.exception.SystemException; 058 059 /** 060 * Creates a new social activity with the primary key. Does not add the social activity to the database. 061 * 062 * @param activityId the primary key for the new social activity 063 * @return the new social activity 064 */ 065 public com.liferay.portlet.social.model.SocialActivity createSocialActivity( 066 long activityId); 067 068 /** 069 * Deletes the social activity with the primary key from the database. Also notifies the appropriate model listeners. 070 * 071 * @param activityId the primary key of the social activity 072 * @return the social activity that was removed 073 * @throws PortalException if a social activity with the primary key could not be found 074 * @throws SystemException if a system exception occurred 075 */ 076 public com.liferay.portlet.social.model.SocialActivity deleteSocialActivity( 077 long activityId) 078 throws com.liferay.portal.kernel.exception.PortalException, 079 com.liferay.portal.kernel.exception.SystemException; 080 081 /** 082 * Deletes the social activity from the database. Also notifies the appropriate model listeners. 083 * 084 * @param socialActivity the social activity 085 * @return the social activity that was removed 086 * @throws SystemException if a system exception occurred 087 */ 088 public com.liferay.portlet.social.model.SocialActivity deleteSocialActivity( 089 com.liferay.portlet.social.model.SocialActivity socialActivity) 090 throws com.liferay.portal.kernel.exception.SystemException; 091 092 public com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery(); 093 094 /** 095 * Performs a dynamic query on the database and returns the matching rows. 096 * 097 * @param dynamicQuery the dynamic query 098 * @return the matching rows 099 * @throws SystemException if a system exception occurred 100 */ 101 @SuppressWarnings("rawtypes") 102 public java.util.List dynamicQuery( 103 com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery) 104 throws com.liferay.portal.kernel.exception.SystemException; 105 106 /** 107 * Performs a dynamic query on the database and returns a range of the matching rows. 108 * 109 * <p> 110 * 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 com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full result set. 111 * </p> 112 * 113 * @param dynamicQuery the dynamic query 114 * @param start the lower bound of the range of model instances 115 * @param end the upper bound of the range of model instances (not inclusive) 116 * @return the range of matching rows 117 * @throws SystemException if a system exception occurred 118 */ 119 @SuppressWarnings("rawtypes") 120 public java.util.List dynamicQuery( 121 com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery, int start, 122 int end) throws com.liferay.portal.kernel.exception.SystemException; 123 124 /** 125 * Performs a dynamic query on the database and returns an ordered range of the matching rows. 126 * 127 * <p> 128 * 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 com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full result set. 129 * </p> 130 * 131 * @param dynamicQuery the dynamic query 132 * @param start the lower bound of the range of model instances 133 * @param end the upper bound of the range of model instances (not inclusive) 134 * @param orderByComparator the comparator to order the results by (optionally <code>null</code>) 135 * @return the ordered range of matching rows 136 * @throws SystemException if a system exception occurred 137 */ 138 @SuppressWarnings("rawtypes") 139 public java.util.List dynamicQuery( 140 com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery, int start, 141 int end, 142 com.liferay.portal.kernel.util.OrderByComparator orderByComparator) 143 throws com.liferay.portal.kernel.exception.SystemException; 144 145 /** 146 * Returns the number of rows that match the dynamic query. 147 * 148 * @param dynamicQuery the dynamic query 149 * @return the number of rows that match the dynamic query 150 * @throws SystemException if a system exception occurred 151 */ 152 public long dynamicQueryCount( 153 com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery) 154 throws com.liferay.portal.kernel.exception.SystemException; 155 156 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 157 public com.liferay.portlet.social.model.SocialActivity fetchSocialActivity( 158 long activityId) 159 throws com.liferay.portal.kernel.exception.SystemException; 160 161 /** 162 * Returns the social activity with the primary key. 163 * 164 * @param activityId the primary key of the social activity 165 * @return the social activity 166 * @throws PortalException if a social activity with the primary key could not be found 167 * @throws SystemException if a system exception occurred 168 */ 169 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 170 public com.liferay.portlet.social.model.SocialActivity getSocialActivity( 171 long activityId) 172 throws com.liferay.portal.kernel.exception.PortalException, 173 com.liferay.portal.kernel.exception.SystemException; 174 175 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 176 public com.liferay.portal.model.PersistedModel getPersistedModel( 177 java.io.Serializable primaryKeyObj) 178 throws com.liferay.portal.kernel.exception.PortalException, 179 com.liferay.portal.kernel.exception.SystemException; 180 181 /** 182 * Returns a range of all the social activities. 183 * 184 * <p> 185 * 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 com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full result set. 186 * </p> 187 * 188 * @param start the lower bound of the range of social activities 189 * @param end the upper bound of the range of social activities (not inclusive) 190 * @return the range of social activities 191 * @throws SystemException if a system exception occurred 192 */ 193 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 194 public java.util.List<com.liferay.portlet.social.model.SocialActivity> getSocialActivities( 195 int start, int end) 196 throws com.liferay.portal.kernel.exception.SystemException; 197 198 /** 199 * Returns the number of social activities. 200 * 201 * @return the number of social activities 202 * @throws SystemException if a system exception occurred 203 */ 204 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 205 public int getSocialActivitiesCount() 206 throws com.liferay.portal.kernel.exception.SystemException; 207 208 /** 209 * Updates the social activity in the database or adds it if it does not yet exist. Also notifies the appropriate model listeners. 210 * 211 * @param socialActivity the social activity 212 * @return the social activity that was updated 213 * @throws SystemException if a system exception occurred 214 */ 215 public com.liferay.portlet.social.model.SocialActivity updateSocialActivity( 216 com.liferay.portlet.social.model.SocialActivity socialActivity) 217 throws com.liferay.portal.kernel.exception.SystemException; 218 219 /** 220 * Returns the Spring bean ID for this bean. 221 * 222 * @return the Spring bean ID for this bean 223 */ 224 public java.lang.String getBeanIdentifier(); 225 226 /** 227 * Sets the Spring bean ID for this bean. 228 * 229 * @param beanIdentifier the Spring bean ID for this bean 230 */ 231 public void setBeanIdentifier(java.lang.String beanIdentifier); 232 233 /** 234 * Records an activity with the given time in the database. 235 * 236 * <p> 237 * This method records a social activity done on an asset, identified by its 238 * class name and class primary key, in the database. Additional information 239 * (such as the original message ID for a reply to a forum post) is passed 240 * in via the <code>extraData</code> in JSON format. For activities 241 * affecting another user, a mirror activity is generated that describes the 242 * action from the user's point of view. The target user's ID is passed in 243 * via the <code>receiverUserId</code>. 244 * </p> 245 * 246 * <p> 247 * Example for a mirrored activity:<br> When a user replies to a message 248 * boards post, the reply action is stored in the database with the 249 * <code>receiverUserId</code> being the ID of the author of the original 250 * message. The <code>extraData</code> contains the ID of the original 251 * message in JSON format. A mirror activity is generated with the values of 252 * the <code>userId</code> and the <code>receiverUserId</code> swapped. This 253 * mirror activity basically describes a "replied to" event. 254 * </p> 255 * 256 * <p> 257 * Mirror activities are most often used in relation to friend requests and 258 * activities. 259 * </p> 260 * 261 * @param userId the primary key of the acting user 262 * @param groupId the primary key of the group 263 * @param createDate the activity's date 264 * @param className the target asset's class name 265 * @param classPK the primary key of the target asset 266 * @param type the activity's type 267 * @param extraData any extra data regarding the activity 268 * @param receiverUserId the primary key of the receiving user 269 * @throws PortalException if the user or group could not be found 270 * @throws SystemException if a system exception occurred 271 */ 272 public void addActivity(long userId, long groupId, 273 java.util.Date createDate, java.lang.String className, long classPK, 274 int type, java.lang.String extraData, long receiverUserId) 275 throws com.liferay.portal.kernel.exception.PortalException, 276 com.liferay.portal.kernel.exception.SystemException; 277 278 /** 279 * Records an activity in the database, using a time based on the current 280 * time in an attempt to make the activity's time unique. 281 * 282 * @param userId the primary key of the acting user 283 * @param groupId the primary key of the group 284 * @param className the target asset's class name 285 * @param classPK the primary key of the target asset 286 * @param type the activity's type 287 * @param extraData any extra data regarding the activity 288 * @param receiverUserId the primary key of the receiving user 289 * @throws PortalException if the user or group could not be found 290 * @throws SystemException if a system exception occurred 291 */ 292 public void addActivity(long userId, long groupId, 293 java.lang.String className, long classPK, int type, 294 java.lang.String extraData, long receiverUserId) 295 throws com.liferay.portal.kernel.exception.PortalException, 296 com.liferay.portal.kernel.exception.SystemException; 297 298 public void addActivity( 299 com.liferay.portlet.social.model.SocialActivity activity, 300 com.liferay.portlet.social.model.SocialActivity mirrorActivity) 301 throws com.liferay.portal.kernel.exception.PortalException, 302 com.liferay.portal.kernel.exception.SystemException; 303 304 /** 305 * Records an activity in the database, but only if there isn't already an 306 * activity with the same parameters. 307 * 308 * <p> 309 * For the main functionality see {@link #addActivity(long, long, Date, 310 * String, long, int, String, long)} 311 * </p> 312 * 313 * @param userId the primary key of the acting user 314 * @param groupId the primary key of the group 315 * @param createDate the activity's date 316 * @param className the target asset's class name 317 * @param classPK the primary key of the target asset 318 * @param type the activity's type 319 * @param extraData any extra data regarding the activity 320 * @param receiverUserId the primary key of the receiving user 321 * @throws PortalException if the user or group could not be found 322 * @throws SystemException if a system exception occurred 323 */ 324 public void addUniqueActivity(long userId, long groupId, 325 java.util.Date createDate, java.lang.String className, long classPK, 326 int type, java.lang.String extraData, long receiverUserId) 327 throws com.liferay.portal.kernel.exception.PortalException, 328 com.liferay.portal.kernel.exception.SystemException; 329 330 /** 331 * Records an activity with the current time in the database, but only if 332 * there isn't one with the same parameters. 333 * 334 * <p> 335 * For the main functionality see {@link #addActivity(long, long, Date, 336 * String, long, int, String, long)} 337 * </p> 338 * 339 * @param userId the primary key of the acting user 340 * @param groupId the primary key of the group 341 * @param className the target asset's class name 342 * @param classPK the primary key of the target asset 343 * @param type the activity's type 344 * @param extraData any extra data regarding the activity 345 * @param receiverUserId the primary key of the receiving user 346 * @throws PortalException if the user or group could not be found 347 * @throws SystemException if a system exception occurred 348 */ 349 public void addUniqueActivity(long userId, long groupId, 350 java.lang.String className, long classPK, int type, 351 java.lang.String extraData, long receiverUserId) 352 throws com.liferay.portal.kernel.exception.PortalException, 353 com.liferay.portal.kernel.exception.SystemException; 354 355 /** 356 * Removes stored activities for the asset. 357 * 358 * @param assetEntry the asset from which to remove stored activities 359 * @throws PortalException if a portal exception occurred 360 * @throws SystemException if a system exception occurred 361 */ 362 public void deleteActivities( 363 com.liferay.portlet.asset.model.AssetEntry assetEntry) 364 throws com.liferay.portal.kernel.exception.PortalException, 365 com.liferay.portal.kernel.exception.SystemException; 366 367 /** 368 * Removes stored activities for the asset identified by the class name and 369 * class primary key. 370 * 371 * @param className the target asset's class name 372 * @param classPK the primary key of the target asset 373 * @throws SystemException if a system exception occurred 374 */ 375 public void deleteActivities(java.lang.String className, long classPK) 376 throws com.liferay.portal.kernel.exception.SystemException; 377 378 /** 379 * Removes the stored activity from the database. 380 * 381 * @param activityId the primary key of the stored activity 382 * @throws PortalException if the activity could not be found 383 * @throws SystemException if a system exception occurred 384 */ 385 public void deleteActivity(long activityId) 386 throws com.liferay.portal.kernel.exception.PortalException, 387 com.liferay.portal.kernel.exception.SystemException; 388 389 /** 390 * Removes the stored activity and its mirror activity from the database. 391 * 392 * @param activity the activity to be removed 393 * @throws SystemException if a system exception occurred 394 */ 395 public void deleteActivity( 396 com.liferay.portlet.social.model.SocialActivity activity) 397 throws com.liferay.portal.kernel.exception.SystemException; 398 399 /** 400 * Removes the user's stored activities from the database. 401 * 402 * <p> 403 * This method removes all activities where the user is either the actor or 404 * the receiver. 405 * </p> 406 * 407 * @param userId the primary key of the user 408 * @throws PortalException if the user's activity counters could not be 409 deleted 410 * @throws SystemException if a system exception occurred 411 */ 412 public void deleteUserActivities(long userId) 413 throws com.liferay.portal.kernel.exception.PortalException, 414 com.liferay.portal.kernel.exception.SystemException; 415 416 /** 417 * Returns a range of all the activities done on assets identified by the 418 * class name ID. 419 * 420 * <p> 421 * Useful when paginating results. Returns a maximum of <code>end - 422 * start</code> instances. <code>start</code> and <code>end</code> are not 423 * primary keys, they are indexes in the result set. Thus, <code>0</code> 424 * refers to the first result in the set. Setting both <code>start</code> 425 * and <code>end</code> to {@link 426 * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full 427 * result set. 428 * </p> 429 * 430 * @param classNameId the target asset's class name ID 431 * @param start the lower bound of the range of results 432 * @param end the upper bound of the range of results (not inclusive) 433 * @return the range of matching activities 434 * @throws SystemException if a system exception occurred 435 */ 436 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 437 public java.util.List<com.liferay.portlet.social.model.SocialActivity> getActivities( 438 long classNameId, int start, int end) 439 throws com.liferay.portal.kernel.exception.SystemException; 440 441 /** 442 * Returns a range of all the activities done on the asset identified by the 443 * class name ID and class primary key that are mirrors of the activity 444 * identified by the mirror activity ID. 445 * 446 * <p> 447 * Useful when paginating results. Returns a maximum of <code>end - 448 * start</code> instances. <code>start</code> and <code>end</code> are not 449 * primary keys, they are indexes in the result set. Thus, <code>0</code> 450 * refers to the first result in the set. Setting both <code>start</code> 451 * and <code>end</code> to {@link 452 * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full 453 * result set. 454 * </p> 455 * 456 * @param mirrorActivityId the primary key of the mirror activity 457 * @param classNameId the target asset's class name ID 458 * @param classPK the primary key of the target asset 459 * @param start the lower bound of the range of results 460 * @param end the upper bound of the range of results (not inclusive) 461 * @return the range of matching activities 462 * @throws SystemException if a system exception occurred 463 */ 464 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 465 public java.util.List<com.liferay.portlet.social.model.SocialActivity> getActivities( 466 long mirrorActivityId, long classNameId, long classPK, int start, 467 int end) throws com.liferay.portal.kernel.exception.SystemException; 468 469 /** 470 * Returns a range of all the activities done on the asset identified by the 471 * class name and the class primary key that are mirrors of the activity 472 * identified by the mirror activity ID. 473 * 474 * <p> 475 * Useful when paginating results. Returns a maximum of <code>end - 476 * start</code> instances. <code>start</code> and <code>end</code> are not 477 * primary keys, they are indexes in the result set. Thus, <code>0</code> 478 * refers to the first result in the set. Setting both <code>start</code> 479 * and <code>end</code> to {@link 480 * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full 481 * result set. 482 * </p> 483 * 484 * @param mirrorActivityId the primary key of the mirror activity 485 * @param className the target asset's class name 486 * @param classPK the primary key of the target asset 487 * @param start the lower bound of the range of results 488 * @param end the upper bound of the range of results (not inclusive) 489 * @return the range of matching activities 490 * @throws SystemException if a system exception occurred 491 */ 492 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 493 public java.util.List<com.liferay.portlet.social.model.SocialActivity> getActivities( 494 long mirrorActivityId, java.lang.String className, long classPK, 495 int start, int end) 496 throws com.liferay.portal.kernel.exception.SystemException; 497 498 /** 499 * Returns a range of all the activities done on assets identified by the 500 * class name. 501 * 502 * <p> 503 * Useful when paginating results. Returns a maximum of <code>end - 504 * start</code> instances. <code>start</code> and <code>end</code> are not 505 * primary keys, they are indexes in the result set. Thus, <code>0</code> 506 * refers to the first result in the set. Setting both <code>start</code> 507 * and <code>end</code> to {@link 508 * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full 509 * result set. 510 * </p> 511 * 512 * @param className the target asset's class name 513 * @param start the lower bound of the range of results 514 * @param end the upper bound of the range of results (not inclusive) 515 * @return the range of matching activities 516 * @throws SystemException if a system exception occurred 517 */ 518 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 519 public java.util.List<com.liferay.portlet.social.model.SocialActivity> getActivities( 520 java.lang.String className, int start, int end) 521 throws com.liferay.portal.kernel.exception.SystemException; 522 523 /** 524 * Returns the number of activities done on assets identified by the class 525 * name ID. 526 * 527 * @param classNameId the target asset's class name ID 528 * @return the number of matching activities 529 * @throws SystemException if a system exception occurred 530 */ 531 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 532 public int getActivitiesCount(long classNameId) 533 throws com.liferay.portal.kernel.exception.SystemException; 534 535 /** 536 * Returns the number of activities done on the asset identified by the 537 * class name ID and class primary key that are mirrors of the activity 538 * identified by the mirror activity ID. 539 * 540 * @param mirrorActivityId the primary key of the mirror activity 541 * @param classNameId the target asset's class name ID 542 * @param classPK the primary key of the target asset 543 * @return the number of matching activities 544 * @throws SystemException if a system exception occurred 545 */ 546 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 547 public int getActivitiesCount(long mirrorActivityId, long classNameId, 548 long classPK) 549 throws com.liferay.portal.kernel.exception.SystemException; 550 551 /** 552 * Returns the number of activities done on the asset identified by the 553 * class name and class primary key that are mirrors of the activity 554 * identified by the mirror activity ID. 555 * 556 * @param mirrorActivityId the primary key of the mirror activity 557 * @param className the target asset's class name 558 * @param classPK the primary key of the target asset 559 * @return the number of matching activities 560 * @throws SystemException if a system exception occurred 561 */ 562 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 563 public int getActivitiesCount(long mirrorActivityId, 564 java.lang.String className, long classPK) 565 throws com.liferay.portal.kernel.exception.SystemException; 566 567 /** 568 * Returns the number of activities done on assets identified by class name. 569 * 570 * @param className the target asset's class name 571 * @return the number of matching activities 572 * @throws SystemException if a system exception occurred 573 */ 574 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 575 public int getActivitiesCount(java.lang.String className) 576 throws com.liferay.portal.kernel.exception.SystemException; 577 578 /** 579 * Returns the activity identified by its primary key. 580 * 581 * @param activityId the primary key of the activity 582 * @return Returns the activity 583 * @throws PortalException if the activity could not be found 584 * @throws SystemException if a system exception occurred 585 */ 586 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 587 public com.liferay.portlet.social.model.SocialActivity getActivity( 588 long activityId) 589 throws com.liferay.portal.kernel.exception.PortalException, 590 com.liferay.portal.kernel.exception.SystemException; 591 592 /** 593 * Returns a range of all the activities done in the group. 594 * 595 * <p> 596 * This method only finds activities without mirrors. 597 * </p> 598 * 599 * <p> 600 * Useful when paginating results. Returns a maximum of <code>end - 601 * start</code> instances. <code>start</code> and <code>end</code> are not 602 * primary keys, they are indexes in the result set. Thus, <code>0</code> 603 * refers to the first result in the set. Setting both <code>start</code> 604 * and <code>end</code> to {@link 605 * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full 606 * result set. 607 * </p> 608 * 609 * @param groupId the primary key of the group 610 * @param start the lower bound of the range of results 611 * @param end the upper bound of the range of results (not inclusive) 612 * @return the range of matching activities 613 * @throws SystemException if a system exception occurred 614 */ 615 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 616 public java.util.List<com.liferay.portlet.social.model.SocialActivity> getGroupActivities( 617 long groupId, int start, int end) 618 throws com.liferay.portal.kernel.exception.SystemException; 619 620 /** 621 * Returns the number of activities done in the group. 622 * 623 * <p> 624 * This method only counts activities without mirrors. 625 * </p> 626 * 627 * @param groupId the primary key of the group 628 * @return the number of matching activities 629 * @throws SystemException if a system exception occurred 630 */ 631 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 632 public int getGroupActivitiesCount(long groupId) 633 throws com.liferay.portal.kernel.exception.SystemException; 634 635 /** 636 * Returns a range of activities done by users that are members of the 637 * group. 638 * 639 * <p> 640 * This method only finds activities without mirrors. 641 * </p> 642 * 643 * <p> 644 * Useful when paginating results. Returns a maximum of <code>end - 645 * start</code> instances. <code>start</code> and <code>end</code> are not 646 * primary keys, they are indexes in the result set. Thus, <code>0</code> 647 * refers to the first result in the set. Setting both <code>start</code> 648 * and <code>end</code> to {@link 649 * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full 650 * result set. 651 * </p> 652 * 653 * @param groupId the primary key of the group 654 * @param start the lower bound of the range of results 655 * @param end the upper bound of the range of results (not inclusive) 656 * @return the range of matching activities 657 * @throws SystemException if a system exception occurred 658 */ 659 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 660 public java.util.List<com.liferay.portlet.social.model.SocialActivity> getGroupUsersActivities( 661 long groupId, int start, int end) 662 throws com.liferay.portal.kernel.exception.SystemException; 663 664 /** 665 * Returns the number of activities done by users that are members of the 666 * group. 667 * 668 * <p> 669 * This method only counts activities without mirrors. 670 * </p> 671 * 672 * @param groupId the primary key of the group 673 * @return the number of matching activities 674 * @throws SystemException if a system exception occurred 675 */ 676 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 677 public int getGroupUsersActivitiesCount(long groupId) 678 throws com.liferay.portal.kernel.exception.SystemException; 679 680 /** 681 * Returns the activity that has the mirror activity. 682 * 683 * @param mirrorActivityId the primary key of the mirror activity 684 * @return Returns the mirror activity 685 * @throws PortalException if the mirror activity could not be found 686 * @throws SystemException if a system exception occurred 687 */ 688 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 689 public com.liferay.portlet.social.model.SocialActivity getMirrorActivity( 690 long mirrorActivityId) 691 throws com.liferay.portal.kernel.exception.PortalException, 692 com.liferay.portal.kernel.exception.SystemException; 693 694 /** 695 * Returns a range of all the activities done in the organization. This 696 * method only finds activities without mirrors. 697 * 698 * <p> 699 * Useful when paginating results. Returns a maximum of <code>end - 700 * start</code> instances. <code>start</code> and <code>end</code> are not 701 * primary keys, they are indexes in the result set. Thus, <code>0</code> 702 * refers to the first result in the set. Setting both <code>start</code> 703 * and <code>end</code> to {@link 704 * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full 705 * result set. 706 * </p> 707 * 708 * @param organizationId the primary key of the organization 709 * @param start the lower bound of the range of results 710 * @param end the upper bound of the range of results (not inclusive) 711 * @return the range of matching activities 712 * @throws SystemException if a system exception occurred 713 */ 714 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 715 public java.util.List<com.liferay.portlet.social.model.SocialActivity> getOrganizationActivities( 716 long organizationId, int start, int end) 717 throws com.liferay.portal.kernel.exception.SystemException; 718 719 /** 720 * Returns the number of activities done in the organization. This method 721 * only counts activities without mirrors. 722 * 723 * @param organizationId the primary key of the organization 724 * @return the number of matching activities 725 * @throws SystemException if a system exception occurred 726 */ 727 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 728 public int getOrganizationActivitiesCount(long organizationId) 729 throws com.liferay.portal.kernel.exception.SystemException; 730 731 /** 732 * Returns a range of all the activities done by users of the organization. 733 * This method only finds activities without mirrors. 734 * 735 * <p> 736 * Useful when paginating results. Returns a maximum of <code>end - 737 * start</code> instances. <code>start</code> and <code>end</code> are not 738 * primary keys, they are indexes in the result set. Thus, <code>0</code> 739 * refers to the first result in the set. Setting both <code>start</code> 740 * and <code>end</code> to {@link 741 * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full 742 * result set. 743 * </p> 744 * 745 * @param organizationId the primary key of the organization 746 * @param start the lower bound of the range of results 747 * @param end the upper bound of the range of results (not inclusive) 748 * @return the range of matching activities 749 * @throws SystemException if a system exception occurred 750 */ 751 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 752 public java.util.List<com.liferay.portlet.social.model.SocialActivity> getOrganizationUsersActivities( 753 long organizationId, int start, int end) 754 throws com.liferay.portal.kernel.exception.SystemException; 755 756 /** 757 * Returns the number of activities done by users of the organization. This 758 * method only counts activities without mirrors. 759 * 760 * @param organizationId the primary key of the organization 761 * @return the number of matching activities 762 * @throws SystemException if a system exception occurred 763 */ 764 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 765 public int getOrganizationUsersActivitiesCount(long organizationId) 766 throws com.liferay.portal.kernel.exception.SystemException; 767 768 /** 769 * Returns a range of all the activities done by users in a relationship 770 * with the user identified by the user ID. 771 * 772 * <p> 773 * Useful when paginating results. Returns a maximum of <code>end - 774 * start</code> instances. <code>start</code> and <code>end</code> are not 775 * primary keys, they are indexes in the result set. Thus, <>0</code> refers 776 * to the first result in the set. Setting both <code>start</code> and 777 * <code>end</code> to {@link 778 * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full 779 * result set. 780 * </p> 781 * 782 * @param userId the primary key of the user 783 * @param start the lower bound of the range of results 784 * @param end the upper bound of the range of results (not inclusive) 785 * @return the range of matching activities 786 * @throws SystemException if a system exception occurred 787 */ 788 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 789 public java.util.List<com.liferay.portlet.social.model.SocialActivity> getRelationActivities( 790 long userId, int start, int end) 791 throws com.liferay.portal.kernel.exception.SystemException; 792 793 /** 794 * Returns a range of all the activities done by users in a relationship of 795 * type <code>type</code> with the user identified by <code>userId</code>. 796 * This method only finds activities without mirrors. 797 * 798 * <p> 799 * Useful when paginating results. Returns a maximum of <code>end - 800 * start</code> instances. <code>start</code> and <code>end</code> are not 801 * primary keys, they are indexes in the result set. Thus, <code>0</code> 802 * refers to the first result in the set. Setting both <code>start</code> 803 * and <code>end</code> to {@link 804 * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full 805 * result set. 806 * </p> 807 * 808 * @param userId the primary key of the user 809 * @param type the relationship type 810 * @param start the lower bound of the range of results 811 * @param end the upper bound of the range of results (not inclusive) 812 * @return the range of matching activities 813 * @throws SystemException if a system exception occurred 814 */ 815 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 816 public java.util.List<com.liferay.portlet.social.model.SocialActivity> getRelationActivities( 817 long userId, int type, int start, int end) 818 throws com.liferay.portal.kernel.exception.SystemException; 819 820 /** 821 * Returns the number of activities done by users in a relationship with the 822 * user identified by userId. 823 * 824 * @param userId the primary key of the user 825 * @return the number of matching activities 826 * @throws SystemException if a system exception occurred 827 */ 828 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 829 public int getRelationActivitiesCount(long userId) 830 throws com.liferay.portal.kernel.exception.SystemException; 831 832 /** 833 * Returns the number of activities done by users in a relationship of type 834 * <code>type</code> with the user identified by <code>userId</code>. This 835 * method only counts activities without mirrors. 836 * 837 * @param userId the primary key of the user 838 * @param type the relationship type 839 * @return the number of matching activities 840 * @throws SystemException if a system exception occurred 841 */ 842 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 843 public int getRelationActivitiesCount(long userId, int type) 844 throws com.liferay.portal.kernel.exception.SystemException; 845 846 /** 847 * Returns a range of all the activities done by the user. 848 * 849 * <p> 850 * Useful when paginating results. Returns a maximum of <code>end - 851 * start</code> instances. <code>start</code> and <code>end</code> are not 852 * primary keys, they are indexes in the result set. Thus, <code>0</code> 853 * refers to the first result in the set. Setting both <code>start</code> 854 * and <code>end</code> to {@link 855 * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full 856 * result set. 857 * </p> 858 * 859 * @param userId the primary key of the user 860 * @param start the lower bound of the range of results 861 * @param end the upper bound of the range of results (not inclusive) 862 * @return the range of matching activities 863 * @throws SystemException if a system exception occurred 864 */ 865 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 866 public java.util.List<com.liferay.portlet.social.model.SocialActivity> getUserActivities( 867 long userId, int start, int end) 868 throws com.liferay.portal.kernel.exception.SystemException; 869 870 /** 871 * Returns the number of activities done by the user. 872 * 873 * @param userId the primary key of the user 874 * @return the number of matching activities 875 * @throws SystemException if a system exception occurred 876 */ 877 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 878 public int getUserActivitiesCount(long userId) 879 throws com.liferay.portal.kernel.exception.SystemException; 880 881 /** 882 * Returns a range of all the activities done in the user's groups. This 883 * method only finds activities without mirrors. 884 * 885 * <p> 886 * Useful when paginating results. Returns a maximum of <code>end - 887 * start</code> instances. <code>start</code> and <code>end</code> are not 888 * primary keys, they are indexes in the result set. Thus, <code>0</code> 889 * refers to the first result in the set. Setting both <code>start</code> 890 * and <code>end</code> to {@link 891 * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full 892 * result set. 893 * </p> 894 * 895 * @param userId the primary key of the user 896 * @param start the lower bound of the range of results 897 * @param end the upper bound of the range of results (not inclusive) 898 * @return the range of matching activities 899 * @throws SystemException if a system exception occurred 900 */ 901 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 902 public java.util.List<com.liferay.portlet.social.model.SocialActivity> getUserGroupsActivities( 903 long userId, int start, int end) 904 throws com.liferay.portal.kernel.exception.SystemException; 905 906 /** 907 * Returns the number of activities done in user's groups. This method only 908 * counts activities without mirrors. 909 * 910 * @param userId the primary key of the user 911 * @return the number of matching activities 912 * @throws SystemException if a system exception occurred 913 */ 914 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 915 public int getUserGroupsActivitiesCount(long userId) 916 throws com.liferay.portal.kernel.exception.SystemException; 917 918 /** 919 * Returns a range of all the activities done in the user's groups and 920 * organizations. This method only finds activities without mirrors. 921 * 922 * <p> 923 * Useful when paginating results. Returns a maximum of <code>end - 924 * start</code> instances. <code>start</code> and <code>end</code> are not 925 * primary keys, they are indexes in the result set. Thus, <code>0</code> 926 * refers to the first result in the set. Setting both <code>start</code> 927 * and <code>end</code> to {@link 928 * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full 929 * result set. 930 * </p> 931 * 932 * @param userId the primary key of the user 933 * @param start the lower bound of the range of results 934 * @param end the upper bound of the range of results (not inclusive) 935 * @return the range of matching activities 936 * @throws SystemException if a system exception occurred 937 */ 938 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 939 public java.util.List<com.liferay.portlet.social.model.SocialActivity> getUserGroupsAndOrganizationsActivities( 940 long userId, int start, int end) 941 throws com.liferay.portal.kernel.exception.SystemException; 942 943 /** 944 * Returns the number of activities done in user's groups and organizations. 945 * This method only counts activities without mirrors. 946 * 947 * @param userId the primary key of the user 948 * @return the number of matching activities 949 * @throws SystemException if a system exception occurred 950 */ 951 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 952 public int getUserGroupsAndOrganizationsActivitiesCount(long userId) 953 throws com.liferay.portal.kernel.exception.SystemException; 954 955 /** 956 * Returns a range of all activities done in the user's organizations. This 957 * method only finds activities without mirrors. 958 * 959 * <p> 960 * Useful when paginating results. Returns a maximum of <code>end - 961 * start</code> instances. <code>start</code> and <code>end</code> are not 962 * primary keys, they are indexes in the result set. Thus, <code>0</code> 963 * refers to the first result in the set. Setting both <code>start</code> 964 * and <code>end</code> to {@link 965 * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full 966 * result set. 967 * </p> 968 * 969 * @param userId the primary key of the user 970 * @param start the lower bound of the range of results 971 * @param end the upper bound of the range of results (not inclusive) 972 * @return the range of matching activities 973 * @throws SystemException if a system exception occurred 974 */ 975 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 976 public java.util.List<com.liferay.portlet.social.model.SocialActivity> getUserOrganizationsActivities( 977 long userId, int start, int end) 978 throws com.liferay.portal.kernel.exception.SystemException; 979 980 /** 981 * Returns the number of activities done in the user's organizations. This 982 * method only counts activities without mirrors. 983 * 984 * @param userId the primary key of the user 985 * @return the number of matching activities 986 * @throws SystemException if a system exception occurred 987 */ 988 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 989 public int getUserOrganizationsActivitiesCount(long userId) 990 throws com.liferay.portal.kernel.exception.SystemException; 991 }