/*
 * Copyright (C) 2017-2017 DataStax Inc.
 *
 * Licensed 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 com.datastax.oss.protocol.internal.response.error;

import com.datastax.oss.protocol.internal.Message;
import com.datastax.oss.protocol.internal.PrimitiveCodec;
import com.datastax.oss.protocol.internal.PrimitiveSizes;
import com.datastax.oss.protocol.internal.ProtocolConstants;
import com.datastax.oss.protocol.internal.response.Error;

public class ReadTimeout extends Error {
  
The consistency level of the query that triggered the exception.
/** The consistency level of the query that triggered the exception. */
public final int consistencyLevel;
The number of nodes having answered the request.
/** The number of nodes having answered the request. */
public final int received;
The number of replicas whose response is required to achieve consistencyLevel.

It is possible to have received >= blockFor if data_present is false. Also in the (unlikely) case where consistencyLevel is achieved but the coordinator node times out while waiting for read-repair acknowledgement.

/** * The number of replicas whose response is required to achieve {@code consistencyLevel}. * * <p>It is possible to have {@code received >= blockFor} if {@code data_present} is false. Also * in the (unlikely) case where {@code consistencyLevel} is achieved but the coordinator node * times out while waiting for read-repair acknowledgement. */
public final int blockFor;
Whether the replica that was asked for data responded.
/** Whether the replica that was asked for data responded. */
public final boolean dataPresent; public ReadTimeout( String message, int consistencyLevel, int received, int blockFor, boolean dataPresent) { super(ProtocolConstants.ErrorCode.READ_TIMEOUT, message); this.consistencyLevel = consistencyLevel; this.received = received; this.blockFor = blockFor; this.dataPresent = dataPresent; } public static class SubCodec extends Error.SubCodec { public SubCodec(int protocolVersion) { super(ProtocolConstants.ErrorCode.READ_TIMEOUT, protocolVersion); } @Override public <B> void encode(B dest, Message message, PrimitiveCodec<B> encoder) { ReadTimeout readTimeout = (ReadTimeout) message; encoder.writeString(readTimeout.message, dest); encoder.writeUnsignedShort(readTimeout.consistencyLevel, dest); encoder.writeInt(readTimeout.received, dest); encoder.writeInt(readTimeout.blockFor, dest); encoder.writeByte((byte) (readTimeout.dataPresent ? 1 : 0), dest); } @Override public int encodedSize(Message message) { ReadTimeout readTimeout = (ReadTimeout) message; return PrimitiveSizes.sizeOfString(readTimeout.message) + PrimitiveSizes.SHORT + PrimitiveSizes.INT + PrimitiveSizes.INT + PrimitiveSizes.BYTE; } @Override public <B> Message decode(B source, PrimitiveCodec<B> decoder) { String message = decoder.readString(source); int consistencyLevel = decoder.readUnsignedShort(source); int received = decoder.readInt(source); int blockFor = decoder.readInt(source); boolean dataPresent = decoder.readByte(source) != 0; return new ReadTimeout(message, consistencyLevel, received, blockFor, dataPresent); } } }