// 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 two or more "equal" values.<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> primarily exists to support AnyOf.<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 AbstractFQFReferenceAnd_N_Values
//        extends AbstractFQFReferenceAndBoxedType
{
//    private Object[] mValues;
//
//    /**
//     * Constructor that associates two or more !null "equal" values with
//     * a column.<p>
//     * <p/>
//     * Note: Both the type of the Column and the types of the values should
//     * be comparable.  For the SQL generation, the object's toString()
//     * method is used for <i>conversion</i>.<p>
//     *
//     * @param pType      the Type for this FormQueryFilter.
//     * @param pFinder    !null
//     * @param pReference !null
//     */
//    protected AbstractFQFReferenceAnd_N_Values( WhereClauseType pType, Finder pFinder, String pReference )
//    {
//        super( pType, pFinder, pReference );
//    }
//
//    /**
//     * Accessor for the two or more "equal" values (!null).<p>
//     *
//     * @return the two or more "equal" values (!null).
//     */
//    public final Object[] getValues()
//    {
//        return mValues;
//    }
//
//    protected boolean LLequalsSameTypesAndReference( AbstractFQFReferenceAndBoxedType pThem )
//    {
//        AbstractFQFReferenceAnd_N_Values them = (AbstractFQFReferenceAnd_N_Values) pThem;
//        return Utils.areArraysEqual( this.mValues, them.mValues );
//    }
//
//    protected void toStringHelper( StringBuilder pSB )
//    {
//        toStringReference( pSB );
//        pSB.append( ' ' );
//        pSB.append( getType().getToStr() );
//        Object[] zValues = getValues();
//        toStringValue( pSB, zValues[0] );
//        for ( int i = 1; i < zValues.length; i++ )
//        {
//            pSB.append( ',' );
//            toStringValue( pSB, zValues[i] );
//        }
//        pSB.append( ')' );
//    }
//
//    protected void setValues( boolean[] pValues )
//    {
//        LLsetValues( BoxedBooleanArray.box( pValues ) );
//    }
//
//    protected void setValues( double[] pValues )
//    {
//        LLsetValues( BoxedDoubleArray.box( pValues ) );
//    }
//
//    protected void setValues( float[] pValues )
//    {
//        LLsetValues( BoxedFloatArray.box( pValues ) );
//    }
//
//    protected void setValues( int[] pValues )
//    {
//        LLsetValues( BoxedIntegerArray.box( pValues ) );
//    }
//
//    protected void setValues( long[] pValues )
//    {
//        LLsetValues( BoxedLongArray.box( pValues ) );
//    }
//
//    protected void setValues( short[] pValues )
//    {
//        LLsetValues( BoxedShortArray.box( pValues ) );
//    }
//
//    protected void setValues( Boolean[] pValues )
//    {
//        LLsetValues( BoxedBooleanArray.class, pValues );
//    }
//
//    protected void setValues( Date[] pValues )
//    {
//        LLsetValues( BoxedDateArray.class, pValues );
//    }
//
//    protected void setValues( Double[] pValues )
//    {
//        LLsetValues( BoxedDoubleArray.class, pValues );
//    }
//
//    protected void setValues( Float[] pValues )
//    {
//        LLsetValues( BoxedFloatArray.class, pValues );
//    }
//
//    protected void setValues( Integer[] pValues )
//    {
//        LLsetValues( BoxedIntegerArray.class, pValues );
//    }
//
//    protected void setValues( Long[] pValues )
//    {
//        LLsetValues( BoxedLongArray.class, pValues );
//    }
//
//    protected void setValues( Short[] pValues )
//    {
//        LLsetValues( BoxedShortArray.class, pValues );
//    }
//
//    protected void setValues( String[] pValues )
//    {
//        LLsetValues( BoxedStringArray.class, pValues );
//    }
//
//    private void LLsetValues( AbstractBoxedObjectArrayType pValues )
//    {
//        LLsetValues( pValues.getClass(), (Object[]) pValues.getBoxedValue() );
//    }
//
//    private void LLsetValues( Class pBoxedTypeClass, Object[] pValues )
//    {
//        mBoxedTypeClass = pBoxedTypeClass;
//        Utils.assertNotNullNotEmpty( "No Values", mValues = pValues );
//    }
//
//    protected void LLpopulate( HierarchicalDataSink.Node pNode )
//    {
//        super.LLpopulate( pNode );
//        AbstractBoxedObjectArrayType zBoxedArrayType;
//        try
//        {
//            zBoxedArrayType = (AbstractBoxedObjectArrayType) mBoxedTypeClass.newInstance();
//        }
//        catch ( InstantiationException e )
//        {
//            throw new RuntimeException( e );
//        }
//        catch ( IllegalAccessException e )
//        {
//            throw new RuntimeException( e );
//        }
//        AbstractBoxedObjectArrayType.BackDoor.setObjectArrayValue( zBoxedArrayType, mValues );
//        zBoxedArrayType.desiccate( pNode );
//    }
//
//    protected abstract static class FQFRefNValuesRehydrateFactory
//            extends FQFReferenceWithChildrenRehydrateFactory
//    {
//        protected HierarchicalDesiccatable create( HierarchicalRehydrateFactoryFactory pFactoryFactory, //
//                                                   HierarchicalDataSource.Node pSourceNode, //
//                                                   Finder pFinder, String pReference )
//        {
//            Object zValues = pFactoryFactory.rehydrateNextChild( pSourceNode, pFinder );
//            if ( !(zValues instanceof AbstractBoxedObjectArrayType) )
//            {
//                throw new IllegalArgumentException( "Got a " + pSourceNode.getName() +
//                                                    ", but instead of expected Values(BoxedObjectArrayType), got a " +
//                                                    (zValues == null ? "null" :
//                                                     zValues.getClass().getName()) );
//            }
//            pSourceNode.assertNoMoreChildren();
//            AbstractFQFReferenceAnd_N_Values zFQF = create( pFinder, pReference );
//            zFQF.LLsetValues( zValues.getClass(), //
//                              (Object[]) ((AbstractBoxedObjectArrayType) zValues).getBoxedValue() );
//            return zFQF;
//        }
//
//        abstract protected AbstractFQFReferenceAnd_N_Values create( Finder pFinder, String pReference );
//    }
}