nz.ac.waikato.mcennis.rat.dataAquisition
Class LastFMTagFileReader

java.lang.Object
  nz.ac.waikato.mcennis.rat.graph.model.ModelShell
      nz.ac.waikato.mcennis.rat.dataAquisition.LastFMTagFileReader

All Implemented Interfaces:

Component, DataAquisition, Model

public class LastFMTagFileReader
extends ModelShell
implements DataAquisition

Read a directory of files containing tags for each artist in an XML file read by the LastFMArtistTag XML parser. Parameters for this algorithm:

• Parameter AlgorithmClass:
  • Human readable name for this kind of Data Aquisition algorithm. " + "Used as the key for creating a new DataAquisition object with the DataAquisitionFactory.
  • String Object
  • max: 1
  • min: 1
  • Typically not altered
  • Default: Crawl LastFM
• Parameter Name:
  • Globally unique name for this instance of the Crawl LastFM data aquisition algorithm.
  • String Object
  • max: 1
  • min: 1
  • Default: Crawl LastFM
• Parameter Category:
  • Describes the type of data aquisition algorithm. Used as the key for creating a new DataAquisition object with the DataAquisitionFactory.
  • String Object
  • max: 1
  • min: 1
  • Typically not altered
  • Default: Web Crawler
• Parameter Directory:
  • Root directory where LastFM Tag files are stored.
  • File Object
  • max: 1
  • min: 1
  • Must be a valid directory
  • No default provided

Field Summary

Fields inherited from class nz.ac.waikato.mcennis.rat.graph.model.ModelShell

listener

Constructor Summary

LastFMTagFileReader()

Method Summary

void	cancel() Stop all collection at the end of the next entity (file, web-page, etc.)
Graph	get() Obtain a reference to the graph this object holds
java.util.List<IODescriptor>	getInputType() The input type describes all the different kinds of graph objects that are utilized (and hence required) by this object.
java.util.List<IODescriptor>	getOutputType() The output type describes all the different kinds of graph objects that are created during the execution of this algorithm.
Properties	getParameter() List of all parameters this component accepts.
Parameter	getParameter(java.lang.String param) Returns the specific parameter identified by its key-name.
void	init(Properties map) Parameters of this module: input: None output: Artist Type: Actor Description: LastFM artist Tag Type: Actor Description: Freeform metadata tag URL Type: Actor Property Mode: tag Description: LastFM homepage of this tag ArtistTag Type: Link Description: Link representing the assigning of a metadata element to an artist in general
LastFMTagFileReader	prototype() All Components implement the prototype pattern.
void	set(Graph g) Set the graph to be populated by this object
void	start() Begin executing the data aquisition module

Methods inherited from class nz.ac.waikato.mcennis.rat.graph.model.ModelShell

addListener, fireChange

Methods inherited from class java.lang.Object

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

Methods inherited from interface nz.ac.waikato.mcennis.rat.graph.model.Model

addListener

Constructor Detail

LastFMTagFileReader

public LastFMTagFileReader()

Method Detail

start

public void start()

Description copied from interface: DataAquisition

Begin executing the data aquisition module

Specified by:

start in interface DataAquisition

set

public void set(Graph g)

Description copied from interface: DataAquisition

Set the graph to be populated by this object

Specified by:

set in interface DataAquisition

Parameters:

g - graph to be created for analysis

get

public Graph get()

Description copied from interface: DataAquisition

Obtain a reference to the graph this object holds

Specified by:

get in interface DataAquisition

Returns:

graph created by this object

cancel

public void cancel()

Description copied from interface: DataAquisition

Stop all collection at the end of the next entity (file, web-page, etc.)

Specified by:

cancel in interface DataAquisition

getInputType

public java.util.List<IODescriptor> getInputType()

Description copied from interface: Component

The input type describes all the different kinds of graph objects that are utilized (and hence required) by this object. This result is only guaranteed to be fixed if structural parameters are not modified. This is an empty array if there is no input.

Specified by:

getInputType in interface Component

Returns:

IODescriptor array for this component

See Also:

IODescriptor

getOutputType

public java.util.List<IODescriptor> getOutputType()

Description copied from interface: Component

The output type describes all the different kinds of graph objects that are created during the execution of this algorithm. The result is only guaranteed to be fixed if structural parameters are not modified. This is an empty array if there is no output.

Specified by:

getOutputType in interface Component

Returns:

IODescriptor array for this component

See Also:

IODescriptor

getParameter

public Properties getParameter()

Description copied from interface: Component

List of all parameters this component accepts. Each parameter also has a distinct key-name used when initializing the object using the init method. If there are no parameters, null is returned.

Specified by:

getParameter in interface Component

Returns:

read-only array of Parameters

getParameter

public Parameter getParameter(java.lang.String param)

Description copied from interface: Component

Returns the specific parameter identified by its key-name. If no parameter is found with this key-name, null is returned.

Specified by:

getParameter in interface Component

Parameters:

param - key-name of the parameter

Returns:

named parameter

init

public void init(Properties map)

Parameters of this module:

• input: None
• output:
  • Artist
    • Type: Actor
    • Description: LastFM artist
  • Tag
    • Type: Actor
    • Description: Freeform metadata tag
  • URL
    • Type: Actor Property
    • Mode: tag
    • Description: LastFM homepage of this tag
  • ArtistTag
    • Type: Link
    • Description: Link representing the assigning of a metadata element to an artist in general

Specified by:

init in interface Component

Parameters:

map - properties to load - null is permitted.

prototype

public LastFMTagFileReader prototype()

Description copied from interface: Component

All Components implement the prototype pattern. The new parameter has no common resources to the original that are not static resources o the class.

Specified by:

prototype in interface Component

Returns:

default-parameter version of the same class as the original.