001    /*
002    Copyright (c) 1996-2012, Damon Hart-Davis
003    All rights reserved.
004    
005    Redistribution and use in source and binary forms, with or without
006    modification, are permitted provided that the following conditions are
007    met:
008    
009      * Redistributions of source code must retain the above copyright
010        notice, this list of conditions and the following disclaimer.
011    
012      * Redistributions in binary form must reproduce the above copyright
013        notice, this list of conditions and the following disclaimer in the
014        documentation and/or other materials provided with the
015        distribution.
016    
017    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
018    IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
019    TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
020    PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
021    OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
022    SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
023    LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
024    DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
025    THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
026    (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
027    OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
028    */
029    package org.hd.d.pg2k.webSvr.exhibit;
030    
031    import org.hd.d.pg2k.svrCore.AllExhibitProperties;
032    import org.hd.d.pg2k.svrCore.Name;
033    
034    /**Interface for a class to filter exhibits (for a FilterBean).
035     * Filters must be Serializable so that filter expressions can
036     * be persisted.  They must not attempt to cache any reference,
037     * direct or indirect, to the DataSourceBean.
038     * <p>
039     * Filter objects must be immutable and the accept() method must be
040     * idempotent and not depend on any state held within the object.
041     * <p>
042     * The output ordering is not necessarily stable with respect to the input.
043     * <p>
044     * Implementing classes should implement equals() and hashCode() properly.
045     */
046    public interface FilterIF extends ExprIF, AllExhibitProperties.AEPFilter
047        {
048        /**Returns true if the exhibit (specified by full name) should be accepted.
049         */
050        public boolean accept(AllExhibitProperties aep, Name.ExhibitFull exhibitName);
051        }