public abstract class AbstractPluginProxy extends Object implements PluginProxy, ContextMenuIf
This means that
PluginProxy.Comparator
Modifier and Type | Field and Description |
---|---|
static Localizer |
mLocalizer
The localizer for this class.
|
Modifier | Constructor and Description |
---|---|
protected |
AbstractPluginProxy() |
Modifier and Type | Method and Description |
---|---|
void |
addToArtificialPluginTree(MutableProgram program) |
protected void |
assertActivatedState()
Checks whether the plugin is activated.
|
boolean |
canReceivePrograms()
Deprecated.
Since 2.5
|
boolean |
canReceiveProgramsWithTarget()
Gets whether the plugin supports receiving programs from other plugins with target.
|
boolean |
canUseProgramTree() |
protected abstract boolean |
doCanReceivePrograms()
Deprecated.
Since 2.5
|
protected abstract boolean |
doCanReceiveProgramsWithTarget()
Really gets whether the plugin supports receiving programs from other
plugins with target.
|
protected abstract boolean |
doCanUseProgramTree() |
protected abstract PluginsProgramFilter[] |
doGetAvailableFilter()
Really returns the available program filters that the plugin supports.
|
protected abstract Class<? extends PluginsFilterComponent>[] |
doGetAvailableFilterComponentClasses()
Really gets the available filter component classes.
|
protected abstract ActionMenu |
doGetButtonAction()
Really gets the action to use for the main menu and the toolbar.
|
protected abstract PluginInfo |
doGetInfo()
Really gets the meta information about the plugin.
|
protected abstract Icon[] |
doGetMarkIcons(Program p)
Really gets the icon to use for marking programs in the program table.
|
protected abstract int |
doGetMarkPriorityForProgram(Program p)
Really gets the mark priority for the given Program.
|
protected abstract ProgramReceiveTarget[] |
doGetProgramReceiveTargets()
Really return an array of receive target or
null if there is no target |
protected abstract Icon[] |
doGetProgramTableIcons(Program program)
Really gets the icons this Plugin provides for the given program.
|
protected abstract String |
doGetProgramTableIconText()
Gets the description text for the program table icons provided by this
Plugin.
|
protected abstract SettingsTabProxy |
doGetSettingsTab()
Rally gets the SettingsTab object, which is added to the settings-window.
|
protected abstract void |
doHandleTvBrowserStartFinished() |
protected abstract void |
doHandleTvDataAdded(ChannelDayProgram newProg)
This method is automatically called, when TV data was added.
|
protected abstract void |
doHandleTvDataAdded(MutableChannelDayProgram newProg)
This method is automatically called, when TV data was added.
|
protected abstract void |
doHandleTvDataDeleted(ChannelDayProgram oldProg)
This method is automatically called, when TV data was deleted.
|
protected abstract void |
doHandleTvDataTouched(ChannelDayProgram removedDayProgram,
ChannelDayProgram addedDayProgram)
This method is automatically called, when TV data was added.
|
protected abstract void |
doHandleTvDataUpdateFinished()
This method is automatically called, when the TV data update is finished.
|
protected abstract boolean |
doIsAllowedToDeleteProgramFilter(PluginsProgramFilter programFilter)
Really return if a program filter can be deleted.
|
protected abstract void |
doLoadSettings(File userDirectory)
Really loads the settings for this plugin.
|
protected abstract void |
doOnActivation() |
protected abstract void |
doOnDeactivation() |
protected abstract void |
doReceivePrograms(Program[] programArr)
Deprecated.
Since 2.5
|
protected abstract boolean |
doReceivePrograms(Program[] programArr,
ProgramReceiveTarget receiveTarget)
Really receives a list of programs from another plugin with target.
|
protected abstract boolean |
doReceiveValues(String[] values,
ProgramReceiveTarget receiveTarget)
Really receives a list of Strings from another plugin with a target.
|
protected abstract void |
doSaveSettings(File userDirectory,
boolean log)
Really saves the settings for this plugin.
|
PluginTreeNode |
getArtificialRootNode() |
PluginsProgramFilter[] |
getAvailableFilter()
Returns the available program filters that the plugin supports.
|
Class<? extends PluginsFilterComponent>[] |
getAvailableFilterComponentClasses()
Returns the available plugins filter component classes.
|
ActionMenu |
getButtonAction()
Gets the action to use for the main menu and the toolbar.
|
ActionMenu |
getContextMenuActions(Program program)
Gets the actions for the context menu of a program.
|
PluginInfo |
getInfo()
Gets the meta information about the plugin.
|
Icon |
getMarkIcon()
Gets the icon to use for marking programs in the program table.
|
Icon[] |
getMarkIcons(Program p)
Gets the icons to use for marking programs in the program table.
|
int |
getMarkPriorityForProgram(Program p)
Gets the mark priority for the given program that this Plugin uses.
|
Icon |
getPluginIcon()
get the icon to represent this plugin in the settings
|
ProgramReceiveTarget[] |
getProgramReceiveTargets()
Returns an array of receive target or
null if there is no target |
Icon[] |
getProgramTableIcons(Program program)
Gets the icons this Plugin provides for the given program.
|
String |
getProgramTableIconText()
Gets the description text for the program table icons provided by this
Plugin.
|
SettingsTabProxy |
getSettingsTab()
Gets the SettingsTab object, which is added to the settings-window.
|
protected abstract ActionMenu |
goGetContextMenuActions(Program program)
Really gets the actions for the context menu of a program.
|
void |
handlePluginException(Throwable t)
Handles a runtime exception that was caused by the plugin.
|
void |
handleTvBrowserStartFinished()
This method is called when the TV-Browser start is complete.
|
void |
handleTvDataAdded(ChannelDayProgram newProg)
This method is automatically called, when TV data was added.
|
void |
handleTvDataAdded(MutableChannelDayProgram newProg)
This method is automatically called, when TV data was added.
|
void |
handleTvDataDeleted(ChannelDayProgram oldProg)
This method is automatically called, when TV data was deleted.
|
void |
handleTvDataTouched(ChannelDayProgram removedDayProgram,
ChannelDayProgram addedDayProgram)
This method is automatically called, when TV data was touched (that means something was done with it).
|
void |
handleTvDataUpdateFinished()
This method is automatically called, when the TV data update is finished.
|
boolean |
hasArtificialPluginTree() |
boolean |
isActivated()
Gets whether the plugin is currently activated.
|
boolean |
isAllowedToDeleteProgramFilter(PluginsProgramFilter programFilter)
Is used to track if a program filter be deleted.
|
(package private) void |
loadSettings(File userDirectory)
Loads the settings for this plugin.
|
void |
onActivation()
This method is automatically called, when the plugin after activating
the plugin.
|
void |
onDeactivation()
This method is automatically called, when the plugin after deactivating
the plugin.
|
void |
receivePrograms(Program[] programArr)
Deprecated.
Since 2.5
|
boolean |
receivePrograms(Program[] programArr,
ProgramReceiveTarget receiveTarget)
Receives a list of programs from another plugin with a target.
|
boolean |
receiveValues(String[] values,
ProgramReceiveTarget receiveTarget)
Receives a list of Strings from another plugin with a target.
|
void |
removeArtificialPluginTree() |
(package private) void |
saveSettings(File userDirectory,
boolean log)
Saves the settings for this plugin.
|
(package private) void |
setActivated(boolean activated)
Sets whether the plugin is currently activated.
|
(package private) abstract void |
setParentFrame(Frame parent)
Sets the parent frame to the plugin.
|
String |
toString()
Gets the name of the plugin.
|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
getPluginFileName, getProgramRatingIfs, getRootNode
getId
getButtonActionDescription
public static final Localizer mLocalizer
public final boolean isActivated()
isActivated
in interface PluginProxy
setActivated(boolean)
,
assertActivatedState()
final void setActivated(boolean activated)
This method may only be called by the PluginProxyManager
(that's
why it is package private).
activated
- Whether the plugin is currently activated.isActivated()
,
assertActivatedState()
abstract void setParentFrame(Frame parent)
parent
- The parent frame to set.final void loadSettings(File userDirectory) throws TvBrowserException
userDirectory
- The directory where the user data is stored.TvBrowserException
- If loading failed.protected abstract void doLoadSettings(File userDirectory) throws TvBrowserException
userDirectory
- The directory where the user data is stored.TvBrowserException
- If loading failed.final void saveSettings(File userDirectory, boolean log) throws TvBrowserException
userDirectory
- The directory where the user data is stored.TvBrowserException
- If saving failed.protected abstract void doSaveSettings(File userDirectory, boolean log) throws TvBrowserException
userDirectory
- The directory where the user data is stored.TvBrowserException
- If saving failed.public final PluginInfo getInfo()
getInfo
in interface PluginAccess
protected abstract PluginInfo doGetInfo()
@Deprecated public final boolean canReceivePrograms()
canReceivePrograms
in interface ProgramReceiveIf
receivePrograms(Program[])
@Deprecated protected abstract boolean doCanReceivePrograms()
receivePrograms(Program[])
@Deprecated public final void receivePrograms(Program[] programArr)
receivePrograms
in interface ProgramReceiveIf
programArr
- The programs passed from the other plugin.canReceivePrograms()
@Deprecated protected abstract void doReceivePrograms(Program[] programArr)
programArr
- The programs passed from the other plugin.canReceivePrograms()
public final SettingsTabProxy getSettingsTab()
getSettingsTab
in interface PluginProxy
null
if the plugin does
not provide this feature.protected abstract SettingsTabProxy doGetSettingsTab()
null
if the plugin does
not provide this feature.public final ActionMenu getContextMenuActions(Program program)
getContextMenuActions
in interface ContextMenuIf
program
- The program the context menu will be shown for.null
if the plugin does not provide this feature.protected abstract ActionMenu goGetContextMenuActions(Program program)
program
- The program the context menu will be shown for.null
if the plugin does not provide this feature.getContextMenuActions(Program)
public final ActionMenu getButtonAction()
getButtonAction
in interface ButtonActionIf
getButtonAction
in interface PluginProxy
null
if the plugin does not provide this feature.protected abstract ActionMenu doGetButtonAction()
null
if the plugin does not provide this feature.getButtonAction()
public Icon[] getMarkIcons(Program p)
getMarkIcons
in interface Marker
getMarkIcons
in interface PluginAccess
public Icon getMarkIcon()
getMarkIcon
in interface Marker
getMarkIcon
in interface PluginAccess
protected abstract Icon[] doGetMarkIcons(Program p)
public final String getProgramTableIconText()
Return null
if your plugin does not provide this feature.
getProgramTableIconText
in interface PluginAccess
null
if the plugin does not provide this feature.getProgramTableIcons(Program)
protected abstract String doGetProgramTableIconText()
Return null
if your plugin does not provide this feature.
null
if the plugin does not provide this feature.getProgramTableIcons(Program)
public final Icon[] getProgramTableIcons(Program program)
Return null
if your plugin does not provide this feature.
getProgramTableIcons
in interface PluginAccess
program
- The programs to get the icons for.null
.getProgramTableIconText()
protected abstract Icon[] doGetProgramTableIcons(Program program)
Return null
if your plugin does not provide this feature.
program
- The programs to get the icons for.null
.getProgramTableIconText()
public final void handleTvDataUpdateFinished()
handleTvDataUpdateFinished
in interface PluginProxy
handleTvDataAdded(ChannelDayProgram)
,
handleTvDataDeleted(ChannelDayProgram)
protected abstract void doHandleTvDataUpdateFinished()
public void handleTvDataAdded(MutableChannelDayProgram newProg)
The TV data can be modified by the plugin!
Override this method if you want to change/add data.
Don't do other things than changing/adding data,
use handleTvDataAdded(ChannelDayProgram)
istead.
newProg
- The new ChannelDayProgram.handleTvDataDeleted(ChannelDayProgram)
,
#handleTvDataChanged()
protected abstract void doHandleTvDataAdded(MutableChannelDayProgram newProg)
The TV data can be modified by the plugin!
Override this method if you want to change/add data.
Don't do other things than changing/adding data,
use handleTvDataAdded(ChannelDayProgram)
istead.
newProg
- The new ChannelDayProgram.handleTvDataDeleted(ChannelDayProgram)
,
#handleTvDataChanged()
public final void handleTvDataAdded(ChannelDayProgram newProg)
The TV data may be modified by the plugin! So this method must be called before new TV data is saved.
handleTvDataAdded
in interface PluginProxy
newProg
- The new ChannelDayProgram.handleTvDataDeleted(ChannelDayProgram)
,
handleTvDataUpdateFinished()
protected abstract void doHandleTvDataAdded(ChannelDayProgram newProg)
The TV data may be modified by the plugin! So this method must be called before new TV data is saved.
newProg
- The new ChannelDayProgram.handleTvDataDeleted(ChannelDayProgram)
,
handleTvDataUpdateFinished()
public final void handleTvDataDeleted(ChannelDayProgram oldProg)
handleTvDataDeleted
in interface PluginProxy
oldProg
- The old ChannelDayProgram which was deleted.handleTvDataAdded(ChannelDayProgram)
,
handleTvDataUpdateFinished()
protected abstract void doHandleTvDataDeleted(ChannelDayProgram oldProg)
oldProg
- The old ChannelDayProgram which was deleted.handleTvDataAdded(ChannelDayProgram)
,
handleTvDataUpdateFinished()
public final void handleTvDataTouched(ChannelDayProgram removedDayProgram, ChannelDayProgram addedDayProgram)
handleTvDataTouched
in interface PluginProxy
removedDayProgram
- The old ChannelDayProgram.addedDayProgram
- The new ChannelDayProgram.handleTvDataAdded(ChannelDayProgram)
,
handleTvDataDeleted(ChannelDayProgram)
,
handleTvDataUpdateFinished()
protected abstract void doHandleTvDataTouched(ChannelDayProgram removedDayProgram, ChannelDayProgram addedDayProgram)
The TV data may be modified by the plugin! So this method must be called before new TV data is saved.
newProg
- The new ChannelDayProgram.handleTvDataAdded(ChannelDayProgram)
,
handleTvDataDeleted(ChannelDayProgram)
,
handleTvDataUpdateFinished()
public void onActivation()
PluginProxy
onActivation
in interface PluginProxy
protected abstract void doOnActivation()
public void onDeactivation()
PluginProxy
onDeactivation
in interface PluginProxy
protected abstract void doOnDeactivation()
public boolean canUseProgramTree()
canUseProgramTree
in interface PluginProxy
public void handleTvBrowserStartFinished()
handleTvBrowserStartFinished
in interface PluginProxy
protected abstract void doHandleTvBrowserStartFinished()
protected abstract boolean doCanUseProgramTree()
public final String toString()
This way Plugin objects may be used directly in GUI components like JLists.
public void handlePluginException(Throwable t)
handlePluginException
in interface PluginProxy
t
- The exception to handlepublic final boolean canReceiveProgramsWithTarget()
canReceiveProgramsWithTarget
in interface ProgramReceiveIf
receivePrograms(Program[],ProgramReceiveTarget)
protected abstract boolean doCanReceiveProgramsWithTarget()
receivePrograms(Program[],ProgramReceiveTarget)
public final boolean receivePrograms(Program[] programArr, ProgramReceiveTarget receiveTarget)
receivePrograms
in interface ProgramReceiveIf
programArr
- The programs passed from the other plugin.receiveTarget
- The target of the programs.canReceiveProgramsWithTarget()
protected abstract boolean doReceivePrograms(Program[] programArr, ProgramReceiveTarget receiveTarget)
programArr
- The programs passed from the other plugin with target.receiveTarget
- The target of the programs.canReceiveProgramsWithTarget()
public final boolean receiveValues(String[] values, ProgramReceiveTarget receiveTarget)
receiveValues
in interface ProgramReceiveIf
values
- The value array passed from the other plugin.target
- The receive target of the programs.True
if the value array was handled correct,
false otherwise.canReceiveProgramsWithTarget()
protected abstract boolean doReceiveValues(String[] values, ProgramReceiveTarget receiveTarget)
values
- The value array passed from the other plugin.target
- The receive target of the programs.True
if the value array was handled correct,
false otherwise.canReceiveProgramsWithTarget()
public final ProgramReceiveTarget[] getProgramReceiveTargets()
null
if there is no targetgetProgramReceiveTargets
in interface ProgramReceiveIf
canReceiveProgramsWithTarget()
,
receivePrograms(Program[],ProgramReceiveTarget)
protected abstract ProgramReceiveTarget[] doGetProgramReceiveTargets()
null
if there is no targetcanReceiveProgramsWithTarget()
,
receivePrograms(Program[],ProgramReceiveTarget)
public PluginsProgramFilter[] getAvailableFilter()
getAvailableFilter
in interface PluginAccess
null
if it supports no filter.protected abstract PluginsProgramFilter[] doGetAvailableFilter()
null
if it supports no filter.public boolean isAllowedToDeleteProgramFilter(PluginsProgramFilter programFilter)
isAllowedToDeleteProgramFilter
in interface PluginProxy
programFilter
- The program filter to delete.protected abstract boolean doIsAllowedToDeleteProgramFilter(PluginsProgramFilter programFilter)
programFilter
- The program filter to delete.public Class<? extends PluginsFilterComponent>[] getAvailableFilterComponentClasses()
(Class extends PluginsFilterComponent>[]) new Class[] {MyFilterComponent1.class,MyFilterComponent2.class};
because the creation of a class array with generic type didn't work.getAvailableFilterComponentClasses
in interface PluginAccess
null
if no plugins filter components are supported.protected abstract Class<? extends PluginsFilterComponent>[] doGetAvailableFilterComponentClasses()
null
if no plugins filter components are supported.public int getMarkPriorityForProgram(Program p)
The mark priority can be Program.NO_MARK_PRIORITY
, Program.MIN_MARK_PRIORITY
, Program.LOWER_MEDIUM_MARK_PRIORITY
,
Program.MEDIUM_MARK_PRIORITY
, Program.HIGHER_MEDIUM_MARK_PRIORITY
or
Program.MAX_MARK_PRIORITY
.
getMarkPriorityForProgram
in interface Marker
p
- The program to get the mark prioriy for.protected abstract int doGetMarkPriorityForProgram(Program p)
p
- The program to get the mark priority for.protected void assertActivatedState() throws TvBrowserException
TvBrowserException
- If the plugin is not activatedpublic Icon getPluginIcon()
PluginProxy
getPluginIcon
in interface PluginProxy
public final boolean hasArtificialPluginTree()
hasArtificialPluginTree
in interface PluginProxy
public final void addToArtificialPluginTree(MutableProgram program)
addToArtificialPluginTree
in interface PluginProxy
public final PluginTreeNode getArtificialRootNode()
getArtificialRootNode
in interface PluginProxy
public final void removeArtificialPluginTree()
TV-Browser 2.7.6, Copyright (C) 04-2003 Martin Oberhauser (martin@tvbrowser.org)