L’interface BdfRequest est une interface dans le dialogue entre, d’un côté, la servlet BaseDeFichesServlet qui est en charge du traitement de la requête Http et de la fourniture de la réponse et, de l’autre côté, les commandes qui vont intérargir sur la base (modifications ou affichage des données).
En effet, la servlet BaseDeFichesServlet commence par analyser l’URL de la requête, en déduit quelle commande s’applique, déclenche les éventuelles instructions de la commande et lui demande enfin ce qu’elle doit afficher comme réponse.
Toute extension de BaseDeFiches possède une implémentation de BdfRequest afin que la servlet BaseDeFichesServlet sache quoi faire quand la page d’une extension est appelée.
Les méthodes de l’interface sont les suivantes. Elles sont dans l’ordre de leur appel par la servlet BaseDeFichesServlet :
public boolean needBdfUser();
public void setBdfBundle(BdfBundle bdfBundle);
public boolean isInstruction();
public void runInstruction(BdfRequestMap requestMap) throws ParameterException;
public ResponsePrinter getResponsePrinter();
Méthodes
public boolean needBdfUser();
Indique si la commande nécéssite l’identification de l’utilisateur.
public void setBdfBundle(BdfBundle bdfBundle);
Permet à la servlet de transmettre à la commande les données sur le serveur et l’utilisateur en cours.
public boolean isInstruction();
Indique si la commande est une instruction susceptible de modifier la base. Si la valeur de retour est positive, la méthode runInstruction() est lancée.
public void runInstruction(BdfRequestMap requestMap) throws ParameterException;
Lance l’instruction de la commande. N’est apppelé que si isInstruction() = true.
public ResponsePrinter getResponsePrinter();
Renvoie l’objet qui va s’occuper de la production de la réponse (voir net.mapeadores.util.servlets.ResponsePrinter).
Dépendances
import fr.exemole.bdfserver.request.*;
import net.mapeadores.util.servlets.*;