Partie III
Langages et outils
304
© Éditions Eyrolles
Connector/J de MySQL ne permet pas encore de changer le sens de parcours d’un curseur au
niveau de l’état et au niveau du curseur lui-même (seule la constante ResultSet.FETCH_
FORWARD est interprétée). Aucune erreur n’a lieu à l’exécution si vous modifiez le sens de parcours d’un curseur, la direction restera simplement inchangée (en avant toute !).
Ainsi, pour parcourir un curseur à l’envers, il faudra soit utiliser des indices négatifs (dans les
méthodes absolute et relative), soit employer la méthode previous en partant de la
fin du curseur (afterLast).
Tableau 8-19 Méthodes de navigation dans un curseur
Méthode
Fonction
void setFetchDirection(int) Affecte la direction du parcours :
ResultSet.FETCH_FORWARD (1000),
ResultSet.FETCH_REVERSE (1001) ou
ResultSet.FETCH_UNKNOWN (1002).
int getFetchDirection()
Extrait la direction courante (une des trois valeurs ci-dessus).
boolean isBeforeFirst()
Indique si le curseur est positionné avant le premier enregistrement (false si aucun enregistrement n’existe).
void beforeFirst()
Positionne le curseur avant le premier enregistrement (aucun
effet si le curseur est vide).
boolean isFirst()
Indique si le curseur est positionné sur le premier enregistrement
(false si aucun enregistrement n’existe).
boolean isLast()
Indique si le curseur est positionné sur le dernier enregistrement
(false si aucun enregistrement n’existe).
boolean isAfterLast()
Indique si le curseur est positionné après le dernier enregistrement (false si aucun enregistrement n’existe).
void afterLast()
Positionne le curseur après le dernier enregistrement (aucun effet
si le curseur est vide).
boolean first()
Positionne le curseur sur le premier enregistrement (false si
aucun enregistrement n’existe).
boolean previous()
Positionne le curseur sur l’enregistrement précédent (false si
aucun enregistrement ne précède).
boolean last()
Positionne le curseur sur le dernier enregistrement (false si
aucun enregistrement n’existe).
boolean absolute(int)
Positionne le curseur sur le n-ième enregistrement (en partant du
début si n est positif, ou de la fin si n est négatif, false si aucun
enregistrement n’existe à cet indice).
boolean relative(int)
Positionne le curseur sur le n-ième enregistrement en partant de
la position courante (en avant si n est positif, ou en arrière si n est
négatif, false si aucun enregistrement n’existe à cet indice).