/*
* 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.db.marshal;
import java.nio.ByteBuffer;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;
import com.google.common.base.Objects;
import org.apache.cassandra.cql3.CQL3Type;
import org.apache.cassandra.exceptions.ConfigurationException;
import org.apache.cassandra.exceptions.SyntaxException;
import org.apache.cassandra.serializers.*;
import org.apache.cassandra.utils.ByteBufferUtil;
import org.apache.cassandra.utils.Pair;
/**
* This is essentially like a CompositeType, but it's not primarily meant for comparison, just
* to pack multiple values together so has a more friendly encoding.
*/
public class TupleType extends AbstractType<ByteBuffer>
{
protected final List<AbstractType<?>> types;
public TupleType(List<AbstractType<?>> types)
{
this.types = types;
}
public static TupleType getInstance(TypeParser parser) throws ConfigurationException, SyntaxException
{
return new TupleType(parser.getTypeParameters());
}
public AbstractType<?> type(int i)
{
return types.get(i);
}
public int size()
{
return types.size();
}
public List<AbstractType<?>> allTypes()
{
return types;
}
public int compare(ByteBuffer o1, ByteBuffer o2)
{
if (!o1.hasRemaining() || !o2.hasRemaining())
return o1.hasRemaining() ? 1 : o2.hasRemaining() ? -1 : 0;
ByteBuffer bb1 = o1.duplicate();
ByteBuffer bb2 = o2.duplicate();
int i = 0;
while (bb1.remaining() > 0 && bb2.remaining() > 0)
{
AbstractType<?> comparator = types.get(i);
int size1 = bb1.getInt();
int size2 = bb2.getInt();
// Handle nulls
if (size1 < 0)
{
if (size2 < 0)
continue;
return -1;
}
if (size2 < 0)
return 1;
ByteBuffer value1 = ByteBufferUtil.readBytes(bb1, size1);
ByteBuffer value2 = ByteBufferUtil.readBytes(bb2, size2);
int cmp = comparator.compare(value1, value2);
if (cmp != 0)
return cmp;
++i;
}
if (bb1.remaining() == 0)
return bb2.remaining() == 0 ? 0 : -1;
// bb1.remaining() > 0 && bb2.remaining() == 0
return 1;
}
@Override
public void validate(ByteBuffer bytes) throws MarshalException
{
ByteBuffer input = bytes.duplicate();
for (int i = 0; i < size(); i++)
{
// we allow the input to have less fields than declared so as to support field addition.
if (!input.hasRemaining())
return;
if (input.remaining() < 4)
throw new MarshalException(String.format("Not enough bytes to read size of %dth component", i));
int size = input.getInt();
// We don't handle null just yet, but we should fix that soon (CASSANDRA-7206)
if (size < 0)
throw new MarshalException("Nulls are not yet supported inside tuple values");
if (input.remaining() < size)
throw new MarshalException(String.format("Not enough bytes to read %dth component", i));
ByteBuffer field = ByteBufferUtil.readBytes(input, size);
types.get(i).validate(field);
}
// We're allowed to get less fields than declared, but not more
if (input.hasRemaining())
throw new MarshalException("Invalid remaining data after end of tuple value");
}
/**
* Split a tuple value into its component values.
*/
public ByteBuffer[] split(ByteBuffer value)
{
ByteBuffer[] components = new ByteBuffer[size()];
ByteBuffer input = value.duplicate();
for (int i = 0; i < size(); i++)
{
if (!input.hasRemaining())
return Arrays.copyOfRange(components, 0, i);
int size = input.getInt();
components[i] = size < 0 ? null : ByteBufferUtil.readBytes(input, size);
}
return components;
}
public static ByteBuffer buildValue(ByteBuffer[] components)
{
int totalLength = 0;
for (ByteBuffer component : components)
totalLength += 4 + component.remaining();
ByteBuffer result = ByteBuffer.allocate(totalLength);
for (ByteBuffer component : components)
{
result.putInt(component.remaining());
result.put(component.duplicate());
}
result.rewind();
return result;
}
@Override
public String getString(ByteBuffer value)
{
StringBuilder sb = new StringBuilder();
ByteBuffer input = value.duplicate();
for (int i = 0; i < size(); i++)
{
if (!input.hasRemaining())
return sb.toString();
if (i > 0)
sb.append(":");
int size = input.getInt();
assert size >= 0; // We don't support nulls yet, but we will likely do with #7206 and we'll need
// a way to represent it as a string (without it conflicting with a user value)
ByteBuffer field = ByteBufferUtil.readBytes(input, size);
// We use ':' as delimiter so escape it if it's in the generated string
sb.append(field == null ? "null" : type(i).getString(value).replaceAll(":", "\\\\:"));
}
return sb.toString();
}
public ByteBuffer fromString(String source)
{
// Split the input on non-escaped ':' characters
List<String> strings = AbstractCompositeType.split(source);
ByteBuffer[] components = new ByteBuffer[strings.size()];
for (int i = 0; i < strings.size(); i++)
{
// TODO: we'll need to handle null somehow here once we support them
String str = strings.get(i).replaceAll("\\\\:", ":");
components[i] = type(i).fromString(str);
}
return buildValue(components);
}
public TypeSerializer<ByteBuffer> getSerializer()
{
return BytesSerializer.instance;
}
@Override
public boolean isCompatibleWith(AbstractType<?> previous)
{
if (!(previous instanceof TupleType))
return false;
// Extending with new components is fine, removing is not
TupleType tt = (TupleType)previous;
if (size() < tt.size())
return false;
for (int i = 0; i < tt.size(); i++)
{
AbstractType<?> tprev = tt.type(i);
AbstractType<?> tnew = type(i);
if (!tnew.isCompatibleWith(tprev))
return false;
}
return true;
}
@Override
public boolean isValueCompatibleWithInternal(AbstractType<?> otherType)
{
if (!(otherType instanceof TupleType))
return false;
// Extending with new components is fine, removing is not
TupleType tt = (TupleType) otherType;
if (size() < tt.size())
return false;
for (int i = 0; i < tt.size(); i++)
{
AbstractType<?> tprev = tt.type(i);
AbstractType<?> tnew = type(i);
if (!tnew.isValueCompatibleWith(tprev))
return false;
}
return true;
}
@Override
public int hashCode()
{
return Objects.hashCode(types);
}
@Override
public boolean equals(Object o)
{
if(!(o instanceof TupleType))
return false;
TupleType that = (TupleType)o;
return types.equals(that.types);
}
@Override
public String toString()
{
return getClass().getName() + TypeParser.stringifyTypeParameters(types);
}
}