litesoft
@ 950
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 |
// This Source Code is in the Public Domain per: http://unlicense.org package org.litesoft.aokeyhole.swing.namevaluecomponents; import org.litesoft.aokeyhole.objects.*; import org.litesoft.aokeyhole.objects.support.*; import org.litesoft.aokeyhole.swing.*; import org.litesoft.aokeyhole.toolkit.*; import javax.swing.*; public abstract class NamedComponent extends LabeledComponent implements NameValueComponent, ValueChangedListener // todo: Indicate Errors? { private static final ValueStringConverter NULL_VALIDATER = new NullValueStringConverter(); private static final int VALUE_CHANGE_REJECTED = 0; private static final int VALUE_CHANGE_ACCEPTED = 1; private static final int VALUE_CHANGE_BUT_MUTATED = 2; private boolean mDataRequired; private boolean mPermDisabled = false; protected NameValueChangedByUserListener mNameValueChangedByUserListener = null; private ValueStringConverter mValidater = NULL_VALIDATER; private String mInitialValue = null; // 'External' (non-Native) Value protected Object mLastValue = null; // Component Native Value protected boolean mSystemUpdate = false; protected NamedComponent( NameValueComponentParams pParams ) { super( pParams ); mDataRequired = pParams.isDataRequired(); setName( pParams.getName() ); mPermDisabled = pParams.isPermDisabled(); mNameValueChangedByUserListener = pParams.getNameValueChangedByUserListener(); mValidater = (pParams.getValidater() != null) ? pParams.getValidater() : NULL_VALIDATER; mInitialValue = mValidater.valueToString( mValidater.validateAndNormalize( pParams.getInitialValue() ) ); } @Override public LabeledComponent initialize() { super.initialize(); if ( mPermDisabled ) { LLsetComponentEnabled( false ); } return this; } public String getInitialValue() { return mInitialValue; } public boolean isDataRequired() { return mDataRequired; } @Override public String getValue() { String rv = mValidater.valueToString( mValidater.validateAndNormalize( getComponentValue() ) ); return (rv.length() != 0) ? rv : null; } @Override public void clearValue() { if ( !setValue( mInitialValue ) ) { System.err.println( "NamedComponent(" + getName() + ").clearValue failed with: '" + mInitialValue + "'" ); } } @Override public void initializeView() { // Nothing needed at the common level } @Override public boolean setValue( String pValue ) { try { systemSetComponentValue( mValidater.validateAndNormalize( pValue ) ); } catch ( ParseException e ) { return false; } return true; } @Override public boolean setOptions( String[] pOptions ) { return false; } @Override public void setComponentEnabled( boolean pEnable ) { if ( !mPermDisabled ) { LLsetComponentEnabled( pEnable ); } } @Override public boolean isComponentEnabled() { return !mPermDisabled && LLisComponentEnabled(); } abstract protected boolean LLisComponentEnabled(); abstract protected void LLsetComponentEnabled( boolean pEnable ); protected void systemSetComponentValue( Object pValue ) { mSystemUpdate = true; try { setComponentValue( mLastValue = normalize( pValue ) ); } finally { mSystemUpdate = false; } } protected Object normalize( Object pValue ) { return pValue; } protected int determineValueChangeType( Object pCurCompValue, Object pMutatedCompValue ) { if ( AbstractBase.areEqual( pMutatedCompValue, mLastValue ) ) { return VALUE_CHANGE_REJECTED; } if ( AbstractBase.areEqual( pMutatedCompValue, pCurCompValue ) ) { return VALUE_CHANGE_ACCEPTED; } return VALUE_CHANGE_BUT_MUTATED; } protected void notifyValueChangedByUser() { if ( mNameValueChangedByUserListener != null ) { mNameValueChangedByUserListener.namedValueChangedByUser( getName() ); } } @Override public void valueChanged() { if ( !mSystemUpdate ) { Object curValue = getComponentValue(); if ( !AbstractBase.areEqual( curValue, mLastValue ) ) { Object mutatedValue = mutateChangeTo( mLastValue, curValue ); Runnable r; switch ( determineValueChangeType( curValue, mutatedValue ) ) { default: case VALUE_CHANGE_REJECTED: r = new ValueChangeRejectedRunner(); break; case VALUE_CHANGE_ACCEPTED: mLastValue = curValue; r = new ValueChangeAcceptedRunner(); break; case VALUE_CHANGE_BUT_MUTATED: r = new ValueChangeButMutatedRunner( mutatedValue ); break; } SwingUtilities.invokeLater( r ); } } } protected Object mutateChangeTo( Object pLastValue, Object pCurValue ) { return pCurValue; } abstract public Object getComponentValue(); abstract public void setComponentValue( Object pValue ); protected String toString( Object pValue ) { return mValidater.valueToString( pValue ); } private static class NullValueStringConverter implements ValueStringConverter { @Override public Object validateAndNormalize( Object pValue ) throws ParseException { return pValue; } @Override public String valueToString( Object pValue ) { return (pValue == null) ? null : pValue.toString(); } } private class ValueChangeRejectedRunner implements Runnable { @Override public void run() { systemSetComponentValue( mLastValue ); } } private class ValueChangeAcceptedRunner implements Runnable { @Override public void run() { notifyValueChangedByUser(); } } private class ValueChangeButMutatedRunner implements Runnable { private Object mMutatedValue; public ValueChangeButMutatedRunner( Object pMutatedValue ) { mMutatedValue = pMutatedValue; } @Override public void run() { systemSetComponentValue( mMutatedValue ); notifyValueChangedByUser(); } } } |
Commits for litesoft/trunk/Java/KeyHole/src/org/litesoft/aokeyhole/swing/namevaluecomponents/NamedComponent.java
Revision | Author | Commited | Message |
---|---|---|---|
950 Diff | GeorgeS | Thu 19 Jun, 2014 17:57:04 +0000 | New Lines |
948 Diff | GeorgeS | Sat 07 Jun, 2014 23:42:39 +0000 | Jusefuls Formatter Updated to New Code Format |
947 Diff | GeorgeS | Fri 06 Jun, 2014 23:36:56 +0000 | Correct Spelling of package! |
49 Diff | GeorgeS | Mon 12 Apr, 2010 02:59:10 +0000 | License Text |
17 Diff | GeorgeS | Thu 18 Feb, 2010 23:54:44 +0000 | |
2 | GeorgeS | Sun 07 Feb, 2010 12:50:58 +0000 |