Subversion Repository Public Repository

litesoft

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
// This Source Code is in the Public Domain per: http://litesoft.org/License.txt
package org.litesoft.GWT.client.widgets.datatables;

import java.util.*;

import org.litesoft.bo.*;
import org.litesoft.bo.views.*;
import org.litesoft.core.typeutils.*;
import org.litesoft.core.util.*;

public abstract class FilterManager<RowType extends IViewObject> implements FetchRowsDataProviderCallBack<RowType>
{
    public static final String TOO_MANY_ROWS_MATCHED = "Too Many Rows Matched, Found At Least: ";
    public static final String NO_ROWS_MATCHED = "No Rows Matched";
    public static final String NOTHING_ENTERED = "You must enter something";

    public interface CallBacks<OurRowType extends IViewObject>
    {
        public ImmutableArrayList<OurRowType> filterRows( ImmutableArrayList<OurRowType> pRows );

        public void setNewList( List<OurRowType> pList, String pMsgText );
    }

    private BoMetaData mMetaData;
    private CallBacks<RowType> mCallBacks;
    private BoAccessorFilters mFilters = new BoAccessorFilters();
    private BoAccessorFilters mBaseLineFilters = null;
    private List<RowType> mBaseLineRows = null;
    private int mVsFilters, mVsList;

    public FilterManager( BoMetaData pMetaData, CallBacks<RowType> pCallBacks )
    {
        Objects.assertNotNull( "MetaData", mMetaData = pMetaData );
        Objects.assertNotNull( "CallBacks", mCallBacks = pCallBacks );
    }

    public void clearCache()
    {
        mBaseLineFilters = null;
        mBaseLineRows = null;
    }

    public boolean clear()
    {
        boolean rv = !mFilters.isEmpty();
        if ( rv )
        {
            mFilters.clear();
            mVsFilters++;
        }
        return rv;
    }

    public boolean setFilter( BoAccessorFilterType pFilterType, String pAttributeName, String pValue )
    {
        boolean zAdded = mFilters.setFilter( pFilterType, pAttributeName, pValue );
        if ( zAdded )
        {
            mVsFilters++;
        }
        return zAdded;
    }

    public boolean isEmpty()
    {
        return mFilters.isEmpty();
    }

    public int activeFilters()
    {
        return mFilters.activeFilters();
    }

    /**
     * @return false if the tables data model is up to date!
     */
    public boolean updateList()
    {
        if ( mVsFilters == mVsList ) // Filter & List Match!
        {
            return false;
        }
        if ( mFilters.isEmpty() )
        {
            setNewList( new ArrayList<RowType>(), NOTHING_ENTERED );
        }
        else if ( mPendingRequest == null )
        {
            requestRows();
        }
        return true;
    }

    private void setNewList( List<RowType> pList, String pMsgText )
    {
        mVsList = mVsFilters;
        mCallBacks.setNewList( pList, pMsgText );
    }

    private void requestRows()
    {
        if ( (mBaseLineFilters != null) && !FilterUtil.needsRefresh( mMetaData, mBaseLineFilters, mFilters ) )
        {
            Filter zFilter = FilterUtil.createFilter( mMetaData, mFilters.getFilters() );
            ArrayList<RowType> zNewList = new ArrayList<RowType>();
            for ( RowType zType : mBaseLineRows )
            {
                if ( zFilter.isSatisfiedBy( zType ) )
                {
                    zNewList.add( zType );
                }
            }
            setNewList( zNewList, zNewList.isEmpty() ? NO_ROWS_MATCHED : null );
            return;
        }
        mPendingRequest = new PendingRequestStructure( mVsFilters, mFilters );
        requestRowsFromServer( mPendingRequest.getFilters() );
    }

    protected void addBaseline( BoAccessorFilters pFilters, List<RowType> pList )
    {
        mBaseLineFilters = pFilters; // Simply save it - Not Shared/Used anymore
        mBaseLineRows = new ArrayList<RowType>( pList ); // Save it - Used by others - Copy it
    }

    abstract protected void requestRowsFromServer( BoAccessorFilters pFilters );

    private static class PendingRequestStructure
    {
        private int mVsFilters;
        private BoAccessorFilters mFilters;

        public PendingRequestStructure( int pVsFilters, BoAccessorFilters pFilters )
        {
            mVsFilters = pVsFilters;
            mFilters = pFilters.copy(); // Snap shot Filters
        }

        public int getVsFilters()
        {
            return mVsFilters;
        }

        public BoAccessorFilters getFilters()
        {
            return mFilters;
        }
    }

    private PendingRequestStructure mPendingRequest;

    private void filteredResponse( List<RowType> pList, // !null means that this could be a legitimate base line!
                                   String pMsgText )
    {
        PendingRequestStructure zPendingRequest = mPendingRequest; // Capture & clear the current PendingRequest
        mPendingRequest = null;
        if ( pList != null )
        {
            addBaseline( zPendingRequest.getFilters(), pList );
        }
        if ( mVsList == mVsFilters ) // This should only be possible if the user has cleared the filters while the response was pending
        {
            return;
        }
        if ( mVsFilters != zPendingRequest.getVsFilters() ) // Filters have changed since request
        {
            requestRows();
            return;
        }
        setNewList( (pList != null) ? pList : new ArrayList<RowType>(), pMsgText );
    }

    @Override
    public void success( ImmutableArrayList<RowType> pRows )
    {
        if ( (pRows == null) || pRows.isEmpty() )
        {
            filteredResponse( new ArrayList<RowType>(), NO_ROWS_MATCHED );
        }
        else
        {
            filteredResponse( mCallBacks.filterRows( pRows ).getSortedList(), null );
        }
    }

    @Override
    public void tooMany( long pCount )
    {
        filteredResponse( null, TOO_MANY_ROWS_MATCHED + pCount );
    }

    @Override
    public void error( String pError )
    {
        filteredResponse( null, "Error: " + pError );
    }
}

Commits for litesoft/trunk/Java/GWT/Client/src/org/litesoft/GWT/client/widgets/datatables/FilterManager.java

Diff revisions: vs.
Revision Author Commited Message
804 Diff Diff GeorgeS picture GeorgeS Wed 15 Aug, 2012 12:48:51 +0000
216 Diff Diff GeorgeS picture GeorgeS Wed 18 May, 2011 13:44:57 +0000
199 Diff Diff GeorgeS picture GeorgeS Tue 10 May, 2011 00:55:21 +0000
151 Diff Diff GeorgeS picture GeorgeS Thu 17 Mar, 2011 04:16:22 +0000
49 Diff Diff GeorgeS picture GeorgeS Mon 12 Apr, 2010 02:59:10 +0000

License Text

23 Diff Diff GeorgeS picture GeorgeS Wed 24 Feb, 2010 00:34:32 +0000
2 GeorgeS picture GeorgeS Sun 07 Feb, 2010 12:50:58 +0000