Package org.languagetool.databroker

Class DefaultResourceDataBroker

java.lang.Object

org.languagetool.databroker.DefaultResourceDataBroker

All Implemented Interfaces:

ResourceDataBroker

public class DefaultResourceDataBroker
extends Object
implements ResourceDataBroker

Responsible for getting any items from the grammar checker's resource directories. This default data broker assumes that they are accessible directly via class-path and the directory names are like specified in:

• ResourceDataBroker.RESOURCE_DIR
• ResourceDataBroker.RULES_DIR

If you'd like to determine another resource directory location this default data broker provides proper methods. Assuming your /rules and /resource directories are accessible via class-path with following path information:

• /res/grammarchecker/rulesdirname
• /res/grammarchecker/resourcedirname

In this case you have to use the constructor with the following arguments:

• /res/grammarchecker/rulesdirname
• /res/grammarchecker/resourcedirname

Make sure that you never obtain any grammar checker resources by calling Object.class.getResource(String) or Object.class.getResourceAsStream(String) directly. If you would like to obtain something from these directories do always use JLanguageTool.getDataBroker() which provides proper methods for reading the directories above.

For example, if you want to get the URL of /rules/de/grammar.xml just invoke ResourceDataBroker.getFromRulesDirAsUrl(String) and pass /de/grammar.xml as a string. Note: The /rules directory's name isn't passed because its name might have changed. The same usage does apply for the /resource directory.

Since:

1.0.1

See Also:

• ResourceDataBroker

Field Summary

Fields

Modifier and Type	Field	Description
private final String	resourceDir	The directory's name of the grammar checker's resource directory.
private final String	rulesDir	The directory's name of the grammar checker's rules directory.

Fields inherited from interface org.languagetool.databroker.ResourceDataBroker

RESOURCE_DIR, RULES_DIR

Constructor Summary

Constructors

Constructor	Description
DefaultResourceDataBroker()	Instantiates this data broker with the default resource directory names as specified in: ResourceDataBroker.RESOURCE_DIR ResourceDataBroker.RULES_DIR
DefaultResourceDataBroker(String resourceDir, String rulesDir)	Instantiates this data broker with the passed resource directory names.

Method Summary

Modifier and Type	Method	Description
private String	appendPath(String baseDir, String path)
private void	assertNotNull(Object object, String path, String completePath)
private String	getCompleteResourceUrl(String path)	Concatenates the passed resource path with the currently set resource directory path.
private String	getCompleteRulesUrl(String path)	Concatenates the passed resource path with the currently set rules directory path.
InputStream	getFromResourceDirAsStream(String path)	See: ResourceDataBroker.getFromResourceDirAsStream(String)
URL	getFromResourceDirAsUrl(String path)	See: ResourceDataBroker.getFromResourceDirAsUrl(String)
InputStream	getFromRulesDirAsStream(String path)	See: ResourceDataBroker.getFromRulesDirAsStream(String)
URL	getFromRulesDirAsUrl(String path)	See: ResourceDataBroker.getFromRulesDirAsUrl(String)
String	getResourceDir()
String	getRulesDir()
boolean	resourceExists(String path)	See: ResourceDataBroker.resourceExists(String) Checks if a resource in the grammar checker's /resource exists.
boolean	ruleFileExists(String path)	See: ResourceDataBroker.ruleFileExists(String) Checks if a resource in the grammar checker's /rules exists.

Methods inherited from class java.lang.Object

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

Field Details

resourceDir

private final String resourceDir

The directory's name of the grammar checker's resource directory. The default value equals ResourceDataBroker.RESOURCE_DIR.

rulesDir

private final String rulesDir

The directory's name of the grammar checker's rules directory. The default value equals ResourceDataBroker.RULES_DIR.

Constructor Details

DefaultResourceDataBroker

public DefaultResourceDataBroker()

Instantiates this data broker with the default resource directory names as specified in:

• ResourceDataBroker.RESOURCE_DIR
• ResourceDataBroker.RULES_DIR

DefaultResourceDataBroker

public DefaultResourceDataBroker(String resourceDir,
 String rulesDir)

Instantiates this data broker with the passed resource directory names.

Parameters:

resourceDir - The directory's name of the grammar checker's resource directory. The default value equals ResourceDataBroker.RESOURCE_DIR.

rulesDir - The directory's name of the grammar checker's rules directory. The default value equals ResourceDataBroker.RULES_DIR.

Method Details

getFromResourceDirAsStream

public InputStream getFromResourceDirAsStream(String path)

See: ResourceDataBroker.getFromResourceDirAsStream(String)

Specified by:

getFromResourceDirAsStream in interface ResourceDataBroker

Parameters:

path - The relative path to the item inside of the /resource directory. Please start your path information with / because it will be concatenated with the directory's name: /resource/yourpath.

Returns:

An InputStream object to the requested item

Throws:

RuntimeException - if path cannot be found

getFromResourceDirAsUrl

public URL getFromResourceDirAsUrl(String path)

See: ResourceDataBroker.getFromResourceDirAsUrl(String)

Specified by:

getFromResourceDirAsUrl in interface ResourceDataBroker

Parameters:

path - The relative path to the item inside of the /resource directory. Please start your path information with / because it will be concatenated with the directory's name: /resource/yourpath.

Returns:

An URL object to the requested item

Throws:

RuntimeException - if path cannot be found

getCompleteResourceUrl

private String getCompleteResourceUrl(String path)

Concatenates the passed resource path with the currently set resource directory path.

Parameters:

path - The relative path to a resource item inside of the resource directory.

Returns:

The full relative path to the resource including the path to the resource directory.

getFromRulesDirAsStream

public InputStream getFromRulesDirAsStream(String path)

See: ResourceDataBroker.getFromRulesDirAsStream(String)

Specified by:

getFromRulesDirAsStream in interface ResourceDataBroker

Parameters:

path - The relative path to the item inside of the /rules directory. Please start your path information with / because it will be concatenated with the directory's name: /rules/yourpath.

Returns:

An InputStream object to the requested item

Throws:

RuntimeException - if path cannot be found

getFromRulesDirAsUrl

public URL getFromRulesDirAsUrl(String path)

See: ResourceDataBroker.getFromRulesDirAsUrl(String)

Specified by:

getFromRulesDirAsUrl in interface ResourceDataBroker

Parameters:

path - The relative path to the item inside of the /rules directory. Please start your path information with / because it will be concatenated with the directory's name: /rules/yourpath.

Returns:

An URL object to the requested item

Throws:

RuntimeException - if path cannot be found

assertNotNull

private void assertNotNull(Object object,
 String path,
 String completePath)

getCompleteRulesUrl

private String getCompleteRulesUrl(String path)

Concatenates the passed resource path with the currently set rules directory path.

Parameters:

path - The relative path to a resource item inside of the rules directory.

Returns:

The full relative path to the resource including the path to the rules directory.

appendPath

private String appendPath(String baseDir,
 String path)

resourceExists

public boolean resourceExists(String path)

See: ResourceDataBroker.resourceExists(String) Checks if a resource in the grammar checker's /resource exists.

Specified by:

resourceExists in interface ResourceDataBroker

Parameters:

path - Path to an item from the /resource directory.

Returns:

true if the resource file exists.

ruleFileExists

public boolean ruleFileExists(String path)

See: ResourceDataBroker.ruleFileExists(String) Checks if a resource in the grammar checker's /rules exists.

Specified by:

ruleFileExists in interface ResourceDataBroker

Parameters:

path - Path to an item from the /rules directory.

Returns:

true if the resource file exists.

getResourceDir

public String getResourceDir()

Specified by:

getResourceDir in interface ResourceDataBroker

Returns:

The directory's name of the grammar checker's resource directory. The default value equals ResourceDataBroker.RESOURCE_DIR.

getRulesDir

public String getRulesDir()

Specified by:

getRulesDir in interface ResourceDataBroker

Returns:

The directory's name of the grammar checker's rules directory. The default value equals ResourceDataBroker.RULES_DIR.