All Known Implementing Classes:

DBCassandraAstyanaxImpl
```
public interface DatabookStore
```
Author:

Massimiliano Assante ISTI-CNR, Costantino Perciante ISTI-CNR DatabookStore is the high level interface for querying and adding data to DatabookStore

Method Summary

All Methods Instance Methods Abstract Methods Deprecated Methods
Modifier and Type	Method	Description
`boolean`	`addComment(Comment comment)`	add a comment to a feed
`boolean`	`approveFriendship(String from, String to)`	userid from approves a friendship to userid to
`boolean`	`checkUnreadMessagesNotifications(String userid)`
`boolean`	`checkUnreadNotifications(String userid)`
`void`	`closeConnection()`	close the connection to the underlying database
`boolean`	`deleteComment(String commentid, String feedid)`	deletes a comment
`boolean`	`deleteFeed(String feedid)`	Deprecated. use saveUserPost
`boolean`	`deleteHashTags(String postid, String vreid, List<String> hashtags)`
`boolean`	`deleteHashTagsComment(String commentId, String vreid, List<String> hashtags)`
`boolean`	`deletePost(String postid)`	delete a Feed from the store
`boolean`	`denyFriendship(String from, String to)`	userid from denies a friendship to userid to
`boolean`	`editComment(Comment comment)`	edit a comment
`List<Comment>`	`getAllCommentByFeed(String feedid)`	Deprecated. use getAllCommentByPost
`List<Comment>`	`getAllCommentByPost(String postid)`
`List<Feed>`	`getAllFeedsByApp(String appid)`	Deprecated. use getAllPostsByApp instead
`List<Feed>`	`getAllFeedsByUser(String userid)`	Deprecated. use getAllPostsByUser instead
`List<Feed>`	`getAllFeedsByVRE(String vreid)`	Deprecated. use getAllPostsByVRE
`List<String>`	`getAllLikedFeedIdsByUser(String userid)`	Deprecated. use getAllLikedPostIdsByUser
`List<Feed>`	`getAllLikedFeedsByUser(String userid, int limit)`	Deprecated. use getAllLikedPostsByUser
`List<String>`	`getAllLikedPostIdsByUser(String userid)`
`List<Post>`	`getAllLikedPostsByUser(String userid, int limit)`
`List<Like>`	`getAllLikesByFeed(String postid)`	Deprecated. use getAllLikesByPost
`List<Like>`	`getAllLikesByPost(String postid)`
`List<Notification>`	`getAllNotificationByUser(String userid, int limit)`
`List<Feed>`	`getAllPortalPrivacyLevelFeeds()`	Deprecated. use getAllPortalPrivacyLevelPosts instead return all the feeds whose Level is PORTAL
`List<Post>`	`getAllPortalPrivacyLevelPosts()`	return all the feeds whose Level is PORTAL
`List<Post>`	`getAllPostsByApp(String appid)`
`List<Post>`	`getAllPostsByUser(String userid)`
`List<Post>`	`getAllPostsByVRE(String vreid)`
`List<String>`	`getAllVREIds()`	Retrieve all the ids of the vre
`List<Attachment>`	`getAttachmentsByFeedId(String feedId)`
`List<String>`	`getFriends(String userid)`
`List<Invite>`	`getInvitedEmailsByVRE(String vreid, InviteStatus... status)`	Use to get the list of invites per VRE
`List<String>`	`getPendingFriendRequests(String userid)`
`List<Notification>`	`getRangeNotificationsByUser(String userid, int from, int quantity)`
`List<Feed>`	`getRecentCommentedFeedsByUserAndDate(String userid, long timeInMillis)`	Deprecated. use getRecentCommentedPostsByUserAndDate instead
`List<Post>`	`getRecentCommentedPostsByUserAndDate(String userid, long timeInMillis)`
`List<Comment>`	`getRecentCommentsByUserAndDate(String userid, long timeInMillis)`
`List<Feed>`	`getRecentFeedsByUser(String userid, int quantity)`	Deprecated.
`List<Feed>`	`getRecentFeedsByUserAndDate(String userid, long timeInMillis)`	Deprecated. use getRecentPostsByUserAndDate
`List<Feed>`	`getRecentFeedsByVRE(String vreid, int quantity)`	Deprecated. use getRecentPostsByVRE return the most recent feeds for this vre up to quantity param
`RangeFeeds`	`getRecentFeedsByVREAndRange(String vreid, int from, int quantity)`	Deprecated. use getRecentPostsByVREAndRange
`List<Feed>`	`getRecentLikedFeedsByUserAndDate(String userid, long timeInMillis)`	Deprecated. use getRecentLikedPostsByUserAndDate
`List<Post>`	`getRecentLikedPostsByUserAndDate(String userid, long timeInMillis)`
`List<Post>`	`getRecentPostsByUser(String userid, int quantity)`	return the most recent feeds for this user up to quantity param
`List<Post>`	`getRecentPostsByUserAndDate(String userid, long timeInMillis)`
`List<Post>`	`getRecentPostsByVRE(String vreid, int quantity)`	return the most recent posts for this vre up to quantity param
`RangePosts`	`getRecentPostsByVREAndRange(String vreid, int from, int quantity)`	return the most recent posts for this vre up to quantity param and the last index of the posts in the timeline lastReturnedPostTimelineIndex is useful to know from where to start the range the next time you ask, because there are deletions
`List<Notification>`	`getUnreadNotificationsByUser(String userid)`	return the not yet read notifications (not including messages)
`List<NotificationChannelType>`	`getUserNotificationChannels(String userid, NotificationType notificationType)`	return the channels a user chose for being notified for a given notification type
`Map<NotificationType,NotificationChannelType[]>`	`getUserNotificationPreferences(String userid)`	get the notification preferences map (enableor disable the channels to be used for notifying the user)
`List<Feed>`	`getVREFeedsByHashtag(String vreid, String hashtag)`	Deprecated. use getVREPostsByHashtag
`Map<String,Integer>`	`getVREHashtagsWithOccurrence(String vreid)`	get a map of vre hashtags where the key is the hashtag and the value is the occurrence of the hashtag in the VRE
`Map<String,Integer>`	`getVREHashtagsWithOccurrenceFilteredByTime(String vreid, long timestamp)`	get a map of vre hashtags where the key is the hashtag and the value is the occurrence of the hashtag in the VRE
`List<Post>`	`getVREPostsByHashtag(String vreid, String hashtag)`
`String`	`isExistingInvite(String vreid, String email)`
`boolean`	`like(Like like)`	add a like to a feed
`Comment`	`readCommentById(String commentId)`
`Feed`	`readFeed(String feedid)`	Deprecated. use readPost read a feed from a given id
`Invite`	`readInvite(String inviteid)`	read an invite from a given id
`Notification`	`readNotification(String notificationid)`	read a notification from a given id
`Post`	`readPost(String postid)`	read a feed from a given id
`boolean`	`requestFriendship(String from, String to)`	userid from requests a friendship to userid to
`boolean`	`saveAppFeed(Feed feed)`	Deprecated. use saveAppPost save a Post instance in the store
`boolean`	`saveAppFeed(Feed feed, List<Attachment> attachments)`	Deprecated. use saveAppPost Save a Post instance in the store Use this if your app needs to attach more than one file to the post
`boolean`	`saveAppPost(Post feed)`	save a Post instance in the store
`boolean`	`saveAppPost(Post feed, List<Attachment> attachments)`	Save a Post instance in the store Use this if your app needs to attach more than one file to the post
`boolean`	`saveFeedToVRETimeline(String feedKey, String vreid)`	Deprecated. use savePostToVRETimeline
`boolean`	`saveHashTags(String postid, String vreid, List<String> hashtags)`
`boolean`	`saveHashTagsComment(String commentId, String vreid, List<String> hashtags)`
`InviteOperationResult`	`saveInvite(Invite invite)`	Save the invite for a given email into a given vre
`boolean`	`saveNotification(Notification notification)`	save a Notification instance in the store
`boolean`	`savePostToVRETimeline(String postKey, String vreid)`	save a post in the VRES TimeLine in the store
`boolean`	`saveUserFeed(Feed feed)`	Deprecated. use saveUserPost save a Feed instance in the store
`boolean`	`saveUserFeed(Feed feed, List<Attachment> attachments)`	Deprecated. use saveUserPost
`boolean`	`saveUserPost(Post feed)`	save a Post instance in the store
`boolean`	`saveUserPost(Post post, List<Attachment> attachments)`	Save a Post instance in the store having more than one attachment Use this if you need to attach more than one file to the post
`boolean`	`setAllNotificationReadByUser(String userid)`	This is a fast way to set all notification to read quickly
`boolean`	`setInviteStatus(String vreid, String email, InviteStatus status)`	set the status of an invite, see `InviteStatus`
`boolean`	`setNotificationRead(String notificationidToSet)`	set an existing Notification instance in the to read
`boolean`	`setUserNotificationPreferences(String userid, Map<NotificationType,NotificationChannelType[]> enabledChannels)`	set the notification preferences map (enable or disable the channels to be used for notifying the user)
`boolean`	`unlike(String userid, String likeid, String feedid)`	unlike a feed

Method Detail

requestFriendship

boolean requestFriendship(String from,
                          String to)

userid from requests a friendship to userid to

Returns:: true if everything went fine

approveFriendship

boolean approveFriendship(String from,
                          String to)

userid from approves a friendship to userid to

Returns:: true if everything went fine

denyFriendship

boolean denyFriendship(String from,
                       String to)

userid from denies a friendship to userid to

Returns:: true if everything went fine

getFriends
```
List<String> getFriends(String userid)
```
Parameters:

userid - the user id you want to know friends

Returns:

a List of userid representing the friends for the given userid

getPendingFriendRequests
```
List<String> getPendingFriendRequests(String userid)
```
Parameters:

userid - the user id you want to know the pending friend requests

Returns:

a List of userid representing the friends for the given userid

saveUserFeed
```
boolean saveUserFeed(Feed feed)
```
Deprecated.
use saveUserPost save a Feed instance in the store

Returns:

true if everything went fine

saveUserPost
```
boolean saveUserPost(Post feed)
```
save a Post instance in the store

Returns:

true if everything went fine

saveUserFeed
```
boolean saveUserFeed(Feed feed,
                     List<Attachment> attachments)
```
Deprecated.
use saveUserPost

Save a Feed instance in the store having more than one attachment Use this if you need to attach more than one file to the post

Parameters:

attachments - a list of attachments starting from the second

Returns:

true if everything went fine

saveUserPost
```
boolean saveUserPost(Post post,
                     List<Attachment> attachments)
```
Save a Post instance in the store having more than one attachment Use this if you need to attach more than one file to the post

Parameters:

attachments - a list of attachments starting from the second

Returns:

true if everything went fine

deleteFeed

boolean deleteFeed(String feedid)
            throws FeedIDNotFoundException,
                   PrivacyLevelTypeNotFoundException,
                   FeedTypeNotFoundException,
                   ColumnNameNotFoundException

Deprecated.

use saveUserPost

Delete a Feed from the store

Returns:: true if everything went fine
Throws:: FeedIDNotFoundException; PrivacyLevelTypeNotFoundException; FeedTypeNotFoundException; ColumnNameNotFoundException

deletePost

boolean deletePost(String postid)
            throws FeedIDNotFoundException,
                   PrivacyLevelTypeNotFoundException,
                   FeedTypeNotFoundException,
                   ColumnNameNotFoundException

delete a Feed from the store

Returns:: true if everything went fine
Throws:: FeedIDNotFoundException; PrivacyLevelTypeNotFoundException; FeedTypeNotFoundException; ColumnNameNotFoundException

saveFeedToVRETimeline

boolean saveFeedToVRETimeline(String feedKey,
                              String vreid)
                       throws FeedIDNotFoundException

Deprecated.

use savePostToVRETimeline

Save a post in the VRES TimeLine in the store

Parameters:: feedKey - feedKey; vreid - vre identifier
Throws:: FeedIDNotFoundException

savePostToVRETimeline

boolean savePostToVRETimeline(String postKey,
                              String vreid)
                       throws FeedIDNotFoundException

save a post in the VRES TimeLine in the store

Parameters:: postKey - the post id; vreid - vre identifier
Throws:: FeedIDNotFoundException

saveAppFeed
```
boolean saveAppFeed(Feed feed)
```
Deprecated.
use saveAppPost save a Post instance in the store

Returns:

true if everything went fine

saveAppPost
```
boolean saveAppPost(Post feed)
```
save a Post instance in the store

Returns:

true if everything went fine

saveAppFeed
```
boolean saveAppFeed(Feed feed,
                    List<Attachment> attachments)
```
Deprecated.
use saveAppPost Save a Post instance in the store Use this if your app needs to attach more than one file to the post

Parameters:

attachments - a list of attachments starting from the second

Returns:

true if everything went fine

saveAppPost
```
boolean saveAppPost(Post feed,
                    List<Attachment> attachments)
```
Save a Post instance in the store Use this if your app needs to attach more than one file to the post

Parameters:

attachments - a list of attachments starting from the second

Returns:

true if everything went fine

readFeed

Feed readFeed(String feedid)
       throws PrivacyLevelTypeNotFoundException,
              FeedTypeNotFoundException,
              FeedIDNotFoundException,
              ColumnNameNotFoundException

Deprecated.

use readPost read a feed from a given id

Throws:: PrivacyLevelTypeNotFoundException; FeedTypeNotFoundException; ColumnNameNotFoundException; FeedIDNotFoundException

readPost

Post readPost(String postid)
       throws PrivacyLevelTypeNotFoundException,
              FeedTypeNotFoundException,
              FeedIDNotFoundException,
              ColumnNameNotFoundException

read a feed from a given id

Throws:: PrivacyLevelTypeNotFoundException; FeedTypeNotFoundException; ColumnNameNotFoundException; FeedIDNotFoundException

getAllFeedsByUser

List<Feed> getAllFeedsByUser(String userid)
                      throws PrivacyLevelTypeNotFoundException,
                             FeedTypeNotFoundException,
                             FeedIDNotFoundException,
                             ColumnNameNotFoundException

Deprecated.

use getAllPostsByUser instead

Parameters:: userid - user identifier return all the feeds belonging to the userid
Throws:: FeedTypeNotFoundException; PrivacyLevelTypeNotFoundException; ColumnNameNotFoundException; FeedIDNotFoundException

getAllPostsByUser

List<Post> getAllPostsByUser(String userid)
                      throws PrivacyLevelTypeNotFoundException,
                             FeedTypeNotFoundException,
                             FeedIDNotFoundException,
                             ColumnNameNotFoundException

Parameters:: userid - user identifier return all the feeds belonging to the userid
Throws:: FeedTypeNotFoundException; PrivacyLevelTypeNotFoundException; ColumnNameNotFoundException; FeedIDNotFoundException

getAllFeedsByApp

List<Feed> getAllFeedsByApp(String appid)
                     throws PrivacyLevelTypeNotFoundException,
                            FeedTypeNotFoundException,
                            FeedIDNotFoundException,
                            ColumnNameNotFoundException

Deprecated.

use getAllPostsByApp instead

Parameters:: appid - application identifier return all the feeds belonging to the appid
Throws:: FeedTypeNotFoundException; PrivacyLevelTypeNotFoundException; ColumnNameNotFoundException; FeedIDNotFoundException

getAllPostsByApp

List<Post> getAllPostsByApp(String appid)
                     throws PrivacyLevelTypeNotFoundException,
                            FeedTypeNotFoundException,
                            FeedIDNotFoundException,
                            ColumnNameNotFoundException

Parameters:: appid - application identifier return all the feeds belonging to the appid
Throws:: FeedTypeNotFoundException; PrivacyLevelTypeNotFoundException; ColumnNameNotFoundException; FeedIDNotFoundException

getRecentCommentedFeedsByUserAndDate
```
List<Feed> getRecentCommentedFeedsByUserAndDate(String userid,
                                                long timeInMillis)
                                         throws Exception
```
Deprecated.
use getRecentCommentedPostsByUserAndDate instead

Parameters:

userid - the user identifier like andrea.rossi

timeInMillis - the initial time in millis to be considered

Returns:

a list of feeds commented by userid starting from timeInMillis

Throws:

Exception

getRecentCommentedPostsByUserAndDate
```
List<Post> getRecentCommentedPostsByUserAndDate(String userid,
                                                long timeInMillis)
                                         throws Exception
```
Parameters:

userid - the user identifier like andrea.rossi

timeInMillis - the initial time in millis to be considered

Returns:

a list of feeds commented by userid starting from timeInMillis

Throws:

Exception

getAllPortalPrivacyLevelFeeds

List<Feed> getAllPortalPrivacyLevelFeeds()
                                  throws FeedTypeNotFoundException,
                                         ColumnNameNotFoundException,
                                         PrivacyLevelTypeNotFoundException

Deprecated.

use getAllPortalPrivacyLevelPosts instead return all the feeds whose Level is PORTAL

Throws:: PrivacyLevelTypeNotFoundException; ColumnNameNotFoundException; PrivacyLevelTypeNotFoundException; FeedTypeNotFoundException

getAllPortalPrivacyLevelPosts

List<Post> getAllPortalPrivacyLevelPosts()
                                  throws FeedTypeNotFoundException,
                                         ColumnNameNotFoundException,
                                         PrivacyLevelTypeNotFoundException

return all the feeds whose Level is PORTAL

Throws:: PrivacyLevelTypeNotFoundException; ColumnNameNotFoundException; PrivacyLevelTypeNotFoundException; FeedTypeNotFoundException

getRecentFeedsByUser

List<Feed> getRecentFeedsByUser(String userid,
                                int quantity)
                         throws PrivacyLevelTypeNotFoundException,
                                FeedTypeNotFoundException,
                                ColumnNameNotFoundException,
                                FeedIDNotFoundException

Deprecated.

return the most recent feeds for this user up to quantity param

Parameters:: userid - user identifier; quantity - the number of most recent feeds for this user
Returns:: a List of most recent feeds for this user
Throws:: FeedTypeNotFoundException; PrivacyLevelTypeNotFoundException; ColumnNameNotFoundException; FeedIDNotFoundException

getRecentPostsByUser

List<Post> getRecentPostsByUser(String userid,
                                int quantity)
                         throws PrivacyLevelTypeNotFoundException,
                                FeedTypeNotFoundException,
                                ColumnNameNotFoundException,
                                FeedIDNotFoundException

return the most recent feeds for this user up to quantity param

Parameters:: userid - user identifier; quantity - the number of most recent feeds for this user
Returns:: a List of most recent feeds for this user
Throws:: FeedTypeNotFoundException; PrivacyLevelTypeNotFoundException; ColumnNameNotFoundException; FeedIDNotFoundException

getAllFeedsByVRE

List<Feed> getAllFeedsByVRE(String vreid)
                     throws PrivacyLevelTypeNotFoundException,
                            FeedTypeNotFoundException,
                            ColumnNameNotFoundException,
                            FeedIDNotFoundException

Deprecated.

use getAllPostsByVRE

Parameters:: vreid - vre identifier return all the feeds belonging to the userid
Throws:: FeedTypeNotFoundException; PrivacyLevelTypeNotFoundException; ColumnNameNotFoundException; FeedIDNotFoundException

getAllPostsByVRE

List<Post> getAllPostsByVRE(String vreid)
                     throws PrivacyLevelTypeNotFoundException,
                            FeedTypeNotFoundException,
                            ColumnNameNotFoundException,
                            FeedIDNotFoundException

Parameters:: vreid - vre identifier return all the feeds belonging to the userid
Throws:: FeedTypeNotFoundException; PrivacyLevelTypeNotFoundException; ColumnNameNotFoundException; FeedIDNotFoundException

getRecentFeedsByVRE

List<Feed> getRecentFeedsByVRE(String vreid,
                               int quantity)
                        throws IllegalArgumentException,
                               PrivacyLevelTypeNotFoundException,
                               FeedTypeNotFoundException,
                               ColumnNameNotFoundException,
                               FeedIDNotFoundException

Deprecated.

use getRecentPostsByVRE return the most recent feeds for this vre up to quantity param

Parameters:: vreid - VRES identifier; quantity - the number of most recent feeds for this vre
Returns:: a List of most recent feeds for this vre
Throws:: FeedTypeNotFoundException; PrivacyLevelTypeNotFoundException; ColumnNameNotFoundException; IllegalArgumentException; FeedIDNotFoundException

getRecentPostsByVRE

List<Post> getRecentPostsByVRE(String vreid,
                               int quantity)
                        throws IllegalArgumentException,
                               PrivacyLevelTypeNotFoundException,
                               FeedTypeNotFoundException,
                               ColumnNameNotFoundException,
                               FeedIDNotFoundException

return the most recent posts for this vre up to quantity param

Parameters:: vreid - VRES identifier; quantity - the number of most recent posts for this vre
Returns:: a List of most recent posts for this vre
Throws:: FeedTypeNotFoundException; PrivacyLevelTypeNotFoundException; ColumnNameNotFoundException; IllegalArgumentException; FeedIDNotFoundException

getRecentFeedsByVREAndRange
```
RangeFeeds getRecentFeedsByVREAndRange(String vreid,
                                       int from,
                                       int quantity)
                                throws PrivacyLevelTypeNotFoundException,
                                       FeedTypeNotFoundException,
                                       ColumnNameNotFoundException,
                                       FeedIDNotFoundException
```
Deprecated.
use getRecentPostsByVREAndRange

return the most recent posts for this vre up to quantity param and the last index of the feeds in the timeline lastReturnedFeedTimelineIndex is usuful to know from where to start the range the second time you ask because there are deletions

Parameters:

vreid - VRES identifier

from - the range start (most recent feeds for this vre) has to be greater than 0

quantity - the number of most recent feeds for this vre starting from "from" param

Returns:

a lastReturnedFeedTimelineIndex containing of most recent feeds for this vre

Throws:

FeedTypeNotFoundException

PrivacyLevelTypeNotFoundException

ColumnNameNotFoundException

FeedIDNotFoundException

getRecentPostsByVREAndRange
```
RangePosts getRecentPostsByVREAndRange(String vreid,
                                       int from,
                                       int quantity)
                                throws PrivacyLevelTypeNotFoundException,
                                       FeedTypeNotFoundException,
                                       ColumnNameNotFoundException,
                                       FeedIDNotFoundException
```
return the most recent posts for this vre up to quantity param and the last index of the posts in the timeline lastReturnedPostTimelineIndex is useful to know from where to start the range the next time you ask, because there are deletions

Parameters:

vreid - VRES identifier

from - the range start (most recent feeds for this vre) has to be greater than 0

quantity - the number of most recent feeds for this vre starting from "from" param

Returns:

a RangePosts containing of most recent feeds for this vre

Throws:

FeedTypeNotFoundException

PrivacyLevelTypeNotFoundException

ColumnNameNotFoundException

FeedIDNotFoundException

getRecentFeedsByUserAndDate
```
List<Feed> getRecentFeedsByUserAndDate(String userid,
                                       long timeInMillis)
                                throws IllegalArgumentException
```
Deprecated.
use getRecentPostsByUserAndDate

Parameters:

userid - user identifier

timeInMillis - time in milliseconds from which you want to start retrieve the feeds

Returns:

the number of feeds in the range from: today to: timeInMillis

Throws:

IllegalArgumentException

getRecentPostsByUserAndDate
```
List<Post> getRecentPostsByUserAndDate(String userid,
                                       long timeInMillis)
                                throws IllegalArgumentException
```
Parameters:

userid - user identifier

timeInMillis - time in milliseconds from which you want to start retrieve the feeds

Returns:

the number of feeds in the range from: today to: timeInMillis

Throws:

IllegalArgumentException

saveNotification
```
boolean saveNotification(Notification notification)
```
save a Notification instance in the store

Returns:

true if everything went fine

setNotificationRead

boolean setNotificationRead(String notificationidToSet)
                     throws NotificationIDNotFoundException,
                            NotificationTypeNotFoundException,
                            ColumnNameNotFoundException

set an existing Notification instance in the to read

Returns:: true if everything went fine
Throws:: NotificationIDNotFoundException; NotificationTypeNotFoundException; ColumnNameNotFoundException

readNotification

Notification readNotification(String notificationid)
                       throws NotificationIDNotFoundException,
                              NotificationTypeNotFoundException,
                              ColumnNameNotFoundException

read a notification from a given id

Throws:: NotificationIDNotFoundException; NotificationTypeNotFoundException; ColumnNameNotFoundException

getAllNotificationByUser

List<Notification> getAllNotificationByUser(String userid,
                                            int limit)
                                     throws NotificationTypeNotFoundException,
                                            ColumnNameNotFoundException,
                                            NotificationIDNotFoundException

Parameters:: userid - user identifier; limit - set 0 to get everything, an int to get the most recent -limit- notifications return all the notifications belonging to the userid up to limit, set 0 to get everything
Throws:: NotificationTypeNotFoundException; ColumnNameNotFoundException; NotificationIDNotFoundException

getRangeNotificationsByUser

List<Notification> getRangeNotificationsByUser(String userid,
                                               int from,
                                               int quantity)
                                        throws NotificationTypeNotFoundException,
                                               ColumnNameNotFoundException,
                                               NotificationIDNotFoundException

Parameters:: userid - user identifier; from - the range start has to be greater than 0; quantity - the number of most recent notifications for this user starting from "from" param
Returns:: all the notifications for the userid in the range requested
Throws:: NotificationTypeNotFoundException; ColumnNameNotFoundException; NotificationIDNotFoundException

setAllNotificationReadByUser

boolean setAllNotificationReadByUser(String userid)
                              throws NotificationIDNotFoundException,
                                     NotificationTypeNotFoundException,
                                     ColumnNameNotFoundException

This is a fast way to set all notification to read quickly

Parameters:: userid -
Returns:: true if everything went fine
Throws:: NotificationIDNotFoundException; NotificationTypeNotFoundException; ColumnNameNotFoundException

getUnreadNotificationsByUser

List<Notification> getUnreadNotificationsByUser(String userid)
                                         throws NotificationTypeNotFoundException,
                                                ColumnNameNotFoundException,
                                                NotificationIDNotFoundException

return the not yet read notifications (not including messages)

Parameters:: userid - user identifier
Returns:: a List of not yet read notifications for this user
Throws:: NotificationTypeNotFoundException; ColumnNameNotFoundException; NotificationIDNotFoundException

checkUnreadNotifications

boolean checkUnreadNotifications(String userid)
                          throws NotificationIDNotFoundException,
                                 NotificationTypeNotFoundException,
                                 ColumnNameNotFoundException

Parameters:: userid - user identifier
Returns:: true if there are unread notifications (not including messages), false if they are all read
Throws:: ColumnNameNotFoundException; NotificationTypeNotFoundException; NotificationIDNotFoundException

checkUnreadMessagesNotifications

boolean checkUnreadMessagesNotifications(String userid)
                                  throws NotificationIDNotFoundException,
                                         NotificationTypeNotFoundException,
                                         ColumnNameNotFoundException

Parameters:: userid - user identifier
Returns:: true if there are unread messages notifications (including messages), false if they are all read
Throws:: ColumnNameNotFoundException; NotificationTypeNotFoundException - self explaining; NotificationChannelTypeNotFoundException - self explaining; NotificationIDNotFoundException

getUserNotificationChannels

List<NotificationChannelType> getUserNotificationChannels(String userid,
                                                          NotificationType notificationType)
                                                   throws NotificationChannelTypeNotFoundException,
                                                          NotificationTypeNotFoundException

return the channels a user chose for being notified for a given notification type

Parameters:: userid - user identifier; notificationType - the type of the notification
Returns:: a list of NotificationChannelType that represents the channels this user wants to be notified
Throws:: NotificationChannelTypeNotFoundException; NotificationTypeNotFoundException

setUserNotificationPreferences
```
boolean setUserNotificationPreferences(String userid,
                                       Map<NotificationType,NotificationChannelType[]> enabledChannels)
```
set the notification preferences map (enable or disable the channels to be used for notifying the user)

Parameters:

userid - user identifier

enabledChannels - a map of the channels to which reach the user per notification, empty array or null values to set the key notification type off

Returns:

true if everything was fine

getUserNotificationPreferences

Map<NotificationType,NotificationChannelType[]> getUserNotificationPreferences(String userid)
                                                                              throws NotificationTypeNotFoundException,
                                                                                     NotificationChannelTypeNotFoundException

get the notification preferences map (enableor disable the channels to be used for notifying the user)

Parameters:: userid - user identifier
Returns:: the map
Throws:: NotificationTypeNotFoundException - self explaining; NotificationChannelTypeNotFoundException - self explaining

readCommentById
```
Comment readCommentById(String commentId)
                 throws CommentIDNotFoundException
```
Parameters:

commentId - comment unique identifier

Returns:

the comment belonging to the commentId

Throws:

CommentIDNotFoundException

addComment
```
boolean addComment(Comment comment)
            throws FeedIDNotFoundException
```
add a comment to a feed

Parameters:

comment - the Comment instance to add

Throws:

FeedIDNotFoundException

getAllCommentByFeed
```
List<Comment> getAllCommentByFeed(String feedid)
```
Deprecated.
use getAllCommentByPost

Parameters:

feedid - feed identifier return all the comments belonging to the feedid

getAllCommentByPost
```
List<Comment> getAllCommentByPost(String postid)
```
Parameters:

postid - the post identifier return all the comments belonging to the postid

getRecentCommentsByUserAndDate
```
List<Comment> getRecentCommentsByUserAndDate(String userid,
                                             long timeInMillis)
                                      throws Exception
```
Parameters:

userid - user identifier

timeInMillis - time in milliseconds from which you want to start retrieve the feeds

Returns:

a list of comments (sorted starting from the most recent one) made by the user since timeInMillis up to now

Throws:

Exception

editComment

boolean editComment(Comment comment)
             throws PrivacyLevelTypeNotFoundException,
                    FeedTypeNotFoundException,
                    ColumnNameNotFoundException,
                    CommentIDNotFoundException,
                    FeedIDNotFoundException

edit a comment

Parameters:: comment - the comment to edit
Returns:: true if success, false otherwise
Throws:: PrivacyLevelTypeNotFoundException; FeedTypeNotFoundException; ColumnNameNotFoundException; CommentIDNotFoundException; FeedIDNotFoundException

deleteComment

boolean deleteComment(String commentid,
                      String feedid)
               throws PrivacyLevelTypeNotFoundException,
                      FeedTypeNotFoundException,
                      ColumnNameNotFoundException,
                      CommentIDNotFoundException,
                      FeedIDNotFoundException

deletes a comment

Parameters:: commentid - the comment identifier to delete; feedid - the feedid to which the comment is associated
Returns:: true if success, false otherwise
Throws:: PrivacyLevelTypeNotFoundException; FeedTypeNotFoundException; ColumnNameNotFoundException; CommentIDNotFoundException; FeedIDNotFoundException

like
```
boolean like(Like like)
      throws FeedIDNotFoundException
```
add a like to a feed

Parameters:

like - instance

Throws:

FeedIDNotFoundException

unlike

boolean unlike(String userid,
               String likeid,
               String feedid)
        throws PrivacyLevelTypeNotFoundException,
               FeedTypeNotFoundException,
               ColumnNameNotFoundException,
               LikeIDNotFoundException,
               FeedIDNotFoundException

unlike a feed

Parameters:: userid - user identifier; likeid - the like identifier to delete; feedid - the feedid to which the comment is associated
Returns:: true if success, false otherwise
Throws:: PrivacyLevelTypeNotFoundException; FeedTypeNotFoundException; ColumnNameNotFoundException; LikeIDNotFoundException; FeedIDNotFoundException

getAllLikedFeedIdsByUser
```
List<String> getAllLikedFeedIdsByUser(String userid)
```
Deprecated.
use getAllLikedPostIdsByUser

Parameters:

userid - user identifier return all the feedids a user has liked

getAllLikedPostIdsByUser
```
List<String> getAllLikedPostIdsByUser(String userid)
```
Parameters:

userid - user identifier return all the feedids a user has liked

getAllLikedFeedsByUser

List<Feed> getAllLikedFeedsByUser(String userid,
                                  int limit)
                           throws PrivacyLevelTypeNotFoundException,
                                  FeedTypeNotFoundException,
                                  FeedIDNotFoundException,
                                  ColumnNameNotFoundException

Deprecated.

use getAllLikedPostsByUser

Parameters:: userid - user identifier; limit - set 0 to get everything, an int to get the most recent -limit- liked feeds
Throws:: ColumnNameNotFoundException - .; FeedIDNotFoundException - .; FeedTypeNotFoundException - .; PrivacyLevelTypeNotFoundException; FeedIDNotFoundException - . return all the feeds a user has liked

getAllLikedPostsByUser

List<Post> getAllLikedPostsByUser(String userid,
                                  int limit)
                           throws PrivacyLevelTypeNotFoundException,
                                  FeedTypeNotFoundException,
                                  FeedIDNotFoundException,
                                  ColumnNameNotFoundException

Parameters:: userid - user identifier; limit - set 0 to get everything, an int to get the most recent -limit- liked posts
Throws:: ColumnNameNotFoundException - .; FeedIDNotFoundException - .; FeedTypeNotFoundException - .; PrivacyLevelTypeNotFoundException; FeedIDNotFoundException - . return all the feeds a user has liked

getRecentLikedFeedsByUserAndDate
```
List<Feed> getRecentLikedFeedsByUserAndDate(String userid,
                                            long timeInMillis)
                                     throws IllegalArgumentException
```
Deprecated.
use getRecentLikedPostsByUserAndDate

Parameters:

userid - user identifier

timeInMillis - time in milliseconds from which you want to start retrieve the feeds

Returns:

the likes made to feeds in the range from: today to: timeInMillis

Throws:

IllegalArgumentException

getRecentLikedPostsByUserAndDate
```
List<Post> getRecentLikedPostsByUserAndDate(String userid,
                                            long timeInMillis)
                                     throws IllegalArgumentException
```
Parameters:

userid - user identifier

timeInMillis - time in milliseconds from which you want to start retrieve the feeds

Returns:

the likes made to feeds in the range from: today to: timeInMillis

Throws:

IllegalArgumentException

getAllLikesByFeed
```
List<Like> getAllLikesByFeed(String postid)
```
Deprecated.
use getAllLikesByPost

Parameters:

postid - postid identifier return all the likes belonging to the postid

getAllLikesByPost
```
List<Like> getAllLikesByPost(String postid)
```
Parameters:

postid - postid identifier return all the likes belonging to the postid

saveHashTags

boolean saveHashTags(String postid,
                     String vreid,
                     List<String> hashtags)
              throws FeedIDNotFoundException

Parameters:: hashtags - the hashtag including the '#'; postid - the postid to which the hashtag is associated; vreid - VRE identifier
Returns:: true if success, false otherwise
Throws:: FeedIDNotFoundException

saveHashTagsComment

boolean saveHashTagsComment(String commentId,
                            String vreid,
                            List<String> hashtags)
                     throws CommentIDNotFoundException

Parameters:: hashtags - the hashtag including the '#'; commentId - the commentId to which the hashtag is associated; vreid - VRE identifier
Returns:: true if success, false otherwise
Throws:: CommentIDNotFoundException

deleteHashTags

boolean deleteHashTags(String postid,
                       String vreid,
                       List<String> hashtags)
                throws FeedIDNotFoundException

Parameters:: hashtags - the hashtag including the '#'; postid - the postid to which the hashtag is associated; vreid - VRE identifier
Returns:: true if success, false otherwise
Throws:: FeedIDNotFoundException

deleteHashTagsComment

boolean deleteHashTagsComment(String commentId,
                              String vreid,
                              List<String> hashtags)
                       throws CommentIDNotFoundException

Parameters:: hashtags - the hashtag including the '#'; commentId - the commentId to which the hashtag is associated; vreid - VRE identifier
Returns:: true if success, false otherwise
Throws:: CommentIDNotFoundException

getVREHashtagsWithOccurrence
```
Map<String,Integer> getVREHashtagsWithOccurrence(String vreid)
```
get a map of vre hashtags where the key is the hashtag and the value is the occurrence of the hashtag in the VRE

Parameters:

vreid - vre identifier (scope)

Returns:

a HashMap of vre Hashtags associated with their occurrence

getVREHashtagsWithOccurrenceFilteredByTime
```
Map<String,Integer> getVREHashtagsWithOccurrenceFilteredByTime(String vreid,
                                                                     long timestamp)
```
get a map of vre hashtags where the key is the hashtag and the value is the occurrence of the hashtag in the VRE

Parameters:

vreid - vre identifier (scope)

timestamp - do not consider hashtags used before timestamp

Returns:

a HashMap of vre Hashtags associated with their occurrence

getVREFeedsByHashtag

List<Feed> getVREFeedsByHashtag(String vreid,
                                String hashtag)
                         throws PrivacyLevelTypeNotFoundException,
                                FeedTypeNotFoundException,
                                FeedIDNotFoundException,
                                ColumnNameNotFoundException

Deprecated.

use getVREPostsByHashtag

Parameters:: vreid - VRE identifier; hashtag - the hashtag to look for including the '#', it is case sensitive
Returns:: all the feeds having the hashtag passed as parameter
Throws:: ColumnNameNotFoundException - .; FeedIDNotFoundException - .; FeedTypeNotFoundException - .; PrivacyLevelTypeNotFoundException; FeedIDNotFoundException - .

getVREPostsByHashtag

List<Post> getVREPostsByHashtag(String vreid,
                                String hashtag)
                         throws PrivacyLevelTypeNotFoundException,
                                FeedTypeNotFoundException,
                                FeedIDNotFoundException,
                                ColumnNameNotFoundException

Parameters:: vreid - VRE identifier; hashtag - the hashtag to look for including the '#', it is case sensitive
Returns:: all the feeds having the hashtag passed as parameter
Throws:: ColumnNameNotFoundException - .; FeedIDNotFoundException - .; FeedTypeNotFoundException - .; PrivacyLevelTypeNotFoundException; FeedIDNotFoundException - .

saveInvite
```
InviteOperationResult saveInvite(Invite invite)
                          throws javax.mail.internet.AddressException
```
Save the invite for a given email into a given vre

Parameters:

invite - the invite object instanc to save

Returns:

InviteOperationResult SUCCESS, FAILED or ALREADY_INVITED (if an invite is sent to en existing email in the same environment more than once)

Throws:

javax.mail.internet.AddressException

isExistingInvite
```
String isExistingInvite(String vreid,
                        String email)
```
Parameters:

vreid - the environment where you want to check the invite

email - the email of the invite to check in the environmnet

Returns:

the InviteId if present, null otherwise

readInvite

Invite readInvite(String inviteid)
           throws InviteIDNotFoundException,
                  InviteStatusNotFoundException

read an invite from a given id

Throws:: InviteIDNotFoundException; InviteStatusNotFoundException

setInviteStatus

boolean setInviteStatus(String vreid,
                        String email,
                        InviteStatus status)
                 throws InviteIDNotFoundException,
                        InviteStatusNotFoundException

set the status of an invite, see InviteStatus

Throws:: InviteIDNotFoundException; InviteStatusNotFoundException

getInvitedEmailsByVRE

List<Invite> getInvitedEmailsByVRE(String vreid,
                                   InviteStatus... status)
                            throws InviteIDNotFoundException,
                                   InviteStatusNotFoundException

Use to get the list of invites per VRE

Parameters:: vreid - the vre id; status - optional, if you want to restict on the status, e.g. all pending invites
Returns:: return the list of invites
Throws:: InviteIDNotFoundException; InviteStatusNotFoundException

getAttachmentsByFeedId
```
List<Attachment> getAttachmentsByFeedId(String feedId)
                                 throws FeedIDNotFoundException
```
Parameters:

feedId -

Returns:

the list of attachments of the feed feedId, starting from the second one (first attachment is included in Feed instance already)

Throws:

FeedIDNotFoundException

getAllVREIds
```
List<String> getAllVREIds()
```
Retrieve all the ids of the vre

Returns:

the set of ids of the vre available or empty list in case of errors.

closeConnection
```
void closeConnection()
```
close the connection to the underlying database

Interface DatabookStore

Method Summary

Method Detail

requestFriendship

approveFriendship

denyFriendship

getFriends

getPendingFriendRequests

saveUserFeed

saveUserPost

saveUserFeed

saveUserPost

deleteFeed

deletePost

saveFeedToVRETimeline

savePostToVRETimeline

saveAppFeed

saveAppPost

saveAppFeed

saveAppPost

readFeed

readPost

getAllFeedsByUser

getAllPostsByUser

getAllFeedsByApp

getAllPostsByApp

getRecentCommentedFeedsByUserAndDate

getRecentCommentedPostsByUserAndDate

getAllPortalPrivacyLevelFeeds

getAllPortalPrivacyLevelPosts

getRecentFeedsByUser

getRecentPostsByUser

getAllFeedsByVRE

getAllPostsByVRE

getRecentFeedsByVRE

getRecentPostsByVRE

getRecentFeedsByVREAndRange

getRecentPostsByVREAndRange

getRecentFeedsByUserAndDate

getRecentPostsByUserAndDate

saveNotification

setNotificationRead

readNotification

getAllNotificationByUser

getRangeNotificationsByUser

setAllNotificationReadByUser

getUnreadNotificationsByUser

checkUnreadNotifications

checkUnreadMessagesNotifications

getUserNotificationChannels

setUserNotificationPreferences

getUserNotificationPreferences

readCommentById

addComment

getAllCommentByFeed

getAllCommentByPost

getRecentCommentsByUserAndDate

editComment

deleteComment

like

unlike

getAllLikedFeedIdsByUser

getAllLikedPostIdsByUser

getAllLikedFeedsByUser

getAllLikedPostsByUser

getRecentLikedFeedsByUserAndDate

getRecentLikedPostsByUserAndDate

getAllLikesByFeed

getAllLikesByPost

saveHashTags

saveHashTagsComment

deleteHashTags

deleteHashTagsComment

getVREHashtagsWithOccurrence

getVREHashtagsWithOccurrenceFilteredByTime

getVREFeedsByHashtag

getVREPostsByHashtag

saveInvite

isExistingInvite

readInvite