mirror of
https://code.briarproject.org/briar/briar.git
synced 2026-02-12 18:59:06 +01:00
d058172429
Like other recursive operations on the dependency graph, this is not done in a single transaction to prevent an attacker from creating arbitrary large transactions. So at startup, the `ValidationManager` finds and resumes any unfinished operations, by looking for shared messages with unshared dependencies.
64 lines
1.5 KiB
Java
64 lines
1.5 KiB
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), DELIVERED(3);
|
|
|
|
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.
|
|
* @return whether or not this message should be shared
|
|
*/
|
|
boolean incomingMessage(Transaction txn, Message m, Metadata meta)
|
|
throws DbException;
|
|
}
|
|
}
|