briar/briar-api/src/org/briarproject/api/sync/ValidationManager.java

package org.briarproject.api.sync;

import org.briarproject.api.db.DbException;
import org.briarproject.api.db.Metadata;
import org.briarproject.api.db.Transaction;

/**
 * Responsible for managing message validators and passing them messages to
 * validate.
 */
public interface ValidationManager {

	enum State {

		UNKNOWN(0), INVALID(1), PENDING(2), VALID(3), DELIVERED(4);

		private final int value;

		State(int value) {
			this.value = value;
		}

		public int getValue() {
			return value;
		}

		public static State fromValue(int value) {
			for (State s : values()) if (s.value == value) return s;
			throw new IllegalArgumentException();
		}
	}

	/**
	 * Sets the message validator for the given client.
	 */
	void registerMessageValidator(ClientId c, MessageValidator v);

	/**
	 * Sets the incoming message hook for the given client. The hook will be
	 * called once for each incoming message that passes validation.
	 */
	void registerIncomingMessageHook(ClientId c, IncomingMessageHook hook);

	interface MessageValidator {

		/**
		 * Validates the given message and returns its metadata and
		 * dependencies.
		 */
		MessageContext validateMessage(Message m, Group g)
				throws InvalidMessageException;
	}

	interface IncomingMessageHook {

		/**
		 * Called once for each incoming message that passes validation.
		 */
		void incomingMessage(Transaction txn, Message m, Metadata meta)
				throws DbException;
	}
}