Package ece.ing3.java.projet.vue.components.inputs

Class StringInput

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

ece.ing3.java.projet.vue.components.inputs.StringInput

All Implemented Interfaces:

BaseInput<String>, ImageObserver, MenuContainer, Serializable, EventListener, Accessible, DocumentListener

Direct Known Subclasses:

StringIdInput

public class StringInput
extends JPanel
implements BaseInput<String>, DocumentListener

Champ de saisie de valeur textuelle, avec possibilité de sélection en exact ou approximatif pour la recherche

Author:

Virgile, Nicolas, Louis-Félix

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Component

Component.BaselineResizeBehavior

Field Summary

Fields inherited from class javax.swing.JComponent

TOOL_TIP_TEXT_KEY, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor	Description
StringInput(String columnName, boolean isSearch)	Créer un nouveau champ de saisie textuel.

Method Summary

Modifier and Type	Method	Description
void	addValueChangeListener(ValueChangeListener valueChangeListener)	Modifie l'objet qui écoute les changements de valeurs du champ
void	changedUpdate(DocumentEvent documentEvent)	Méthode de retour appelée lors d'un changement de valeur dans un Document, ici lorsque l'utilisateur change la valeur dans le champ texte de saisie NumericInput.textField.
String	getColumnName()	Retourne le nom de la colonne en base de donnée associée à ce champ de saisie.
String	getValue()	Récupère la valeur actuelle du champ de saisie, ou la première des valeurs multiples s'il y en a.
String[]	getValues()	Récupère l'ensemble des valeurs saisies.
Where	getWhere()	Construit la clause Where de sélection liée à la/aux valeur(s) du champ
void	insertUpdate(DocumentEvent documentEvent)	Méthode de retour appelée lors d'une insertion de valeur dans un Document, ici lorsque l'utilisateur insert une valeur dans le champ texte de saisie NumericInput.textField.
boolean	isFilled()	Retourne si le champ est actuellement rempli.
void	removeUpdate(DocumentEvent documentEvent)	Méthode de retour appelée lors d'une suppression de valeur dans un Document, ici lorsque l'utilisateur supprime la valeur dans le champ texte de saisie NumericInput.textField.
void	setPreferredSize(Dimension size)	Modifie la taille souhaitée du champ, de manière à ne modifier que la largeur et à conserver la hauteur à sa valeur d'avant, ce pour garantir que le champ ne soit pas trop petit en hauteur.
void	setRawValue(Object value)	Remplace la valeur saisie par la valeur passée en paramètre, en faisant une conversion vers le type attendu.
void	setValue(String value)	Remplace la valeur saisie par la valeur passée en paramètre.

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, setUI, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintImmediately, paintImmediately, print, printAll, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setRequestFocusEnabled, setToolTipText, setTransferHandler, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, contains, createImage, createImage, createVolatileImage, createVolatileImage, dispatchEvent, enable, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

StringInput

public StringInput(String columnName,
 boolean isSearch)

Créer un nouveau champ de saisie textuel.

Parameters:

columnName - Nom de la colonne associée

isSearch - true si le champ est utilisé pour de la recherche

Method Details

setPreferredSize

public void setPreferredSize(Dimension size)

Modifie la taille souhaitée du champ, de manière à ne modifier que la largeur et à conserver la hauteur à sa valeur d'avant, ce pour garantir que le champ ne soit pas trop petit en hauteur.

Overrides:

setPreferredSize in class JComponent

Parameters:

size - Dimensions souhaitées (seul la largeur sera considéré)

getColumnName

public String getColumnName()

Retourne le nom de la colonne en base de donnée associée à ce champ de saisie.

Specified by:

getColumnName in interface BaseInput<String>

Returns:

Nom de la colonne

isFilled

public boolean isFilled()

Retourne si le champ est actuellement rempli.

Specified by:

isFilled in interface BaseInput<String>

Returns:

true champ rempli

getValue

public String getValue()

Récupère la valeur actuelle du champ de saisie, ou la première des valeurs multiples s'il y en a.

Specified by:

getValue in interface BaseInput<String>

Returns:

Valeur saisie actuelle

Throws:

IllegalArgumentException - La valeur saisie est invalide

getValues

public String[] getValues()
                   throws IllegalArgumentException

Récupère l'ensemble des valeurs saisies.

Specified by:

getValues in interface BaseInput<String>

Returns:

Valeurs saisies

Throws:

IllegalArgumentException - Au moins une valeure saisie est invalide

setValue

public void setValue(String value)
              throws IllegalArgumentException

Remplace la valeur saisie par la valeur passée en paramètre.

Specified by:

setValue in interface BaseInput<String>

Parameters:

value - Nouvelle valeur du champ

Throws:

IllegalArgumentException - La valeur fournie est invalide

setRawValue

public void setRawValue(Object value)
                 throws IllegalArgumentException

Remplace la valeur saisie par la valeur passée en paramètre, en faisant une conversion vers le type attendu.

Specified by:

setRawValue in interface BaseInput<String>

Parameters:

value - Nouvelle valeur du champ

Throws:

IllegalArgumentException - La valeur fournie est invalide

getWhere

public Where getWhere()
               throws IllegalArgumentException

Construit la clause Where de sélection liée à la/aux valeur(s) du champ

Specified by:

getWhere in interface BaseInput<String>

Returns:

Clause Where de sélection

Throws:

IllegalArgumentException - Au moins une valeure saisie est invalide

addValueChangeListener

public void addValueChangeListener(ValueChangeListener valueChangeListener)

Modifie l'objet qui écoute les changements de valeurs du champ

Specified by:

addValueChangeListener in interface BaseInput<String>

Parameters:

valueChangeListener - Objet qui écoute les changements de valeurs

insertUpdate

public void insertUpdate(DocumentEvent documentEvent)

Méthode de retour appelée lors d'une insertion de valeur dans un Document, ici lorsque l'utilisateur insert une valeur dans le champ texte de saisie NumericInput.textField.

Specified by:

insertUpdate in interface DocumentListener

Parameters:

documentEvent - Evénement de modification de document

removeUpdate

public void removeUpdate(DocumentEvent documentEvent)

Méthode de retour appelée lors d'une suppression de valeur dans un Document, ici lorsque l'utilisateur supprime la valeur dans le champ texte de saisie NumericInput.textField.

Specified by:

removeUpdate in interface DocumentListener

Parameters:

documentEvent - Evénement de modification de document

changedUpdate

public void changedUpdate(DocumentEvent documentEvent)

Méthode de retour appelée lors d'un changement de valeur dans un Document, ici lorsque l'utilisateur change la valeur dans le champ texte de saisie NumericInput.textField.

Specified by:

changedUpdate in interface DocumentListener

Parameters:

documentEvent - Evénement de modification de document