org.eclipse.rse.core.filters
Interface ISystemFilterPoolManager
-
All Superinterfaces:
-
IRSEPersistableContainer
-
public interface ISystemFilterPoolManager
- extends
IRSEPersistableContainer
A filter pool manager manages filter pools.
Further, this is the front door for working with filters too. By forcing all
filter related activity through a single point like this, we can ensure that
all changes are saved to disk, and events are fired properly.
Method Summary
|
ISystemFilterString
|
addSystemFilterString
(
ISystemFilter filter,
String newString)
Append a new filter string to the given filter's list
Does the following:
Adds the filter string to the in-memory cache
Saves parent filter pool to disk. |
ISystemFilterString
|
addSystemFilterString
(
ISystemFilter filter,
String newString,
int position)
Insert a new filter string to the given filter's list, at the given zero-based position
Does the following:
Adds the filter string to the in-memory cache
Saves parent filter pool to disk. |
boolean
|
areStringsCaseSensitive
()
|
ISystemFilter
|
copySystemFilter
(
ISystemFilterPool targetPool,
ISystemFilter oldFilter,
String newName)
Copy a system filter to a pool in this or another filter manager. |
ISystemFilterPool
|
copySystemFilterPool
(
ISystemFilterPoolManager targetMgr,
ISystemFilterPool pool,
String newName)
Copy the specified filter pool from this manager to this manager or another manager. |
void
|
copySystemFilterPools
(
ISystemFilterPoolManager targetMgr)
Copy all filter pools from this manager to another manager. |
ISystemFilterString
|
copySystemFilterString
(
ISystemFilter targetFilter,
ISystemFilterString oldFilterString)
Copy a system filter string to a filter in this or another filter pool manager. |
ISystemFilter
|
createSystemFilter
(
ISystemFilterContainer parent,
String aliasName,
List filterStrings)
Creates a new system filter within the given filter container (either a
filter pool, or a filter). |
ISystemFilter
|
createSystemFilter
(
ISystemFilterContainer parent,
String aliasName,
List filterStrings,
String type)
Creates a new system filter that is typed. |
ISystemFilter
|
createSystemFilter
(
ISystemFilterContainer parent,
String aliasName,
List filterStrings,
String type,
boolean promptable)
Creates a new system filter that is typed and promptable Same as
createSystemFilter(ISystemFilterContainer, String ,String[], String)
but takes a boolean indicating if it is promptable. |
ISystemFilter
|
createSystemFilter
(
ISystemFilterContainer parent,
String aliasName,
String[] filterStrings)
Creates a new system filter within the given filter container (either a
filter pool, or a filter). |
ISystemFilter
|
createSystemFilter
(
ISystemFilterContainer parent,
String aliasName,
String[] filterStrings,
String type)
Creates a new system filter that is typed. |
ISystemFilter
|
createSystemFilter
(
ISystemFilterContainer parent,
String aliasName,
String[] filterStrings,
String type,
boolean promptable)
Creates a new system filter that is typed and promptable Same as
createSystemFilter(ISystemFilterContainer, String ,String[], String)
but takes a boolean indicating if it is promptable. |
ISystemFilterPool
|
createSystemFilterPool
(
String name,
boolean isDeletable)
Create a new filter pool. |
void
|
deleteAllSystemFilterPools
()
Delete all existing filter pools. |
boolean
|
deleteSystemFilter
(
ISystemFilter filter)
Delete an existing system filter. |
void
|
deleteSystemFilterPool
(
ISystemFilterPool pool)
Delete a given filter pool. |
ISystemFilterPool
|
getFirstDefaultSystemFilterPool
()
Return the first pool that has the default attribute set to true. |
String
|
getName
()
Return the name of this manager. |
ISystemFilterPoolManagerProvider
|
getProvider
()
Return the caller which instantiated the filter pool manager |
ISystemFilterPool
|
getSystemFilterPool
(
String name)
Given a filter pool name, return that filter pool object. |
Object
|
getSystemFilterPoolManagerData
()
Return transient data set via setFilterPoolDataManager. |
String[]
|
getSystemFilterPoolNames
()
Get array of filter pool names currently existing. |
ISystemFilterPool[]
|
getSystemFilterPools
()
Return array of SystemFilterPools managed by this manager. |
int
|
getSystemFilterPosition
(
ISystemFilter filter)
Return the zero-based position of a SystemFilter object within its container |
int
|
getSystemFilterStringPosition
(
ISystemFilterString filterString)
Return the zero-based position of a SystemFilterString object within its filter |
ISystemProfile
|
getSystemProfile
()
Return the owning profile for this provider |
boolean
|
isSetSupportsDuplicateFilterStrings
()
|
boolean
|
isSingleFilterStringOnly
()
Returns the value of the '
Single Filter String Only
' attribute |
boolean
|
isStringsCaseSensitive
()
|
boolean
|
isSupportsDuplicateFilterStrings
()
|
boolean
|
isSupportsNestedFilters
()
|
ISystemFilter
|
moveSystemFilter
(
ISystemFilterPool targetPool,
ISystemFilter oldFilter,
String newName)
Move a system filter to a pool in this or another filter manager. |
ISystemFilterPool
|
moveSystemFilterPool
(
ISystemFilterPoolManager targetMgr,
ISystemFilterPool oldPool,
String newName)
Move the specified filter pool from this manager to another manager. |
void
|
moveSystemFilters
(
ISystemFilter[] filters,
int delta)
Move existing filters a given number of positions in the same container. |
ISystemFilterString
|
moveSystemFilterString
(
ISystemFilter targetFilter,
ISystemFilterString oldFilterString)
Move a system filter string to a filter in this or another filter pool manager. |
void
|
moveSystemFilterStrings
(
ISystemFilterString[] filterStrings,
int delta)
Move existing filter strings a given number of positions in the same filter
If the delta is negative, they are all moved up by the given amount. |
void
|
orderSystemFilters
(
ISystemFilterPool pool,
String[] names)
Order filters according to user preferences. |
boolean
|
preTestRenameFilterPool
(
ISystemFilterPool pool)
Pre-test if we are going to run into any trouble renaming any of the files or folders
used to persist a filter pool. |
boolean
|
removeSystemFilterString
(
ISystemFilter filter,
int position)
Remove a filter string from the given filter's list, given its zero-based position
Does the following:
Removes the filter string from the in-memory cache
Saves parent filter pool to disk. |
boolean
|
removeSystemFilterString
(
ISystemFilter filter,
ISystemFilterString filterString)
Remove a filter string from this filter's list, given its SystemFilterString object. |
boolean
|
removeSystemFilterString
(
ISystemFilter filter,
String oldString)
Delete a filter string from the given filter's list
Does the following:
Removes the filter string from the in-memory cache
Saves parent filter pool to disk. |
void
|
renameSystemFilter
(
ISystemFilter filter,
String newName)
Renames a filter. |
void
|
renameSystemFilterPool
(
ISystemFilterPool pool,
String newName)
Rename a filter pool. |
void
|
setName
(
String name)
Set the name of this manager. |
void
|
setProvider
(
ISystemFilterPoolManagerProvider caller)
Set the caller instance which instantiated the filter pool manager. |
void
|
setSingleFilterStringOnly
(boolean value)
Sets the value of the '
Single Filter String Only ' attribute |
void
|
setStringsCaseSensitive
(boolean value)
|
void
|
setSupportsDuplicateFilterStrings
(boolean supports)
Set attribute indicating if filters managed by this manager support duplicate filter strings, by default. |
void
|
setSupportsNestedFilters
(boolean supports)
Set attribute indicating if filter pools managed by this manager support nested filters, by default. |
void
|
setSystemFilterPoolManagerData
(
Object data)
This is to set transient data that is subsequently queryable. |
void
|
setSystemFilterType
(
ISystemFilter filter,
String newType)
Sets a filter's type. |
boolean
|
supportsDuplicateFilterStrings
()
Return attribute indicating if filters managed by this manager support nested duplicate filter strings. |
boolean
|
supportsNestedFilters
()
Return attribute indicating if filter pools managed by this manager support nested filters. |
void
|
suspendCallbacks
(boolean suspend)
Suspend callbacks to the provider |
void
|
unsetSupportsDuplicateFilterStrings
()
|
void
|
updateSystemFilter
(
ISystemFilter filter,
String newName,
String[] strings)
Updates a filter. |
void
|
updateSystemFilterString
(
ISystemFilterString filterString,
String newValue)
Update a filter string's string vale
Does the following:
Update the filter string in the in-memory cache
Saves parent filter pool to disk. |
boolean
|
wasRestored
()
Return false if the instantiation of this filter pool manager resulting in a new manager versus a restoration |
getProvider
ISystemFilterPoolManagerProvider getProvider()
- Return the caller which instantiated the filter pool manager
-
-
getSystemProfile
ISystemProfile getSystemProfile()
- Return the owning profile for this provider
-
-
setProvider
void setProvider(
ISystemFilterPoolManagerProvider caller)
- Set the caller instance which instantiated the filter pool manager.
This is only recorded to enable getProvider from any filter framework object.
-
-
setSystemFilterPoolManagerData
void setSystemFilterPoolManagerData(
Object data)
- This is to set transient data that is subsequently queryable.
-
-
getSystemFilterPoolManagerData
Object getSystemFilterPoolManagerData()
- Return transient data set via setFilterPoolDataManager.
-
-
getName
String getName()
- Return the name of this manager.
This matches the name of the folder, which is the parent of the individual filter pool folders.
-
-
setName
void setName(
String name)
- Set the name of this manager.
-
-
supportsNestedFilters
boolean supportsNestedFilters()
- Return attribute indicating if filter pools managed by this manager support nested filters.
-
-
supportsDuplicateFilterStrings
boolean supportsDuplicateFilterStrings()
- Return attribute indicating if filters managed by this manager support nested duplicate filter strings.
-
-
setSupportsNestedFilters
void setSupportsNestedFilters(boolean supports)
- Set attribute indicating if filter pools managed by this manager support nested filters, by default.
-
-
setSupportsDuplicateFilterStrings
void setSupportsDuplicateFilterStrings(boolean supports)
- Set attribute indicating if filters managed by this manager support duplicate filter strings, by default.
-
-
isStringsCaseSensitive
boolean isStringsCaseSensitive()
-
-
-
Returns:
- The value of the StringsCaseSensitive attribute
Are filter strings in this filter case sensitive?
areStringsCaseSensitive
boolean areStringsCaseSensitive()
-
-
-
Returns:
- The value of the StringsCaseSensitive attribute
Are filter strings in this filter case sensitive?
Same as isStringsCaseSensitive()
wasRestored
boolean wasRestored()
- Return false if the instantiation of this filter pool manager resulting in a new manager versus a restoration
-
-
Specified by:
-
wasRestored
in interface
IRSEPersistableContainer
-
-
Returns:
- true if the object was created from its persistent form,
false if the object has never been persisted.
getSystemFilterPoolNames
String[] getSystemFilterPoolNames()
- Get array of filter pool names currently existing.
-
-
getSystemFilterPools
ISystemFilterPool[] getSystemFilterPools()
- Return array of SystemFilterPools managed by this manager.
-
-
getSystemFilterPool
ISystemFilterPool getSystemFilterPool(
String name)
- Given a filter pool name, return that filter pool object.
If not found, returns null.
-
-
getFirstDefaultSystemFilterPool
ISystemFilterPool getFirstDefaultSystemFilterPool()
- Return the first pool that has the default attribute set to true.
If none found, returns null.
-
-
createSystemFilterPool
ISystemFilterPool createSystemFilterPool(
String name,
boolean isDeletable)
throws
Exception
- Create a new filter pool.
Inherits the following attributes from this manager:
- data ... the transient data to be associated with every filter pool and filter
- supportsNestedFilters ... whether filters in the pool can themselves contain filters
If a pool of this name already exists, null will be returned.
Depending on the save policy, a new folder to hold the pool may be created. Its name will
be derived from the pool name.
If the operation is successful, the pool will be saved to disk.
If this operation fails unexpectedly, an exception will be thrown.
-
-
-
Throws:
-
Exception
-
See Also:
-
ISystemFilterPool.setName(String)
deleteSystemFilterPool
void deleteSystemFilterPool(
ISystemFilterPool pool)
throws
Exception
- Delete a given filter pool. Dependending on the save policy, the
appropriate file or folder on disk will also be deleted.
Does the following:
- Removes all references
- Removes pool object from in-memory model
- Removes folder from disk for policies of one folder per pool
- Removes file from disk for policy of one file per pool
- Saves model to disk for policy of one file per manager
- Invalidates in-memory caches
- Calls back to inform caller of this event
-
-
-
Parameters:
-
pool
- The filter pool object to physically delete
-
Throws:
-
Exception
deleteAllSystemFilterPools
void deleteAllSystemFilterPools()
- Delete all existing filter pools. Call this when you are about to delete this manager, say.
-
-
preTestRenameFilterPool
boolean preTestRenameFilterPool(
ISystemFilterPool pool)
throws
Exception
- Pre-test if we are going to run into any trouble renaming any of the files or folders
used to persist a filter pool.
-
-
-
Returns:
- true if everything seems ok, false if a file/folder is in use.
-
Throws:
-
Exception
renameSystemFilterPool
void renameSystemFilterPool(
ISystemFilterPool pool,
String newName)
throws
Exception
- Rename a filter pool.
- Renames pool object
- Informs any filter pool references to this pool
- Schedules a save of the pool object
-
-
-
Parameters:
-
pool
- The filter pool object to rename -
newName
- The new name to give the pool
-
Throws:
-
Exception
-
See Also:
-
ISystemFilterPool.setName(String)
copySystemFilterPool
ISystemFilterPool copySystemFilterPool(
ISystemFilterPoolManager targetMgr,
ISystemFilterPool pool,
String newName)
throws
Exception
- Copy the specified filter pool from this manager to this manager or another manager.
Does the following:
- Clones all filters within the pool
- Clones all filter strings within each filter
- Asks target manager to save to disk
- Calls back to target manager provider, unless callbacks are suspended
-
-
-
Parameters:
-
targetMgr
- The target manager to copy our filter pool to. Can be this manager, but target pool name must be unique. -
pool
- The filter pool to copy -
newName
- The new name to give the copied pool
-
Returns:
- the new copy of the copied system filter pool
-
Throws:
-
Exception
-
See Also:
-
ISystemFilterPool.setName(String)
copySystemFilterPools
void copySystemFilterPools(
ISystemFilterPoolManager targetMgr)
throws
Exception
- Copy all filter pools from this manager to another manager.
Does the following:
- Clones all filter pools
- Clones all filters within each pool
- Clones all filter strings within each filter
- Asks target manager to save to disk
- Does not callback to caller to fire events, assumes caller doesn't want to know
-
-
-
Parameters:
-
targetMgr
- The target manager to copy our filter pools to
-
Throws:
-
Exception
moveSystemFilterPool
ISystemFilterPool moveSystemFilterPool(
ISystemFilterPoolManager targetMgr,
ISystemFilterPool oldPool,
String newName)
throws
Exception
- Move the specified filter pool from this manager to another manager.
Does the following:
- Performs a
copySystemFilterPool
operation.
- If copy is successful, updates all references to reference the new copy.
- If copy is successful, deletes original filter pool in this manager
- If this final delete fails, deletes the copied version and restore original references
- Asks target manager to save to disk
- Saves this manager to disk
- Calls back to both targer manager provider and this manager provider, unless callbacks are suspended
-
-
-
Parameters:
-
targetMgr
- The target manager to move our filter pool to. Cannot be this manager. -
oldPool
- The filter pool to move -
newName
- The new name to give the moved pool
-
Returns:
- the new copy of the moved system filter pool
-
Throws:
-
Exception
-
See Also:
-
ISystemFilterPool.setName(String)
createSystemFilter
ISystemFilter createSystemFilter(
ISystemFilterContainer parent,
String aliasName,
String[] filterStrings)
throws
Exception
- Creates a new system filter within the given filter container (either a
filter pool, or a filter). This creates the filter, and then saves the
filter pool.
Calls back to provider to inform of the event (filterEventFilterCreated)
-
-
-
Parameters:
-
parent
- The parent which is either a SystemFilterPool or a
SystemFilter -
aliasName
- The name to give the new filter. Must be unique for this
pool. -
filterStrings
- The list of String objects that represent the filter
strings.
-
Throws:
-
Exception
-
Since:
- org.eclipse.rse.core 3.0
createSystemFilter
ISystemFilter createSystemFilter(
ISystemFilterContainer parent,
String aliasName,
List filterStrings)
throws
Exception
- Creates a new system filter within the given filter container (either a
filter pool, or a filter). This creates the filter, and then saves the
filter pool.
Calls back to provider to inform of the event (filterEventFilterCreated)
-
-
-
Parameters:
-
parent
- The parent which is either a SystemFilterPool or a
SystemFilter -
aliasName
- The name to give the new filter. Must be unique for this
pool. -
filterStrings
- The list of String objects that represent the filter
strings.
-
Throws:
-
Exception
-
Since:
- org.eclipse.rse.core 3.0
createSystemFilter
ISystemFilter createSystemFilter(
ISystemFilterContainer parent,
String aliasName,
String[] filterStrings,
String type)
throws
Exception
- Creates a new system filter that is typed. Same as
createSystemFilter(ISystemFilterContainer, String, String[])
but
takes a filter type as an additional parameter.
A filter's type is an arbitrary string that is not interpreted or used by
the base framework. This is for use entirely by tools who wish to support
multiple types of filters and be able to launch unique actions per type,
say.
-
-
-
Parameters:
-
parent
- The parent which is either a SystemFilterPool or a
SystemFilter -
aliasName
- The name to give the new filter. Must be unique for this
pool. -
filterStrings
- The list of String objects that represent the filter
strings. -
type
- The type of this filter
-
Throws:
-
Exception
-
Since:
- org.eclipse.rse.core 3.0
createSystemFilter
ISystemFilter createSystemFilter(
ISystemFilterContainer parent,
String aliasName,
List filterStrings,
String type)
throws
Exception
- Creates a new system filter that is typed. Same as
createSystemFilter(ISystemFilterContainer, String, String[])
but
takes a filter type as an additional parameter.
A filter's type is an arbitrary string that is not interpreted or used by
the base framework. This is for use entirely by tools who wish to support
multiple types of filters and be able to launch unique actions per type,
say.
-
-
-
Parameters:
-
parent
- The parent which is either a SystemFilterPool or a
SystemFilter -
aliasName
- The name to give the new filter. Must be unique for this
pool. -
filterStrings
- The list of String objects that represent the filter
strings. -
type
- The type of this filter
-
Throws:
-
Exception
-
Since:
- org.eclipse.rse.core 3.0
createSystemFilter
ISystemFilter createSystemFilter(
ISystemFilterContainer parent,
String aliasName,
String[] filterStrings,
String type,
boolean promptable)
throws
Exception
- Creates a new system filter that is typed and promptable Same as
createSystemFilter(ISystemFilterContainer, String ,String[], String)
but takes a boolean indicating if it is promptable.
A promptable filter is one in which the user is prompted for information
at expand time. There is no base filter framework support for this, but
tools can query this attribute and do their own thing at expand time.
-
-
-
Parameters:
-
parent
- The parent which is either a SystemFilterPool or a
SystemFilter -
aliasName
- The name to give the new filter. Must be unique for this
pool. -
filterStrings
- The list of String objects that represent the filter
strings. -
type
- The type of this filter -
promptable
- Pass true if this is a promptable filter
-
Throws:
-
Exception
-
Since:
- org.eclipse.rse.core 3.0
createSystemFilter
ISystemFilter createSystemFilter(
ISystemFilterContainer parent,
String aliasName,
List filterStrings,
String type,
boolean promptable)
throws
Exception
- Creates a new system filter that is typed and promptable Same as
createSystemFilter(ISystemFilterContainer, String ,String[], String)
but takes a boolean indicating if it is promptable.
A promptable filter is one in which the user is prompted for information
at expand time. There is no base filter framework support for this, but
tools can query this attribute and do their own thing at expand time.
-
-
-
Parameters:
-
parent
- The parent which is either a SystemFilterPool or a
SystemFilter -
aliasName
- The name to give the new filter. Must be unique for this
pool. -
filterStrings
- The list of String objects that represent the filter
strings. -
type
- The type of this filter -
promptable
- Pass true if this is a promptable filter
-
Throws:
-
Exception
-
Since:
- org.eclipse.rse.core 3.0
deleteSystemFilter
boolean deleteSystemFilter(
ISystemFilter filter)
throws
Exception
- Delete an existing system filter.
Does the following:
- Removes filter from its parent in memory.
- If appropriate for the save policy, deletes the filter's file from disk.
- Save the SystemFilterPool which direct or indirectly contains the filter.
- Calls back to provider to inform of the event (filterEventFilterDelete)
-
-
-
Throws:
-
Exception
renameSystemFilter
void renameSystemFilter(
ISystemFilter filter,
String newName)
throws
Exception
- Renames a filter. This is better than filter.setName(String newName) as it
saves the parent pool to disk.
Does the following:
- Renames the object in the in-memory cache
- If appropriate for the save policy, rename's the filter's file on disk.
- Save parent filter pool's in-memory object to disk.
- Calls back to provider to inform of the event (filterEventFilterRenamed)
-
-
-
Throws:
-
Exception
updateSystemFilter
void updateSystemFilter(
ISystemFilter filter,
String newName,
String[] strings)
throws
Exception
- Updates a filter. This is better than doing it directly as it saves it to disk.
Does the following:
- Updates the object in the in-memory cache
- Save parent filter pool's in-memory object to disk.
- Calls back to provider to inform of the event (filterEventFilterUpdated). Will be two callbacks if the name is changed ((filterEventFilterRenamed)
-
-
-
Throws:
-
Exception
setSystemFilterType
void setSystemFilterType(
ISystemFilter filter,
String newType)
throws
Exception
- Sets a filter's type. This is better than calling filter.setType(String) directly as it saves the filter to disk after.
A filter's type is an arbitrary string that is not interpreted or used by the base framework. This
is for use entirely by tools who wish to support multiple types of filters and be able to launch unique
actions per type, say.
-
-
-
Parameters:
-
filter
- The parent which is either a SystemFilter -
newType
- The type of this filter
-
Throws:
-
Exception
copySystemFilter
ISystemFilter copySystemFilter(
ISystemFilterPool targetPool,
ISystemFilter oldFilter,
String newName)
throws
Exception
- Copy a system filter to a pool in this or another filter manager.
-
-
-
Throws:
-
Exception
getSystemFilterPosition
int getSystemFilterPosition(
ISystemFilter filter)
- Return the zero-based position of a SystemFilter object within its container
-
-
moveSystemFilter
ISystemFilter moveSystemFilter(
ISystemFilterPool targetPool,
ISystemFilter oldFilter,
String newName)
throws
Exception
- Move a system filter to a pool in this or another filter manager.
Does this by first copying the filter, and only if successful, deleting the old copy.
-
-
-
Throws:
-
Exception
moveSystemFilters
void moveSystemFilters(
ISystemFilter[] filters,
int delta)
throws
Exception
- Move existing filters a given number of positions in the same container.
If the delta is negative, they are all moved up by the given amount. If
positive, they are all moved down by the given amount.
Does the following:
- After the move, the pool containing the filter is saved to disk.
- Calls back to provider to inform of the event (filterEventFiltersRePositioned)
-
-
-
Parameters:
-
filters
- Array of SystemFilters to move. -
delta
- the amount by which to move the filters
-
Throws:
-
Exception
orderSystemFilters
void orderSystemFilters(
ISystemFilterPool pool,
String[] names)
throws
Exception
- Order filters according to user preferences.
While the framework has all the code necessary to arrange filters and save/restore
that arrangement, you may choose to use preferences instead of this support.
In this case, call this method and pass in the saved and sorted filter name list.
Called by someone after restore.
-
-
-
Throws:
-
Exception
addSystemFilterString
ISystemFilterString addSystemFilterString(
ISystemFilter filter,
String newString)
throws
Exception
- Append a new filter string to the given filter's list
Does the following:
- Adds the filter string to the in-memory cache
- Saves parent filter pool to disk.
- Calls back to provider to inform it of this event (filterEventFilterStringCreated)
-
-
-
Throws:
-
Exception
addSystemFilterString
ISystemFilterString addSystemFilterString(
ISystemFilter filter,
String newString,
int position)
throws
Exception
- Insert a new filter string to the given filter's list, at the given zero-based position
Does the following:
- Adds the filter string to the in-memory cache
- Saves parent filter pool to disk.
- Calls back to provider to inform it of this event (filterEventFilterStringCreated)
-
-
-
Throws:
-
Exception
removeSystemFilterString
boolean removeSystemFilterString(
ISystemFilter filter,
ISystemFilterString filterString)
throws
Exception
- Remove a filter string from this filter's list, given its SystemFilterString object.
Does the following:
- Removes the filter string from the in-memory cache
- Saves parent filter pool to disk.
- Calls back to provider to inform it of this event (filterEventFilterStringDeleted)
-
-
-
Returns:
- true if the given string existed and hence was deleted.
-
Throws:
-
Exception
removeSystemFilterString
boolean removeSystemFilterString(
ISystemFilter filter,
String oldString)
throws
Exception
- Delete a filter string from the given filter's list
Does the following:
- Removes the filter string from the in-memory cache
- Saves parent filter pool to disk.
- Calls back to provider to inform it of this event (filterEventFilterStringDeleted)
-
-
-
Returns:
- true if given string was found and hence was deleted.
-
Throws:
-
Exception
removeSystemFilterString
boolean removeSystemFilterString(
ISystemFilter filter,
int position)
throws
Exception
- Remove a filter string from the given filter's list, given its zero-based position
Does the following:
- Removes the filter string from the in-memory cache
- Saves parent filter pool to disk.
- Calls back to provider to inform it of this event (filterEventFilterStringDeleted)
-
-
-
Returns:
- true if a string existed at the given position and hence was deleted.
-
Throws:
-
Exception
updateSystemFilterString
void updateSystemFilterString(
ISystemFilterString filterString,
String newValue)
throws
Exception
- Update a filter string's string vale
Does the following:
- Update the filter string in the in-memory cache
- Saves parent filter pool to disk.
- Calls back to provider to inform it of this event (filterEventFilterStringUpdated)
-
-
-
Throws:
-
Exception
getSystemFilterStringPosition
int getSystemFilterStringPosition(
ISystemFilterString filterString)
- Return the zero-based position of a SystemFilterString object within its filter
-
-
copySystemFilterString
ISystemFilterString copySystemFilterString(
ISystemFilter targetFilter,
ISystemFilterString oldFilterString)
throws
Exception
- Copy a system filter string to a filter in this or another filter pool manager.
-
-
-
Throws:
-
Exception
moveSystemFilterString
ISystemFilterString moveSystemFilterString(
ISystemFilter targetFilter,
ISystemFilterString oldFilterString)
throws
Exception
- Move a system filter string to a filter in this or another filter pool manager.
Does this by doing a copy operation, then if successful doing a delete operation.
-
-
-
Throws:
-
Exception
moveSystemFilterStrings
void moveSystemFilterStrings(
ISystemFilterString[] filterStrings,
int delta)
throws
Exception
- Move existing filter strings a given number of positions in the same filter
If the delta is negative, they are all moved up by the given amount. If
positive, they are all moved down by the given amount.
Does the following:
- After the move, the filter pool containing the filter containing the filter strings is saved to disk.
- Calls back to provider to inform of the event (filterEventFilterStringsRePositioned)
-
-
-
Parameters:
-
filterStrings
- Array of SystemFilterStrings to move. -
delta
- the amount by which to move the filters
-
Throws:
-
Exception
suspendCallbacks
void suspendCallbacks(boolean suspend)
- Suspend callbacks to the provider
-
-
isSupportsNestedFilters
boolean isSupportsNestedFilters()
-
-
-
Returns:
- The value of the SupportsNestedFilters attribute
setStringsCaseSensitive
void setStringsCaseSensitive(boolean value)
-
-
-
Parameters:
-
value
- The new value of the StringsCaseSensitive attribute
isSupportsDuplicateFilterStrings
boolean isSupportsDuplicateFilterStrings()
-
-
-
Returns:
- The value of the SupportsDuplicateFilterStrings attribute
unsetSupportsDuplicateFilterStrings
void unsetSupportsDuplicateFilterStrings()
-
-
isSetSupportsDuplicateFilterStrings
boolean isSetSupportsDuplicateFilterStrings()
-
-
-
Returns:
-
true if the SupportsDuplicateFilterStrings attribute has been set
isSingleFilterStringOnly
boolean isSingleFilterStringOnly()
- Returns the value of the '
Single Filter String Only
' attribute.
If the meaning of the 'Single Filter String Only' attribute isn't clear,
there really should be more of a description here...
-
-
-
Returns:
- the value of the 'Single Filter String Only' attribute.
-
See Also:
-
setSingleFilterStringOnly(boolean)
setSingleFilterStringOnly
void setSingleFilterStringOnly(boolean value)
- Sets the value of the '
Single Filter String Only
' attribute.
-
-
-
Parameters:
-
value
- the new value of the 'Single Filter String Only' attribute. -
See Also:
-
isSingleFilterStringOnly()
Copyright (c) IBM Corporation and others 2000, 2008. All Rights Reserved.