From 98a7ae86ed99e9683945fa0022014391d0652ddb Mon Sep 17 00:00:00 2001 From: Martin Oberhuber < martin.oberhuber@windriver.com> Date: Sat, 12 Apr 2008 01:28:38 +0000 Subject: [PATCH] [190231] Prepare experimental API for UI/Non-UI Splitting --- .../eclipse/rse/core/IRSEInteractionProvider.java | 8 ++++++++ .../eclipse/rse/core/IRSERunnableWithProgress.java | 7 +++++++ .../src/org/eclipse/rse/core/RSECorePlugin.java | 14 ++++++++++++++ .../internal/ui/DefaultUIInteractionProvider.java | 13 ++++++++++--- .../org/eclipse/rse/core/subsystems/SubSystem.java | 14 ++++++++++++++ 5 files changed, 53 insertions(+), 3 deletions(-) diff --git a/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/core/IRSEInteractionProvider.java b/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/core/IRSEInteractionProvider.java index 0a491ede8b2..1b8019b3830 100644 --- a/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/core/IRSEInteractionProvider.java +++ b/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/core/IRSEInteractionProvider.java @@ -27,6 +27,14 @@ import org.eclipse.rse.services.clientserver.messages.SystemMessage; * Non-UI headless applications may log messages rather than doing interactive * messages, and may use different Threads for sending messages. * + *
+ * EXPERIMENTAL. This class or interface has been added as + * part of a work in progress. There is no guarantee that this API will work or + * that it will remain the same. Please do not use this API without consulting + * with the Target Management + * team. + *
+ * * @since org.eclipse.rse.core 3.0 */ public interface IRSEInteractionProvider { diff --git a/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/core/IRSERunnableWithProgress.java b/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/core/IRSERunnableWithProgress.java index fed96814b8f..04d896f007b 100644 --- a/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/core/IRSERunnableWithProgress.java +++ b/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/core/IRSERunnableWithProgress.java @@ -29,6 +29,13 @@ import org.eclipse.core.runtime.IProgressMonitor; *IRunnableWithProgress
to the run
method of an
* IRunnableContext
, which provides the UI for the progress
* monitor and Cancel button.
+ * + * EXPERIMENTAL. This class or interface has been added as + * part of a work in progress. There is no guarantee that this API will work or + * that it will remain the same. Please do not use this API without consulting + * with the Target Management + * team. + *
* * @see IRSEInteractionProvider * @since org.eclipse.rse.core 3.0 diff --git a/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/core/RSECorePlugin.java b/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/core/RSECorePlugin.java index 1e8f73ea4c5..4906a6ccfa8 100644 --- a/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/core/RSECorePlugin.java +++ b/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/core/RSECorePlugin.java @@ -407,6 +407,13 @@ public class RSECorePlugin extends Plugin { * interaction provider for showing dialogs from Core operations. Non-UI * headless operations can use an Interaction Provider that just logs its * messages and works without other UI. + *+ * EXPERIMENTAL. This class or interface has been added as + * part of a work in progress. There is no guarantee that this API will work + * or that it will remain the same. Please do not use this API without + * consulting with the Target + * Management team. + *
* * @param p the interaction provider to set. * @since org.eclipse.rse.core 3.0 @@ -420,6 +427,13 @@ public class RSECorePlugin extends Plugin { /** * Get the default interface for interacting with the user or other outside * world. + *+ * EXPERIMENTAL. This class or interface has been added as + * part of a work in progress. There is no guarantee that this API will work + * or that it will remain the same. Please do not use this API without + * consulting with the Target + * Management team. + *
* * @return the default interaction provider. * @since org.eclipse.rse.core 3.0 diff --git a/rse/plugins/org.eclipse.rse.ui/UI/org/eclipse/rse/internal/ui/DefaultUIInteractionProvider.java b/rse/plugins/org.eclipse.rse.ui/UI/org/eclipse/rse/internal/ui/DefaultUIInteractionProvider.java index 8fb5858b5a4..6f3c6c16dfe 100644 --- a/rse/plugins/org.eclipse.rse.ui/UI/org/eclipse/rse/internal/ui/DefaultUIInteractionProvider.java +++ b/rse/plugins/org.eclipse.rse.ui/UI/org/eclipse/rse/internal/ui/DefaultUIInteractionProvider.java @@ -29,9 +29,16 @@ import org.eclipse.ui.IWorkbenchWindow; import org.eclipse.ui.PlatformUI; /** - * A Default Interaction Provider that runs in the Eclipse / SWT UI. - * Meant to provide the same functionality as it was there before - * UI / Non-UI Splitting. + * A Default Interaction Provider that runs in the Eclipse / SWT UI. Meant to + * provide the same functionality as it was there before UI / Non-UI Splitting. + *+ * EXPERIMENTAL. This class or interface has been added as + * part of a work in progress. There is no guarantee that this API will work or + * that it will remain the same. Please do not use this API without consulting + * with the Target Management + * team. + *
+ * * @since org.eclipse.rse.ui 3.0 */ public class DefaultUIInteractionProvider implements IRSEInteractionProvider { diff --git a/rse/plugins/org.eclipse.rse.ui/subsystems/org/eclipse/rse/core/subsystems/SubSystem.java b/rse/plugins/org.eclipse.rse.ui/subsystems/org/eclipse/rse/core/subsystems/SubSystem.java index ff723b9259a..7aded9a9d99 100644 --- a/rse/plugins/org.eclipse.rse.ui/subsystems/org/eclipse/rse/core/subsystems/SubSystem.java +++ b/rse/plugins/org.eclipse.rse.ui/subsystems/org/eclipse/rse/core/subsystems/SubSystem.java @@ -228,6 +228,13 @@ implements IAdaptable, ISubSystem, ISystemFilterPoolReferenceManagerProvider /** * Set an Interaction Provider specific for this subsystem. + *+ * EXPERIMENTAL. This class or interface has been added as + * part of a work in progress. There is no guarantee that this API will work + * or that it will remain the same. Please do not use this API without + * consulting with the Target + * Management team. + *
* * @param p the new interaction provider to use, ornull
to
* fall back to the default interaction provider (from
@@ -244,6 +251,13 @@ implements IAdaptable, ISubSystem, ISystemFilterPoolReferenceManagerProvider
* Get the current Interaction Provider. Returns a specific one for this
* subsystem if it has been set, or falls back to the default one from
* RSECorePlugin otherwise.
+ * + * EXPERIMENTAL. This class or interface has been added as + * part of a work in progress. There is no guarantee that this API will work + * or that it will remain the same. Please do not use this API without + * consulting with the Target + * Management team. + *
* * @return the interaction provider to use. * @since 3.0