src/java/org/apache/cassandra/repair/ValidationTask.java

/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.apache.cassandra.repair;

import java.util.concurrent.ExecutionException;

import org.apache.cassandra.exceptions.RepairException;
import org.apache.cassandra.locator.InetAddressAndPort;
import org.apache.cassandra.repair.messages.RepairMessage;
import org.apache.cassandra.repair.messages.ValidationRequest;
import org.apache.cassandra.streaming.PreviewKind;
import org.apache.cassandra.utils.MerkleTrees;
import org.apache.cassandra.utils.concurrent.AsyncFuture;

import static org.apache.cassandra.net.Verb.VALIDATION_REQ;
import static org.apache.cassandra.repair.messages.RepairMessage.notDone;

/**
 * ValidationTask sends {@link ValidationRequest} to a replica.
 * When a replica sends back message, task completes.
 */
public class ValidationTask extends AsyncFuture<TreeResponse> implements Runnable
{
    private final RepairJobDesc desc;
    private final InetAddressAndPort endpoint;
    private final long nowInSec;
    private final PreviewKind previewKind;
    private final boolean dontPurgeTombstones;
    private final SharedContext ctx;

    public ValidationTask(SharedContext ctx, RepairJobDesc desc, InetAddressAndPort endpoint, long nowInSec, PreviewKind previewKind, boolean dontPurgeTombstones)
    {
        this.ctx = ctx;
        this.desc = desc;
        this.endpoint = endpoint;
        this.nowInSec = nowInSec;
        this.previewKind = previewKind;
        this.dontPurgeTombstones = dontPurgeTombstones;
    }

    /**
     * Send ValidationRequest to replica
     */
    public void run()
    {
        RepairMessage.sendMessageWithFailureCB(ctx, notDone(this),
                                               new ValidationRequest(desc, nowInSec, dontPurgeTombstones),
                                               VALIDATION_REQ,
                                               endpoint,
                                               this::tryFailure);
    }

    /**
     * Receive MerkleTrees from replica node.
     *
     * @param trees MerkleTrees that is sent from replica. Null if validation failed on replica node.
     */
    public synchronized void treesReceived(MerkleTrees trees)
    {
        if (trees == null)
        {
            tryFailure(RepairException.warn(desc, previewKind, "Validation failed in " + endpoint));
        }
        else if (!trySuccess(new TreeResponse(endpoint, trees)))
        {
            // If the task is done, just release the possibly off-heap trees and move along.
            trees.release();
        }
    }

    /**
     * Release any trees already received by this task, and place it a state where any trees 
     * received subsequently will be properly discarded.
     */
    public synchronized void abort(Throwable reason)
    {
        if (!tryFailure(reason) && isSuccess())
        {
            try
            {
                // If we're done, this should return immediately.
                TreeResponse response = get();

                if (response.trees != null)
                    response.trees.release();
            }
            catch (InterruptedException e)
            {
                // Restore the interrupt.
                Thread.currentThread().interrupt();
            }
            catch (ExecutionException e)
            {
                // Do nothing here. If an exception was set, there were no trees to release.
            }
        }
    }
    
    public synchronized boolean isActive()
    {
        return !isDone();
    }
}