Package org.apache.commons.text.similarity

Class SimilarityScoreFrom<R>

  • Type Parameters:
    R - This is the type of similarity score used by the SimilarityScore function.
    public class SimilarityScoreFrom<R>
extends Object

    This stores a SimilarityScore implementation and a CharSequence "left" string. The apply(CharSequence right) method accepts the "right" string and invokes the comparison function for the pair of strings.

    The following is an example which finds the most similar string: 

     SimilarityScore<Integer> similarityScore = new LevenshteinDistance();
 String target = "Apache";
 SimilarityScoreFrom<Integer> similarityScoreFrom =
     new SimilarityScoreFrom<Integer>(similarityScore, target);
 String mostSimilar = null;
 Integer shortestDistance = null;

 for (String test : new String[] { "Appaloosa", "a patchy", "apple" }) {
     Integer distance = similarityScoreFrom.apply(test);
     if (shortestDistance == null || distance < shortestDistance) {
         shortestDistance = distance;
         mostSimilar = test;
     }
 }

 System.out.println("The string most similar to \"" + target + "\" "
     + "is \"" + mostSimilar + "\" because "
     + "its distance is only " + shortestDistance + ".");
    Since:
    1.0

    • Constructor Detail

      • SimilarityScoreFrom

        public SimilarityScoreFrom​(SimilarityScore<R> similarityScore,
                           CharSequence left)

        This accepts the similarity score implementation and the "left" string.

        Parameters:
        similarityScore - This may not be null.
        left - This may be null here, but the SimilarityScore#compare(CharSequence left, CharSequence right) implementation may not accept nulls.

    • Method Detail

      • apply

        public R apply​(CharSequence right)

        This compares "left" field against the "right" parameter using the "similarity score" implementation.

        Parameters:
        right - the second CharSequence
        Returns:
        The similarity score between two CharSequences

      • getLeft

        public CharSequence getLeft()
        Gets the left parameter.
        Returns:
        The left parameter

      • getSimilarityScore

        public SimilarityScore<R> getSimilarityScore()
        Gets the edit distance.
        Returns:
        The edit distance