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.ldap.client.api.future;
021
022
023import java.util.concurrent.ExecutionException;
024import java.util.concurrent.TimeUnit;
025import java.util.concurrent.TimeoutException;
026
027import org.apache.directory.ldap.client.api.LdapConnection;
028import org.apache.directory.shared.ldap.model.message.CompareResponse;
029
030
031/**
032 * A Future to manage CompareRequest.
033 *
034 * @author <a href="mailto:dev@directory.apache.org">Apache Directory Project</a>
035 */
036public class CompareFuture extends ResponseFuture<CompareResponse>
037{
038    /**
039     * Creates a new instance of CompareFuture.
040     *
041     * @param connection the LDAP connection
042     * @param messageId the associated messageId
043     */
044    // Implicit super constructor ResponseFuture<BindResponse>() is undefined for default constructor. 
045    @SuppressWarnings("PMD.UselessOverridingMethod")
046    public CompareFuture( LdapConnection connection, int messageId )
047    {
048        super( connection, messageId );
049    }
050
051
052    /**
053     * Get the CompareResponse, blocking until one is received.
054     * 
055     * @return the compare response
056     * @throws InterruptedException {@inheritDoc}
057     * @throws ExecutionException {@inheritDoc}
058     */
059    @SuppressWarnings("PMD.UselessOverridingMethod")
060    public CompareResponse get() throws InterruptedException, ExecutionException
061    {
062        return super.get();
063    }
064
065
066    /**
067     * Get the CompareResponse, blocking until one is received, or until the
068     * given timeout is reached.
069     * 
070     * @param timeout {@inheritDoc}
071     * @param unit {@inheritDoc}
072     * @return the compare response
073     * @throws InterruptedException {@inheritDoc}
074     * @throws ExecutionException {@inheritDoc}
075     * @throws TimeoutException {@inheritDoc}
076     */
077    public CompareResponse get( long timeout, TimeUnit unit ) throws InterruptedException, ExecutionException,
078        TimeoutException
079    {
080        return super.get( timeout, unit );
081    }
082
083
084    /**
085     * {@inheritDoc}
086     */
087    public String toString()
088    {
089        StringBuilder sb = new StringBuilder();
090
091        sb.append( "CompareFuture" ).append( super.toString() );
092
093        return sb.toString();
094    }
095}