/* * Hibernate, Relational Persistence for Idiomatic Java * * Copyright (c) 2010, Red Hat, Inc. and/or its affiliates or third-party contributors as * indicated by the @author tags or express copyright attribution * statements applied by the authors. All third-party contributions are * distributed under license by Red Hat, Inc. * * This copyrighted material is made available to anyone wishing to use, modify, * copy, or redistribute it subject to the terms and conditions of the GNU * Lesser General Public License, as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License * for more details. * * You should have received a copy of the GNU Lesser General Public License * along with this distribution; if not, write to: * Free Software Foundation, Inc. * 51 Franklin Street, Fifth Floor * Boston, MA 02110-1301 USA */ package org.hibernate.search.store.impl; import java.io.File; import java.io.IOException; import java.util.Properties; import org.apache.lucene.store.FSDirectory; import org.hibernate.search.indexes.impl.DirectoryBasedIndexManager; import org.hibernate.search.store.DirectoryProvider; import org.hibernate.search.util.logging.impl.Log; import org.hibernate.search.SearchException; import org.hibernate.search.spi.BuildContext; import org.hibernate.search.util.logging.impl.LoggerFactory; /** * Use a Lucene {@link FSDirectory}. The base directory is represented by the property <i>hibernate.search.default.indexBase</i> * or <i>hibernate.search.<index>.indexBase</i>. The former defines the default base directory for all indexes whereas the * latter allows to override the base directory on a per index basis.<i> <index></i> has to be replaced with the fully qualified * classname of the indexed class or the value of the <i>index</i> property of the <code>@Indexed</code> annotation. * <p> * The actual index files are then created in <i><indexBase>/<index name></i>, <i><index name></i> is * per default the name of the indexed entity, or the value of the <i>index</i> property of the <code>@Indexed</code> or can be specified * as property in the configuration file using <i>hibernate.search.<index>.indexName</i>. * </p> * * @author Emmanuel Bernard * @author Sylvain Vieujot * @author Sanne Grinovero */ public class FSDirectoryProvider implements DirectoryProvider<FSDirectory> { private static final Log log = LoggerFactory.make(); private FSDirectory directory; private String indexName; @Override public void initialize(String directoryProviderName, Properties properties, BuildContext context) { // on "manual" indexing skip read-write check on index directory boolean manual = context.getIndexingStrategy().equals( "manual" ); File indexDir = DirectoryProviderHelper.getVerifiedIndexDir( directoryProviderName, properties, !manual ); try { indexName = indexDir.getCanonicalPath(); //this is cheap so it's not done in start() directory = DirectoryProviderHelper.createFSIndex( indexDir, properties ); } catch ( IOException e ) { throw new SearchException( "Unable to initialize index: " + directoryProviderName, e ); } } @Override public void start(DirectoryBasedIndexManager indexManager) { //all the process is done in initialize } public void stop() { try { directory.close(); } catch ( Exception e ) { log.unableToCloseLuceneDirectory( directory.getDirectory(), e ); } } public FSDirectory getDirectory() { return directory; } @Override public boolean equals(Object obj) { // this code is actually broken since the value change after initialize call // but from a practical POV this is fine since we only call this method // after initialize call if ( obj == this ) { return true; } if ( obj == null || !( obj instanceof FSDirectoryProvider ) ) { return false; } return indexName.equals( ( (FSDirectoryProvider) obj ).indexName ); } @Override public int hashCode() { // this code is actually broken since the value change after initialize call // but from a practical POV this is fine since we only call this method // after initialize call int hash = 11; return 37 * hash + indexName.hashCode(); } }