Static Public Member Functions
static String	getServerURL ()

static void	setServerURL (String server_url)

static StringBuilder	trimComma (StringBuilder in)

static List< Follower >	getAssociations (Follower identifier, int max)

static List< Tweet >	getAssociations (TwitterAccount identifier, int max)

static List< EarthquakeUSGS >	getAssociations (USGSaccount identifier, int max)

static List< EarthquakeTweet >	convertTweet (List< Tweet > aList)

static List< Actor >	getAssociations (Actor identifier, int max)

static List< Movie >	getAssociations (Movie identifier, int max)

static List< Tweet >	next (List< Tweet > aList, int max)

static List< EarthquakeUSGS >	next (List< EarthquakeUSGS > aList, int max, USGSaccount acu)

static int	validNumberOfTweets (int max)

static double	getEdgeWeight (String source, String target)

static ArrayList< EarthquakeUSGS >	getEarthquakeUSGSData (int maxElem) throws Exception

static ArrayList< ActorMovieIMDB >	getActorMovieIMDBData (int maxElem) throws Exception, IllegalArgumentException

static ArrayList< ActorMovieIMDB >	getActorMovieIMDBData2 () throws Exception

static ArrayList< GutenbergBook >	getGutenbergBookMetaData () throws Exception

static ArrayList< Game >	getGameData () throws Exception

static ArrayList< Song >	getSongData () throws Exception

static Song	getSong (String songTitle, String artistName) throws Exception

static ArrayList< Shakespeare >	getShakespeareData (String works, Boolean textOnly) throws Exception

static ArrayList< CancerIncidence >	getCancerIncidenceData () throws Exception

Protected Member Functions
	DataFormatter ()

Connector	getBackend ()

void	setBackend (Connector backend)

Detailed Description

Connection to the DataFormatters server.

Initialize this class before using it, and call complete() afterward.

Author: Sean Gallagher

Parameters

<E>	Mihai Mehedint

Constructor & Destructor Documentation

bridges.connect.DataFormatter.DataFormatter ( )

protected

Constructor

Member Function Documentation

static List<EarthquakeTweet> bridges.connect.DataFormatter.convertTweet ( List< Tweet > aList )

static

This method change the tweet object into an earthquake tweet object with more data extracted from the tweet content, like magnitude

Parameters

aList

Returns

static ArrayList<ActorMovieIMDB> bridges.connect.DataFormatter.getActorMovieIMDBData ( int maxElem ) throws Exception, IllegalArgumentException

static

Get ActorMovie IMDB Data retrieved, formatted into a list of ActorMovieIMDB objects

Parameters

maxElements the number of actor/movie pairs

Exceptions

Exception if the request fails

Returns: a list of ActorMovieIMDB objects, but only actor and movie fields in this version

static ArrayList<ActorMovieIMDB> bridges.connect.DataFormatter.getActorMovieIMDBData2 ( ) throws Exception

static

Get ActorMovie IMDB Data retrieved, formatted into a list of ActorMovieIMDB objects

Exceptions

Exception if the request fails

Returns: a list of ActorMovieIMDB objects, consisting of actor name, movie name, movie genre and movie rating is returned.

static List<Follower> bridges.connect.DataFormatter.getAssociations	(	Follower	identifier,
		int	max
	)

static

Automatically choose whether to open a node identifier with: Twitter via followers(), TMDb with movies(), or RottenTomatoes with actors()

Parameters

identifier
max

Returns: a list of identifiers

Exceptions

QueryLimitException This Method returns the list of followers

Parameters

identifier	holds the name of the
max	holds the max number of followers

Returns

static List<Tweet> bridges.connect.DataFormatter.getAssociations	(	TwitterAccount	identifier,
		int	max
	)

static

This Method returns the list of tweets

Parameters

identifier	holds the name of the
max	holds the max number of tweets

Returns

Exceptions

MyExceptionClass

static List<EarthquakeUSGS> bridges.connect.DataFormatter.getAssociations	(	USGSaccount	identifier,
		int	max
	)

static

This Method returns the list of earthquakes

Parameters

identifier	holds the name of the
max	holds the max number of earthquakes

Returns

Exceptions

MyExceptionClass

static List<Actor> bridges.connect.DataFormatter.getAssociations	(	Actor	identifier,
		int	max
	)

static

This Method returns the list of actors

Parameters

identifier	holds the name of the movie
max	holds the max number of actors

Returns

static List<Movie> bridges.connect.DataFormatter.getAssociations	(	Movie	identifier,
		int	max
	)

static

This Method returns the list of movies

Parameters

identifier	holds the name of the movie
max	holds the max number of movies

Returns

Connector bridges.connect.DataFormatter.getBackend ( )

protected

Returns: the backend

static ArrayList<CancerIncidence> bridges.connect.DataFormatter.getCancerIncidenceData ( ) throws Exception

static

static ArrayList<EarthquakeUSGS> bridges.connect.DataFormatter.getEarthquakeUSGSData ( int maxElem ) throws Exception

static

Get USGS earthquake data USGS Tweet data (https://earthquake.usgs.gov/earthquakes/map/) retrieved, formatted into a list of EarthquakeUSGS objects

Parameters

name	USGS account name - must be "earthquake" to create account
maxElements	the number of earthquake records retrieved, limited to 5000

Exceptions

Exception if the request fails

Returns: a list of earthquake records

static double bridges.connect.DataFormatter.getEdgeWeight	(	String	source,
		String	target
	)

static

Generate a sample Edge weight for two nodes

Parameters

source
target

Returns

static ArrayList<Game> bridges.connect.DataFormatter.getGameData ( ) throws Exception

static

Get meta data of the IGN games collection.

This function retrieves and formats the data into a list of Game objects

Exceptions

Exception if the request fails

Returns: a list of Game objects,

static ArrayList<GutenbergBook> bridges.connect.DataFormatter.getGutenbergBookMetaData ( ) throws Exception

static

Get meta data of the Gutenberg book collection (1000 books) This function retrieves, and formats the data into a list of GutenbergBook objects

Exceptions

Exception if the request fails

Returns: a list of GutenbergBook objects,

static String bridges.connect.DataFormatter.getServerURL ( )

static

static ArrayList<Shakespeare> bridges.connect.DataFormatter.getShakespeareData	(	String	works,
		Boolean	textOnly
	)		throws Exception

static

Get data of Shakespeare works (plays, poems)

This function retrieves and formats the data into a a list of Shakespeare objects.

Exceptions

Exception if the request fails

Parameters

works	can be either "plays" or "poems". If this is specified, then only these types of works are retrieved.
textOnly	if this is set, then only the text is retrieved.

Returns: an array of Shakespeare objects

static Song bridges.connect.DataFormatter.getSong	(	String	songTitle,
		String	artistName
	)		throws Exception

static

Get data of a particular songs (including lyrics) using the Genius API (https://docs.genius.com/), given the song title and artist name.

This function retrieves and formats the data into a Song object. The song if not cached in the local DB is queried and added to the DB

Exceptions

Exception if the request fails

Returns: a Song object,

static ArrayList<Song> bridges.connect.DataFormatter.getSongData ( ) throws Exception

static

Get data of the songs (including lyrics) using the Genius API https://docs.genius.com/

This function retrieves and formats the data into a list of Song objects. This version of the API retrieves all the cached songs in the local DB.

Exceptions

Exception if the request fails

Returns: a list of Song objects,

static List<Tweet> bridges.connect.DataFormatter.next	(	List< Tweet >	aList,
		int	max
	)

static

The next(List<Tweet>, int) method retrieves the next batch of tweets and adds deep copy of those tweets to the current list

Parameters

aList	holds the reference to the current list of tweets
max	the number of tweets in the new batch of tweets

Returns: the list of tweets containing the old and the new batch of tweets

Exceptions

MyExceptionClass

static List<EarthquakeUSGS> bridges.connect.DataFormatter.next	(	List< EarthquakeUSGS >	aList,
		int	max,
		USGSaccount	acu
	)

static

The next(List<EarthquakeUSGS>, int) method retrieves the next batch of eq and adds deep copy of those eq to the current list

Parameters

aList	holds the reference to the current list of eq
max	the number of eq in the new batch of eq

Returns: the list of eq containing the old and the new batch of tweets

Exceptions

MyExceptionClass

void bridges.connect.DataFormatter.setBackend ( Connector backend )

protected

Parameters

backend the backend to set

static void bridges.connect.DataFormatter.setServerURL ( String server_url )

static

static StringBuilder bridges.connect.DataFormatter.trimComma ( StringBuilder in )

static

Internal method for JSON preparation

Parameters

in	The original string

Returns: a string with all but the last character

static int bridges.connect.DataFormatter.validNumberOfTweets ( int max )

static

Check the validity of number of Tweets requested

Parameters

max	the number of tweets

Returns: returns true if the number is in the range 0 - 500

Exceptions

MyExceptionClass otherwise

The documentation for this class was generated from the following file:

/Users/kalpathi/gr/bridges/bridges17/java/src/main/java/bridges/connect/DataFormatter.java

Static Public Member Functions

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation