org.lenskit.data.dao.file

Class TextEntitySource

java.lang.Object

org.lenskit.data.dao.file.TextEntitySource

All Implemented Interfaces:

Describable, EntitySource

public class TextEntitySource
extends Object
implements EntitySource, Describable

Entity reader that loads entities from text data, often stored in a file.

Constructor Summary

Constructors

Constructor and Description
TextEntitySource() Construct a new text entity source.
TextEntitySource(String name) Construct a new text entity source.

Method Summary

Modifier and Type	Method and Description
void	describeTo(DescriptionWriter writer) Write this class’s description to a sink.
Path	getFile() Get the input file path.
EntityFormat	getFormat() Get the entity format for the reader.
Map<String,Object>	getMetadata() Get metadata from this entity source.
String	getName() Get the name of this data source.
Set<EntityType>	getTypes() Get the entity types produced by this source.
URL	getURL() Get the source file for this data source.
ObjectStream<Entity>	openStream() Open a stream to read entities from this source.
void	setFile(Path file) Set the source file for this reader.
void	setFormat(EntityFormat format) Set the entity format for the reader.
void	setSource(CharSequence text) Set a string from which to read entities.
void	setURL(URL url) Set the URL of the input data.
com.fasterxml.jackson.databind.JsonNode	toJSON(URI base) Construct a JSON representation of this entity source, suitable for serialization to e.g.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

TextEntitySource

public TextEntitySource()

Construct a new text entity source.

TextEntitySource

public TextEntitySource(String name)

Construct a new text entity source.

Parameters:

name - The source’s name.

Method Detail

getName

public String getName()

Get the name of this data source.

Specified by:

getName in interface EntitySource

Returns:

The data source name.

getTypes

@Nonnull
public Set<EntityType> getTypes()

Description copied from interface: EntitySource

Get the entity types produced by this source.

Specified by:

getTypes in interface EntitySource

Returns:

The set of entity types produced by this source.

setFile

public void setFile(Path file)

Set the source file for this reader.

Parameters:

file - The source file.

setURL

public void setURL(URL url)

Set the URL of the input data.

Parameters:

url - The URL of the input data.

getFile

public Path getFile()

Get the input file path.

Returns:

The input file path.

getURL

public URL getURL()

Get the source file for this data source.

Returns:

The source file.

setSource

public void setSource(CharSequence text)

Set a string from which to read entities.

setFormat

public void setFormat(EntityFormat format)

Set the entity format for the reader.

Parameters:

format - The entity format.

getFormat

public EntityFormat getFormat()

Get the entity format for the reader.

Returns:

The entity format.

getMetadata

public Map<String,Object> getMetadata()

Description copied from interface: EntitySource

Get metadata from this entity source.

Specified by:

getMetadata in interface EntitySource

openStream

public ObjectStream<Entity> openStream()
                                throws IOException

Open a stream to read entities from this source.

Specified by:

openStream in interface EntitySource

Returns:

A stream of entities.

Throws:

IOException

toString

public String toString()

Overrides:

toString in class Object

describeTo

public void describeTo(DescriptionWriter writer)

Description copied from interface: Describable

Write this class’s description to a sink. Anything relevant to this object’s identity should be digested; the idea is that, barring hash collisions, two objects with the same digest are equivalent. Used for things like deterministically generating cache file names.

Specified by:

describeTo in interface Describable

Parameters:

writer - The description writer to use.

toJSON

public com.fasterxml.jackson.databind.JsonNode toJSON(@Nullable
                                                      URI base)

Construct a JSON representation of this entity source, suitable for serialization to e.g. YAML.

Parameters:

base - The URI of the YAML file that will be generated, to generate relative URLs.

Returns:

The JSON node.