001/*
002 *  Licensed to the Apache Software Foundation (ASF) under one
003 *  or more contributor license agreements.  See the NOTICE file
004 *  distributed with this work for additional information
005 *  regarding copyright ownership.  The ASF licenses this file
006 *  to you under the Apache License, Version 2.0 (the
007 *  "License"); you may not use this file except in compliance
008 *  with the License.  You may obtain a copy of the License at
009 *  
010 *    http://www.apache.org/licenses/LICENSE-2.0
011 *  
012 *  Unless required by applicable law or agreed to in writing,
013 *  software distributed under the License is distributed on an
014 *  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
015 *  KIND, either express or implied.  See the License for the
016 *  specific language governing permissions and limitations
017 *  under the License. 
018 *  
019 */
020package org.apache.directory.server.xdbm.search.cursor;
021
022
023import java.io.IOException;
024
025import org.apache.directory.api.ldap.model.constants.Loggers;
026import org.apache.directory.api.ldap.model.cursor.CursorException;
027import org.apache.directory.api.ldap.model.cursor.InvalidCursorPositionException;
028import org.apache.directory.api.ldap.model.exception.LdapException;
029import org.apache.directory.api.ldap.model.filter.ExprNode;
030import org.apache.directory.server.core.api.partition.PartitionTxn;
031import org.apache.directory.server.i18n.I18n;
032import org.apache.directory.server.xdbm.AbstractIndexCursor;
033import org.apache.directory.server.xdbm.IndexEntry;
034import org.apache.directory.server.xdbm.Store;
035import org.apache.directory.server.xdbm.search.Evaluator;
036import org.slf4j.Logger;
037import org.slf4j.LoggerFactory;
038
039
040/**
041 * A Cursor returning candidates satisfying a logical negation expression.
042 *
043 * @author <a href="mailto:dev@directory.apache.org">Apache Directory Project</a>
044 */
045public class NotCursor<V> extends AbstractIndexCursor<V>
046{
047    /** A dedicated log for cursors */
048    private static final Logger LOG_CURSOR = LoggerFactory.getLogger( Loggers.CURSOR_LOG.getName() );
049
050    /** Speedup for logs */
051    private static final boolean IS_DEBUG = LOG_CURSOR.isDebugEnabled();
052
053    private static final String UNSUPPORTED_MSG = I18n.err( I18n.ERR_718 );
054    private final AllEntriesCursor uuidCursor;
055    private final Evaluator<? extends ExprNode> childEvaluator;
056
057
058    /**
059     * Creates a new instance of an NotCursor
060     * 
061     * @param partitionTxn The transaction to use
062     * @param store The store
063     * @param childEvaluator The inner evaluator
064     * @throws LdapException If the creation failed
065     */
066    public NotCursor( PartitionTxn partitionTxn, Store store, Evaluator<? extends ExprNode> childEvaluator ) 
067            throws LdapException
068    {
069        if ( IS_DEBUG )
070        {
071            LOG_CURSOR.debug( "Creating NotCursor {}", this );
072        }
073
074        this.childEvaluator = childEvaluator;
075        this.partitionTxn = partitionTxn;
076        this.uuidCursor = new AllEntriesCursor( partitionTxn, store );
077
078    }
079
080
081    /**
082     * {@inheritDoc}
083     */
084    protected String getUnsupportedMessage()
085    {
086        return UNSUPPORTED_MSG;
087    }
088
089
090    /**
091     * {@inheritDoc}
092     */
093    public void beforeFirst() throws LdapException, CursorException
094    {
095        checkNotClosed();
096        uuidCursor.beforeFirst();
097        setAvailable( false );
098    }
099
100
101    /**
102     * {@inheritDoc}
103     */
104    public void afterLast() throws LdapException, CursorException
105    {
106        checkNotClosed();
107        uuidCursor.afterLast();
108        setAvailable( false );
109    }
110
111
112    /**
113     * {@inheritDoc}
114     */
115    public boolean first() throws LdapException, CursorException
116    {
117        beforeFirst();
118
119        return next();
120    }
121
122
123    /**
124     * {@inheritDoc}
125     */
126    public boolean last() throws LdapException, CursorException
127    {
128        afterLast();
129
130        return previous();
131    }
132
133
134    /**
135     * {@inheritDoc}
136     */
137    public boolean previous() throws LdapException, CursorException
138    {
139        while ( uuidCursor.previous() )
140        {
141            checkNotClosed();
142            IndexEntry<?, String> candidate = uuidCursor.get();
143
144            if ( !childEvaluator.evaluate( partitionTxn, candidate ) )
145            {
146                return setAvailable( true );
147            }
148        }
149
150        return setAvailable( false );
151    }
152
153
154    /**
155     * {@inheritDoc}
156     */
157    public boolean next() throws LdapException, CursorException
158    {
159        while ( uuidCursor.next() )
160        {
161            checkNotClosed();
162            IndexEntry<?, String> candidate = uuidCursor.get();
163
164            if ( !childEvaluator.evaluate( partitionTxn, candidate ) )
165            {
166                return setAvailable( true );
167            }
168        }
169
170        return setAvailable( false );
171    }
172
173
174    /**
175     * {@inheritDoc}
176     */
177    public IndexEntry<V, String> get() throws CursorException
178    {
179        checkNotClosed();
180
181        if ( available() )
182        {
183            return ( IndexEntry<V, String> ) uuidCursor.get();
184        }
185
186        throw new InvalidCursorPositionException( I18n.err( I18n.ERR_708 ) );
187    }
188
189
190    /**
191     * {@inheritDoc}
192     */
193    @Override
194    public void close() throws IOException
195    {
196        if ( IS_DEBUG )
197        {
198            LOG_CURSOR.debug( "Closing NotCursor {}", this );
199        }
200
201        super.close();
202        uuidCursor.close();
203    }
204
205
206    /**
207     * {@inheritDoc}
208     */
209    @Override
210    public void close( Exception cause ) throws IOException
211    {
212        if ( IS_DEBUG )
213        {
214            LOG_CURSOR.debug( "Closing NotCursor {}", this );
215        }
216
217        super.close( cause );
218        uuidCursor.close( cause );
219    }
220
221
222    /**
223     * @see Object#toString()
224     */
225    @Override
226    public String toString( String tabs )
227    {
228        StringBuilder sb = new StringBuilder();
229
230        sb.append( tabs ).append( "NotCursor (" );
231
232        if ( available() )
233        {
234            sb.append( "available)" );
235        }
236        else
237        {
238            sb.append( "absent)" );
239        }
240
241        sb.append( tabs + "  >>" ).append( childEvaluator ).append( '\n' );
242
243        sb.append( uuidCursor.toString( tabs + "    " ) );
244
245        return sb.toString();
246    }
247
248
249    /**
250     * @see Object#toString()
251     */
252    public String toString()
253    {
254        return "";
255    }
256}