package org.infinispan.lucene.impl; import java.io.Closeable; import java.io.IOException; import javax.transaction.Transaction; import javax.transaction.TransactionManager; import org.apache.lucene.store.Lock; import org.infinispan.Cache; import org.infinispan.commons.CacheException; import org.infinispan.context.Flag; import org.infinispan.lucene.FileCacheKey; import org.infinispan.lucene.logging.Log; import org.infinispan.util.logging.LogFactory; /** * Inter-IndexWriter Lucene index lock based on Infinispan. * There are pros and cons about using this implementation, please see javadoc on * the factory class <code>org.infinispan.lucene.locking.TransactionalLockFactory</code> * * @since 4.0 * @author Sanne Grinovero * @see TransactionalLockFactory * @see org.apache.lucene.store.Lock */ @SuppressWarnings("unchecked") class TransactionalSharedLuceneLock extends Lock implements Closeable, ObtainableLock { private static final Log log = LogFactory.getLog(TransactionalSharedLuceneLock.class, Log.class); private static final boolean trace = log.isTraceEnabled(); private final Cache<FileCacheKey, FileCacheKey> noCacheStoreCache; private final String lockName; private final String indexName; private final TransactionManager tm; private final FileCacheKey keyOfLock; TransactionalSharedLuceneLock(Cache<?, ?> cache, String indexName, String lockName, TransactionManager tm) { this.noCacheStoreCache = (Cache<FileCacheKey, FileCacheKey>) cache.getAdvancedCache().withFlags(Flag.SKIP_CACHE_STORE, Flag.SKIP_CACHE_LOAD, Flag.SKIP_INDEXING); this.lockName = lockName; this.indexName = indexName; this.tm = tm; this.keyOfLock = new FileCacheKey(indexName, lockName, -1); } @Override public boolean obtain() throws IOException { Object previousValue = noCacheStoreCache.putIfAbsent(keyOfLock, keyOfLock); if (previousValue == null) { if (trace) { log.tracef("Lock: %s acquired for index: %s", lockName, indexName); } // we own the lock: startTransaction(); return true; } else { if (trace) { log.tracef("Lock: %s not acquired for index: %s, was taken already.", lockName, indexName); } return false; } } /** * Removes the lock, without committing pending changes or involving transactions. Used by Lucene * at Directory creation: we expect the lock to not exist in this case. */ private void clearLock() { Object previousValue = noCacheStoreCache.remove(keyOfLock); if (previousValue!=null && trace) { log.tracef("Lock removed for index: %s", indexName); } } public boolean isLocked() { boolean locked = false; Transaction tx = null; try { // if there is an ongoing transaction we need to suspend it if ((tx = tm.getTransaction()) != null) { tm.suspend(); } locked = noCacheStoreCache.containsKey(keyOfLock); } catch (Exception e) { log.errorSuspendingTransaction(e); } finally { if (tx != null) { try { tm.resume(tx); } catch (Exception e) { throw new CacheException("Unable to resume suspended transaction " + tx, e); } } } return locked; } /** * Starts a new transaction. Used to batch changes in LuceneDirectory: * a transaction is created at lock acquire, and closed on release. * It's also committed and started again at each IndexWriter.commit(); * * @throws IOException wraps Infinispan exceptions to adapt to Lucene's API */ private void startTransaction() throws IOException { try { tm.begin(); } catch (Exception e) { log.unableToStartTransaction(e); throw new IOException("SharedLuceneLock could not start a transaction after having acquired the lock", e); } if (trace) { log.tracef("Batch transaction started for index: %s", indexName); } } /** * Commits the existing transaction. * It's illegal to call this if a transaction was not started. * * @throws IOException wraps Infinispan exceptions to adapt to Lucene's API */ private void commitTransactions() throws IOException { try { tm.commit(); } catch (Exception e) { log.unableToCommitTransaction(e); throw new IOException("SharedLuceneLock could not commit a transaction", e); } if (trace) { log.tracef("Batch transaction committed for index: %s", indexName); } } /** * Will clear the lock, eventually suspending a running transaction to make sure the * release is immediately taking effect. */ public void clearLockSuspending() { Transaction tx = null; try { // if there is an ongoing transaction we need to suspend it if ((tx = tm.getTransaction()) != null) { tm.suspend(); } clearLock(); } catch (Exception e) { log.errorSuspendingTransaction(e); } finally { if (tx != null) { try { tm.resume(tx); } catch (Exception e) { throw new CacheException("Unable to resume suspended transaction " + tx, e); } } } } /** * Since Lucene 4.7, method release() was renamed to close() * @deprecated use method close(). */ @Deprecated public void release() throws IOException { close(); } @Override public void close() throws IOException { try { commitTransactions(); } finally { clearLock(); } } @Override public void ensureValid() throws IOException { if (!isLocked()) { throw new IOException("This lock is no longer being held"); } } }