All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.modeshape.jcr.index.local.ManagedLocalIndexBuilder Maven / Gradle / Ivy

There is a newer version: 5.4.1.Final
Show newest version
/*
 * ModeShape (http://www.modeshape.org)
 *
 * 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 org.modeshape.jcr.index.local;

import java.util.Comparator;
import org.mapdb.BTreeKeySerializer;
import org.mapdb.DB;
import org.mapdb.Serializer;
import org.modeshape.common.collection.Problems;
import org.modeshape.jcr.ExecutionContext;
import org.modeshape.jcr.JcrI18n;
import org.modeshape.jcr.JcrLexicon;
import org.modeshape.jcr.ModeShapeLexicon;
import org.modeshape.jcr.NodeTypes;
import org.modeshape.jcr.NodeTypes.Supplier;
import org.modeshape.jcr.api.index.IndexColumnDefinition;
import org.modeshape.jcr.api.index.IndexDefinition;
import org.modeshape.jcr.api.index.IndexDefinition.IndexKind;
import org.modeshape.jcr.cache.change.ChangeSetAdapter.NodeTypePredicate;
import org.modeshape.jcr.index.local.IndexValues.Converter;
import org.modeshape.jcr.index.local.MapDB.Serializers;
import org.modeshape.jcr.spi.index.provider.IndexChangeAdapter;
import org.modeshape.jcr.value.Name;
import org.modeshape.jcr.value.Path;
import org.modeshape.jcr.value.PropertyType;
import org.modeshape.jcr.value.ValueComparators;
import org.modeshape.jcr.value.ValueFactory;

/**
 * A builder for {@link LocalIndex local indexes}.
 *
 * @author Randall Hauch ([email protected])
 * @param  the type of value that is indexed
 */
public abstract class ManagedLocalIndexBuilder {

    /**
     * Create a builder for the supplied index definition.
     *
     * @param context the execution context in which the index should operate; may not be null
     * @param defn the index definition; may not be null
     * @param nodeTypesSupplier the supplier of the {@link NodeTypes} instance; may not be null
     * @param matcher the node type matcher used to determine which nodes should be included in the index; may not be null
     * @return the index builder; never null
     */
    public static  ManagedLocalIndexBuilder create( ExecutionContext context,
                                                          IndexDefinition defn,
                                                          Supplier nodeTypesSupplier,
                                                          NodeTypePredicate matcher ) {
        if (defn.hasSingleColumn()) {
            PropertyType actualPropertyType = determineActualPropertyType(defn.getColumnDefinition(0));
            return new SingleColumnIndexBuilder(context, defn, nodeTypesSupplier, matcher, actualPropertyType);
        }
        throw new LocalIndexException("The local provider does not support multi-column indexes");
    }

    protected static PropertyType determineActualPropertyType( IndexColumnDefinition columnDefn ) {
        PropertyType type = PropertyType.valueFor(columnDefn.getColumnType());
        switch (type) {
            case BOOLEAN:
            case DATE:
            case DECIMAL:
            case DOUBLE:
            case LONG:
            case STRING:
            case NAME:
            case PATH:
                // These types are all usable as-is
                return type; // no conversion
            case BINARY:
            case OBJECT:
            case REFERENCE:
            case SIMPLEREFERENCE:
            case WEAKREFERENCE:
            case URI:
                // These types are all represented in the indexes as STRING
                return PropertyType.STRING;
        }
        assert false : "should never get here";
        return type;
    }

    protected final ExecutionContext context;
    protected final Serializers serializers;
    protected final Supplier nodeTypesSupplier;
    protected final IndexDefinition defn;
    protected final NodeTypePredicate matcher;

    protected ManagedLocalIndexBuilder( ExecutionContext context,
                                        IndexDefinition defn,
                                        Supplier nodeTypesSupplier,
                                        NodeTypePredicate matcher ) {
        this.context = context;
        this.serializers = MapDB.serializers(this.context.getValueFactories());
        this.nodeTypesSupplier = nodeTypesSupplier;
        this.defn = defn;
        this.matcher = matcher;
    }

    /**
     * Build the managed index.
     *
     * @param workspaceName the name of the workspace; may not be null
     * @param localDatabase the local database; may not be null
     * @return the managed local index
     * @throws LocalIndexException if there is a problem creating the index
     */
    public abstract ManagedLocalIndex build( String workspaceName,
                                             DB localDatabase ) throws LocalIndexException;

    /**
     * Validate whether the index definition is acceptable for this provider.
     *
     * @param problems the component to record any problems, errors, or warnings; may not be null
     */
    public abstract void validate( Problems problems );

    protected final Supplier getNodeTypesSupplier() {
        return nodeTypesSupplier;
    }

    protected final String indexName() {
        return defn.getName();
    }

    protected abstract Serializer getSerializer();

    protected abstract BTreeKeySerializer getBTreeKeySerializer();

    protected abstract Comparator getComparator();

    protected abstract Converter getConverter();

    protected abstract Class getValueClass();

    protected boolean isNodeTypesIndex() {
        return false;
    }

    protected boolean isPrimaryTypeIndex() {
        return false;
    }

    protected boolean isMixinTypesIndex() {
        return false;
    }

    protected boolean isNodeNameIndex() {
        return false;
    }

    protected boolean isNodeLocalNameIndex() {
        return false;
    }

    protected boolean isNodeDepthIndex() {
        return false;
    }

    protected boolean isNodePathIndex() {
        return false;
    }

    protected boolean hasSingleColumn() {
        return defn.hasSingleColumn();
    }

    protected IndexColumnDefinition firstColumn() {
        return defn.getColumnDefinition(0);
    }

    protected final Name name( String name ) {
        return context.getValueFactories().getNameFactory().create(name);
    }

    protected final boolean matches( IndexColumnDefinition defn,
                                     Name name ) {
        return defn.getPropertyName().equals(name.getString(context.getNamespaceRegistry()));
    }

    protected final boolean matches( String actual,
                                     Name name ) {
        return actual.equals(name.getString(context.getNamespaceRegistry()));
    }

    protected final boolean isType( PropertyType propType,
                                    PropertyType expected ) {
        return propType == expected;
    }

    protected final boolean isType( PropertyType propType,
                                    PropertyType expected1,
                                    PropertyType expected2 ) {
        return propType == expected1 || propType == expected2;
    }

    protected static class SingleColumnIndexBuilder extends ManagedLocalIndexBuilder {
        private final IndexColumnDefinition columnDefn;
        private final PropertyType type;
        private final Serializer serializer;
        private final BTreeKeySerializer btreeSerializer;
        private final Comparator comparator;
        private final BTreeKeySerializer stringBtreeSerializer;
        private final Comparator stringComparator;
        private final Class clazz;
        private final Converter converter;
        private final Converter stringConverter;
        private final ValueFactory factory;
        private final ValueFactory stringFactory;

        @SuppressWarnings( "unchecked" )
        protected SingleColumnIndexBuilder( ExecutionContext context,
                                            IndexDefinition defn,
                                            Supplier nodeTypesSupplier,
                                            NodeTypePredicate matcher,
                                            PropertyType actualPropertyType ) {
            super(context, defn, nodeTypesSupplier, matcher);
            assert defn.hasSingleColumn();
            columnDefn = defn.getColumnDefinition(0);
            type = actualPropertyType;
            clazz = (Class)type.getValueClass();
            serializer = (Serializer)serializers.serializerFor(clazz);
            comparator = (Comparator)type.getComparator();
            btreeSerializer = (BTreeKeySerializer)serializers.bTreeKeySerializerFor(clazz, comparator, false);
            factory = (ValueFactory)this.context.getValueFactories().getValueFactory(type);
            converter = IndexValues.converter(factory);
            stringComparator = ValueComparators.STRING_COMPARATOR;
            stringFactory = this.context.getValueFactories().getStringFactory();
            stringBtreeSerializer = (BTreeKeySerializer)serializers.bTreeKeySerializerFor(String.class, stringComparator,
                                                                                                  false);
            stringConverter = IndexValues.converter(stringFactory);
        }

        @Override
        protected Serializer getSerializer() {
            return serializer;
        }

        @Override
        protected BTreeKeySerializer getBTreeKeySerializer() {
            return btreeSerializer;
        }

        @Override
        protected Comparator getComparator() {
            return comparator;
        }

        @Override
        protected Class getValueClass() {
            return clazz;
        }

        protected PropertyType getColumnType() {
            return type;
        }

        @Override
        protected Converter getConverter() {
            return converter;
        }

        @Override
        protected boolean isNodeTypesIndex() {
            return defn.getKind() == IndexKind.NODE_TYPE;
        }

        @Override
        protected boolean isPrimaryTypeIndex() {
            return matches(columnDefn, JcrLexicon.PRIMARY_TYPE) && isType(getColumnType(), PropertyType.NAME);
        }

        @Override
        protected boolean isMixinTypesIndex() {
            return matches(columnDefn, JcrLexicon.MIXIN_TYPES) && isType(getColumnType(), PropertyType.NAME);
        }

        @Override
        protected boolean isNodeNameIndex() {
            return matches(columnDefn, JcrLexicon.NAME) && isType(getColumnType(), PropertyType.NAME);
        }

        @Override
        protected boolean isNodeLocalNameIndex() {
            return matches(columnDefn, ModeShapeLexicon.LOCALNAME) && isType(getColumnType(), PropertyType.STRING);
        }

        @Override
        protected boolean isNodeDepthIndex() {
            return matches(columnDefn, ModeShapeLexicon.DEPTH) && isType(getColumnType(), PropertyType.LONG);
        }

        @Override
        protected boolean isNodePathIndex() {
            return matches(columnDefn, JcrLexicon.PATH) && isType(getColumnType(), PropertyType.PATH);
        }

        @Override
        public void validate( Problems problems ) {
            switch (defn.getKind()) {
                case VALUE:
                    if ((matches(columnDefn, JcrLexicon.PATH) && !isType(getColumnType(), PropertyType.PATH))) {
                        problems.addError(JcrI18n.localIndexMustHaveOneColumnOfSpecificType, defn.getProviderName(),
                                          defn.getName(), columnDefn.getPropertyName(), type, PropertyType.PATH);
                    }
                    if ((matches(columnDefn, ModeShapeLexicon.LOCALNAME) && !isType(getColumnType(), PropertyType.STRING))
                        || (matches(columnDefn, ModeShapeLexicon.ID) && !isType(getColumnType(), PropertyType.STRING))) {
                        problems.addError(JcrI18n.localIndexMustHaveOneColumnOfSpecificType, defn.getProviderName(),
                                          defn.getName(), columnDefn.getPropertyName(), type, PropertyType.STRING);
                    }
                    if ((matches(columnDefn, ModeShapeLexicon.DEPTH) && !isType(getColumnType(), PropertyType.LONG))) {
                        problems.addError(JcrI18n.localIndexMustHaveOneColumnOfSpecificType, defn.getProviderName(),
                                          defn.getName(), columnDefn.getPropertyName(), type, PropertyType.LONG);
                    }
                    if ((matches(columnDefn, JcrLexicon.PRIMARY_TYPE) && !isType(getColumnType(), PropertyType.NAME))
                        || (matches(columnDefn, JcrLexicon.MIXIN_TYPES) && !isType(getColumnType(), PropertyType.NAME))
                        || (matches(columnDefn, JcrLexicon.NAME) && !isType(getColumnType(), PropertyType.NAME))) {
                        problems.addError(JcrI18n.localIndexMustHaveOneColumnOfSpecificType, defn.getProviderName(),
                                          defn.getName(), columnDefn.getPropertyName(), type, PropertyType.NAME);
                    }
                    break;
                case UNIQUE_VALUE:
                    break;
                case ENUMERATED_VALUE:
                    break;
                case NODE_TYPE:
                    if (columnDefn.getColumnType() != PropertyType.STRING.jcrType()) {
                        problems.addError(JcrI18n.localIndexMustHaveOneColumnOfSpecificType, defn.getProviderName(),
                                          defn.getName(), columnDefn.getPropertyName(), type, PropertyType.STRING);
                    }
                    break;
                case TEXT:
                    // This is not valid ...
                    problems.addError(JcrI18n.localIndexProviderDoesNotSupportTextIndexes, defn.getProviderName(), defn.getName());
            }
        }

        @SuppressWarnings( "unchecked" )
        @Override
        public ManagedLocalIndex build( String workspaceName,
                                        DB db ) throws LocalIndexException {
            IndexChangeAdapter changeAdapter = null;
            switch (defn.getKind()) {
                case VALUE:
                    assert !isNodeTypesIndex();
                    LocalDuplicateIndex dupIndex = LocalDuplicateIndex.create(indexName(), workspaceName, db, getConverter(),
                                                                                 getSerializer(), getComparator());
                    if (isPrimaryTypeIndex()) {
                        // We know that the value type must be a name ...
                        LocalDuplicateIndex strIndex = (LocalDuplicateIndex)dupIndex;
                        changeAdapter = IndexChangeAdapters.forPrimaryType(context, matcher, workspaceName, strIndex);
                    } else if (isMixinTypesIndex()) {
                        // We know that the value type must be a name ...
                        LocalDuplicateIndex strIndex = (LocalDuplicateIndex)dupIndex;
                        changeAdapter = IndexChangeAdapters.forMixinTypes(context, matcher, workspaceName, strIndex);
                    } else if (isNodeNameIndex()) {
                        // We know that the value type must be a name ...
                        LocalDuplicateIndex strIndex = (LocalDuplicateIndex)dupIndex;
                        changeAdapter = IndexChangeAdapters.forNodeName(context, matcher, workspaceName, strIndex);
                    } else if (isNodeLocalNameIndex()) {
                        // We know that the value type must be a string ...
                        LocalDuplicateIndex strIndex = (LocalDuplicateIndex)dupIndex;
                        changeAdapter = IndexChangeAdapters.forNodeLocalName(context, matcher, workspaceName, strIndex);
                    } else if (isNodePathIndex()) {
                        // We know that the value type must be a path ...
                        LocalDuplicateIndex strIndex = (LocalDuplicateIndex)dupIndex;
                        changeAdapter = IndexChangeAdapters.forNodePath(context, matcher, workspaceName, strIndex);
                    } else if (isNodeDepthIndex()) {
                        // We know that the value type must be a long ...
                        LocalDuplicateIndex strIndex = (LocalDuplicateIndex)dupIndex;
                        changeAdapter = IndexChangeAdapters.forNodeDepth(context, matcher, workspaceName, strIndex);
                    } else {
                        // This is a single type ...
                        Name propertyName = name(firstColumn().getPropertyName());
                        assert propertyName != null;
                        changeAdapter = IndexChangeAdapters.forSingleValuedProperty(context, matcher, workspaceName,
                                                                                    propertyName, factory, dupIndex);
                    }
                    return new ManagedLocalIndex(dupIndex, changeAdapter);
                case UNIQUE_VALUE:
                    // Already validated ...
                    assert !isNodeTypesIndex();
                    assert !isPrimaryTypeIndex();
                    assert !isMixinTypesIndex();
                    LocalUniqueIndex uidx = LocalUniqueIndex.create(indexName(), workspaceName, db, getConverter(),
                                                                       getBTreeKeySerializer(), getSerializer());
                    // This is a single type ...
                    Name propertyName = name(firstColumn().getPropertyName());
                    assert propertyName != null;
                    changeAdapter = IndexChangeAdapters.forUniqueValuedProperty(context, matcher, workspaceName, propertyName,
                                                                                factory, uidx);
                    return new ManagedLocalIndex(uidx, changeAdapter);
                case ENUMERATED_VALUE:
                    // Already validated ...
                    assert !isNodeTypesIndex();
                    assert !isPrimaryTypeIndex();
                    assert !isMixinTypesIndex();

                    // We know that the value type must be a string if this is an enumerated ...
                    propertyName = name(firstColumn().getPropertyName());
                    assert propertyName != null;
                    LocalEnumeratedIndex idx = LocalEnumeratedIndex.create(defn.getName(), workspaceName, db, stringConverter,
                                                                           stringBtreeSerializer);
                    changeAdapter = IndexChangeAdapters.forSingleValuedEnumeratedProperty(context, matcher, workspaceName,
                                                                                          propertyName, idx);
                    return new ManagedLocalIndex(idx, changeAdapter);
                case NODE_TYPE:
                    // We know that the value type must be a string ...
                    idx = LocalEnumeratedIndex.create(defn.getName(), workspaceName, db, stringConverter, stringBtreeSerializer);
                    changeAdapter = IndexChangeAdapters.forNodeTypes(context, matcher, workspaceName, idx);
                    return new ManagedLocalIndex(idx, changeAdapter);
                case TEXT:
                    assert false : "should not ever see this because validation should prevent such indexes from being used";
            }
            assert false : "Should never get here";
            throw new IllegalArgumentException("Unexpected index kind on: " + defn);
        }
    }
}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy