// This Source Code is in the Public Domain per: http://unlicense.org
package org.litesoft.ui_1_5.filtering.nonpublic;

/**
 * An abstract representation of a SQL <i>WHERE</i> clause that supports a
 * column and comparison value.<p>
 * <a href="../../../Licence.txt">Licence</a><br>
 * <p/>
 * This <b>FormQueryFilter</b> is <a href="FormQueryFilterNotable.html"><b>NOT</b><i>able</i></a>.<p>
 * <p/>
 * This form of <b>FormQueryFilter</b> is currently used to support:
 * EQUALS, LESSTHAN, and GREATERTHAN.<p>
 * <p/>
 * See <a href="FormQueryFilter.html">FormQueryFilter</a><br>
 * See <a href="FormQueryFilterFactory.html">FormQueryFilterFactory</a><p>
 * <p/>
 * Exceptions: All problems caught when the parameter(s) are checked (as
 * indicated/implied in the @param tags) will generate an IllegalArgumentException,
 * and means the API user has a problem.  If a NullPointerException (or some
 * others, like: ClassCastException or ArrayIndexOutOfBoundsException) is thrown,
 * it means the API developer has a problem.  Any Exception that is explicitly
 * thrown in the API, but unrelated to a parameter, will be listed in the throws
 * clause (and hopefully in the tag @throws).  These may (but probably won't) be
 * checked Exceptions.
 *
 * @author George Smith
 * @version 1.0 08/08/08
 */

public abstract class AbstractFQFReferenceAndValue
//        extends AbstractFQFReferenceAndBoxedType
{
//    private Object mValue;
//
//    /**
//     * Constructor that supports a Column and comparison value SQL <i>WHERE</i> clause.<p>
//     * <p/>
//     * Note: Both the type of the Column and the type of the Value should be
//     * comparable.  For the SQL generation, the Value object's toString()
//     * method is used for <i>conversion</i>.<p>
//     *
//     * @param pType      The Type (EQUALS, LESSTHAN, and GREATERTHAN) for this FormQueryFilter.
//     * @param pFinder    !null
//     * @param pReference !null
//     */
//    protected AbstractFQFReferenceAndValue( WhereClauseType pType, Finder pFinder, String pReference )
//    {
//        super( pType, pFinder, pReference );
//    }
//
//    /**
//     * Accessor for the comparison value.<p>
//     *
//     * @return the comparison value (!null).
//     */
//    public final Object getValue()
//    {
//        return mValue;
//    }
//
//    protected boolean LLequalsSameTypesAndReference( AbstractFQFReferenceAndBoxedType pThem )
//    {
//        AbstractFQFReferenceAndValue them = (AbstractFQFReferenceAndValue) pThem;
//        return equal( this.mValue, them.mValue );
//    }
//
//    /**
//     * Helper method for <b>toString()</b> that provides a more efficient
//     * mechanism for the recursive decent of a FormQueryFilter <i>tree</i>.<p>
//     *
//     * @param pSB the StringBuilder to build the FormQueryFilter into.<p>
//     */
//    protected void toStringHelper( StringBuilder pSB )
//    {
//        toStringReference( pSB );
//        pSB.append( ' ' );
//        pSB.append( getType().getToStr() );
//        pSB.append( ' ' );
//        toStringValue( pSB, getValue() );
//    }
//
//    protected void setValue( Boolean pValue )
//    {
//        LLsetValue( BoxedBoolean.class, pValue );
//    }
//
//    protected void setValue( Date pValue )
//    {
//        LLsetValue( BoxedDate.class, pValue );
//    }
//
//    protected void setValue( Double pValue )
//    {
//        LLsetValue( BoxedDouble.class, pValue );
//    }
//
//    protected void setValue( Float pValue )
//    {
//        LLsetValue( BoxedFloat.class, pValue );
//    }
//
//    protected void setValue( Integer pValue )
//    {
//        LLsetValue( BoxedInteger.class, pValue );
//    }
//
//    protected void setValue( Long pValue )
//    {
//        LLsetValue( BoxedLong.class, pValue );
//    }
//
//    protected void setValue( Short pValue )
//    {
//        LLsetValue( BoxedShort.class, pValue );
//    }
//
//    protected void setValue( String pValue )
//    {
//        LLsetValue( BoxedString.class, pValue );
//    }
//
//    private void LLsetValue( Class pBoxedTypeClass, Object pValue )
//    {
//        mBoxedTypeClass = pBoxedTypeClass;
//        IllegalArgument.ifNull( "Value", mValue = pValue );
//    }
//
//    protected void LLpopulate( HierarchicalDataSink.Node pNode )
//    {
//        super.LLpopulate( pNode );
//        AbstractBoxedSimpleType zBoxedSimpleType;
//        try
//        {
//            zBoxedSimpleType = (AbstractBoxedSimpleType) mBoxedTypeClass.newInstance();
//        }
//        catch ( InstantiationException e )
//        {
//            throw new RuntimeException( e );
//        }
//        catch ( IllegalAccessException e )
//        {
//            throw new RuntimeException( e );
//        }
//        AbstractBoxedSimpleType.BackDoor.setObjectValue( zBoxedSimpleType, mValue );
//        zBoxedSimpleType.desiccate( pNode );
//    }
//
//    protected abstract static class FQFRefNValueRehydrateFactory
//            extends FQFReferenceWithChildrenRehydrateFactory
//    {
//        protected HierarchicalDesiccatable create( HierarchicalRehydrateFactoryFactory pFactoryFactory, //
//                                                   HierarchicalDataSource.Node pSourceNode, //
//                                                   Finder pFinder, String pReference )
//        {
//            Object zChild = pFactoryFactory.rehydrateNextChild( pSourceNode, pFinder );
//            if ( !(zChild instanceof AbstractBoxedSimpleType) )
//            {
//                throw new IllegalArgumentException( "Got a " + pSourceNode.getName() +
//                                                    ", but instead of expected Value(BoxedSimpleType), got a " +
//                                                    (zChild == null ? "null" : zChild.getClass().getName()) );
//            }
//            pSourceNode.assertNoMoreChildren();
//            AbstractFQFReferenceAndValue zFQF = create( pFinder, pReference );
//            zFQF.LLsetValue( zChild.getClass(), ((AbstractBoxedSimpleType) zChild).getBoxedValue() );
//            return zFQF;
//        }
//
//        abstract protected AbstractFQFReferenceAndValue create( Finder pFinder, String pReference );
//    }
}