192 lines
5.2 KiB
Java
192 lines
5.2 KiB
Java
package envoy.client.data;
|
|
|
|
import java.util.*;
|
|
|
|
import envoy.data.*;
|
|
import envoy.event.*;
|
|
|
|
/**
|
|
* Stores information about the current {@link User} and their {@link Chat}s.
|
|
* For message ID generation a {@link IDGenerator} is stored as well.<br>
|
|
* <br>
|
|
* Project: <strong>envoy-client</strong><br>
|
|
* File: <strong>LocalDB.java</strong><br>
|
|
* Created: <strong>3 Feb 2020</strong><br>
|
|
*
|
|
* @author Kai S. K. Engelbart
|
|
* @since Envoy Client v0.3-alpha
|
|
*/
|
|
public abstract class LocalDB {
|
|
|
|
protected User user;
|
|
protected Map<String, User> users = new HashMap<>();
|
|
protected List<Chat> chats = new ArrayList<>();
|
|
protected IDGenerator idGenerator;
|
|
protected Cache<Message> messageCache = new Cache<>();
|
|
protected Cache<MessageStatusChangeEvent> statusCache = new Cache<>();
|
|
|
|
/**
|
|
* Initializes a storage space for a user-specific list of chats.
|
|
*
|
|
* @since Envoy Client v0.3-alpha
|
|
*/
|
|
public void initializeUserStorage() {}
|
|
|
|
/**
|
|
* Stores all users. If the client user is specified, their chats will be stored
|
|
* as well. The message id generator will also be saved if present.
|
|
*
|
|
* @throws Exception if the saving process failed
|
|
* @since Envoy Client v0.3-alpha
|
|
*/
|
|
public void save() throws Exception {}
|
|
|
|
/**
|
|
* Loads all user data.
|
|
*
|
|
* @throws Exception if the loading process failed
|
|
* @since Envoy Client v0.3-alpha
|
|
*/
|
|
public void loadUsers() throws Exception {}
|
|
|
|
/**
|
|
* Loads all data of the client user.
|
|
*
|
|
* @throws Exception if the loading process failed
|
|
* @since Envoy Client v0.3-alpha
|
|
*/
|
|
public void loadUserData() throws Exception {}
|
|
|
|
/**
|
|
* Loads the ID generator. Any exception thrown during this process is ignored.
|
|
*
|
|
* @since Envoy Client v0.3-alpha
|
|
*/
|
|
public void loadIDGenerator() {}
|
|
|
|
/**
|
|
* @return a {@code Map<String, User>} of all users stored locally with their
|
|
* user names as keys
|
|
* @since Envoy Client v0.2-alpha
|
|
*/
|
|
public Map<String, User> getUsers() { return users; }
|
|
|
|
/**
|
|
* @param users the users to set
|
|
*/
|
|
public void setUsers(Map<String, User> users) { this.users = users; }
|
|
|
|
/**
|
|
* @return all saved {@link Chat} objects that list the client user as the
|
|
* sender
|
|
* @since Envoy Client v0.1-alpha
|
|
**/
|
|
public List<Chat> getChats() { return chats; }
|
|
|
|
/**
|
|
* @param chats the chats to set
|
|
*/
|
|
public void setChats(List<Chat> chats) { this.chats = chats; }
|
|
|
|
/**
|
|
* @return the {@link User} who initialized the local database
|
|
* @since Envoy Client v0.2-alpha
|
|
*/
|
|
public User getUser() { return user; }
|
|
|
|
/**
|
|
* @param user the user to set
|
|
* @since Envoy Client v0.2-alpha
|
|
*/
|
|
public void setUser(User user) { this.user = user; }
|
|
|
|
/**
|
|
* @return the message ID generator
|
|
* @since Envoy Client v0.3-alpha
|
|
*/
|
|
public IDGenerator getIDGenerator() { return idGenerator; }
|
|
|
|
/**
|
|
* @param idGenerator the message ID generator to set
|
|
* @since Envoy Client v0.3-alpha
|
|
*/
|
|
public void setIDGenerator(IDGenerator idGenerator) { this.idGenerator = idGenerator; }
|
|
|
|
/**
|
|
* @return {@code true} if an {@link IDGenerator} is present
|
|
* @since Envoy Client v0.3-alpha
|
|
*/
|
|
public boolean hasIDGenerator() { return idGenerator != null; }
|
|
|
|
/**
|
|
* @return the offline message cache
|
|
* @since Envoy Client v0.3-alpha
|
|
*/
|
|
public Cache<Message> getMessageCache() { return messageCache; }
|
|
|
|
/**
|
|
* @param messageCache the offline message cache to set
|
|
* @since Envoy Client v0.3-alpha
|
|
*/
|
|
public void setMessageCache(Cache<Message> messageCache) { this.messageCache = messageCache; }
|
|
|
|
/**
|
|
* @return the offline status cache
|
|
* @since Envoy Client v0.3-alpha
|
|
*/
|
|
public Cache<MessageStatusChangeEvent> getStatusCache() { return statusCache; }
|
|
|
|
/**
|
|
* @param statusCache the offline status cache to set
|
|
* @since Envoy Client v0.3-alpha
|
|
*/
|
|
public void setStatusCache(Cache<MessageStatusChangeEvent> statusCache) { this.statusCache = statusCache; }
|
|
|
|
/**
|
|
* Searches for a message by ID.
|
|
*
|
|
* @param id the ID of the message to search for
|
|
* @return the message with the corresponding ID, or {@code null} if no message
|
|
* has been found
|
|
* @since Envoy Client v0.1-beta
|
|
*/
|
|
public Message getMessage(long id) {
|
|
return chats.stream().map(Chat::getMessages).flatMap(List::stream).filter(m -> m.getID() == id).findAny().orElse(null);
|
|
}
|
|
|
|
/**
|
|
* Performs a contact name change if the corresponding contact is present.
|
|
*
|
|
* @param event the {@link NameChangeEvent} to process
|
|
* @since Envoy Client v0.1-beta
|
|
*/
|
|
public void replaceContactName(NameChangeEvent event) {
|
|
chats.stream().map(Chat::getRecipient).filter(c -> c.getID() == event.getId()).findAny().ifPresent(c -> c.setName(event.get()));
|
|
}
|
|
|
|
/**
|
|
* Performs a group resize operation if the corresponding group is present.
|
|
*
|
|
* @param event the {@link GroupResizeEvent} to process
|
|
* @since Envoy Client v0.1-beta
|
|
*/
|
|
public void updateGroup(GroupResizeEvent event) {
|
|
chats.stream()
|
|
.map(Chat::getRecipient)
|
|
.filter(Group.class::isInstance)
|
|
.filter(g -> g.getID() == event.getGroupID() && g.getID() != user.getID())
|
|
.map(Group.class::cast)
|
|
.findAny()
|
|
.ifPresent(group -> {
|
|
switch (event.getOperation()) {
|
|
case ADD:
|
|
group.getMemberIDs().add(event.get());
|
|
break;
|
|
case REMOVE:
|
|
group.getMemberIDs().remove(event.get());
|
|
break;
|
|
}
|
|
});
|
|
}
|
|
}
|