devplugin

Interface PluginManager

All Known Implementing Classes:

PluginManagerImpl

public interface PluginManager

The PluginManager provides some useful methods for a plugin. More methods may follow in future versions.

Author:

Martin Oberhauser

Field Summary

Fields

Modifier and Type	Field and Description
static int	SEARCHER_TYPE_BOOLEAN Specifies, that the search term is a boolean expression.
static int	SEARCHER_TYPE_EXACTLY Specifies, that the search term has to match exactly.
static int	SEARCHER_TYPE_KEYWORD Specifies, that the search term is a keyword (= substring).
static int	SEARCHER_TYPE_REGULAR_EXPRESSION Specifies, that the search term is a regular expression.

Method Summary

Methods

Modifier and Type	Method and Description
JPopupMenu	createPluginContextMenu(Program program, ContextMenuIf caller) Creates a context menu for the given program containing all plugins.
ProgramSearcher	createProgramSearcher(int type, String searchTerm, boolean caseSensitive) Creates a ProgramSearcher.
PluginAccess	getActivatedPluginForId(String pluginId) Gets the activated plugin with the given ID.
PluginAccess[]	getActivatedPlugins() Returns all activated Plugins.
ProgramRatingIf[]	getAllProgramRatingIfs() Gets all ProgramRatingIfs of all plugins.
ProgramFilter[]	getAvailableFilters() Deprecated. Since 2.5 Use FilterManager.getAvailableFilters() instead.
AbstractPluginProgramFormating[]	getAvailableGlobalPuginProgramFormatings() Gets the available global program configurations.
Iterator<Program>	getChannelDayProgram(Date date, Channel channel) Gets an iterator through all programs of the specified channel at the specified date.
Date	getCurrentDate() Get the date currently shown in the program table.
TvDataService	getDataService(String dataServiceClassName) Deprecated.
TvDataServiceProxy	getDataServiceProxy(String id)
Program	getExampleProgram() Returns an example program.
FilterManager	getFilterManager() Returns the filter manager of TV-Browser.
ImageIcon	getIconFromTheme(Plugin plugin, String category, String icon, int size) Returns an Icon from the Icon-Theme-System If your Plugin has Icons that are not available as Icons within an Theme, you can add your Icons into your Jar-File.
ImageIcon	getIconFromTheme(Plugin plugin, ThemeIcon icon) Returns an Icon from the Icon-Theme-System If your Plugin has Icons that are not available as Icons within an Theme, you can add your Icons into your Jar-File.
Plugin[]	getInstalledPlugins() Deprecated. Since 1.1. Use getActivatedPlugins() instead.
String	getJavaPluginId(Plugin javaPlugin) Gets the ID of the given Java plugin.
Program[]	getMarkedPrograms() Return all marked programs.
Program	getProgram(Date date, String progID) Gets a program.
ProgramReceiveIf	getReceiceIfForId(String id) Return the ReceiveIfFor given id or null if there is no ReceiveIf for the given id.
ProgramReceiveIf[]	getReceiveIfs() Return all Plugins/Functions that are able to receive programs.
ProgramReceiveIf[]	getReceiveIfs(ProgramReceiveIf caller, ProgramReceiveTarget callerTarget) Return all Plugins/Functions that are able to receive programs.
Channel[]	getSubscribedChannels() Gets all channels the user has subscribed.
TvBrowserSettings	getTvBrowserSettings() Returns some settings a plugin may need.
void	goToDate(Date date) Let TVB change the date to the given date.
void	handleProgramDoubleClick(Program program) Handles a double click on a program.
void	handleProgramDoubleClick(Program program, ContextMenuIf caller) Handles a double click on a program.
void	handleProgramMiddleClick(Program program) Handles a middle click on a program.
void	handleProgramMiddleClick(Program program, ContextMenuIf caller) Handles a middle click on a program.
void	handleProgramSingleClick(Program program) Handles a single left click on a program.
void	handleProgramSingleClick(Program program, ContextMenuIf caller) Handles a single left click on a program.
void	scrollToChannel(Channel channel) Let TVB scroll to the given channel.
void	scrollToProgram(Program program) Let TVB scroll to the given program.
void	scrollToTime(int time) Let TVB scroll to the given time.
Program[]	search(String regex, boolean inTitle, boolean inText, boolean caseSensitive, Channel[] channels, Date startDate, int nrDays) Deprecated. Use createProgramSearcher(int, String, boolean) instead.
Program[]	search(String regex, boolean caseSensitive, ProgramFieldType[] fieldArr, Date startDate, int nrDays, Channel[] channels, boolean sortByStartTime) Deprecated. Since 1.1. Use createProgramSearcher(int, String, boolean) instead.
void	showSettings(Plugin plugin) Show the Settings-Dialog for a Plugin
void	showSettings(String settingsItem) Show the Settings-Dialog with a Specific SettingsItem

Field Detail

SEARCHER_TYPE_EXACTLY

static final int SEARCHER_TYPE_EXACTLY

Specifies, that the search term has to match exactly.

See Also:

Constant Field Values

SEARCHER_TYPE_KEYWORD

static final int SEARCHER_TYPE_KEYWORD

Specifies, that the search term is a keyword (= substring).

See Also:

Constant Field Values

SEARCHER_TYPE_REGULAR_EXPRESSION

static final int SEARCHER_TYPE_REGULAR_EXPRESSION

Specifies, that the search term is a regular expression.

See Also:

Constant Field Values

SEARCHER_TYPE_BOOLEAN

static final int SEARCHER_TYPE_BOOLEAN

Specifies, that the search term is a boolean expression.

See Also:

Constant Field Values

Method Detail

getProgram

Program getProgram(Date date,
                 String progID)

Gets a program.

Parameters:

date - The date when the program is shown.

progID - The ID of the program.

Returns:

The program or null if there is no such program.

getSubscribedChannels

Channel[] getSubscribedChannels()

Gets all channels the user has subscribed.

Returns:

all channels the user has subscribed.

getChannelDayProgram

Iterator<Program> getChannelDayProgram(Date date,
                                     Channel channel)

Gets an iterator through all programs of the specified channel at the specified date.

Parameters:

date - The date of the programs.

channel - The channel of the programs.

Returns:

an Iterator for all programs of one day and channel or null if the requested data is not available.

search

Program[] search(String regex,
               boolean inTitle,
               boolean inText,
               boolean caseSensitive,
               Channel[] channels,
               Date startDate,
               int nrDays)
                 throws TvBrowserException

Deprecated. Use createProgramSearcher(int, String, boolean) instead.

Searches the TV data for programs which match a regular expression.

Parameters:

regex - The regular expression programs must match to.

inTitle - Should be searched in the title?

inText - Should be searched in the description?

caseSensitive - Should the search be case sensitive?

channels - The channels to search in.

startDate - The date to start the search.

nrDays - The number of days to include after the start date. If negative the days before the start date are used.

Returns:

The matching programs.

Throws:

TvBrowserException - If there is a syntax error in the regular expression.

search

Program[] search(String regex,
               boolean caseSensitive,
               ProgramFieldType[] fieldArr,
               Date startDate,
               int nrDays,
               Channel[] channels,
               boolean sortByStartTime)
                 throws TvBrowserException

Deprecated. Since 1.1. Use createProgramSearcher(int, String, boolean) instead.

Searches the TV data base for programs that match a regular expression.

Parameters:

regex - The regular expression programs must match to.

caseSensitive - Should the search be case sensitive?

fieldArr - The fields to search in

startDate - The date to start the search.

nrDays - The number of days to include after the start date. If negative the days before the start date are used.

channels - The channels to search in.

sortByStartTime - Should the results be sorted by the start time? If not, the results will be grouped by date and channel and the search will be faster.

Returns:

The matching programs.

Throws:

TvBrowserException - Error while searching

createProgramSearcher

ProgramSearcher createProgramSearcher(int type,
                                    String searchTerm,
                                    boolean caseSensitive)
                                      throws TvBrowserException

Creates a ProgramSearcher.

Parameters:

type - The searcher type to create. Must be one of SEARCHER_TYPE_EXACTLY, SEARCHER_TYPE_KEYWORD, SEARCHER_TYPE_REGULAR_EXPRESSION or SEARCHER_TYPE_BOOLEAN.

searchTerm - The search term the searcher should look for.

caseSensitive - Specifies whether the searcher should be case sensitive.

Returns:

A program searcher.

Throws:

TvBrowserException - If creating the program searcher failed.

getActivatedPlugins

PluginAccess[] getActivatedPlugins()

Returns all activated Plugins.

Returns:

all activated Plugins.

Since:

1.1

getJavaPluginId

String getJavaPluginId(Plugin javaPlugin)

Gets the ID of the given Java plugin.

Parameters:

javaPlugin - The Java plugin to get the ID for.

Returns:

The ID of the given Java plugin.

getActivatedPluginForId

PluginAccess getActivatedPluginForId(String pluginId)

Gets the activated plugin with the given ID.

Parameters:

pluginId - The ID of the wanted plugin.

Returns:

The plugin with the given ID or null if no such plugin exists or if the plugin is not activated.

getInstalledPlugins

Plugin[] getInstalledPlugins()

Deprecated. Since 1.1. Use getActivatedPlugins() instead.

Returns a list of all installed Plugins.

This method always returns an empty array! Use getActivatedPlugins() instead!

Returns:

An empty array!

getDataService

TvDataService getDataService(String dataServiceClassName)

Deprecated.

Gets a TvDataService for a class name.

Parameters:

dataServiceClassName - the class name of the wanted TvDataService.

Returns:

The TvDataService or null if there is no such TvDataService.

getDataServiceProxy

TvDataServiceProxy getDataServiceProxy(String id)

createPluginContextMenu

JPopupMenu createPluginContextMenu(Program program,
                                 ContextMenuIf caller)

Creates a context menu for the given program containing all plugins.

Parameters:

program - The program to create the context menu for

caller - The calling plugin.

Returns:

a context menu for the given program.

getAvailableFilters

ProgramFilter[] getAvailableFilters()

Deprecated. Since 2.5 Use FilterManager.getAvailableFilters() instead.

Returns an array of all available filters.

Returns:

An array of all available filters.

Since:

0.9.7.4

getExampleProgram

Program getExampleProgram()

Returns an example program. You can use it for preview stuff.

Returns:

an example program.

Since:

0.9.7.4

handleProgramSingleClick

void handleProgramSingleClick(Program program)

Handles a single left click on a program.

Executes the single left click context menu function. Plugins should use handleProgramDoubleClick(Program program, Plugin caller). It prevents the Plugin to be activated a second time.

Parameters:

program - The program to pass to the single left click context menu function.

Since:

2.7

handleProgramSingleClick

void handleProgramSingleClick(Program program,
                            ContextMenuIf caller)

Handles a single left click on a program.

Executes the default context menu plugin.

Parameters:

program - The program to pass to the default context menu function.

caller - The ContextMenuIf that calls this. Prevents the ContextMenuIf to be activated twice

Since:

2.7

handleProgramDoubleClick

void handleProgramDoubleClick(Program program)

Handles a double click on a program.

Executes the default context menu plugin. Plugins should use handleProgramDoubleClick(Program program, Plugin caller). It prevents the Plugin to be activated a second time.

Parameters:

program - The program to pass to the default context menu plugin.

Since:

1.1

handleProgramDoubleClick

void handleProgramDoubleClick(Program program,
                            ContextMenuIf caller)

Handles a double click on a program.

Executes the default context menu plugin.

Parameters:

program - The program to pass to the default context menu plugin.

caller - The ContextMenuIf that calls this. Prevents the ContextMenuIf to be activated twice

Since:

1.1

handleProgramMiddleClick

void handleProgramMiddleClick(Program program)

Handles a middle click on a program.

Executes the middle click context menu plugin. Plugins should use handleProgramMiddleClick(Program program, Plugin caller). It prevents the Plugin to be activated a second time.

Parameters:

program - The program to pass to the middle click context menu plugin.

Since:

1.1

handleProgramMiddleClick

void handleProgramMiddleClick(Program program,
                            ContextMenuIf caller)

Handles a middle click on a program.

Executes the middle click context menu plugin.

Parameters:

program - The program to pass to the middle click context menu plugin.

caller - The ContextMenuIf that calls this. Prevents the ContextMenuIf to be activated twice.

Since:

1.1

getTvBrowserSettings

TvBrowserSettings getTvBrowserSettings()

Returns some settings a plugin may need.

Returns:

Some settings a plugin may need.

getIconFromTheme

ImageIcon getIconFromTheme(Plugin plugin,
                         String category,
                         String icon,
                         int size)

Returns an Icon from the Icon-Theme-System If your Plugin has Icons that are not available as Icons within an Theme, you can add your Icons into your Jar-File. The Directory-Structure must be like this: [PackageOfYourPlugin]/icons/[Size]x[Size]/[category]/[icon].png Please try to use the FreeDesktop-Icon Naming Conventions http://cvs.freedesktop.org/[*]checkout[*]/icon-theme/default-icon-theme/spec/icon-naming-spec.xml (please remove the [ ])

Parameters:

plugin - Plugin that wants to load an Icon

category - Category of the Icon (Action, etc...)

icon - Icon-Name without File-Extension

size - Size of the Icon

Returns:

Icon if found, null if not

Since:

2.2

getIconFromTheme

ImageIcon getIconFromTheme(Plugin plugin,
                         ThemeIcon icon)

Returns an Icon from the Icon-Theme-System If your Plugin has Icons that are not available as Icons within an Theme, you can add your Icons into your Jar-File. The Directory-Structure must be like this: [PackageOfYourPlugin]/icons/[Size]x[Size]/[category]/[icon].png Please try to use the FreeDesktop-Icon Naming Conventions http://cvs.freedesktop.org/[*]checkout[*]/icon-theme/default-icon-theme/spec/icon-naming-spec.xml (please remove the [ ])

Parameters:

plugin - Plugin that wants to load an Icon

icon - Icon in the Icon-Theme

Returns:

Icon if found, null if not

Since:

2.2

showSettings

void showSettings(Plugin plugin)

Show the Settings-Dialog for a Plugin

Parameters:

plugin - Use this Plugin

Since:

2.2

showSettings

void showSettings(String settingsItem)

Show the Settings-Dialog with a Specific SettingsItem

Parameters:

settingsItem - SettingsItem to show (e.g. SettingsItem.CHANNELS)

Since:

2.2

getMarkedPrograms

Program[] getMarkedPrograms()

Return all marked programs.

Returns:

The marked programs

Since:

2.2

getReceiveIfs

ProgramReceiveIf[] getReceiveIfs()

Return all Plugins/Functions that are able to receive programs.

Returns:

The ProgramReceiveIfs.

Since:

2.5

getReceiveIfs

ProgramReceiveIf[] getReceiveIfs(ProgramReceiveIf caller,
                               ProgramReceiveTarget callerTarget)

Return all Plugins/Functions that are able to receive programs.

Parameters:

caller - The caller ProgramReceiveIf.

callerTarget - The target that calls the receive if array.

Returns:

The ProgramReceiveIfs.

Since:

2.5

getReceiceIfForId

ProgramReceiveIf getReceiceIfForId(String id)

Return the ReceiveIfFor given id or null if there is no ReceiveIf for the given id.

Parameters:

id - The id of the ReceiveIf.

Returns:

The ReceiveIf with the given id or null

Since:

2.5

scrollToProgram

void scrollToProgram(Program program)

Let TVB scroll to the given program.

Parameters:

program - The program to scroll to.

Since:

2.5

scrollToTime

void scrollToTime(int time)

Let TVB scroll to the given time.

Parameters:

time - The time to scroll to in minutes.

Since:

2.5

scrollToChannel

void scrollToChannel(Channel channel)

Let TVB scroll to the given channel.

Parameters:

channel - The channel to scroll to.

Since:

2.5

goToDate

void goToDate(Date date)

Let TVB change the date to the given date.

Parameters:

date - The date to show the program for.

Since:

2.5

getFilterManager

FilterManager getFilterManager()

Returns the filter manager of TV-Browser. With the filter manager you get access to the filter system of TV-Browser. You can add or remove filters of you plugin and switch the current used filter.

Don't use this method until TV-Browser is fully loaded.

Returns:

The filter manager of TV-Browser or null if TV-Browser isn't fully loaded.

Since:

2.5

getAvailableGlobalPuginProgramFormatings

AbstractPluginProgramFormating[] getAvailableGlobalPuginProgramFormatings()

Gets the available global program configurations.

Returns:

The available global program configurations.

Since:

2.5.1

getCurrentDate

Date getCurrentDate()

Get the date currently shown in the program table.

Returns:

date currently shown in program table

Since:

2.6

getAllProgramRatingIfs

ProgramRatingIf[] getAllProgramRatingIfs()

Gets all ProgramRatingIfs of all plugins. You can get all available ratings for ~ one program.

Returns:

all ProgramRatingIfs of all plugins

Since:

2.7