/*
 * 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.schema;

import java.io.IOException;
import java.lang.reflect.InvocationTargetException;
import java.util.*;
import java.util.regex.Pattern;
import java.util.stream.Collectors;

import com.google.common.base.Objects;
import com.google.common.collect.ImmutableMap;
import com.google.common.collect.Maps;
import org.apache.commons.lang3.builder.ToStringBuilder;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import org.apache.cassandra.config.CFMetaData;
import org.apache.cassandra.config.ColumnDefinition;
import org.apache.cassandra.cql3.statements.IndexTarget;
import org.apache.cassandra.exceptions.ConfigurationException;
import org.apache.cassandra.index.Index;
import org.apache.cassandra.io.util.DataInputPlus;
import org.apache.cassandra.io.util.DataOutputPlus;
import org.apache.cassandra.utils.FBUtilities;
import org.apache.cassandra.utils.UUIDSerializer;

An immutable representation of secondary index metadata.
/** * An immutable representation of secondary index metadata. */
public final class IndexMetadata { private static final Logger logger = LoggerFactory.getLogger(IndexMetadata.class); private static final Pattern PATTERN_NON_WORD_CHAR = Pattern.compile("\\W"); private static final Pattern PATTERN_WORD_CHARS = Pattern.compile("\\w+"); public static final Serializer serializer = new Serializer(); public enum Kind { KEYS, CUSTOM, COMPOSITES } // UUID for serialization. This is a deterministic UUID generated from the index name // Both the id and name are guaranteed unique per keyspace. public final UUID id; public final String name; public final Kind kind; public final Map<String, String> options; private IndexMetadata(String name, Map<String, String> options, Kind kind) { this.id = UUID.nameUUIDFromBytes(name.getBytes()); this.name = name; this.options = options == null ? ImmutableMap.of() : ImmutableMap.copyOf(options); this.kind = kind; } public static IndexMetadata fromLegacyMetadata(CFMetaData cfm, ColumnDefinition column, String name, Kind kind, Map<String, String> options) { Map<String, String> newOptions = new HashMap<>(); if (options != null) newOptions.putAll(options); IndexTarget target; if (newOptions.containsKey(IndexTarget.INDEX_KEYS_OPTION_NAME)) { newOptions.remove(IndexTarget.INDEX_KEYS_OPTION_NAME); target = new IndexTarget(column.name, IndexTarget.Type.KEYS); } else if (newOptions.containsKey(IndexTarget.INDEX_ENTRIES_OPTION_NAME)) { newOptions.remove(IndexTarget.INDEX_KEYS_OPTION_NAME); target = new IndexTarget(column.name, IndexTarget.Type.KEYS_AND_VALUES); } else { if (column.type.isCollection() && !column.type.isMultiCell()) { target = new IndexTarget(column.name, IndexTarget.Type.FULL); } else { target = new IndexTarget(column.name, IndexTarget.Type.VALUES); } } newOptions.put(IndexTarget.TARGET_OPTION_NAME, target.asCqlString(cfm)); return new IndexMetadata(name, newOptions, kind); } public static IndexMetadata fromSchemaMetadata(String name, Kind kind, Map<String, String> options) { return new IndexMetadata(name, options, kind); } public static IndexMetadata fromIndexTargets(CFMetaData cfm, List<IndexTarget> targets, String name, Kind kind, Map<String, String> options) { Map<String, String> newOptions = new HashMap<>(options); newOptions.put(IndexTarget.TARGET_OPTION_NAME, targets.stream() .map(target -> target.asCqlString(cfm)) .collect(Collectors.joining(", "))); return new IndexMetadata(name, newOptions, kind); } public static boolean isNameValid(String name) { return name != null && !name.isEmpty() && PATTERN_WORD_CHARS.matcher(name).matches(); } public static String getDefaultIndexName(String cfName, String root) { if (root == null) return PATTERN_NON_WORD_CHAR.matcher(cfName + "_" + "idx").replaceAll(""); else return PATTERN_NON_WORD_CHAR.matcher(cfName + "_" + root + "_idx").replaceAll(""); } public void validate(CFMetaData cfm) { if (!isNameValid(name)) throw new ConfigurationException("Illegal index name " + name); if (kind == null) throw new ConfigurationException("Index kind is null for index " + name); if (kind == Kind.CUSTOM) { if (options == null || !options.containsKey(IndexTarget.CUSTOM_INDEX_OPTION_NAME)) throw new ConfigurationException(String.format("Required option missing for index %s : %s", name, IndexTarget.CUSTOM_INDEX_OPTION_NAME)); String className = options.get(IndexTarget.CUSTOM_INDEX_OPTION_NAME); Class<Index> indexerClass = FBUtilities.classForName(className, "custom indexer"); if(!Index.class.isAssignableFrom(indexerClass)) throw new ConfigurationException(String.format("Specified Indexer class (%s) does not implement the Indexer interface", className)); validateCustomIndexOptions(cfm, indexerClass, options); } } private void validateCustomIndexOptions(CFMetaData cfm, Class<? extends Index> indexerClass, Map<String, String> options) throws ConfigurationException { try { Map<String, String> filteredOptions = Maps.filterKeys(options,key -> !key.equals(IndexTarget.CUSTOM_INDEX_OPTION_NAME)); if (filteredOptions.isEmpty()) return; Map<?,?> unknownOptions; try { unknownOptions = (Map) indexerClass.getMethod("validateOptions", Map.class, CFMetaData.class).invoke(null, filteredOptions, cfm); } catch (NoSuchMethodException e) { unknownOptions = (Map) indexerClass.getMethod("validateOptions", Map.class).invoke(null, filteredOptions); } if (!unknownOptions.isEmpty()) throw new ConfigurationException(String.format("Properties specified %s are not understood by %s", unknownOptions.keySet(), indexerClass.getSimpleName())); } catch (NoSuchMethodException e) { logger.info("Indexer {} does not have a static validateOptions method. Validation ignored", indexerClass.getName()); } catch (InvocationTargetException e) { if (e.getTargetException() instanceof ConfigurationException) throw (ConfigurationException) e.getTargetException(); throw new ConfigurationException("Failed to validate custom indexer options: " + options); } catch (ConfigurationException e) { throw e; } catch (Exception e) { throw new ConfigurationException("Failed to validate custom indexer options: " + options); } } public boolean isCustom() { return kind == Kind.CUSTOM; } public boolean isKeys() { return kind == Kind.KEYS; } public boolean isComposites() { return kind == Kind.COMPOSITES; } public int hashCode() { return Objects.hashCode(id, name, kind, options); } public boolean equalsWithoutName(IndexMetadata other) { return Objects.equal(kind, other.kind) && Objects.equal(options, other.options); } public boolean equals(Object obj) { if (obj == this) return true; if (!(obj instanceof IndexMetadata)) return false; IndexMetadata other = (IndexMetadata)obj; return Objects.equal(id, other.id) && Objects.equal(name, other.name) && equalsWithoutName(other); } public String toString() { return new ToStringBuilder(this) .append("id", id.toString()) .append("name", name) .append("kind", kind) .append("options", options) .build(); } public static class Serializer { public void serialize(IndexMetadata metadata, DataOutputPlus out, int version) throws IOException { UUIDSerializer.serializer.serialize(metadata.id, out, version); } public IndexMetadata deserialize(DataInputPlus in, int version, CFMetaData cfm) throws IOException { UUID id = UUIDSerializer.serializer.deserialize(in, version); return cfm.getIndexes().get(id).orElseThrow(() -> new UnknownIndexException(cfm, id)); } public long serializedSize(IndexMetadata metadata, int version) { return UUIDSerializer.serializer.serializedSize(metadata.id, version); } } }