/* * 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. */ using System; using Directory = Lucene.Net.Store.Directory; using IndexInput = Lucene.Net.Store.IndexInput; using IndexOutput = Lucene.Net.Store.IndexOutput; namespace Lucene.Net.Index { [Serializable] public sealed class SegmentInfos : System.Collections.ArrayList { private class AnonymousClassFindSegmentsFile:FindSegmentsFile { private void InitBlock(SegmentInfos enclosingInstance) { this.enclosingInstance = enclosingInstance; } private SegmentInfos enclosingInstance; public SegmentInfos Enclosing_Instance { get { return enclosingInstance; } } internal AnonymousClassFindSegmentsFile(SegmentInfos enclosingInstance, Lucene.Net.Store.Directory Param1):base(Param1) { InitBlock(enclosingInstance); } public override System.Object DoBody(System.String segmentFileName) { Enclosing_Instance.Read(directory, segmentFileName); return null; } } private class AnonymousClassFindSegmentsFile1:FindSegmentsFile { internal AnonymousClassFindSegmentsFile1(Lucene.Net.Store.Directory Param1):base(Param1) { } public override System.Object DoBody(System.String segmentFileName) { IndexInput input = directory.OpenInput(segmentFileName); int format = 0; long version = 0; try { format = input.ReadInt(); if (format < 0) { if (format < Lucene.Net.Index.SegmentInfos.FORMAT_SINGLE_NORM_FILE) throw new System.IO.IOException("Unknown format version: " + format); version = input.ReadLong(); // read version } } finally { input.Close(); } if (format < 0) return (long) version; // We cannot be sure about the format of the file. // Therefore we have to read the whole file and cannot simply seek to the version entry. SegmentInfos sis = new SegmentInfos(); sis.Read(directory, segmentFileName); return (long) sis.GetVersion(); } } /// The file format version, a negative number. /* Works since counter, the old 1st entry, is always >= 0 */ public const int FORMAT = - 1; /// This format adds details used for lockless commits. It differs /// slightly from the previous format in that file names /// are never re-used (write once). Instead, each file is /// written to the next generation. For example, /// segments_1, segments_2, etc. This allows us to not use /// a commit lock. See file /// formats for details. /// public const int FORMAT_LOCKLESS = - 2; /// This is the current file format written. It adds a /// "hasSingleNormFile" flag into each segment info. /// See LUCENE-756 /// for details. /// public const int FORMAT_SINGLE_NORM_FILE = - 3; public int counter = 0; // used to name new segments /// counts how often the index has been changed by adding or deleting docs. /// starting with the current time in milliseconds forces to create unique version numbers. /// private long version = System.DateTime.Now.Millisecond; private long generation = 0; // generation of the "segments_N" for the next commit private long lastGeneration = 0; // generation of the "segments_N" file we last successfully read // or wrote; this is normally the same as generation except if // there was an IOException that had interrupted a commit /// If non-null, information about loading segments_N files /// /// private static System.IO.TextWriter infoStream; public SegmentInfo Info(int i) { return (SegmentInfo) this[i]; } /// Get the generation (N) of the current segments_N file /// from a list of files. /// /// /// -- array of file names to check /// public static long GetCurrentSegmentGeneration(System.String[] files) { if (files == null) { return - 1; } long max = - 1; int prefixLen = IndexFileNames.SEGMENTS.Length + 1; for (int i = 0; i < files.Length; i++) { System.String file = (new System.IO.FileInfo(files[i])).Name; if (file.StartsWith(IndexFileNames.SEGMENTS) && !file.Equals(IndexFileNames.SEGMENTS_GEN)) { if (file.Equals(IndexFileNames.SEGMENTS)) { // Pre lock-less commits: if (max == - 1) { max = 0; } } else { #if !PRE_LUCENE_NET_2_0_0_COMPATIBLE long v = Lucene.Net.Documents.NumberTools.ToLong(file.Substring(prefixLen)); #else long v = System.Convert.ToInt64(file.Substring(prefixLen), 16); #endif if (v > max) { max = v; } } } } return max; } /// Get the generation (N) of the current segments_N file /// in the directory. /// /// /// -- directory to search for the latest segments_N file /// public static long GetCurrentSegmentGeneration(Directory directory) { System.String[] files = directory.List(); if (files == null) { throw new System.IO.IOException("Cannot read directory " + directory); } return GetCurrentSegmentGeneration(files); } /// Get the filename of the current segments_N file /// from a list of files. /// /// /// -- array of file names to check /// public static System.String GetCurrentSegmentFileName(System.String[] files) { return IndexFileNames.FileNameFromGeneration(IndexFileNames.SEGMENTS, "", GetCurrentSegmentGeneration(files)); } /// Get the filename of the current segments_N file /// in the directory. /// /// /// -- directory to search for the latest segments_N file /// public static System.String GetCurrentSegmentFileName(Directory directory) { return IndexFileNames.FileNameFromGeneration(IndexFileNames.SEGMENTS, "", GetCurrentSegmentGeneration(directory)); } /// Get the segments_N filename in use by this segment infos. public System.String GetCurrentSegmentFileName() { return IndexFileNames.FileNameFromGeneration(IndexFileNames.SEGMENTS, "", lastGeneration); } /// Get the next segments_N filename that will be written. public System.String GetNextSegmentFileName() { long nextGeneration; if (generation == - 1) { nextGeneration = 1; } else { nextGeneration = generation + 1; } return IndexFileNames.FileNameFromGeneration(IndexFileNames.SEGMENTS, "", nextGeneration); } /// Read a particular segmentFileName. Note that this may /// throw an IOException if a commit is in process. /// /// /// -- directory containing the segments file /// /// -- segment file to load /// public void Read(Directory directory, System.String segmentFileName) { bool success = false; IndexInput input = directory.OpenInput(segmentFileName); if (segmentFileName.Equals(IndexFileNames.SEGMENTS)) { generation = 0; } else { #if !PRE_LUCENE_NET_2_0_0_COMPATIBLE generation = Lucene.Net.Documents.NumberTools.ToLong(segmentFileName.Substring(1 + IndexFileNames.SEGMENTS.Length)); #else generation = System.Convert.ToInt64(segmentFileName.Substring(1 + IndexFileNames.SEGMENTS.Length), 16); #endif } lastGeneration = generation; try { int format = input.ReadInt(); if (format < 0) { // file contains explicit format info // check that it is a format we can understand if (format < FORMAT_SINGLE_NORM_FILE) throw new System.IO.IOException("Unknown format version: " + format); version = input.ReadLong(); // read version counter = input.ReadInt(); // read counter } else { // file is in old format without explicit format info counter = format; } for (int i = input.ReadInt(); i > 0; i--) { // read segmentInfos Add(new SegmentInfo(directory, format, input)); } if (format >= 0) { // in old format the version number may be at the end of the file if (input.GetFilePointer() >= input.Length()) version = System.DateTime.Now.Millisecond; // old file format without version number else version = input.ReadLong(); // read version } success = true; } finally { input.Close(); if (!success) { // Clear any segment infos we had loaded so we // have a clean slate on retry: Clear(); } } } /// This version of read uses the retry logic (for lock-less /// commits) to find the right segments file to load. /// public void Read(Directory directory) { generation = lastGeneration = - 1; new AnonymousClassFindSegmentsFile(this, directory).run(); } public void Write(Directory directory) { System.String segmentFileName = GetNextSegmentFileName(); // Always advance the generation on write: if (generation == - 1) { generation = 1; } else { generation++; } IndexOutput output = directory.CreateOutput(segmentFileName); try { output.WriteInt(FORMAT_SINGLE_NORM_FILE); // write FORMAT output.WriteLong(++version); // every write changes // the index output.WriteInt(counter); // write counter output.WriteInt(Count); // write infos for (int i = 0; i < Count; i++) { Info(i).Write(output); } } finally { output.Close(); } try { output = directory.CreateOutput(IndexFileNames.SEGMENTS_GEN); try { output.WriteInt(FORMAT_LOCKLESS); output.WriteLong(generation); output.WriteLong(generation); } finally { output.Close(); } } catch (System.IO.IOException e) { // It's OK if we fail to write this file since it's // used only as one of the retry fallbacks. } lastGeneration = generation; } /// Returns a copy of this instance, also copying each /// SegmentInfo. /// public override System.Object Clone() { SegmentInfos sis = new SegmentInfos(); // Copy Fields. const and static fields are ignored sis.counter = this.counter; sis.version = this.version; sis.generation = this.generation; sis.lastGeneration = this.lastGeneration; for (int i = 0; i < this.Count; i++) { sis.Add(((SegmentInfo)this[i]).Clone()); } return sis; } /// version number when this SegmentInfos was generated. public long GetVersion() { return version; } /// Current version number from segments file. public static long ReadCurrentVersion(Directory directory) { return (long) ((System.Int64) new AnonymousClassFindSegmentsFile1(directory).run()); } /// If non-null, information about retries when loading /// the segments file will be printed to this. /// public static void SetInfoStream(System.IO.TextWriter infoStream) { SegmentInfos.infoStream = infoStream; } /* Advanced configuration of retry logic in loading segments_N file */ private static int defaultGenFileRetryCount = 10; private static int defaultGenFileRetryPauseMsec = 50; private static int defaultGenLookaheadCount = 10; /// Advanced: set how many times to try loading the /// segments.gen file contents to determine current segment /// generation. This file is only referenced when the /// primary method (listing the directory) fails. /// public static void SetDefaultGenFileRetryCount(int count) { defaultGenFileRetryCount = count; } /// /// public static int GetDefaultGenFileRetryCount() { return defaultGenFileRetryCount; } /// Advanced: set how many milliseconds to pause in between /// attempts to load the segments.gen file. /// public static void SetDefaultGenFileRetryPauseMsec(int msec) { defaultGenFileRetryPauseMsec = msec; } /// /// public static int GetDefaultGenFileRetryPauseMsec() { return defaultGenFileRetryPauseMsec; } /// Advanced: set how many times to try incrementing the /// gen when loading the segments file. This only runs if /// the primary (listing directory) and secondary (opening /// segments.gen file) methods fail to find the segments /// file. /// public static void SetDefaultGenLookaheadCount(int count) { defaultGenLookaheadCount = count; } /// /// public static int GetDefaultGenLookahedCount() { return defaultGenLookaheadCount; } /// /// public static System.IO.TextWriter GetInfoStream() { return infoStream; } private static void Message(System.String message) { if (infoStream != null) { infoStream.WriteLine(SupportClass.ThreadClass.Current().Name + ": " + message); } } /// Utility class for executing code that needs to do /// something with the current segments file. This is /// necessary with lock-less commits because from the time /// you locate the current segments file name, until you /// actually open it, read its contents, or check modified /// time, etc., it could have been deleted due to a writer /// commit finishing. /// public abstract class FindSegmentsFile { internal System.IO.FileInfo fileDirectory; internal Directory directory; public FindSegmentsFile(System.IO.FileInfo directory) { this.fileDirectory = directory; } public FindSegmentsFile(Directory directory) { this.directory = directory; } public System.Object run() { System.String segmentFileName = null; long lastGen = - 1; long gen = 0; int genLookaheadCount = 0; System.IO.IOException exc = null; bool retry = false; int method = 0; // Loop until we succeed in calling doBody() without // hitting an IOException. An IOException most likely // means a commit was in process and has finished, in // the time it took us to load the now-old infos files // (and segments files). It's also possible it's a // true error (corrupt index). To distinguish these, // on each retry we must see "forward progress" on // which generation we are trying to load. If we // don't, then the original error is real and we throw // it. // We have three methods for determining the current // generation. We try each in sequence. while (true) { // Method 1: list the directory and use the highest // segments_N file. This method works well as long // as there is no stale caching on the directory // contents: System.String[] files = null; if (0 == method) { if (directory != null) { files = directory.List(); } else { files = System.IO.Directory.GetFileSystemEntries(fileDirectory.FullName); for (int i = 0; i < files.Length; i++) { System.IO.FileInfo fi = new System.IO.FileInfo(files[i]); files[i] = fi.Name; } } gen = Lucene.Net.Index.SegmentInfos.GetCurrentSegmentGeneration(files); if (gen == - 1) { System.String s = ""; for (int i = 0; i < files.Length; i++) { s += (" " + files[i]); } throw new System.IO.FileNotFoundException("no segments* file found: files:" + s); } } // Method 2 (fallback if Method 1 isn't reliable): // if the directory listing seems to be stale, then // try loading the "segments.gen" file. if (1 == method || (0 == method && lastGen == gen && retry)) { method = 1; for (int i = 0; i < Lucene.Net.Index.SegmentInfos.defaultGenFileRetryCount; i++) { IndexInput genInput = null; try { genInput = directory.OpenInput(IndexFileNames.SEGMENTS_GEN); } catch (System.IO.IOException e) { Lucene.Net.Index.SegmentInfos.Message("segments.gen open: IOException " + e); } if (genInput != null) { try { int version = genInput.ReadInt(); if (version == Lucene.Net.Index.SegmentInfos.FORMAT_LOCKLESS) { long gen0 = genInput.ReadLong(); long gen1 = genInput.ReadLong(); Lucene.Net.Index.SegmentInfos.Message("fallback check: " + gen0 + "; " + gen1); if (gen0 == gen1) { // The file is consistent. if (gen0 > gen) { Lucene.Net.Index.SegmentInfos.Message("fallback to '" + IndexFileNames.SEGMENTS_GEN + "' check: now try generation " + gen0 + " > " + gen); gen = gen0; } break; } } } catch (System.IO.IOException err2) { // will retry } finally { genInput.Close(); } } try { System.Threading.Thread.Sleep(new System.TimeSpan((System.Int64) 10000 * Lucene.Net.Index.SegmentInfos.defaultGenFileRetryPauseMsec)); } catch (System.Threading.ThreadInterruptedException e) { // will retry } } } // Method 3 (fallback if Methods 2 & 3 are not // reliable): since both directory cache and file // contents cache seem to be stale, just advance the // generation. if (2 == method || (1 == method && lastGen == gen && retry)) { method = 2; if (genLookaheadCount < Lucene.Net.Index.SegmentInfos.defaultGenLookaheadCount) { gen++; genLookaheadCount++; Lucene.Net.Index.SegmentInfos.Message("look ahead increment gen to " + gen); } } if (lastGen == gen) { // This means we're about to try the same // segments_N last tried. This is allowed, // exactly once, because writer could have been in // the process of writing segments_N last time. if (retry) { // OK, we've tried the same segments_N file // twice in a row, so this must be a real // error. We throw the original exception we // got. throw exc; } else { retry = true; } } else { // Segment file has advanced since our last loop, so // reset retry: retry = false; } lastGen = gen; segmentFileName = IndexFileNames.FileNameFromGeneration(IndexFileNames.SEGMENTS, "", gen); try { System.Object v = DoBody(segmentFileName); if (exc != null) { Lucene.Net.Index.SegmentInfos.Message("success on " + segmentFileName); } return v; } catch (System.IO.IOException err) { // Save the original root cause: if (exc == null) { exc = err; } Lucene.Net.Index.SegmentInfos.Message("primary Exception on '" + segmentFileName + "': " + err + "'; will retry: retry=" + retry + "; gen = " + gen); if (!retry && gen > 1) { // This is our first time trying this segments // file (because retry is false), and, there is // possibly a segments_(N-1) (because gen > 1). // So, check if the segments_(N-1) exists and // try it if so: System.String prevSegmentFileName = IndexFileNames.FileNameFromGeneration(IndexFileNames.SEGMENTS, "", gen - 1); if (directory.FileExists(prevSegmentFileName)) { Lucene.Net.Index.SegmentInfos.Message("fallback to prior segment file '" + prevSegmentFileName + "'"); try { System.Object v = DoBody(prevSegmentFileName); if (exc != null) { Lucene.Net.Index.SegmentInfos.Message("success on fallback " + prevSegmentFileName); } return v; } catch (System.IO.IOException err2) { Lucene.Net.Index.SegmentInfos.Message("secondary Exception on '" + prevSegmentFileName + "': " + err2 + "'; will retry"); } } } } } } /// Subclass must implement this. The assumption is an /// IOException will be thrown if something goes wrong /// during the processing that could have been caused by /// a writer committing. /// public abstract System.Object DoBody(System.String segmentFileName); } } }