net.sf.okapi.connectors.translatetoolkit

Class TranslateToolkitTMConnector

java.lang.Object

net.sf.okapi.lib.translation.BaseConnector

net.sf.okapi.connectors.translatetoolkit.TranslateToolkitTMConnector

All Implemented Interfaces:

AutoCloseable, Iterator<QueryResult>, IQuery, ITMQuery

public class TranslateToolkitTMConnector
extends BaseConnector
implements ITMQuery

Implement IQuery for the amaGama TM hosted for Translate-Toolkit.

Initial URL was: http://amagama.locamotion.org:80/tmserver/

Around May-20-2014 it changed to: https://amagama-live.translatehouse.org/api/v1/

Field Summary

Fields inherited from class net.sf.okapi.lib.translation.BaseConnector

result, srcCode, srcLoc, trgCode, trgLoc

Constructor Summary

Constructors

Constructor and Description
TranslateToolkitTMConnector()

Method Summary

Modifier and Type	Method and Description
List<List<QueryResult>>	batchQuery(List<TextFragment> fragments) Slow default implementation using query!! Override to take advantage of servers batch API
void	clearAttributes() Removes all attributes from this query engine.
void	close() Closes this connector.
int	getMaximumHits() Gets the current maximum number of hits to retrieve.
String	getName() Gets the name of the connector.
Parameters	getParameters() Gets the current parameters of this connector.
String	getSettingsDisplay() Gets a display representation of the current settings for this connector.
int	getThreshold() Gets the current threshold value to use for the query.
boolean	hasNext() Indicates of there is a hit available.
QueryResult	next() Gets the next hit for the last query.
void	open() Opens this query engine.
int	query(String plainText) Starts a query for a give plain text.
int	query(TextFragment text) Starts a query for a given text.
void	removeAttribute(String name) Removes a given attribute from this query engine.
void	setAttribute(String name, String value) Sets an attribute for this query engine.
void	setMaximumHits(int max) Sets the maximum number of hits to retrieve.
void	setParameters(IParameters params) Sets the parameters for opening and querying this connector.
void	setRootDirectory(String rootDir) Sets the root directory that may be used to replace the available ${rootDir} in the parameters of this object.
void	setThreshold(int threshold) Sets the threshold value to use for the query.
protected String	toInternalCode(LocaleId standardCode) Converts a locale identifier to the internal string value for a language/locale code for this connector.

Methods inherited from class net.sf.okapi.lib.translation.BaseConnector

batchLeverage, batchLeverageUsingBatchQuery, batchQueryText, getNoQueryThreshold, getSourceLanguage, getTargetLanguage, getWeight, leverage, leverageUsingBatchQuery, setLanguages, setNoQueryThreshold, setWeight

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface net.sf.okapi.common.query.IQuery

batchLeverage, batchQueryText, getNoQueryThreshold, getSourceLanguage, getTargetLanguage, getWeight, leverage, setLanguages, setNoQueryThreshold, setWeight

Methods inherited from interface java.util.Iterator

forEachRemaining, remove

Constructor Detail

TranslateToolkitTMConnector

public TranslateToolkitTMConnector()

Method Detail

getName

public String getName()

Description copied from interface: IQuery

Gets the name of the connector.

Specified by:

getName in interface IQuery

Returns:

the name of the connector.

getSettingsDisplay

public String getSettingsDisplay()

Description copied from interface: IQuery

Gets a display representation of the current settings for this connector. This can be a display of some of the parameters for example, or some explanations about default non-modifiable settings.

Specified by:

getSettingsDisplay in interface IQuery

Returns:

a display representation of the current settings.

close

public void close()

Description copied from interface: IQuery

Closes this connector.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface IQuery

hasNext

public boolean hasNext()

Description copied from interface: IQuery

Indicates of there is a hit available.

Specified by:

hasNext in interface Iterator<QueryResult>

Specified by:

hasNext in interface IQuery

Overrides:

hasNext in class BaseConnector

Returns:

True if a hit is available, false if not.

next

public QueryResult next()

Description copied from interface: IQuery

Gets the next hit for the last query.

Specified by:

next in interface Iterator<QueryResult>

Specified by:

next in interface IQuery

Overrides:

next in class BaseConnector

Returns:

A QueryResult object that holds the source and target text of the hit, or null if there is no more hit.

open

public void open()

Description copied from interface: IQuery

Opens this query engine.

Specified by:

open in interface IQuery

query

public int query(String plainText)

Description copied from interface: IQuery

Starts a query for a give plain text.

Specified by:

query in interface IQuery

Parameters:

plainText - text to query.

Returns:

The number of hits for the given query.

query

public int query(TextFragment text)

Description copied from interface: IQuery

Starts a query for a given text.

Specified by:

query in interface IQuery

Parameters:

text - The text to query.

Returns:

The number of hits for the given query.

batchQuery

public List<List<QueryResult>> batchQuery(List<TextFragment> fragments)

Description copied from class: BaseConnector

Slow default implementation using query!! Override to take advantage of servers batch API

Specified by:

batchQuery in interface IQuery

Overrides:

batchQuery in class BaseConnector

Parameters:

fragments - list of the text fragments to translate.

Returns:

a list of lists of query result. Each list corresponds to a source text (in the same order)

clearAttributes

public void clearAttributes()

Description copied from interface: IQuery

Removes all attributes from this query engine.

Specified by:

clearAttributes in interface IQuery

Overrides:

clearAttributes in class BaseConnector

removeAttribute

public void removeAttribute(String name)

Description copied from interface: IQuery

Removes a given attribute from this query engine.

Specified by:

removeAttribute in interface IQuery

Overrides:

removeAttribute in class BaseConnector

Parameters:

name - The name of the attribute to remove.

setAttribute

public void setAttribute(String name,
                         String value)

Description copied from interface: IQuery

Sets an attribute for this query engine.

Specified by:

setAttribute in interface IQuery

Overrides:

setAttribute in class BaseConnector

Parameters:

name - name of the attribute.

value - Value of the attribute.

setMaximumHits

public void setMaximumHits(int max)

Description copied from interface: ITMQuery

Sets the maximum number of hits to retrieve.

Specified by:

setMaximumHits in interface ITMQuery

Parameters:

max - The maximum number of hits to retrieve.

setThreshold

public void setThreshold(int threshold)

Description copied from interface: ITMQuery

Sets the threshold value to use for the query.

Specified by:

setThreshold in interface ITMQuery

Parameters:

threshold - The threshold value (between 0 and 100).

getMaximumHits

public int getMaximumHits()

Description copied from interface: ITMQuery

Gets the current maximum number of hits to retrieve.

Specified by:

getMaximumHits in interface ITMQuery

Returns:

the current maximum number of hits to retrieve.

getThreshold

public int getThreshold()

Description copied from interface: ITMQuery

Gets the current threshold value to use for the query.

Specified by:

getThreshold in interface ITMQuery

Returns:

The current threshold value to use for the query.

toInternalCode

protected String toInternalCode(LocaleId standardCode)

Description copied from class: BaseConnector

Converts a locale identifier to the internal string value for a language/locale code for this connector. By default, this simply returns the string of the given LocaleId.

Overrides:

toInternalCode in class BaseConnector

Parameters:

standardCode - the locale identifier to convert.

Returns:

the internal string code for language/locale code for this connector.

getParameters

public Parameters getParameters()

Description copied from interface: IQuery

Gets the current parameters of this connector.

Specified by:

getParameters in interface IQuery

Overrides:

getParameters in class BaseConnector

Returns:

the current parameters of this connector or null if no parameters are used.

setParameters

public void setParameters(IParameters params)

Description copied from interface: IQuery

Sets the parameters for opening and querying this connector.

Specified by:

setParameters in interface IQuery

Overrides:

setParameters in class BaseConnector

Parameters:

params - the parameters to set.

setRootDirectory

public void setRootDirectory(String rootDir)

Description copied from interface: IQuery

Sets the root directory that may be used to replace the available ${rootDir} in the parameters of this object.

Specified by:

setRootDirectory in interface IQuery

Overrides:

setRootDirectory in class BaseConnector

Parameters:

rootDir - the root directory.