net.sourceforge.rssowl.controller.thread
Class FeedSearchManager

java.lang.Object
  net.sourceforge.rssowl.controller.thread.FeedSearchManager

public class FeedSearchManager
extends java.lang.Object

The FeedSearchManager performs a search for RSS / RDF feeds on a certain topic. Each link that is in the result is checked for a valid feed. If the link is a newsfeed, a new line is added to the table of the FeedSearchDialog.

Version:

1.2.4

Author:

Benjamin Pasero

Field Summary

private static int	COLLECTOR_THREAD_COUNT Number of collector threads
(package private) int	collectorsDone Count the number of collector threads that have finished
private ExtendedThread[]	collectorThreads Collector threads to collect and parse links from the results of the search
private boolean	intensiveSearch If TRUE parse any link from the results.
private java.util.Vector	links List of links from the results
private static java.util.Vector	localeSearchList Domains that are allowed to use for search
private boolean	nativeLangSearch If TRUE only display news that match the selected language
(package private) java.util.Vector	normalUrlObjects Synchronized list of normal URL objects
(package private) org.jdom.input.SAXBuilder[]	parser Create one parser for each Collector thread
(package private) java.util.Vector	preferredUrlObjects Synchronized list of preferred URL objects
(package private) java.util.Random	randomNumberGenerator Random Number Generator for sleep Time of Threads
private int	resultCounter Count the resulting Feeds
(package private) FeedSearchDialog	rssOwlFeedSearchDialog The opened rss feedsearch dialog
(package private) boolean	running Flag indicates the running threads
private static java.lang.String[]	SEARCH_DELIMITER One of the words from this array is combined with the search of the user
(package private) boolean	searchDone Flag indicates when the search has finished
private java.lang.Thread	searchThread Thread that performs the search
private java.lang.String	searchUrl URL to get the results from
private static java.lang.String	START_PARAM Token for start parameter
private java.lang.String	topic Topic that the user searches for

Constructor Summary

FeedSearchManager(java.lang.String topic, FeedSearchDialog rssOwlFeedSearchDialog, boolean intensiveSearch, boolean nativeLangSearch)
Instantiate a new FeedSearchManager

Method Summary

static void	addIntoLocaleSearchList(java.lang.String value) Add a value to the locale search list
(package private) void	buildChannel(java.net.URL url, int parserNumber) Build RSS channel object from the given URl
private org.jdom.Document	buildDocument(java.net.URL xmlUrl, boolean forceDefaultEncoding, int parserNumber) Build the XML document from the given URL
private void	createCollectorThreads() Collector thread checks if URLs in "urlObj" are valid RSS / RDF feeds
private void	createSearchThread() Search thread performs the search for the topic
private java.lang.String	createUrl() Create the URL to perform the search
private void	filterLink(java.lang.String url) Filter the given URL.
private void	initXMLParsers() Init one SAX Parser for each collector thread
boolean	isRunning() Get the state of the search
(package private) void	performSearch() Perform a search on the search engine and add every link to the Stack, that was found.
void	startSearch() Start search- and collector threads
void	stopSearch() Interrupt the search- and collector threads

Methods inherited from class java.lang.Object

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

Field Detail

COLLECTOR_THREAD_COUNT

private static final int COLLECTOR_THREAD_COUNT

Number of collector threads

See Also:

Constant Field Values

localeSearchList

private static final java.util.Vector localeSearchList

Domains that are allowed to use for search

SEARCH_DELIMITER

private static final java.lang.String[] SEARCH_DELIMITER

One of the words from this array is combined with the search of the user

START_PARAM

private static final java.lang.String START_PARAM

Token for start parameter

See Also:

Constant Field Values

collectorThreads

private ExtendedThread[] collectorThreads

Collector threads to collect and parse links from the results of the search

intensiveSearch

private boolean intensiveSearch

If TRUE parse any link from the results. If FALSE parse .xml, .rss and .rdf

links

private java.util.Vector links

List of links from the results

nativeLangSearch

private boolean nativeLangSearch

If TRUE only display news that match the selected language

resultCounter

private int resultCounter

Count the resulting Feeds

searchThread

private java.lang.Thread searchThread

Thread that performs the search

searchUrl

private java.lang.String searchUrl

URL to get the results from

topic

private java.lang.String topic

Topic that the user searches for

collectorsDone

int collectorsDone

Count the number of collector threads that have finished

normalUrlObjects

java.util.Vector normalUrlObjects

Synchronized list of normal URL objects

parser

org.jdom.input.SAXBuilder[] parser

Create one parser for each Collector thread

preferredUrlObjects

java.util.Vector preferredUrlObjects

Synchronized list of preferred URL objects

randomNumberGenerator

java.util.Random randomNumberGenerator

Random Number Generator for sleep Time of Threads

rssOwlFeedSearchDialog

FeedSearchDialog rssOwlFeedSearchDialog

The opened rss feedsearch dialog

running

boolean running

Flag indicates the running threads

searchDone

boolean searchDone

Flag indicates when the search has finished

Constructor Detail

FeedSearchManager

public FeedSearchManager(java.lang.String topic,
                         FeedSearchDialog rssOwlFeedSearchDialog,
                         boolean intensiveSearch,
                         boolean nativeLangSearch)

Instantiate a new FeedSearchManager

Parameters:

topic - Topic to search for

rssOwlFeedSearchDialog - This dialog called the FeedSearchManager

intensiveSearch - TRUE if intensive search is performed

nativeLangSearch - TRUE if native lang search is performed

Method Detail

addIntoLocaleSearchList

public static void addIntoLocaleSearchList(java.lang.String value)

Add a value to the locale search list

Parameters:

value - The value to add

isRunning

public boolean isRunning()

Get the state of the search

Returns:

boolean TRUE if search is running

startSearch

public void startSearch()

Start search- and collector threads

stopSearch

public void stopSearch()

Interrupt the search- and collector threads

buildDocument

private org.jdom.Document buildDocument(java.net.URL xmlUrl,
                                        boolean forceDefaultEncoding,
                                        int parserNumber)

Build the XML document from the given URL

Parameters:

xmlUrl - The XML Url object

forceDefaultEncoding - If set to TRUE the encoding is not being detected from the XMl document and the OS default encoding is used

parserNumber - The number of the index in the parser array to use

Returns:

Document The builded XML document from the URL or NULL on warning

createCollectorThreads

private void createCollectorThreads()

Collector thread checks if URLs in "urlObj" are valid RSS / RDF feeds

createSearchThread

private void createSearchThread()

Search thread performs the search for the topic

createUrl

private java.lang.String createUrl()

Create the URL to perform the search

Returns:

String search URL

filterLink

private void filterLink(java.lang.String url)

Filter the given URL. Do not add URLs which have a file name which marks them as binary file

Parameters:

url - Any URL to filter

initXMLParsers

private void initXMLParsers()

Init one SAX Parser for each collector thread

buildChannel

void buildChannel(java.net.URL url,
                  int parserNumber)

Build RSS channel object from the given URl

Parameters:

url - The URL of the newsfeed

parserNumber - The number of the index in the parser array to use

performSearch

void performSearch()
             throws java.io.IOException

Perform a search on the search engine and add every link to the Stack, that was found. Each link is first filtered, to see if it's not an image or zip for example.

Throws:

java.io.IOException - If connection fails