Package net.sf.okapi.lib.translation

Class QueryManager

  • All Implemented Interfaces:
    Iterator<QueryResult>
    public class QueryManager
extends Object
implements Iterator<QueryResult>
    Provides a wrapper to manage and query several translation resources at the same time. For example, a local TM, a remote TM and a Machine Translation server.

    • Constructor Summary

      Constructors 
      Constructor Description
      QueryManager()
      Creates a new QueryManager object.

    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      int addAndInitializeResource​(String connectorClass, String resourceName, ClassLoader loader, String connectorParams)
      Creates a translation resource and its parameters from their class names, adds it to the manager and initializes it with the current source and target language of this manager, as well as any attributes that is set, and the current threshold and maximum hits if it is relevant.
      int addAndInitializeResource​(String connectorClass, String resourceName, String connectorParams)
      Creates a translation resource and its parameters from their class names, adds it to the manager and initializes it with the current source and target language of this manager, as well as any attributes that is set, and the current threshold and maximum hits if it is relevant.
      int addAndInitializeResource​(IQuery connector, String resourceName, IParameters params)
      Adds a translation resource to the manager and initializes it with the current source and target language of this manager, as well as any attributes that is set, and the current threshold and maximum hits if it is relevant.
      int addResource​(IQuery connector, String name)
      Adds a translation resource to the manager.
      static boolean canLeverage​(Segment srcSeg, Segment trgSeg, boolean leverageIfTargetIsEmpty, boolean leverageIfTargetIsSameAsSource)
      Indicates if we can fill a given target segment with leveraged translation based on whether it is empty and whether it is the same as the source segment.
      static boolean canLeverage​(TextContainer srcTc, TextContainer trgTc, boolean leverageIfTargetIsEmpty, boolean leverageIfTargetIsSameAsSource)
      Indicates if we can fill a given target TextContent with leveraged translation based on whether it is empty and whether it is the same as the source TextContent.
      void clearAttributes()
      Removes all attributes from this manager and all the translation resources in this manager.
      void close()
      Closes all translation resources in this manager.
      int getExactBestMatches()
      Gets the number of best matches that are exact (100%) since the last call to resetCounters().
      int getFuzzyBestMatches()
      Gets the number of best matches that are fuzzy (less that 100%, more than 0%) since the last call to resetCounters().
      IQuery getInterface​(int resourceId)
      Gets the IQuery interface for a given translation resource.
      String getName​(int resourceId)
      Gets the name for a given translation resource.
      ResourceItem getResource​(int resourceId)
      Gets the configuration data for a given translation resource.
      Map<Integer,​ResourceItem> getResources()
      Gets the configuration data for all the translation resources in this manager.
      List<QueryResult> getResults()
      Gets the list of all hit results of the last query.
      LocaleId getSourceLanguage()
      Gets the current source locale for this manager.
      LocaleId getTargetLanguage()
      Gets the current target locale for this manager.
      int getTotalSegments()
      Gets the total number of segments processed since the last call to resetCounters().
      boolean hasNext()
      Indicates of there is a hit available.
      void leverage​(ITextUnit tu)
      Leverages a text unit (segmented or not) based on the current settings.
      QueryResult next()
      Gets the next hit for the last query.
      int query​(String plainText)
      Queries all enabled translation resources for a given plain text.
      int query​(TextFragment text)
      Queries all enabled translation resources for a given text fragment.
      void remove​(int resourceId)
      Removes a given translation resource.
      void removeAttribute​(String name)
      Removes a given attribute from this manager and all translation resources in this manager.
      void resetCounters()
      Resets the counters used to calculate the number of segments leveraged.
      void rewind()
      Resets the current result to the first one if there is one.
      void setAttribute​(String name, String value)
      Sets an attribute for this manager and all translation resources in this manager.
      void setEnabled​(int resourceId, boolean enabled)
      Enables or disables a given translation resource.
      void setLanguages​(LocaleId sourceLocale, LocaleId targetLocale)
      Sets the source and target locales for this manager and for all translation resources in this manager.
      void setMaximumHits​(int max)
      Sets the maximum number of hits to return for this query manager and all the relevant translation resources it holds.
      void setNoQueryThreshold​(int noQueryThreshold)
      Sets the no-query threshold for this query manager.
      void setOptions​(int thresholdToFill, boolean fillIfTargetIsEmpty, boolean fillIfTargetIsSameAsSource, boolean downgradeIdenticalBestMatches, String targetPrefix, int thresholdToPrefix, boolean copySourceOnNoText)
      Sets the options for performing the leverage.
      void setRootDirectory​(String rootDir)
      Sets the root directory for this query manager and all translation resources it holds.
      void setThreshold​(int value)
      Sets the threshold for this query manager and all the relevant translation resources it holds.

    • Constructor Detail

      • QueryManager

        public QueryManager()
        Creates a new QueryManager object.

    • Method Detail

      • canLeverage

        public static boolean canLeverage​(Segment srcSeg,
                                  Segment trgSeg,
                                  boolean leverageIfTargetIsEmpty,
                                  boolean leverageIfTargetIsSameAsSource)
        Indicates if we can fill a given target segment with leveraged translation based on whether it is empty and whether it is the same as the source segment.
        Parameters:
        srcSeg - the source segment.
        trgSeg - the target segment.
        leverageIfTargetIsEmpty - true if we leverage only if the target is empty.
        leverageIfTargetIsSameAsSource - true if we leverage if the target is not empty but is the same as the source.
        Returns:
        true if we can leverage, false otherwise.

      • canLeverage

        public static boolean canLeverage​(TextContainer srcTc,
                                  TextContainer trgTc,
                                  boolean leverageIfTargetIsEmpty,
                                  boolean leverageIfTargetIsSameAsSource)
        Indicates if we can fill a given target TextContent with leveraged translation based on whether it is empty and whether it is the same as the source TextContent.
        Parameters:
        srcTc - the source TextContent.
        trgTc - the target TextContent.
        leverageIfTargetIsEmpty - true if we leverage only if the target is empty.
        leverageIfTargetIsSameAsSource - true if we leverage if the target is not empty but is the same as the source.
        Returns:
        true if we can leverage, false otherwise.

      • addResource

        public int addResource​(IQuery connector,
                       String name)
        Adds a translation resource to the manager.
        Parameters:
        connector - The translation resource connector to add.
        name - Name of the translation resource to add.
        Returns:
        The ID for the added translation resource. This ID can be used later to access specifically the added translation resource.

      • addAndInitializeResource

        public int addAndInitializeResource​(IQuery connector,
                                    String resourceName,
                                    IParameters params)
        Adds a translation resource to the manager and initializes it with the current source and target language of this manager, as well as any attributes that is set, and the current threshold and maximum hits if it is relevant.
        Parameters:
        connector - The translation resource connector to add.
        resourceName - Name of the translation resource to add.
        params - the parameters for this connector.
        Returns:
        The identifier for the added translation resource. This identifier can be used later to access specifically the added translation resource.
        Throws:
        RuntimeException - if an error occurs.

      • addAndInitializeResource

        public int addAndInitializeResource​(String connectorClass,
                                    String resourceName,
                                    String connectorParams)
        Creates a translation resource and its parameters from their class names, adds it to the manager and initializes it with the current source and target language of this manager, as well as any attributes that is set, and the current threshold and maximum hits if it is relevant.
        Parameters:
        connectorClass - the name of the class for the connector.
        resourceName - the name of the translation resource (can be null).
        connectorParams - connector parameters stored in a string.
        Returns:
        The identifier for the added translation resource. This identifier can be used later to access specifically the added translation resource.
        Throws:
        RuntimeException - if an error occurs.

      • addAndInitializeResource

        public int addAndInitializeResource​(String connectorClass,
                                    String resourceName,
                                    ClassLoader loader,
                                    String connectorParams)
        Creates a translation resource and its parameters from their class names, adds it to the manager and initializes it with the current source and target language of this manager, as well as any attributes that is set, and the current threshold and maximum hits if it is relevant.
        Parameters:
        connectorClass - the name of the class for the connector.
        resourceName - the name of the translation resource (can be null).
        loader - class loader from which the connector class must be loaded
        connectorParams - connector parameters stored in a string.
        Returns:
        The identifier for the added translation resource. This identifier can be used later to access specifically the added translation resource.
        Throws:
        RuntimeException - if an error occurs.

      • setEnabled

        public void setEnabled​(int resourceId,
                       boolean enabled)
        Enables or disables a given translation resource.
        Parameters:
        resourceId - ID of the translation resource to enable or disable.
        enabled - True to enable the resource, false to disable it.

      • remove

        public void remove​(int resourceId)
        Removes a given translation resource.
        Parameters:
        resourceId - ID of the translation resource to remove.

      • getInterface

        public IQuery getInterface​(int resourceId)
        Gets the IQuery interface for a given translation resource.
        Parameters:
        resourceId - ID of the translation resource to lookup.
        Returns:
        The IQuery interface for the given translation resource, or null if the ID is not found.

      • getResource

        public ResourceItem getResource​(int resourceId)
        Gets the configuration data for a given translation resource.
        Parameters:
        resourceId - ID of the translation resource to lookup.
        Returns:
        A ResourceItem object that contains the configuration data for the given translation resource, or null if the ID is not found.

      • getName

        public String getName​(int resourceId)
        Gets the name for a given translation resource.
        Parameters:
        resourceId - ID of the translation resource to lookup.
        Returns:
        The name of the given translation resource, or null if the ID is not found.

      • getResources

        public Map<Integer,​ResourceItem> getResources()
        Gets the configuration data for all the translation resources in this manager.
        Returns:
        A map of ID+ResourceItem objects pairs that contains the configuration data for each translation resource. the map can be empty.

      • close

        public void close()
        Closes all translation resources in this manager.

      • getResults

        public List<QueryResult> getResults()
        Gets the list of all hit results of the last query.
        Returns:
        A list of all hit results of the last query.

      • rewind

        public void rewind()
        Resets the current result to the first one if there is one.

      • hasNext

        public boolean hasNext()
        Indicates of there is a hit available.
        Specified by:
        hasNext in interface Iterator<QueryResult>
        Returns:
        True if a hit is available, false if not.

      • next

        public QueryResult next()
        Gets the next hit for the last query.
        Specified by:
        next in interface Iterator<QueryResult>
        Returns:
        A QueryResult object that holds the source and target text of the hit, or null if there is no more hit.

      • query

        public int query​(String plainText)
        Queries all enabled translation resources for a given plain text.
        Parameters:
        plainText - The text to query.
        Returns:
        The number of hits for the given query.

      • query

        public int query​(TextFragment text)
        Queries all enabled translation resources for a given text fragment.
        Parameters:
        text - The text to query.
        Returns:
        The number of hits for the given query.

      • setAttribute

        public void setAttribute​(String name,
                         String value)
        Sets an attribute for this manager and all translation resources in this manager.
        Parameters:
        name - name of the attribute.
        value - Value of the attribute.

      • removeAttribute

        public void removeAttribute​(String name)
        Removes a given attribute from this manager and all translation resources in this manager.
        Parameters:
        name - The name of the attribute to remove.

      • clearAttributes

        public void clearAttributes()
        Removes all attributes from this manager and all the translation resources in this manager.

      • setLanguages

        public void setLanguages​(LocaleId sourceLocale,
                         LocaleId targetLocale)
        Sets the source and target locales for this manager and for all translation resources in this manager.
        Parameters:
        sourceLocale - Code of the source locale to set.
        targetLocale - Code of the target locale to set.

      • getSourceLanguage

        public LocaleId getSourceLanguage()
        Gets the current source locale for this manager.
        Returns:
        Code of the current source locale for this manager.

      • getTargetLanguage

        public LocaleId getTargetLanguage()
        Gets the current target locale for this manager.
        Returns:
        Code of the current target locale for this manager.

      • setThreshold

        public void setThreshold​(int value)
        Sets the threshold for this query manager and all the relevant translation resources it holds.
        Parameters:
        value - the threshold value to set.

      • setMaximumHits

        public void setMaximumHits​(int max)
        Sets the maximum number of hits to return for this query manager and all the relevant translation resources it holds.
        Parameters:
        max - the maximum value to set.

      • setRootDirectory

        public void setRootDirectory​(String rootDir)
        Sets the root directory for this query manager and all translation resources it holds.
        Parameters:
        rootDir - the root directory.

      • setNoQueryThreshold

        public void setNoQueryThreshold​(int noQueryThreshold)
        Sets the no-query threshold for this query manager. and all the translation resources it holds.
        Parameters:
        noQueryThreshold - the value of the no-query threshold (between 0 and 101). Use 101 to always allow the query.

      • setOptions

        public void setOptions​(int thresholdToFill,
                       boolean fillIfTargetIsEmpty,
                       boolean fillIfTargetIsSameAsSource,
                       boolean downgradeIdenticalBestMatches,
                       String targetPrefix,
                       int thresholdToPrefix,
                       boolean copySourceOnNoText)
        Sets the options for performing the leverage.
        Parameters:
        thresholdToFill - if the first match has a score equal or above this value, the target text of the match is placed in the target content. To avoid any filling of the target: simply use a high value (e.g. Integer.MAX_VALUE).
        fillIfTargetIsEmpty - true to fill the target only if its content is currently empty.
        fillIfTargetIsSameAsSource - true to fill the target if fillIfTargetIsEmpty is true and the source and target content are the same.
        downgradeIdenticalBestMatches - true to reduce the score of best matches when they are identical.
        targetPrefix - A prefix to place at the front of the candidate target if it is leveraged into the text unit. Use null to not set a prefix.
        thresholdToPrefix - if a target prefix is defined and the score is equal or below this threshold the prefix is added. This parameter is ignored if the target prefix is null.
        copySourceOnNoText - true to copy the source content for the target segments that have no text (but they may have codes and/or white spaces).

      • getTotalSegments

        public int getTotalSegments()
        Gets the total number of segments processed since the last call to resetCounters().
        Returns:
        the total number of segment processed.

      • getExactBestMatches

        public int getExactBestMatches()
        Gets the number of best matches that are exact (100%) since the last call to resetCounters().
        Returns:
        the number of best matches that are exact.

      • getFuzzyBestMatches

        public int getFuzzyBestMatches()
        Gets the number of best matches that are fuzzy (less that 100%, more than 0%) since the last call to resetCounters().
        Returns:
        the number of best matches that are fuzzy.