mirrors/cdt
1
0
Fork 0
mirror of https://github.com/eclipse-cdt/cdt synced 2025-08-05 15:25:49 +02:00
Code Issues Wiki Activity

[cleanup] Forward deprecation from implementation to interface

Browse source
This commit is contained in:
Martin Oberhuber 2008-08-25 17:33:33 +00:00
parent 271001d63b
commit 7060404b1b
2 changed files with 25 additions and 23 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

45
rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/core/model/ISystemRegistry.java
View file

@ -3,13 +3,13 @@
* This program and the accompanying materials are made available under the terms * This program and the accompanying materials are made available under the terms
* of the Eclipse Public License v1.0 which accompanies this distribution, and is * of the Eclipse Public License v1.0 which accompanies this distribution, and is
* available at http://www.eclipse.org/legal/epl-v10.html * available at http://www.eclipse.org/legal/epl-v10.html
* *
* Initial Contributors: * Initial Contributors:
* The following IBM employees contributed to the Remote System Explorer * The following IBM employees contributed to the Remote System Explorer
* component that contains this file: David McKnight, Kushal Munir, * component that contains this file: David McKnight, Kushal Munir,
* Michael Berger, David Dykstal, Phil Coulthard, Don Yantzi, Eric Simpson, * Michael Berger, David Dykstal, Phil Coulthard, Don Yantzi, Eric Simpson,
* Emily Bruner, Mazen Faraj, Adrian Storisteanu, Li Ding, and Kent Hawley. * Emily Bruner, Mazen Faraj, Adrian Storisteanu, Li Ding, and Kent Hawley.
* *
* Contributors: * Contributors:
* Martin Oberhuber (Wind River) - [168975] Move RSE Events API to Core * Martin Oberhuber (Wind River) - [168975] Move RSE Events API to Core
* Martin Oberhuber (Wind River) - [184095] Replace systemTypeName by IRSESystemType * Martin Oberhuber (Wind River) - [184095] Replace systemTypeName by IRSESystemType
@ -93,7 +93,7 @@ public interface ISystemRegistry extends ISchedulingRule, IAdaptable, ISystemVie
/** /**
* Return all subsystem factories. * Return all subsystem factories.
* *
* Be careful when you call this, as it activates all subsystem configurations. * Be careful when you call this, as it activates all subsystem configurations.
* @deprecated use {@link #getSubSystemConfigurationProxies()} and filter the * @deprecated use {@link #getSubSystemConfigurationProxies()} and filter the
* list of needed subsystem configurations in order to activate only those * list of needed subsystem configurations in order to activate only those
@ -110,8 +110,8 @@ public interface ISystemRegistry extends ISchedulingRule, IAdaptable, ISystemVie
* Return all subsystem configurations which support the given system type. * Return all subsystem configurations which support the given system type.
* If the type is null, returns all subsystem configurations. Fully * If the type is null, returns all subsystem configurations. Fully
* equivalent to getSubSystemConfigurationsBySystemType(systemType, * equivalent to getSubSystemConfigurationsBySystemType(systemType,
* filterDuplicates, <code>true</code>) which is preferred since we do * filterDuplicates, <code>true</code>) which is preferred since we do not
* not want to load subsystem configurations unless necessary. * want to load subsystem configurations unless necessary.
* *
* @param systemType system type to filter * @param systemType system type to filter
* @param filterDuplicates if true and the subsystem configuration uses * @param filterDuplicates if true and the subsystem configuration uses
@ -119,13 +119,18 @@ public interface ISystemRegistry extends ISchedulingRule, IAdaptable, ISystemVie
* supports this service. Which configuration is returned is * supports this service. Which configuration is returned is
* undefined. * undefined.
* @return an array of subsystem configurations meeting the criteria * @return an array of subsystem configurations meeting the criteria
*
* @deprecated Use
* {@link #getSubSystemConfigurationsBySystemType(IRSESystemType,boolean,boolean)}
* instead in order to avoid instantiating subsystem
* configurations if possible.
*/ */
public ISubSystemConfiguration[] getSubSystemConfigurationsBySystemType(IRSESystemType systemType, boolean filterDuplicates); public ISubSystemConfiguration[] getSubSystemConfigurationsBySystemType(IRSESystemType systemType, boolean filterDuplicates);
/** /**
* Return all subsystem configurations which support the given system type. * Return all subsystem configurations which support the given system type.
* If the type is null, returns all subsystem configurations. * If the type is null, returns all subsystem configurations.
* *
* @param systemType system type to filter * @param systemType system type to filter
* @param filterDuplicates if true and the subsystem configuration uses * @param filterDuplicates if true and the subsystem configuration uses
* services then return only one subsystem configuration that * services then return only one subsystem configuration that
@ -302,7 +307,7 @@ public interface ISystemRegistry extends ISchedulingRule, IAdaptable, ISystemVie
* <p> * <p>
* This looks for a match on the "category" of the subsystem factory's xml declaration * This looks for a match on the "category" of the subsystem factory's xml declaration
* in its plugin.xml file. * in its plugin.xml file.
* *
* @see org.eclipse.rse.core.model.ISubSystemConfigurationCategories * @see org.eclipse.rse.core.model.ISubSystemConfigurationCategories
* @deprecated use {@link #getSubSystemConfigurationProxiesByCategory(String)} * @deprecated use {@link #getSubSystemConfigurationProxiesByCategory(String)}
* and instantiate only those subsystem configurations from the proxy * and instantiate only those subsystem configurations from the proxy
@ -322,7 +327,7 @@ public interface ISystemRegistry extends ISchedulingRule, IAdaptable, ISystemVie
// ---------------------------- // ----------------------------
/** /**
* Return the first connection to the local host we can find. * Return the first connection to the local host we can find.
* *
* While we always create a default one in the user's profile, it is possible that * While we always create a default one in the user's profile, it is possible that
* this profile is not active or the connection was deleted. However, since any * this profile is not active or the connection was deleted. However, since any
* connection to the local host will usually do, we just search all active profiles * connection to the local host will usually do, we just search all active profiles
@ -359,7 +364,7 @@ public interface ISystemRegistry extends ISchedulingRule, IAdaptable, ISystemVie
* configuration's xml declaration in its plugin.xml file. * configuration's xml declaration in its plugin.xml file.
* Thus, it is efficient as it need not bring to life a * Thus, it is efficient as it need not bring to life a
* subsystem configuration just to test its parent class type. * subsystem configuration just to test its parent class type.
* *
* @see org.eclipse.rse.core.model.ISubSystemConfigurationCategories * @see org.eclipse.rse.core.model.ISubSystemConfigurationCategories
*/ */
public IHost[] getHostsBySubSystemConfigurationCategory(String factoryCategory); public IHost[] getHostsBySubSystemConfigurationCategory(String factoryCategory);
@ -369,7 +374,7 @@ public interface ISystemRegistry extends ISchedulingRule, IAdaptable, ISystemVie
* If the specified system type is null, an empty array is returned. * If the specified system type is null, an empty array is returned.
* In order to get an IRSESystemType, use * In order to get an IRSESystemType, use
* <code>RSECorePlugin.getTheCoreRegistry().{@link RSECoreRegistry#getSystemTypeById(String) getSystemTypeById(String)}</code> * <code>RSECorePlugin.getTheCoreRegistry().{@link RSECoreRegistry#getSystemTypeById(String) getSystemTypeById(String)}</code>
* *
* @param systemType The system type instance. * @param systemType The system type instance.
* @return The list of connections or an empty array. * @return The list of connections or an empty array.
*/ */
@ -377,7 +382,7 @@ public interface ISystemRegistry extends ISchedulingRule, IAdaptable, ISystemVie
/** /**
* Return all connections for all active profiles, for the given system types. * Return all connections for all active profiles, for the given system types.
* *
* In order to get an IRSESystemType, use * In order to get an IRSESystemType, use
* <code>RSECorePlugin.getTheCoreRegistry().{@link RSECoreRegistry#getSystemTypeById(String) getSystemTypeById(String)}</code> * <code>RSECorePlugin.getTheCoreRegistry().{@link RSECoreRegistry#getSystemTypeById(String) getSystemTypeById(String)}</code>
*/ */
@ -527,7 +532,7 @@ public interface ISystemRegistry extends ISchedulingRule, IAdaptable, ISystemVie
* registered listeners * registered listeners
* </ul> * </ul>
* <p> * <p>
* *
* @param profileName Name of the system profile to which the host is to be * @param profileName Name of the system profile to which the host is to be
* added. * added.
* @param systemType system type of the new host. * @param systemType system type of the new host.
@ -582,7 +587,7 @@ public interface ISystemRegistry extends ISchedulingRule, IAdaptable, ISystemVie
/** /**
* Update the workoffline mode for a connection. * Update the workoffline mode for a connection.
* *
* @param conn SystemConnection to change * @param conn SystemConnection to change
* @param offline true if connection should be set offline, false if it should be set online * @param offline true if connection should be set offline, false if it should be set online
*/ */
@ -772,7 +777,7 @@ public interface ISystemRegistry extends ISchedulingRule, IAdaptable, ISystemVie
/** /**
* Query if the ISystemRemoteChangeListener is already listening for * Query if the ISystemRemoteChangeListener is already listening for
* SystemRemoteChange events. * SystemRemoteChange events.
* *
* @param l the listener instance to check * @param l the listener instance to check
* @since org.eclipse.rse.core 3.0 * @since org.eclipse.rse.core 3.0
*/ */
@ -787,7 +792,7 @@ public interface ISystemRegistry extends ISchedulingRule, IAdaptable, ISystemVie
/** /**
* Notify all listeners of a change to a remote resource such as a file. * Notify all listeners of a change to a remote resource such as a file.
* This one takes the information needed and creates the event for you. * This one takes the information needed and creates the event for you.
* *
* @param eventType - one of the constants from * @param eventType - one of the constants from
* {@link org.eclipse.rse.core.events.ISystemRemoteChangeEvents} * {@link org.eclipse.rse.core.events.ISystemRemoteChangeEvents}
* @param resource - the remote resource object, or absolute name of the * @param resource - the remote resource object, or absolute name of the
@ -809,7 +814,7 @@ public interface ISystemRegistry extends ISchedulingRule, IAdaptable, ISystemVie
/** /**
* Notify all listeners of a change to a remote resource such as a file. * Notify all listeners of a change to a remote resource such as a file.
* This one takes the information needed and creates the event for you. * This one takes the information needed and creates the event for you.
* *
* @param eventType - one of the constants from * @param eventType - one of the constants from
* {@link org.eclipse.rse.core.events.ISystemRemoteChangeEvents} * {@link org.eclipse.rse.core.events.ISystemRemoteChangeEvents}
* @param resource - the remote resource object, or absolute name of the * @param resource - the remote resource object, or absolute name of the
@ -836,7 +841,7 @@ public interface ISystemRegistry extends ISchedulingRule, IAdaptable, ISystemVie
/** /**
* Notify all listeners of a change to a remote resource such as a file. * Notify all listeners of a change to a remote resource such as a file.
* This one takes the information needed and creates the event for you. * This one takes the information needed and creates the event for you.
* *
* @param operation - the operation for which this event was fired * @param operation - the operation for which this event was fired
* @param eventType - one of the constants from * @param eventType - one of the constants from
* {@link org.eclipse.rse.core.events.ISystemRemoteChangeEvents} * {@link org.eclipse.rse.core.events.ISystemRemoteChangeEvents}
@ -859,7 +864,7 @@ public interface ISystemRegistry extends ISchedulingRule, IAdaptable, ISystemVie
/** /**
* Notify all listeners of a change to a remote resource such as a file. * Notify all listeners of a change to a remote resource such as a file.
* This one takes the information needed and creates the event for you. * This one takes the information needed and creates the event for you.
* *
* @param operation - the operation for which this event was fired * @param operation - the operation for which this event was fired
* @param eventType - one of the constants from * @param eventType - one of the constants from
* {@link org.eclipse.rse.core.events.ISystemRemoteChangeEvents} * {@link org.eclipse.rse.core.events.ISystemRemoteChangeEvents}
@ -930,7 +935,7 @@ public interface ISystemRegistry extends ISchedulingRule, IAdaptable, ISystemVie
/** /**
* Marks all filters for this subsystem as stale to prevent caching * Marks all filters for this subsystem as stale to prevent caching
* *
* @param subsystem the subsystem to work on * @param subsystem the subsystem to work on
*/ */
public void invalidateFiltersFor(ISubSystem subsystem); public void invalidateFiltersFor(ISubSystem subsystem);
@ -938,7 +943,7 @@ public interface ISystemRegistry extends ISchedulingRule, IAdaptable, ISystemVie
/** /**
* Marks all filters for this subsystem that contain resourceParent as stale * Marks all filters for this subsystem that contain resourceParent as stale
* to prevent caching * to prevent caching
* *
* @param resourceParent a remote resource object * @param resourceParent a remote resource object
* @param subsystem the subsystem to work on * @param subsystem the subsystem to work on
*/ */

3
rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/internal/core/model/SystemRegistry.java
View file

@ -320,9 +320,6 @@ public class SystemRegistry implements ISystemRegistry
* (non-Javadoc) * (non-Javadoc)
* @see org.eclipse.rse.core.model.ISystemRegistry#getSubSystemConfigurationsBySystemType(org.eclipse.rse.core.IRSESystemType, boolean) * @see org.eclipse.rse.core.model.ISystemRegistry#getSubSystemConfigurationsBySystemType(org.eclipse.rse.core.IRSESystemType, boolean)
*/ */
/**
* @deprecated Use {@link #getSubSystemConfigurationsBySystemType(IRSESystemType,boolean,boolean)} instead
*/
public ISubSystemConfiguration[] getSubSystemConfigurationsBySystemType(IRSESystemType systemType, boolean filterDuplicateServiceSubSystemFactories) public ISubSystemConfiguration[] getSubSystemConfigurationsBySystemType(IRSESystemType systemType, boolean filterDuplicateServiceSubSystemFactories)
{ {
return getSubSystemConfigurationsBySystemType(systemType, filterDuplicateServiceSubSystemFactories, true); return getSubSystemConfigurationsBySystemType(systemType, filterDuplicateServiceSubSystemFactories, true);