Contact manager hooks. #209

briar-api/src/org/briarproject/api/contact/Contact.java

@@ -5,14 +5,37 @@ import org.briarproject.api.identity.AuthorId;
 
 public class Contact {
 
+	public enum Status {
+
+		ADDING(0), ACTIVE(1), REMOVING(2);
+
+		private final int value;
+
+		Status(int value) {
+			this.value = value;
+		}
+
+		public int getValue() {
+			return value;
+		}
+
+		public static Status fromValue(int value) {
+			for (Status s : values()) if (s.value == value) return s;
+			throw new IllegalArgumentException();
+		}
+	}
+
 	private final ContactId id;
 	private final Author author;
 	private final AuthorId localAuthorId;
+	private final Status status;
 
-	public Contact(ContactId id, Author author, AuthorId localAuthorId) {
+	public Contact(ContactId id, Author author, AuthorId localAuthorId,
+			Status status) {
 		this.id = id;
 		this.author = author;
 		this.localAuthorId = localAuthorId;
+		this.status = status;
 	}
 
 	public ContactId getId() {
@@ -27,6 +50,10 @@ public class Contact {
 		return localAuthorId;
 	}
 
+	public Status getStatus() {
+		return status;
+	}
+
 	@Override
 	public int hashCode() {
 		return id.hashCode();

briar-api/src/org/briarproject/api/contact/ContactManager.java

@@ -8,6 +8,12 @@ import java.util.Collection;
 
 public interface ContactManager {
 
+	/** Registers a hook to be called whenever a contact is added. */
+	void registerContactAddedHook(ContactAddedHook hook);
+
+	/** Registers a hook to be called whenever a contact is removed. */
+	void registerContactRemovedHook(ContactRemovedHook hook);
+
 	/**
 	 * Stores a contact associated with the given local and remote pseudonyms,
 	 * and returns an ID for the contact.
@@ -22,4 +28,12 @@ public interface ContactManager {
 
 	/** Removes a contact and all associated state. */
 	void removeContact(ContactId c) throws DbException;
+
+	interface ContactAddedHook {
+		void contactAdded(ContactId c);
+	}
+
+	interface ContactRemovedHook {
+		void contactRemoved(ContactId c);
+	}
 }