package de.anomic.data; import java.util.Collections; import java.util.Comparator; import java.util.Set; import java.util.TreeSet; import java.util.concurrent.LinkedBlockingQueue; import de.anomic.document.Word; import de.anomic.kelondro.text.IndexCell; import de.anomic.kelondro.text.referencePrototype.WordReference; import de.anomic.yacy.logging.Log; /** * People make mistakes when they type words. * The most common mistakes are the four categories listed below: *
    *
  1. Changing one letter: bat / cat;
  2. *
  3. Adding one letter: bat / boat;
  4. *
  5. Deleting one letter: frog / fog; or
  6. *
  7. Reversing two consecutive letters: two / tow.
  8. *
* DidYouMean provides producer threads, that feed a blocking queue with word variations according to * the above mentioned four categories. Consumer threads check then the generated word variations against a term index. * Only words contained in the term index are return by the getSuggestion method.

* @author apfelmaennchen */ public class DidYouMean { protected static final char[] alphabet = {'a','b','c','d','e','f','g','h','i','j','k','l','m','n','o','p', 'q','r','s','t','u','v','w','x','y','z','\u00e4','\u00f6','\u00fc','\u00df'}; private static final String poisonString = "\n"; public static final int availableCPU = Runtime.getRuntime().availableProcessors(); private static final wordLengthComparator wlComp = new wordLengthComparator(); protected final IndexCell index; protected String word; protected int wordLen; protected LinkedBlockingQueue guessGen, guessLib; protected long timeLimit; protected boolean createGen; // keeps the value 'true' as long as no entry in guessLib is written protected final Set resultSet; /** * @param index a termIndex - most likely retrieved from a switchboard object. * @param sort true/false - sorts the resulting TreeSet by index.count(); Warning: this causes heavy i/o. */ public DidYouMean(final IndexCell index, boolean sort) { if(sort) this.resultSet = Collections.synchronizedSortedSet(new TreeSet(new indexSizeComparator())); else this.resultSet = Collections.synchronizedSortedSet(new TreeSet(wlComp)); this.word = ""; this.wordLen = 0; this.index = index; this.guessGen = new LinkedBlockingQueue(); this.guessLib = new LinkedBlockingQueue(); this.createGen = true; } /** * @param index a termIndex - most likely retrieved from a switchboard object. */ public DidYouMean(final IndexCell index) { this(index, false); } /** * This method triggers the producer and consumer threads of DidYouMean. *

Note: the default timeout is 500ms * @param word a String with a single word * @return a Set<String> with word variations contained in index. */ public Set getSuggestion(final String word) { return getSuggestion(word, 500); } /** * This method triggers the producer and consumer threads of the DidYouMean object. * @param word a String with a single word * @param timeout execution time in ms. * @return a Set<String> with word variations contained in term index. */ public Set getSuggestion(final String word, long timeout) { long startTime = System.currentTimeMillis(); this.timeLimit = startTime + timeout; this.word = word.toLowerCase(); this.wordLen = word.length(); // create one consumer thread that checks the guessLib queue // for occurrences in the index. If the producers are started next, their // results can be consumers directly Consumer[] consumers = new Consumer[availableCPU]; consumers[0] = new Consumer(); consumers[0].start(); // get a single recommendation for the word without altering the word Set libr = LibraryProvider.dymLib.recommend(word); for (String t: libr) { if (!t.equals(word)) try { createGen = false; guessLib.put(t); } catch (InterruptedException e) {} } // create and start producers // the CPU load to create the guessed words is very low, but the testing // against the library may be CPU intensive. Since it is possible to test // words in the library concurrently, it is a good idea to start separate threads Thread[] producers = new Thread[4]; producers[0] = new ChangingOneLetter(); producers[1] = new AddingOneLetter(); producers[2] = new DeletingOneLetter(); producers[3] = new ReversingTwoConsecutiveLetters(); for (Thread t: producers) t.start(); // start more consumers if there are more cores if (consumers.length > 1) for (int i = 1; i < consumers.length; i++) { consumers[i] = new Consumer(); consumers[i].start(); } // now decide which kind of guess is better // we take guessLib entries as long as there is any entry in it // to see if this is the case, we must wait for termination of the producer for (Thread t: producers) try { t.join(); } catch (InterruptedException e) {} // if there is not any entry in guessLib, then transfer all entries from the // guessGen to guessLib if (createGen) try { this.guessGen.put(poisonString); String s; while ((s = this.guessGen.take()) != poisonString) this.guessLib.put(s); } catch (InterruptedException e) {} // put poison into guessLib to terminate consumers for (@SuppressWarnings("unused") Consumer c: consumers) try { guessLib.put(poisonString); } catch (InterruptedException e) {} // wait for termination of consumer for (Consumer c: consumers) try { c.join(); } catch (InterruptedException e) {} // we don't want the given word in the result this.resultSet.remove(word.toLowerCase()); // finished Log.logInfo("DidYouMean", "found "+this.resultSet.size()+" terms; execution time: " +(System.currentTimeMillis()-startTime)+"ms"+ " - remaining queue size: "+guessLib.size()); return this.resultSet; } /** * DidYouMean's producer thread that changes one letter (e.g. bat/cat) for a given term * based on the given alphabet and puts it on the blocking queue, to be 'consumed' by a consumer thread.

* Note: the loop runs (alphabet.length * len) tests. */ public class ChangingOneLetter extends Thread { public void run() { String s; Set libr; for (int i = 0; i < wordLen; i++) try { for (char c: alphabet) { s = word.substring(0, i) + c + word.substring(i + 1); libr = LibraryProvider.dymLib.recommend(s); if (libr.size() != 0) createGen = false; for (String t: libr) guessLib.put(t); if (createGen) guessGen.put(s); if (System.currentTimeMillis() > timeLimit) return; } } catch (InterruptedException e) {} } } /** * DidYouMean's producer thread that deletes extra letters (e.g. frog/fog) for a given term * and puts it on the blocking queue, to be 'consumed' by a consumer thread.

* Note: the loop runs (len) tests. */ protected class DeletingOneLetter extends Thread { public void run() { String s; Set libr; for (int i = 0; i < wordLen; i++) try { s = word.substring(0, i) + word.substring(i+1); libr = LibraryProvider.dymLib.recommend(s); if (libr.size() != 0) createGen = false; for (String t: libr) guessLib.put(t); if (createGen) guessGen.put(s); if (System.currentTimeMillis() > timeLimit) return; } catch (InterruptedException e) {} } } /** * DidYouMean's producer thread that adds missing letters (e.g. bat/boat) for a given term * based on the given alphabet and puts it on the blocking queue, to be 'consumed' by a consumer thread.

* Note: the loop runs (alphabet.length * len) tests. */ protected class AddingOneLetter extends Thread { public void run() { String s; Set libr; for (int i = 0; i <= wordLen; i++) try { for (char c: alphabet) { s = word.substring(0, i) + c + word.substring(i); libr = LibraryProvider.dymLib.recommend(s); if (libr.size() != 0) createGen = false; for (String t: libr) guessLib.put(t); if (createGen) guessGen.put(s); if (System.currentTimeMillis() > timeLimit) return; } } catch (InterruptedException e) {} } } /** * DidYouMean's producer thread that reverses any two consecutive letters (e.g. two/tow) for a given term * and puts it on the blocking queue, to be 'consumed' by a consumer thread.

* Note: the loop runs (len-1) tests. */ protected class ReversingTwoConsecutiveLetters extends Thread { public void run() { String s; Set libr; for (int i = 0; i < wordLen - 1; i++) try { s = word.substring(0, i) + word.charAt(i + 1) + word.charAt(i) + word.substring(i +2); libr = LibraryProvider.dymLib.recommend(s); if (libr.size() != 0) createGen = false; for (String t: libr) guessLib.put(t); if (createGen) guessGen.put(s); if (System.currentTimeMillis() > timeLimit) return; } catch (InterruptedException e) {} } } /** * DidYouMean's consumer thread takes a String object (term) from the blocking queue * and checks if it is contained in YaCy's RWI index. * Note: this causes no or moderate i/o as it uses the efficient index.has() method. */ class Consumer extends Thread { public void run() { String s; try { while ((s = guessLib.take()) != poisonString) { if (index.has(Word.word2hash(s))) resultSet.add(s); if (System.currentTimeMillis() > timeLimit) return; } } catch (InterruptedException e) {} } } /** * indexSizeComparator is used by DidYouMean to order terms by index.count()

* Warning: this causes heavy i/o */ protected class indexSizeComparator implements Comparator { public int compare(final String o1, final String o2) { final int i1 = index.count(Word.word2hash(o1)); final int i2 = index.count(Word.word2hash(o2)); if (i1 == i2) return o1.compareTo(o2); return (i1 < i2) ? 1 : -1; // '<' is correct, because the largest count shall be ordered to be the first position in the result } } /** * wordLengthComparator is used by DidYouMean to order terms by the term length

* This is the default order if the indexSizeComparator is not used */ protected static class wordLengthComparator implements Comparator { public int compare(final String o1, final String o2) { final int i1 = o1.length(); final int i2 = o2.length(); if (i1 == i2) return o1.compareTo(o2); return (i1 > i2) ? 1 : -1; // '>' is correct, because the shortest word shall be first } } }