mirror of
https://github.com/eclipse-cdt/cdt
synced 2025-08-16 20:55:44 +02:00
Bug 149331: Update with latest documentation
This commit is contained in:
Kushal Munir
parent
8c384b9182
commit
f41248d8fb
36 changed files with 3900 additions and 3902 deletions
|
|
@ -33,10 +33,10 @@ for disconnecting from the DataStore.
|
|||
The <b>DataStore</b> class is the heart of the DataStore communications framework. An instance of a DataStore contains a tree
|
||||
of <a href="#dataelement">DataElements</a>. This tree can be referred to as the <i>DataStore repository</i> because
|
||||
it consists of all the schema information and data content used. Any type of object or relationship defined, command definition or
|
||||
peice of data that needs to be communicated between the client and server are stored in the <i>DataStore repository</i>.
|
||||
piece of data that needs to be communicated between the client and server are stored in the <i>DataStore repository</i>.
|
||||
The DataStore class can be used for finding, creating and deleting DataElements and for communicating commands
|
||||
to <a href="#miner">miner</a>. The DataStore class encapsulates all remote synchronizations between the client and the
|
||||
server via it's <code>command</code> and <code>refresh</code> APIs.
|
||||
server via its <code>command</code> and <code>refresh</code> APIs.
|
||||
</p>
|
||||
|
||||
<h2><A name="dataelement">DataElement</A></h2>
|
||||
|
|
|
|||
|
|
@ -94,7 +94,7 @@ the specified minerFile.dat file.
|
|||
|
||||
<h2>Sending Commands to a Miner</h2>
|
||||
<p>
|
||||
To send a command to a miner, the required <a href="DataElements.html#commanddescriptor">command descriptor</a> must first be optained
|
||||
To send a command to a miner, the required <a href="DataElements.html#commanddescriptor">command descriptor</a> must first be obtained
|
||||
using the method <code>DataStore.localDescriptorQuery</code>. The method <code>DataStore.command</code> is then called with command
|
||||
descriptor and the subject of the command. For example, a query might need to be called on the miner as shown in the following code segment.
|
||||
</p>
|
||||
|
|
|
|||
|
|
@ -30,14 +30,14 @@ The job of the Command Handler is to route commands to the miners. There are tw
|
|||
|
||||
<h3><a name="clientcommandhandler">Client Command Handler</a></h3>
|
||||
<p>
|
||||
The <b>Client Command Handler</b> is a command handler responsible for transmitting it's queue of DataStore commands across a network to
|
||||
The <b>Client Command Handler</b> is a command handler responsible for transmitting its queue of DataStore commands across a network to
|
||||
the server DataStore. This handler encapsulates the communication of DataStore client data to a DataStore server. The Client Command Handler
|
||||
interfaces the DataStore communication layer, where it's queue of commands gets serialized into XML before being sent over a TCP/IP socket
|
||||
interfaces the DataStore communication layer, where its queue of commands gets serialized into XML before being sent over a TCP/IP socket
|
||||
to the server.
|
||||
</p>
|
||||
|
||||
<h3><a name="servercommandhandler">Server Command Handler</a></h3>
|
||||
The <b>Server Command Handler</b> is a command handler responsible for directly routing the DataStore commands in it's queue to the appropriate
|
||||
The <b>Server Command Handler</b> is a command handler responsible for directly routing the DataStore commands in its queue to the appropriate
|
||||
miner(s) depending on the command.
|
||||
|
||||
<h2><a name="updatehandlers">Update Handlers</a></h2>
|
||||
|
|
@ -49,14 +49,14 @@ update handlers.
|
|||
<h3><a name="clientupdatehandler">Client Update Handler</a></h3>
|
||||
<p>
|
||||
The <b>Client Update Handler</b> is an update handler responsible for sending out domain notifications for each unit of data
|
||||
contained in it's queue.
|
||||
contained in its queue.
|
||||
</p>
|
||||
|
||||
<h3><a name="serverupdatehandler">Server Update Handler</a></h3>
|
||||
<p>
|
||||
The <b>Server Update Handler</b> is an update handler responsible for transmitting it's queue of DataStore objects across a network to
|
||||
The <b>Server Update Handler</b> is an update handler responsible for transmitting its queue of DataStore objects across a network to
|
||||
the client DataStore. This handler encapsulates the communication of DataStore server data to a DataStore client. The Server Update Handler
|
||||
interfaces the DataStore communication layer, where it's queue of data gets serialized into XML before being sent over a TCP/IP socket
|
||||
interfaces the DataStore communication layer, where its queue of data gets serialized into XML before being sent over a TCP/IP socket
|
||||
to the client.
|
||||
</p>
|
||||
|
||||
|
|
@ -71,7 +71,7 @@ the DataStore handlers.
|
|||
<p>
|
||||
Locally, the DataStore may be used standalone such that all communication through the DataStore goes directly to between the <b>miners</b>
|
||||
and the client, all running within the same process. In this case, there is only a single DataStore and no communication goes
|
||||
over the network. For it's handlers, the local DataStore uses a <b>Client Update Handler</b> and a <b>Server Command Handler</b>.
|
||||
over the network. For its handlers, the local DataStore uses a <b>Client Update Handler</b> and a <b>Server Command Handler</b>.
|
||||
</p>
|
||||
|
||||
<img src="images/local.jpg" alt="Local DataStore Eclipse" border="0">
|
||||
|
|
|
|||
|
|
@ -22,13 +22,13 @@ The attribute indices that can be used are as follows:
|
|||
<tr><td><code>A_NAME</code></td><td>Attribute indicating the name of object.</td></tr>
|
||||
<tr><td><code>A_VALUE</code></td><td>Attribute indicating the more information about that object</td></tr>
|
||||
<tr><td><code>A_SOURCE</code></td><td>Attribute indicating source information about an object, if applicable</td></tr>
|
||||
<tr><td><code>A_ISREF</code></td><td>Attribute indicating whether a the object is a reference or not. In the DataStore, a reference to another DataElement is represented with a DataElement</td></tr>
|
||||
<tr><td><code>A_REF_TYPE</code></td><td>Attribute indicating whether the object is a normal object ("value"), a spirit ("spirit"), or a reference to another DataElement ("reference"). In the DataStore, a reference to another DataElement is represented with a DataElement. For more information on spirit elements, see <a href="MemoryManagement.html">Memory Management in DataStore</a> </td></tr>
|
||||
<tr><td><code>A_ID</code></td><td>The unique ID of a DataElement.</td></tr>.
|
||||
</table>
|
||||
</p>
|
||||
<p>
|
||||
Rather than representing different types of objects as different classes, the type attribute of a DataElement
|
||||
indicates it's type. There are two general categories of DataElements. There are schema elements, <A href="#descriptors">descriptors</a>, and instances of
|
||||
indicates its type. There are two general categories of DataElements. There are schema elements, <A href="#descriptors">descriptors</a>, and instances of
|
||||
those schema elements, <a href="#instances">instances</a>.
|
||||
</p>
|
||||
|
||||
|
|
@ -76,15 +76,15 @@ relationships between descriptors in the schema.
|
|||
<h2><a name="instances">Instances</a></h2>
|
||||
<p>
|
||||
An instance object is a DataElement that is an instance of a descriptor. An instance may either by an object, a
|
||||
relation or a command. An instance uses it's descriptor's <code>A_NAME</code> attribute as it's <code>A_TYPE</code> attribute.
|
||||
relation or a command. An instance uses its descriptor's <code>A_NAME</code> attribute as its <code>A_TYPE</code> attribute.
|
||||
</p>
|
||||
|
||||
<h3><a name="objects">Objects</a></h3>
|
||||
<p>
|
||||
<b>Objects</b> are instances of <b>object descriptors</b>. Objects are used to the represent the external or internal
|
||||
entities that are being interacted with. An instance object can be related in a certain way to another type of
|
||||
instance object if it's object descriptor has the same kind of relationship to the other object's object descriptor.
|
||||
An instance object may be associated with a particular command if it's object descriptor is associated with the command descriptor
|
||||
instance object if its object descriptor has the same kind of relationship to the other object's object descriptor.
|
||||
An instance object may be associated with a particular command if its object descriptor is associated with the command descriptor
|
||||
for that command.
|
||||
</p>
|
||||
|
||||
|
|
@ -94,7 +94,7 @@ for that command.
|
|||
may exist from one object to another if the schema indicates that the object descriptor for the first object may have a relationship
|
||||
of that type to the other object's descriptor. Relations are used to describe the relationship between two instances, the
|
||||
relationship between two descriptors and the relationship between an instance and a descriptor. A relation is able to reference
|
||||
another element by storing the other element's <code>A_ID</code> attribute in it's <code>A_SOURCE</code> attribute. If a relation object
|
||||
another element by storing the other element's <code>A_ID</code> attribute in its <code>A_SOURCE</code> attribute. If a relation object
|
||||
needs to be dereferenced, it uses this attribute to query the DataStore for the object being referenced.
|
||||
</p>
|
||||
<p>
|
||||
|
|
@ -106,13 +106,13 @@ relationship between those two elements is implied to be <i>contains/parent of</
|
|||
|
||||
<h3><a name="commands">Commands</a></h3>
|
||||
<p>
|
||||
<b>Commands</b> are instances of <b>command descriptors</b>. A command is always associated with a instance object such that
|
||||
<b>Commands</b> are instances of <b>command descriptors</b>. A command is always associated with an instance object such that
|
||||
the command is to be performed on that object. The object associated with a command is referred to as the <i>subject</i> of
|
||||
the command. Only a command that has a command descriptor that is related to the object descriptor of the subject may be
|
||||
constructed. A command object is constructed when the DataStore method <code>command()</code> is called. The command is
|
||||
created with a reference to the subject, an optional set of arguments, also instance objects, and a status object instance, used
|
||||
to indicate the state of the command. The tree of elements for a command is communicated, via the DataStore comm layer, to
|
||||
the appropriate miner(s), where it is interpretted and executed.
|
||||
the appropriate miner(s), where it is interpreted and executed.
|
||||
</p>
|
||||
<p>
|
||||
The structure of a command looks like the following:
|
||||
|
|
@ -190,7 +190,7 @@ symbol "->" implies a "contains" relationship and "IO()" implies an instance
|
|||
|
||||
<p>
|
||||
DataStore schemas are created by the DataStore <b>miners</b>. Each tool contributes it's
|
||||
own schema or to the DataStore schema, referencing descriptors of other schemas, such
|
||||
own schema to the DataStore schema, referencing descriptors of other schemas, such
|
||||
that one tool can contribute to another tool. All the command descriptors that are
|
||||
contributed by a miner are expected to be handled by the contributing miner. Whenever
|
||||
a miner creates a new command descriptor, the <code>A_SOURCE</code> attribute indicates
|
||||
|
|
|
|||
|
|
@ -11,7 +11,7 @@
|
|||
<body bgcolor="#ffffff">
|
||||
<h1>Extending and Using the DataStore</h1>
|
||||
<p>
|
||||
This section describes the basic steps required for to extending the server DataStore with
|
||||
This section describes the basic steps required for extending the server DataStore with
|
||||
a DataStore miner and how to interact with the miners from an RSE subsystem.
|
||||
</p>
|
||||
</body>
|
||||
|
|
|
|||
|
|
@ -41,7 +41,7 @@ information from another miner's schema.
|
|||
<p>
|
||||
A miner implements <code>extendSchema(DataElement)</code> to add new descriptors to the DataStore schema. If a miner creates representations
|
||||
of objects that are not already represented by some other miner's schema, then it needs to define descriptors for those new types of objects.
|
||||
Sometimes new relationship types also need to be defined by a miner for it's particular model. In order for a miner to be interacted with,
|
||||
Sometimes new relationship types also need to be defined by a miner for its particular model. In order for a miner to be interacted with,
|
||||
via <code>handleCommand</code>, it needs to define command descriptors for object descriptors in the schema. The code below illustrates the
|
||||
typical structure of an <code>extendSchema</code> implementation:
|
||||
</p>
|
||||
|
|
@ -75,7 +75,7 @@ typical structure of an <code>extendSchema</code> implementation:
|
|||
|
||||
<p>
|
||||
The DataStore does not enforce that instance element trees are structured in the manner that the schema describes so the
|
||||
establishing of relationships between object types, as done in this example, is unnecessary as a miner knows it's own
|
||||
establishing of relationships between object types, as done in this example, is unnecessary as a miner knows its own
|
||||
model, since it defined it. But by convention, it is a good thing to describe a model with those relationships explicitly stated
|
||||
because other miners or client tools may want to leverage or extend the model for their own purposes.
|
||||
</p>
|
||||
|
|
@ -121,7 +121,7 @@ the typical structure of a <code>handleCommand</code> implementation.
|
|||
</pre>
|
||||
</font>
|
||||
<p>
|
||||
The results of a command may be returned in a variety of ways, depending one it's
|
||||
The results of a command may be returned in a variety of ways, depending on its
|
||||
purpose. One thing that is always returned is the status object.
|
||||
</p>
|
||||
<p>
|
||||
|
|
|
|||
|
|
@ -18,10 +18,10 @@ This section describes the basic steps needed to extend the server side tooling
|
|||
Write a new <a href="Miners.html">DataStore miner</a> by extending the <b>Miner</b> class.
|
||||
</li>
|
||||
<li>
|
||||
Put the compiled miner class on the host, preferabled in jar form
|
||||
Put the compiled miner class on the host, preferably in jar form
|
||||
</li>
|
||||
<li>
|
||||
Register the new miner so that it get's loaded when the server DataStore is connected to. This may be done
|
||||
Register the new miner so that it gets loaded when the server DataStore is connected to. This may be done
|
||||
by adding the miner's qualified classname to the file <i>minerFile.dat</i>. Alternatively, an additional <i>minerFile.dat</i>
|
||||
file can be used to supply the classname.
|
||||
</li>
|
||||
|
|
|
|||
|
|
@ -14,7 +14,7 @@
|
|||
The RSE uses the concept of <b>subsystems</b> as a common abstraction for remote tooling. Subsystems provide
|
||||
public interfaces that are called when some remote tool or resource needs to be communicated with. As long as
|
||||
the appropriate public interfaces are implemented, the means of communicating with these remote tools and resources
|
||||
is up to the developer of the subsystem. Whatever that means might be, some kind of communication layer is required
|
||||
is up to the developer of the subsystem. Whatever that might be, some kind of communication layer is required
|
||||
to access tools on the host. One such means that is used by existing RSE Subsystems and can be reused is the
|
||||
DataStore framework.
|
||||
</p>
|
||||
|
|
@ -33,8 +33,8 @@ In an RSE subsystem, the goal of the DataStore is to provide the bridge to tools
|
|||
To interact with a remote tool, a DataStore client communicates over a network with a DataStore server. Data and
|
||||
commands are transferred between the client and server via the DataStore communication layer. Information
|
||||
that is communicated between each side is kept in memory with the DataStore repository. Both the client and server DataStores
|
||||
have this repository and it is the responsability of the DataStore communication layer to keep the contents
|
||||
of each of these repositories in synch. All the DataStore data on the server side is replicated to the client and
|
||||
have this repository and it is the responsibility of the DataStore communication layer to keep the contents
|
||||
of each of these repositories in sync. All the DataStore data on the server side is replicated to the client and
|
||||
and vice versa.
|
||||
</p>
|
||||
<p>
|
||||
|
|
@ -55,12 +55,12 @@ describes file systems and how they should be interacted with. The <a href="Sch
|
|||
files, folders, properties of files and relationships between them as well as commands for querying folders or renaming files.
|
||||
An RSE subsystem, can then provide browsing capabilities to a remote file system by sending commands
|
||||
via the DataStore client to the Filesystem Miner on the host. Another <a href="Miners.html">miner</a> can
|
||||
contribute it's own <a href="Schemas.html">schema</a> or extend the existing Filesystem Miner <a href="Schemas.html">schema</a>
|
||||
contribute its own <a href="Schemas.html">schema</a> or extend the existing Filesystem Miner <a href="Schemas.html">schema</a>
|
||||
to leverage or contribute to the existing file system tool.
|
||||
</p>
|
||||
<p>
|
||||
This guide explains all underlying
|
||||
artifacts and model of the DataStore, it's relationship to RSE, and highlights the
|
||||
artifacts and model of the DataStore, its relationship to RSE, and highlights the
|
||||
important APIs available for your use.
|
||||
</p>
|
||||
</body>
|
||||
|
|
|
|||
|
|
@ -80,7 +80,7 @@ exposing artifacts and actions for working with remote resources. The subsystem
|
|||
supply a subsystem for a given host if it does not support the system type of that host
|
||||
</p>
|
||||
<p>
|
||||
IBM supplies two subsystem configurations that supply common subsystems for all Hosts:
|
||||
RSE supplies two subsystem configurations that supply common subsystems for all Hosts:
|
||||
<ol>
|
||||
<li>Files. The subsystems created by this factory access the folders and files of the remote system,
|
||||
and allow users to explore and manipulate those folders and files. Editing support for remote source files is also included. For programmers, the subsystems also supply common APIs and user interface actions, wizards,
|
||||
|
|
@ -100,7 +100,7 @@ supports it, there is also additional subsystem configurations that supply three
|
|||
iSeries host:
|
||||
<ol>
|
||||
<li>iSeries Objects. This accesses the libraries, objects, and members in the native QSYS file system, allowing
|
||||
users to explore and manipulate them via IBM-supplied actions. For programmers, this also supplies
|
||||
users to explore and manipulate them via RSE-supplied actions. For programmers, this also supplies
|
||||
common APIs for listing remote libraries, objects, members, records, and fields, with various filtering
|
||||
capabilities, as well as editing remote source members. Furthermore, there are a number of iSeries-specific
|
||||
user interface actions, wizards, dialogs, and widgets that programmers can easily re-use.
|
||||
|
|
@ -119,36 +119,36 @@ on that iSeries host. Both of these getter methods are available in the
|
|||
subsystems share. System objects are described next.</p>
|
||||
|
||||
<h2><A name="systems">Systems and System Managers</A></h2>
|
||||
<p>While not seen by the user, subsystem objects are required to return a <b>system</b> object via the
|
||||
<A href="../com/ibm/etools/systems/subsystems/SubSystem.html#getSystem()">getSystem()</A> method.
|
||||
A system object is an object implementing the <A href="../com/ibm/etools/systems/subsystems/ISystem.html">ISystem</A> interface.
|
||||
A system object manages the live host to the remote system, and supports
|
||||
<p>While not seen by the user, subsystem objects are required to return a <b>connectorservice</b> object via the
|
||||
<A href="../org/eclipse/rse/core/subsystems/ISubSystem.html#getConnectorService()">getConnectorService()</A> method.
|
||||
A connectorService object is an object implementing the <A href="../org/eclipse/rse/core/subsystems/IConnectorService.html">IConnectorService</A> interface.
|
||||
A connectorService object manages the live host to the remote system, and supports
|
||||
lifecycle methods for that host such as
|
||||
<A href="../com/ibm/etools/systems/subsystems/ISystem.html#connect(org.eclipse.core.runtime.IProgressMonitor)">connect</A>,
|
||||
<A href="../com/ibm/etools/systems/subsystems/ISystem.html#disconnect()">disconnect</A>, and
|
||||
<A href="../com/ibm/etools/systems/subsystems/ISystem.html#isConnected()">isConnected</A>.
|
||||
<A href="../org/eclipse/rse/core/subsystems/IConnectorService.html#connect(org.eclipse.core.runtime.IProgressMonitor)">connect</A>,
|
||||
<A href="../org/eclipse/rse/core/subsystems/IConnectorService.html#disconnect()">disconnect</A>, and
|
||||
<A href="../org/eclipse/rse/core/subsystems/IConnectorService.html#isConnected()">isConnected</A>.
|
||||
The communication layer for that host is entirely the programmer's responsibility, and might use sockets, JDBC, HTTP or
|
||||
SOAP. It is up the provider of the subsystem factory to author their own communication layer; the framework
|
||||
only dictates the handful of methods in ISystem, that the RSE UI depends upon. The framework supplies a base
|
||||
only dictates the handful of methods in IConnectorService, that the RSE UI depends upon. The framework supplies a base
|
||||
system class that is easily extended.
|
||||
</p>
|
||||
<p>It may be the case that multiple subsystems, each from a different subsystem factory, share the same live
|
||||
<p>It may be the case that multiple subsystems, each from a different subsystem configuration, share the same live
|
||||
host for a given host object. To enable this, the framework supplies a base
|
||||
<b>system manager</b> <A href="../com/ibm/etools/systems/subsystems/impl/AbstractSystemManager.html">class</A>
|
||||
that can be used to manage a single shared system object across multiple subsystems. It uses a hashtable to store and
|
||||
return the system objects, keyed by a subsystem interface that all subsystems sharing the same system object
|
||||
are to implement. The subclass of the base system manager class supplies that interface. Further, the subclass
|
||||
must also implement the method for instantiating new instances of the system class, when no instance is found
|
||||
<b>connector service manager</b> <A href="../org/eclipse/rse/core/subsystems/impl/AbstractConnectorServiceManager.html">class</A>
|
||||
that can be used to manage a single shared connector service object across multiple subsystems. It uses a hashtable to store and
|
||||
return the connector service objects, keyed by a subsystem interface that all subsystems sharing the same connector service object
|
||||
are to implement. The subclass of the base connector service manager class supplies that interface. Further, the subclass
|
||||
must also implement the method for instantiating new instances of the connector service class, when no instance is found
|
||||
in the hashtable.
|
||||
</p>
|
||||
<p>
|
||||
It is possible to author a subsystem factory whose subsystems simply use the same system object as that used by
|
||||
the IBM-supplied subsystems. You might do this if the subsystem factory uses only the IBM-supplied APIs for
|
||||
It is possible to author a subsystem configuration whose subsystems simply use the same connector service object as that used by
|
||||
the RSE-supplied subsystems. You might do this if the subsystem configuration uses only the RSE-supplied APIs for
|
||||
accessing remote objects, in which case there is no need for a unique communication layer. By sharing the
|
||||
same system object, it prevents the user from being prompted to signon multiple times. To do this, simply access
|
||||
any IBM-supplied subsystem for a given host, and ask for its
|
||||
<A href="../com/ibm/etools/systems/subsystems/SubSystem.html#getSystemManager()">system manager</A>
|
||||
in your own subsystem's <A href="../com/ibm/etools/systems/subsystems/impl/AbstractSystem.html#getSystemManager()">getSystemManager</A> method.
|
||||
same connector service object, it prevents the user from being prompted to signon multiple times. To do this, simply access
|
||||
any RSE-supplied subsystem for a given host, and ask for its
|
||||
<A href="../org/eclipse/rse/core/subsystems/ISubSystem.html#getConnectorServiceManager()">connector service manager</A>
|
||||
in your own subsystem's <A href="../org/eclipse/rse/core/subsystems/AbstractConnectorService.html#getConnectorServiceManager()">getConnectorServiceManager</A> method.
|
||||
</p>
|
||||
|
||||
<h2><A name="filters">Filters</A></h2>
|
||||
|
|
@ -156,7 +156,7 @@ in your own subsystem's <A href="../com/ibm/etools/systems/subsystems/impl/Abstr
|
|||
When a subsystem is expanded, users usually see <b>filters</b>. Since subsystems typically list remote artifacts,
|
||||
it is typical that a mechanism is needed to allow users to define which artifacts they wish to see, with some
|
||||
form of filtering criteria. Filters are this mechanism. The filter support is fully supplied by the RSE framework.
|
||||
A filter is simply a <A href="../com/ibm/etools/systems/filters/SystemFilter.html">SystemFilter</A>
|
||||
A filter is simply a <A href="../org/eclipse/rse/filters/ISystemFilter.html">ISystemFilter</A>
|
||||
object containing a name and a collection of <b>filter strings</b>. Filter strings are just strings, which
|
||||
the subsystem is required to interpret. When a user expands a filter, the owning subsystem is asked to resolve
|
||||
the filter strings within the filter. The subsystem typically interprets each filter string as some form of
|
||||
|
|
@ -175,17 +175,17 @@ It is possible to author a subsystem that does not support filters, if this is d
|
|||
Subsystems do not actually "own" filters. Since each host has unique subsystems, if each subsystem owned its
|
||||
own filters then filters could not be shared across Hosts, which is sometimes desirable. Instead, filters are
|
||||
actually contained within <b>filter pools</b>. Filter pools are simply
|
||||
<A href="../com/ibm/etools/systems/filters/SystemFilterPool.html">SystemFilterPool</A>
|
||||
<A href="../org/eclipse/rse/filters/ISystemFilterPool.html">ISystemFilterPool</A>
|
||||
objects which have a name and a collection of filters.
|
||||
Filter pools are owned by subsystem configurations, per profile. That is, each subsystem factory will contain filter pools
|
||||
scoped by profile. Each such factory plus profile grouping is known internally as a
|
||||
<A href="../com/ibm/etools/systems/filters/SystemFilterPoolManager.html">filter pool manager</A>.
|
||||
Subsystems contain <A href="../com/ibm/etools/systems/filters/SystemFilterPoolReference.html">references</A>
|
||||
to filter pools. By default, each subsystem factory automatically creates one filter pool
|
||||
Filter pools are owned by subsystem configurations, per profile. That is, each subsystem configuration will contain filter pools
|
||||
scoped by profile. Each such configuration plus profile grouping is known internally as a
|
||||
<A href="../org/eclipse/rse/filters/ISystemFilterPoolManager.html">filter pool manager</A>.
|
||||
Subsystems contain <A href="../org/eclipse/rse/filters/ISystemFilterPoolReference.html">references</A>
|
||||
to filter pools. By default, each subsystem configuration automatically creates one filter pool
|
||||
for each profile, named the "xxx Filter Pool", where "xxx" is the name of the profile. Subsystems contain references to
|
||||
filter pools, so that as the filters in the pool are created, changed, deleted or re-ordered, those changes are automatically
|
||||
reflected in every subsystem (and hence host) that references that filter pool. By default, subsystems are given a
|
||||
reference to the default filter pool in their host's profile (for their parent subsystem factory, so file filters
|
||||
reference to the default filter pool in their host's profile (for their parent subsystem configuration, so file filters
|
||||
are not used in command subsystems, for example).
|
||||
</p>
|
||||
<p>
|
||||
|
|
@ -208,8 +208,8 @@ reference it.
|
|||
|
||||
<h2><A name="useractions">User Actions and Named Types</A></h2>
|
||||
<p>
|
||||
If the subsystem factory returns true to the
|
||||
<A href="../com/ibm/etools/systems/subsystems/SubSystemFactory.html#supportsUserDefinedActions()">supportsUserDefinedActions</A>
|
||||
If the subsystem configuration returns true to the
|
||||
<A href="../org/eclipse/rse/core/subsystems/ISubSystemConfiguration.html#supportsUserDefinedActions()">supportsUserDefinedActions</A>
|
||||
method, users can create their own <b>actions</b>
|
||||
that appear in the pop-up menu for remote objects, using the Work With User Actions <A href="useractions_ww_action.gif">action</A> and
|
||||
<A href="useractions_ww_dialog.gif">dialog</A>. User actions use substitution variables that are resolved at
|
||||
|
|
@ -228,8 +228,8 @@ This is done using the Work With Named Types <A href="namedtypes_ww_action.gif">
|
|||
<A href="namedtypes_ww_dialog.gif">dialog</A>.</p>
|
||||
<p>
|
||||
User actions are contained by each subsystem factory, scoped by profile. You can programmatically access them by calling
|
||||
<A href="../com/ibm/etools/systems/subsystems/SubSystemFactory.html#getActionSubSystem(org.eclipse.rse.subsystems.SubSystem)">getActionSubSystem</A>
|
||||
in a subsystem factory object. They are scoped to the factory, not the subsystem,
|
||||
<A href="../org/eclipse/rse/core/subsystems/util/ISubsystemConfigurationAdapter.html#getSubSystemActions(org.eclipse.rse.subsystems.ISubSystem)">getSubSystemActions</A>
|
||||
in a subsystem configuration object. They are scoped to the configuration, not the subsystem,
|
||||
so the same list of actions is available for every host. The <A href="useractions_menu.gif">User Actions cascading menu </A>
|
||||
for remote objects lists <i>all</i> the actions defined for <i>all active profiles</i>, whose file type scoping criteria matches the
|
||||
types of the currently selected remote objects. When users define new actions, they specify the profile to contain them.
|
||||
|
|
@ -246,8 +246,8 @@ It is assumed there will be fewer of these, and they are not likely to be differ
|
|||
|
||||
<h2><A name="compilecmds">Compile Commands</A></h2>
|
||||
<p>
|
||||
If the subsystem factory returns true to the
|
||||
<A href="../com/ibm/etools/systems/subsystems/SubSystemFactory.html#supportsCompileActions()">supportsCompileActions</A>
|
||||
If the subsystem configuration returns true to the
|
||||
<A href="../org/eclipse/rse/core/subsystems/ISubSystemConfiguration.html#supportsCompileActions()">supportsCompileActions</A>
|
||||
method, users will see a <b>Compile</b> <A href="compile_action.gif">action</A> in
|
||||
the pop-up menu for compilable source files. Clearly, this support usually only makes sense for subsystems that
|
||||
list remote source files. Whether a selected file is compilable or not is decided by the subsystem factory. It
|
||||
|
|
@ -257,8 +257,8 @@ class for this. The compile manager is also responsible for pre-supplying defaul
|
|||
<p>
|
||||
The framework also supplies a Work With Compile Commands <A href="compile_ww_action.gif">action</A> and <A href="compile_ww_dialog.gif">dialog</A>,
|
||||
by which users can create their own compile commands,
|
||||
per source type. Compile commands internally are <A href="../com/ibm/etools/systems/core/ui/compile/SystemCompileCommand.html">SystemCompileCommand</A> objects.
|
||||
These compile commands are stored per subsystem factory, such that they are usable across all Hosts.
|
||||
per source type. Compile commands internally are <A href="../org/eclipse/rse/ui/compile/SystemCompileCommand.html">SystemCompileCommand</A> objects.
|
||||
These compile commands are stored per subsystem configuration, such that they are usable across all Hosts.
|
||||
They are also scoped by profile, and the cascading compile action will list all compile commands from all active profiles,
|
||||
for the selected file's source type. This scoping by profile, as with user actions, enables team support such that
|
||||
users can see and can easily access their own compile commands and any shared compile commands.
|
||||
|
|
@ -266,7 +266,7 @@ users can see and can easily access their own compile commands and any shared co
|
|||
|
||||
<h2><A name="preferences">Preferences</A></h2>
|
||||
<p>
|
||||
Many of the default characterics of the Remote System Explorer view and perspective are configurable by each user
|
||||
Many of the default characteristics of the Remote System Explorer view and perspective are configurable by each user
|
||||
by way of the <A href="preferences.gif">Remote Systems node</A> of the <b>Preferences</b> window, accessible from the Window pull-down of the main menu.
|
||||
Furthermore, many of these preferences are directly accessible from the <A
|
||||
href="view_pulldown.gif">pull-down menu of the title bar for the Remote
|
||||
|
|
@ -277,12 +277,12 @@ be exported and imported.
|
|||
<h2><A name="Registry">System Registry</A></h2>
|
||||
<p>The programmatic front door to all the artifacts in the RSE is the
|
||||
<b>System Registry</b>, which is an object implementing
|
||||
<A href="../com/ibm/etools/systems/model/SystemRegistry.html">SystemRegistry</A>.
|
||||
<A href="../org/eclipse/rse/model/ISystemRegistry.html">ISystemRegistry</A>.
|
||||
This is a singleton object that you
|
||||
can access by calling the static method
|
||||
<A href="../com/ibm/etools/systems/core/SystemPlugin.html#getTheSystemRegistry()">getTheSystemRegistry()</A> in the
|
||||
<A href="../com/ibm/etools/systems/core/SystemPlugin.html">SystemPlugin</A>
|
||||
class in the <samp>org.eclipse.rse.core</samp> plugin.
|
||||
<A href="../org/eclipse/rse/model/SystemStartHere.html#getSystemRegistry()">getSystemRegistry()</A> in the
|
||||
<A href="../org/eclipse/rse/model/SystemStartHere.html">SystemStartHere</A>
|
||||
class in the <samp>org.eclipse.rse.ui</samp> plugin.
|
||||
</p>
|
||||
</body>
|
||||
</html>
|
||||
|
|
@ -14,39 +14,39 @@
|
|||
<p>The underlying containment model for the RSE artifacts is shown here.
|
||||
</p>
|
||||
<ul>
|
||||
<li><A href="../com/ibm/etools/systems/model/SystemProfile.html">Profiles</A> are managed
|
||||
by a <A href="../com/ibm/etools/systems/model/SystemProfileManager.html">profile manager</A>, and contain:</li>
|
||||
<li><A href="../org/eclipse/rse/model/ISystemProfile.html">Profiles</A> are managed
|
||||
by a <A href="../org/eclipse/rse/model/ISystemProfileManager.html">profile manager</A>, and contain:</li>
|
||||
<ul>
|
||||
<li><A href="../com/ibm/etools/systems/model/SystemConnectionPool.html">Connection Pools</A>, one per profile, which contain</li>
|
||||
<li><A href="../org/eclipse/rse/model/ISystemHostPool.html">Host Pools</A>, one per profile, which contain</li>
|
||||
<ul>
|
||||
<li><A href="../com/ibm/etools/systems/model/SystemConnection.html">Connections</A></li>
|
||||
<li><A href="../org/eclipse/rse/model/IHost.html">Hosts</A></li>
|
||||
</ul>
|
||||
<li><A href="../com/ibm/etools/systems/filters/SystemFilterPool.html">Filter pools</A>,
|
||||
<li><A href="../org/eclipse/rse/filters/ISystemFilterPool.html">Filter pools</A>,
|
||||
keyed by Subsystem Factory,
|
||||
and managed by a <A href="../com/ibm/etools/systems/filters/SystemFilterPoolManager.html">filter pool manager</A>
|
||||
and managed by a <A href="../org/eclipse/rse/filters/ISystemFilterPoolManager.html">filter pool manager</A>
|
||||
which contain</li>
|
||||
<ul>
|
||||
<li><A href="../com/ibm/etools/systems/filters/SystemFilter.html">Filters</A>, which contain</li>
|
||||
<li><A href="../org/eclipse/rse/filters/ISystemFilter.html">Filters</A>, which contain</li>
|
||||
<ul>
|
||||
<li><A href="../com/ibm/etools/systems/filters/SystemFilterString.html">Filter strings</A></li>
|
||||
<li><A href="../org/eclipse/rse/filters/ISystemFilterString.html">Filter strings</A></li>
|
||||
</ul>
|
||||
</ul>
|
||||
<li><A href="../com/ibm/etools/systems/core/ui/uda/SystemUDActionElement.html">User actions</A>, keyed by Subsystem Factory, which contain</li>
|
||||
<li><A href="../org/eclipse/rse/ui/uda/ISystemUDActionElement.html">User actions</A>, keyed by Subsystem Configuration, which contain</li>
|
||||
<ul>
|
||||
<li><i>References</i> to <A href="../com/ibm/etools/systems/core/ui/uda/SystemUDTypeElement.html">named types</A></li>
|
||||
<li><i>References</i> to <A href="../org/eclipse/rse/ui/uda/ISystemUDTypeElement.html">named types</A></li>
|
||||
</ul>
|
||||
<li><A href="../com/ibm/etools/systems/core/ui/compile/SystemCompileCommand.html">Compile commands</A></li>
|
||||
<li><A href="../org/eclipse/rse/ui/compile/SystemCompileCommand.html">Compile commands</A></li>
|
||||
</ul>
|
||||
|
||||
<li><A href="../com/ibm/etools/systems/subsystems/SubSystemFactory.html">Subsystem Factories</A> contain:</li>
|
||||
<li><A href="../org/eclipse/rse/core/subsystems/SubSystemConfiguration.html">Subsystem Configurations</A> contain:</li>
|
||||
<ul>
|
||||
<li><A href="../com/ibm/etools/systems/subsystems/SubSystem.html">Subsystems</A>, keyed by connection,
|
||||
<li><A href="../org/eclipse/rse/core/subsystems/SubSystem.html">Subsystems</A>, keyed by host,
|
||||
which contain</li>
|
||||
<ul>
|
||||
<li><i><A href="../com/ibm/etools/systems/filters/SystemFilterPoolReference.html">References</A></i>
|
||||
to <A href="../com/ibm/etools/systems/filters/SystemFilterPool.html">filter pools</A>, which are managed by <A href="../com/ibm/etools/systems/filters/SystemFilterPoolManager.html">filter pool managers</A></li>
|
||||
<li><i><A href="../org/eclipse/rse/filters/ISystemFilterPoolReference.html">References</A></i>
|
||||
to <A href="../org/eclipse/rse/filters/ISystemFilterPool.html">filter pools</A>, which are managed by <A href="../org/eclipse/rse/filters/ISystemFilterPoolManager.html">filter pool managers</A></li>
|
||||
</ul>
|
||||
<li><A href="../com/ibm/etools/systems/core/ui/uda/SystemUDTypeElement.html">Named types</A></li>
|
||||
<li><A href="../org/eclipse/rse/ui/uda/SystemUDTypeElement.html">Named types</A></li>
|
||||
</ul>
|
||||
</ul>
|
||||
</body>
|
||||
|
|
|
|||
|
|
@ -31,8 +31,8 @@ help simplify the creation of action classes, especially when used together with
|
|||
|
||||
<h2>RSE-Supplied Base Classes for Actions</h2>
|
||||
<p>Here are the primary base classes the RSE supplies for actions, all of which are found in the
|
||||
package <samp><A href="../../../com/ibm/etools/systems/core/ui/actions/package-summary.html">com.ibm.etools.systems.core.ui.actions</A></samp>
|
||||
in the plugin <samp>com.ibm.etools.systems.core</samp>:</p>
|
||||
package <samp><A href="../../../org/eclipse/rse/ui/actions/package-summary.html"org.eclipse.rse.ui.actions</A></samp>
|
||||
in the plugin <samp>org.eclipse.rse.ui</samp>:</p>
|
||||
<TABLE border="1">
|
||||
<TBODY>
|
||||
<TR>
|
||||
|
|
@ -40,36 +40,36 @@ in the plugin <samp>com.ibm.etools.systems.core</samp>:</p>
|
|||
<TH>Description</TH>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/actions/SystemBaseAction.html">SystemBaseAction</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/actions/SystemBaseAction.html">SystemBaseAction</A></samp></TD>
|
||||
<TD>This is the base action class for the other classes, and is only used directly for actions that do not
|
||||
result in a dialog or wizard being presented to the user. It extends the JFace <samp>Action</samp> class,
|
||||
adding to it support for properties such as the current shell and viewer and selection, as well as
|
||||
overridable methods for easily enabling/disabling the action based on the selection, and a method for
|
||||
setting the context help for the action. There are many other useful methods, such
|
||||
as <samp><A href="../../../com/ibm/etools/systems/core/ui/actions/SystemBaseAction.html#allowOnMultipleSelection(boolean)">allowOnMultipleSelection(boolean)</A></samp>
|
||||
and <samp><A href="../../../com/ibm/etools/systems/core/ui/actions/SystemBaseAction.html#setContextMenuGroup(java.lang.String)">setContextMenuGroup(String)</A></samp>, to
|
||||
as <samp><A href="../../../org/eclipse/rse/ui/actions/SystemBaseAction.html#allowOnMultipleSelection(boolean)">allowOnMultipleSelection(boolean)</A></samp>
|
||||
and <samp><A href="../../../org/eclipse/rse/ui/actions/SystemBaseAction.html#setContextMenuGroup(java.lang.String)">setContextMenuGroup(String)</A></samp>, to
|
||||
simplify when the action is enabled and where it appears in a popup menu.
|
||||
</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/actions/SystemBaseSubMenuAction.html">SystemBaseSubMenuAction</A></samp></TD>
|
||||
<TD>This base action class extends <samp><A href="../../../com/ibm/etools/systems/core/ui/actions/SystemBaseAction.html">SystemBaseAction</A></samp>, and is used as the parent class when
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/actions/SystemBaseSubMenuAction.html">SystemBaseSubMenuAction</A></samp></TD>
|
||||
<TD>This base action class extends <samp><A href="../../../org/eclipse/rse/ui/actions/SystemBaseAction.html">SystemBaseAction</A></samp>, and is used as the parent class when
|
||||
for popup menu actions that are to cascade. A cascading menu is itself another menu, really, containing actions just like the primary
|
||||
menu does. So, to create a cascading menu action, you simply subclass this class and override the method
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/ui/actions/SystemBaseSubMenuAction.html#populateSubMenu(org.eclipse.jface.action.IMenuManager)">populateSubMenu</A></samp>, where
|
||||
<samp><A href="../../../org/eclipse/rse/ui/actions/SystemBaseSubMenuAction.html#populateSubMenu(org.eclipse.jface.action.IMenuManager)">populateSubMenu</A></samp>, where
|
||||
you add all the actions to show in this cascading menu. And yes, one or more of those can themselves be cascading. The RSE views will
|
||||
automatically call the method <samp><A href="../../../com/ibm/etools/systems/core/ui/actions/SystemBaseSubMenuAction.html#getSubMenu()">getSubMenu</A></samp> when populating the initial popup menu, but your own views will need to do this.</TD>
|
||||
automatically call the method <samp><A href="../../../org/eclipse/rse/ui/actions/SystemBaseSubMenuAction.html#getSubMenu()">getSubMenu</A></samp> when populating the initial popup menu, but your own views will need to do this.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/actions/SystemBaseDialogAction.html">SystemBaseDialogAction</A></samp></TD>
|
||||
<TD>This base action class extends <samp><A href="../../../com/ibm/etools/systems/core/ui/actions/SystemBaseAction.html">SystemBaseAction</A></samp>, and is used when the action presents the
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/actions/SystemBaseDialogAction.html">SystemBaseDialogAction</A></samp></TD>
|
||||
<TD>This base action class extends <samp><A href="../../../org/eclipse/rse/ui/actions/SystemBaseAction.html">SystemBaseAction</A></samp>, and is used when the action presents the
|
||||
user with a dialog, preferably a dialog that extends the RSE
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemPromptDialog.html">SystemPromptDialog</A></samp> class. To use this class, subclass it and override the methods </TD>
|
||||
<samp><A href="../../../org/eclipse/rse/ui/dialogs/SystemPromptDialog.html">SystemPromptDialog</A></samp> class. To use this class, subclass it and override the methods </TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/actions/SystemBaseWizardAction.html">SystemBaseWizardAction</A></samp></TD>
|
||||
<TD>This base action class extends <samp><A href="../../../com/ibm/etools/systems/core/ui/actions/SystemBaseAction.html">SystemBaseAction</A></samp>, and is used when the action presents the
|
||||
user with a wizard, preferably a wizard that extends the RSE <samp><A href="../../../com/ibm/etools/systems/core/ui/wizards/AbstractSystemWizard.html">AbstractSystemWizard</A></samp> class.</TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/actions/SystemBaseWizardAction.html">SystemBaseWizardAction</A></samp></TD>
|
||||
<TD>This base action class extends <samp><A href="../../../org/eclipse/rse/ui/actions/SystemBaseAction.html">SystemBaseAction</A></samp>, and is used when the action presents the
|
||||
user with a wizard, preferably a wizard that extends the RSE <samp><A href="../../../org/eclipse/rse/ui/wizards/AbstractSystemWizard.html">AbstractSystemWizard</A></samp> class.</TD>
|
||||
</TR>
|
||||
|
||||
</TBODY>
|
||||
|
|
@ -79,9 +79,9 @@ in the plugin <samp>com.ibm.etools.systems.core</samp>:</p>
|
|||
<p>You may find some of the actions supplied by the RSE to be immediately re-usable in your own code, saving some
|
||||
development and test effort.
|
||||
All these actions can be found in package
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/ui/actions/package-summary.html">com.ibm.etools.systems.core.ui.actions</A></samp>.
|
||||
<samp><A href="../../../org/eclipse/rse/ui/actions/package-summary.html">org.eclipse.rse.ui.actions</A></samp>.
|
||||
Further, you can find many useful actions related to the selection of remote files or folders, in package
|
||||
<samp><A href="../../../com/ibm/etools/systems/files/ui/actions/package-summary.html">com.ibm.etools.systems.files.ui.actions</A></samp>.
|
||||
<samp><A href="../../../org/eclipse/rse/files/ui/actions/package-summary.html">org.eclipse.rse.files.ui.actions</A></samp>.
|
||||
</p>
|
||||
|
||||
<P><BR></P>
|
||||
|
|
|
|||
|
|
@ -14,18 +14,18 @@
|
|||
typical full error checking.
|
||||
<pre>
|
||||
|
||||
package com.ibm.etools.systems.samples.ui.frameworks.dialogs;
|
||||
package org.eclipse.rse.samples.ui.frameworks.dialogs;
|
||||
|
||||
import org.eclipse.swt.widgets.*;
|
||||
import org.eclipse.swt.events.*;
|
||||
|
||||
import com.ibm.etools.systems.samples.*;
|
||||
import org.eclipse.rse.samples.*;
|
||||
|
||||
import com.ibm.etools.systems.core.ui.dialogs.SystemPromptDialog;
|
||||
import com.ibm.etools.systems.core.ui.*;
|
||||
import com.ibm.etools.systems.core.ui.widgets.*;
|
||||
import com.ibm.etools.systems.core.ui.messages.*;
|
||||
import com.ibm.etools.systems.core.ui.validators.*;
|
||||
import org.eclipse.rse.ui.dialogs.SystemPromptDialog;
|
||||
import org.eclipse.rse.ui.*;
|
||||
import org.eclipse.rse.ui.widgets.*;
|
||||
import org.eclipse.rse.ui.messages.*;
|
||||
import org.eclipse.rse.ui.validators.*;
|
||||
|
||||
/**
|
||||
* <I>A simple example of using the SystemPromptDialog class as the basis for a new dialog</I>.
|
||||
|
|
@ -47,7 +47,7 @@ public class <B>SampleDialog</B> extends SystemPromptDialog
|
|||
*/
|
||||
public <B>SampleDialog</B>(Shell shell)
|
||||
{
|
||||
super(shell, SamplesPlugin.getString("com.ibm.etools.systems.samples.ui.dialogs.dialog1.title"));
|
||||
super(shell, SamplesPlugin.getString("org.eclipse.rse.samples.ui.dialogs.dialog1.title"));
|
||||
setHelp(SamplesPlugin.HELPPREFIX + "dlg11000");
|
||||
nameValidator = new <A href="../validators/validatorSample1.html">SampleNameValidator</A>();
|
||||
yearValidator = new <A href="../validators/validatorSample2.html">SampleBirthYearValidator</A>();
|
||||
|
|
@ -65,22 +65,22 @@ public class <B>SampleDialog</B> extends SystemPromptDialog
|
|||
Composite parentComposite = SystemWidgetHelpers.createComposite(parent, nbrColumns);
|
||||
|
||||
// <I>add gui widgets</I>...
|
||||
SystemWidgetHelpers.createLabel(parentComposite, SamplesPlugin.getResourceBundle(), "com.ibm.etools.systems.samples.ui.dialogs.dialog1.name.");
|
||||
SystemWidgetHelpers.createLabel(parentComposite, SamplesPlugin.getResourceBundle(), "org.eclipse.rse.samples.ui.dialogs.dialog1.name.");
|
||||
boolean readonly = false;
|
||||
namePrompt = SystemWidgetHelpers.createHistoryCombo(parentComposite, null, "name.history.key", readonly,
|
||||
SamplesPlugin.getResourceBundle(), "com.ibm.etools.systems.samples.ui.dialogs.dialog1.name.tooltip");
|
||||
SamplesPlugin.getResourceBundle(), "org.eclipse.rse.samples.ui.dialogs.dialog1.name.tooltip");
|
||||
|
||||
addSeparatorLine(parentComposite, nbrColumns);
|
||||
boolean wantBorder = false;
|
||||
SystemWidgetHelpers.createLabel(parentComposite, SamplesPlugin.getResourceBundle(),
|
||||
"com.ibm.etools.systems.samples.ui.dialogs.dialog1.birthday.verbage.", nbrColumns, wantBorder);
|
||||
"org.eclipse.rse.samples.ui.dialogs.dialog1.birthday.verbage.", nbrColumns, wantBorder);
|
||||
|
||||
yearPrompt = SystemWidgetHelpers.createLabeledTextField(parentComposite, null,
|
||||
SamplesPlugin.getResourceBundle(), "com.ibm.etools.systems.samples.ui.dialogs.dialog1.birthday.year.");
|
||||
SamplesPlugin.getResourceBundle(), "org.eclipse.rse.samples.ui.dialogs.dialog1.birthday.year.");
|
||||
monthPrompt = SystemWidgetHelpers.createLabeledTextField(parentComposite, null,
|
||||
SamplesPlugin.getResourceBundle(), "com.ibm.etools.systems.samples.ui.dialogs.dialog1.birthday.month.");
|
||||
SamplesPlugin.getResourceBundle(), "org.eclipse.rse.samples.ui.dialogs.dialog1.birthday.month.");
|
||||
dayPrompt = SystemWidgetHelpers.createLabeledTextField(parentComposite, null,
|
||||
SamplesPlugin.getResourceBundle(), "com.ibm.etools.systems.samples.ui.dialogs.dialog1.birthday.day.");
|
||||
SamplesPlugin.getResourceBundle(), "org.eclipse.rse.samples.ui.dialogs.dialog1.birthday.day.");
|
||||
|
||||
// <I>if given an existing object, prefill it</I>...
|
||||
inpCust = (SampleCustomer)getInputObject();
|
||||
|
|
|
|||
|
|
@ -22,9 +22,9 @@
|
|||
<i>modal</i>, meaning the rest of the application (in this case eclipse) is disabled while the dialog is showing.
|
||||
Eclipse supplies a raw dialog class in SWT, as well as more robust dialog class in JFace. The RSE supplies its own
|
||||
class,
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemPromptDialog.html">SystemPromptDialog</A></samp>
|
||||
<samp><A href="../../../org/eclipse/rse/ui/dialogs/SystemPromptDialog.html">SystemPromptDialog</A></samp>
|
||||
in package
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/package-summary.html">com.ibm.etools.systems.core.ui.dialogs</A></samp>
|
||||
<samp><A href="../../../org/eclipse/rse/ui/dialogs/package-summary.html">org.eclipse.rse.ui.dialogs</A></samp>
|
||||
, that extends
|
||||
the JFace dialog class and adds to it the following capabilities inherited by all classes which extend it:
|
||||
</p>
|
||||
|
|
@ -40,39 +40,39 @@ effort if your user interface is translated as the assignment of unique mnemonic
|
|||
<li>Built-in support for a number of typical push buttons at the bottom of the dialog: OK, Cancel, Browse, Test, Add and
|
||||
Details. You control via setters which buttons to show, and you can affect their label and tooltip text, although the
|
||||
default labels and tips are already translated for you. To program what happens when pressed, override the appropriate
|
||||
<samp>processXXX()</samp> method, such as <samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemPromptDialog.html#processOK()">processOK()</A></samp>. By default, you get OK and Cancel buttons.
|
||||
<samp>processXXX()</samp> method, such as <samp><A href="../../../org/eclipse/rse/ui/dialogs/SystemPromptDialog.html#processOK()">processOK()</A></samp>. By default, you get OK and Cancel buttons.
|
||||
<li>Support for an optional built-in progress monitor at the bottom of the dialog, just like what eclipse offers for wizards.
|
||||
<li>Support of a simple <samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemPromptDialog.html#wasCancelled()">wasCancelled()</A></samp> method to easily test if the dialog was cancelled or not.
|
||||
<li>Support of a simple <samp><A href="../../../org/eclipse/rse/ui/dialogs/SystemPromptDialog.html#wasCancelled()">wasCancelled()</A></samp> method to easily test if the dialog was cancelled or not.
|
||||
<li>Support for methods to set an input object, and retrieving an output object, making it easy to pass in data and
|
||||
get back data. Your calling code sets the input object, your subclass code sets the output object (typically in
|
||||
its <samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemPromptDialog.html#processOK()">processOK()</A></samp> method) and your calling code gets the output object,
|
||||
if <samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemPromptDialog.html#wasCancelled()">wasCancelled()</A></samp> returns false.
|
||||
<li>Support of a <samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemPromptDialog.html#setPageComplete(boolean)">setPageComplete(boolean)</A></samp> method, consistent with wizard pages, to enable/disable the OK button.
|
||||
its <samp><A href="../../../org/eclipse/rse/ui/dialogs/SystemPromptDialog.html#processOK()">processOK()</A></samp> method) and your calling code gets the output object,
|
||||
if <samp><A href="../../../org/eclipse/rse/ui/dialogs/SystemPromptDialog.html#wasCancelled()">wasCancelled()</A></samp> returns false.
|
||||
<li>Support of a <samp><A href="../../../org/eclipse/rse/ui/dialogs/SystemPromptDialog.html#setPageComplete(boolean)">setPageComplete(boolean)</A></samp> method, consistent with wizard pages, to enable/disable the OK button.
|
||||
This is typically called by your keystroke and button validators. That is, if an error is detected as input is entered, a message
|
||||
is issued to the message line and the OK button is disabled.
|
||||
<li>Support of a simple <samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemPromptDialog.html#setHelp(java.lang.String)">setHelp(String helpId)</A></samp> method to set the dialog's popup help.
|
||||
<li>Support of a simple <samp><A href="../../../org/eclipse/rse/ui/dialogs/SystemPromptDialog.html#setHelp(java.lang.String)">setHelp(String helpId)</A></samp> method to set the dialog's popup help.
|
||||
<li>A simple way to toggle the cursor between busy and normal, using
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemPromptDialog.html#setBusyCursor(boolean)">setBusyCursor(boolean)</A></samp>
|
||||
<li>Helper methods for adding <A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemPromptDialog.html#addFillerLine(org.eclipse.swt.widgets.Composite, int)">filler lines</A>
|
||||
and <A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemPromptDialog.html#addSeparatorLine(org.eclipse.swt.widgets.Composite, int)">separator lines</A>.
|
||||
<samp><A href="../../../org/eclipse/rse/ui/dialogs/SystemPromptDialog.html#setBusyCursor(boolean)">setBusyCursor(boolean)</A></samp>
|
||||
<li>Helper methods for adding <A href="../../../org/eclipse/rse/ui/dialogs/SystemPromptDialog.html#addFillerLine(org.eclipse.swt.widgets.Composite, int)">filler lines</A>
|
||||
and <A href="../../../org/eclipse/rse/ui/dialogs/SystemPromptDialog.html#addSeparatorLine(org.eclipse.swt.widgets.Composite, int)">separator lines</A>.
|
||||
</ul>
|
||||
<p>To create your own dialog:</p>
|
||||
<ol>
|
||||
<li>Subclass <samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemPromptDialog.html">SystemPromptDialog</A></samp>, picking the appropriate constructor, the simplest
|
||||
<li>Subclass <samp><A href="../../../org/eclipse/rse/ui/dialogs/SystemPromptDialog.html">SystemPromptDialog</A></samp>, picking the appropriate constructor, the simplest
|
||||
of which simply requires the shell of the parent window and the title string for this dialog.
|
||||
<li>If buttons beyond OK and Cancel are desired, in your own constructor call the appropriate <samp>setShowXXXButton(true)</samp> methods to enable
|
||||
these buttons, and override the appropriate <samp>processXXX()</samp> methods to process these buttons when pressed by the user.
|
||||
<li>If a progress monitor is desired, in your own constructor call <samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemPromptDialog.html#setNeedsProgressMonitor(boolean)">setNeedsProgressMonitor(true)</A></samp>. Later, to run
|
||||
a long-running operation that displays the progress monitor, use <samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemPromptDialog.html#getProgressMonitor()">getProgressMonitor()</A></samp>.
|
||||
<li>Override the <samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemPromptDialog.html#createInner(org.eclipse.swt.widgets.Composite)">createInner(Composite)</A></samp> method to populate the client area of the dialog with SWT widgets. Typically
|
||||
<li>If a progress monitor is desired, in your own constructor call <samp><A href="../../../org/eclipse/rse/ui/dialogs/SystemPromptDialog.html#setNeedsProgressMonitor(boolean)">setNeedsProgressMonitor(true)</A></samp>. Later, to run
|
||||
a long-running operation that displays the progress monitor, use <samp><A href="../../../org/eclipse/rse/ui/dialogs/SystemPromptDialog.html#getProgressMonitor()">getProgressMonitor()</A></samp>.
|
||||
<li>Override the <samp><A href="../../../org/eclipse/rse/ui/dialogs/SystemPromptDialog.html#createInner(org.eclipse.swt.widgets.Composite)">createInner(Composite)</A></samp> method to populate the client area of the dialog with SWT widgets. Typically
|
||||
you create your composite with a GridLayout layout, populate it, and return it. To ease this programming burden, use the many
|
||||
static helper methods in <samp><A href="../../../com/ibm/etools/systems/core/ui/SystemWidgetHelpers.html">SystemWidgetHelpers</A></samp>.
|
||||
<li>Override the <samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemPromptDialog.html#getInitialFocusControl()">getInitialFocusControl()</A></samp> method to supply the control to get initial focus when the dialog is displayed.
|
||||
<li>Override the <samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemPromptDialog.html#processOK()">processOK()</A></samp> method to supply the processing for when OK is pressed. You typically first validate
|
||||
static helper methods in <samp><A href="../../../org/eclipse/rse/ui/SystemWidgetHelpers.html">SystemWidgetHelpers</A></samp>.
|
||||
<li>Override the <samp><A href="../../../org/eclipse/rse/ui/dialogs/SystemPromptDialog.html#getInitialFocusControl()">getInitialFocusControl()</A></samp> method to supply the control to get initial focus when the dialog is displayed.
|
||||
<li>Override the <samp><A href="../../../org/eclipse/rse/ui/dialogs/SystemPromptDialog.html#processOK()">processOK()</A></samp> method to supply the processing for when OK is pressed. You typically first validate
|
||||
the user input, and then return true if there are no errors found.
|
||||
<li>To allow the caller to get user-entered information out of the dialog, either supply getter methods,
|
||||
or call <samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemPromptDialog.html#setOutputObject(java.lang.Object)">setOuputObject(Object)</A></samp>
|
||||
in your processOK logic so that your caller can code <samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemPromptDialog.html#getOutputObject()">getOutputObject()</A></samp>.
|
||||
or call <samp><A href="../../../org/eclipse/rse/ui/dialogs/SystemPromptDialog.html#setOutputObject(java.lang.Object)">setOuputObject(Object)</A></samp>
|
||||
in your processOK logic so that your caller can code <samp><A href="../../../org/eclipse/rse/ui/dialogs/SystemPromptDialog.html#getOutputObject()">getOutputObject()</A></samp>.
|
||||
</ol>
|
||||
<P>One of the more difficult efforts in building a dialog with multiple entry fields, is the code to do the validation of those entry fields. A common strategy is to add modify listeners to the entry fields, and for each one validate the data as it typed. If the validation fails, a message is issued. If the validation succeeds, then the other fields on the dialog are validated. At the end of the validation, the OK button is enabled or disabled depending on the error message status, and whether the required information has been supplied. The RSE can help with this effort, somewhat, through the use of re-usable <A
|
||||
href="../validators/uiValidatorsAPI.html">validators</A> for various types of input.<BR>
|
||||
|
|
@ -81,11 +81,11 @@ Follow this <A href="dialogSample.html">link</A> for an example of a fully-forme
|
|||
error checking.</P>
|
||||
|
||||
<p>Typically, after creating your dialog, you will create an action to invoke it. The RSE can help with this too, via the
|
||||
supplied <samp><A href="../../../com/ibm/etools/systems/core/ui/actions/SystemBaseDialogAction.html">SystemBaseDialogAction</A></samp> base class.
|
||||
supplied <samp><A href="../../../org/eclipse/rse/ui/actions/SystemBaseDialogAction.html">SystemBaseDialogAction</A></samp> base class.
|
||||
|
||||
<h2>Dialogs Pre-Supplied by RSE</h2>
|
||||
<p>You may find some of the dialogs supplied by the RSE to be immediately re-usable in your own code, saving some
|
||||
development and test effort. All these dialogs are in package <samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/package-summary.html">com.ibm.etools.systems.core.ui.dialogs</A></samp>:
|
||||
development and test effort. All these dialogs are in package <samp><A href="../../../org/eclipse/rse/ui/dialogs/package-summary.html">org.eclipse.rse.ui.dialogs</A></samp>:
|
||||
</p>
|
||||
|
||||
|
||||
|
|
@ -98,51 +98,51 @@ development and test effort. All these dialogs are in package <samp><A href="../
|
|||
<TH>Action</TH>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemRenameDialog.html">SystemRenameDialog</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/dialogs/SystemRenameDialog.html">SystemRenameDialog</A></samp></TD>
|
||||
<TD>Rename multiple items. Provides a table listing the old names and new names, which are editable. If your input objects
|
||||
do not adapt to <samp><A href="../../../com/ibm/etools/systems/core/ui/view/ISystemViewElementAdapter.html">ISystemViewElementAdapter</A></samp>
|
||||
do not adapt to <samp><A href="../../../org/eclipse/rse/ui/view/ISystemViewElementAdapter.html">ISystemViewElementAdapter</A></samp>
|
||||
or <samp><A href="../../../org/eclipse/rse/ui/view/ISystemRemoteElementAdapter.html">ISystemRemoteElementAdapter</A></samp>,
|
||||
you should call <samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemRenameDialog.html#setNameValidator(com.ibm.etools.systems.core.ui.validators.ISystemValidator)">setNameValidator</A></samp> to specify a validator that ensures the new name is correct, and your
|
||||
you should call <samp><A href="../../../org/eclipse/rse/ui/dialogs/SystemRenameDialog.html#setNameValidator(org.eclipse.rse.ui.validators.ISystemValidator)">setNameValidator</A></samp> to specify a validator that ensures the new name is correct, and your
|
||||
input objects should also either be IResource objects or implement
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/ISystemTypedObject.html">ISystemTypedObject</A></samp>.
|
||||
<samp><A href="../../../org/eclipse/rse/ui/dialogs/ISystemTypedObject.html">ISystemTypedObject</A></samp>.
|
||||
</TD>
|
||||
<TD align="center"><A href="renameManyDialog.gif">Sample image</A></TD>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/actions/SystemCommonRenameAction.html">SystemCommonRenameAction</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/actions/SystemCommonRenameAction.html">SystemCommonRenameAction</A></samp></TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemRenameSingleDialog.html">SystemRenameSingleDialog</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/dialogs/SystemRenameSingleDialog.html">SystemRenameSingleDialog</A></samp></TD>
|
||||
<TD>Rename a single item. Provides a simple entry field for the new name. If your input object
|
||||
does not adapt to <samp><A href="../../../com/ibm/etools/systems/core/ui/view/ISystemViewElementAdapter.html">ISystemViewElementAdapter</A></samp> or
|
||||
does not adapt to <samp><A href="../../../org/eclipse/rse/ui/view/ISystemViewElementAdapter.html">ISystemViewElementAdapter</A></samp> or
|
||||
<samp><A href="../../../org/eclipse/rse/ui/view/ISystemRemoteElementAdapter.html">ISystemRemoteElementAdapter</A></samp>,
|
||||
you should call <samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemRenameSingleDialog.html#setNameValidator(com.ibm.etools.systems.core.ui.validators.ISystemValidator)">setNameValidator</A></samp> to specify a validator that ensures the new name is correct, and your
|
||||
input object should also either be an IResource object or implement <samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/ISystemTypedObject.html">ISystemTypedObject</A></samp>.
|
||||
you should call <samp><A href="../../../org/eclipse/rse/ui/dialogs/SystemRenameSingleDialog.html#setNameValidator(org.eclipse.rse.ui.validators.ISystemValidator)">setNameValidator</A></samp> to specify a validator that ensures the new name is correct, and your
|
||||
input object should also either be an IResource object or implement <samp><A href="../../../org/eclipse/rse/ui/dialogs/ISystemTypedObject.html">ISystemTypedObject</A></samp>.
|
||||
</TD>
|
||||
<TD align="center"><A href="renameOneDialog.gif">Sample image</A></TD>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/actions/SystemCommonRenameAction.html">SystemCommonRenameAction</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/actions/SystemCommonRenameAction.html">SystemCommonRenameAction</A></samp></TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemDeleteDialog.html">SystemDeleteDialog</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/dialogs/SystemDeleteDialog.html">SystemDeleteDialog</A></samp></TD>
|
||||
<TD>Confirm delete of one or more items. Provides a table listing the names of input objects. If your input objects
|
||||
do not adapt to <samp><A href="../../../com/ibm/etools/systems/core/ui/view/ISystemViewElementAdapter.html">ISystemViewElementAdapter</A></samp> or
|
||||
do not adapt to <samp><A href="../../../org/eclipse/rse/ui/view/ISystemViewElementAdapter.html">ISystemViewElementAdapter</A></samp> or
|
||||
<samp><A href="../../../org/eclipse/rse/ui/view/ISystemRemoteElementAdapter.html">ISystemRemoteElementAdapter</A></samp>,
|
||||
your input objects should either be IResource objects or implement <samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/ISystemTypedObject.html">ISystemTypedObject</A></samp>.
|
||||
your input objects should either be IResource objects or implement <samp><A href="../../../org/eclipse/rse/ui/dialogs/ISystemTypedObject.html">ISystemTypedObject</A></samp>.
|
||||
</TD>
|
||||
<TD align="center"><A href="deleteDialog.gif">Sample image</A></TD>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/actions/SystemCommonDeleteAction.html">SystemCommonDeleteAction</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/actions/SystemCommonDeleteAction.html">SystemCommonDeleteAction</A></samp></TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemSelectFileTypesDialog.html">SystemSelectFileTypesDialog</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/dialogs/SystemSelectFileTypesDialog.html">SystemSelectFileTypesDialog</A></samp></TD>
|
||||
<TD>Presents a dialog listing all the file types defined in the eclipse File Associations preferences page, and
|
||||
allows the user to select one or more of these types, or enter additional types not defined in eclipse.</TD>
|
||||
<TD align="center"><A href="selectTypesDialog.gif">Sample image</A></TD>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/actions/SystemSelectFileTypesAction.html">SystemSelectFileTypesAction</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/actions/SystemSelectFileTypesAction.html">SystemSelectFileTypesAction</A></samp></TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemSimpleSelectDialog.html">SystemSimpleSelectDialog</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/dialogs/SystemSimpleSelectDialog.html">SystemSimpleSelectDialog</A></samp></TD>
|
||||
<TD>Eclipse has a CheckboxTreeViewer that is designed to allow the user to select multiple items from a hierarchical model.
|
||||
This is a nice viewer, but very difficult to program to, as you have to handle reflecting the state of the selected children
|
||||
for each parent node yourself. This dialog makes that trivial. The trick is to create wrappers of your model objects using
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemSimpleContentElement.html">SystemSimpleContentElement</A></samp>, maintaining the parent/child hierarchy, and pass the root element to the dialog. The rest is
|
||||
<samp><A href="../../../org/eclipse/rse/ui/dialogs/SystemSimpleContentElement.html">SystemSimpleContentElement</A></samp>, maintaining the parent/child hierarchy, and pass the root element to the dialog. The rest is
|
||||
done for you, and the result is the selected state set for those elements selected by the user. Note this can also be used
|
||||
as a simple flat list checkbox selection dialog, just by passing a non-visible root with a flat list of children.</TD>
|
||||
<TD align="center"><A href="simpleSelectDialog.gif">Sample image</A></TD>
|
||||
|
|
@ -152,12 +152,12 @@ development and test effort. All these dialogs are in package <samp><A href="../
|
|||
</TBODY>
|
||||
</TABLE>
|
||||
<P><BR>While the dialogs can be instantiated directly, it is perhaps best to use them by instantiating their action class, and calling the run method on it.
|
||||
The action classes are all in <samp><A href="../../../com/ibm/etools/systems/core/ui/actions/package-summary.html">com.ibm.etools.systems.core.ui.actions</A></samp> package.
|
||||
The action classes are all in <samp><A href="../../../org/eclipse/rse/ui/actions/package-summary.html">org.eclipse.rse.ui.actions</A></samp> package.
|
||||
</P>
|
||||
|
||||
<P>In addition to these universal dialogs, there are dialogs specific to the Files subsystem supplied by IBM. These enable selection
|
||||
of remote files or folders. They can be found in the <A href="../../../com/ibm/etools/systems/files/ui/dialogss/package-summary.html">
|
||||
com.ibm.etools.systems.files.ui.dialogs</A> package.
|
||||
of remote files or folders. They can be found in the <A href="../../../org/eclipse/rse/files/ui/dialogss/package-summary.html">
|
||||
org.eclipse.rse.files.ui.dialogs</A> package.
|
||||
</p>
|
||||
<TABLE border="1">
|
||||
<TBODY>
|
||||
|
|
@ -168,14 +168,14 @@ com.ibm.etools.systems.files.ui.dialogs</A> package.
|
|||
<TH>Action</TH>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/files/ui/dialogs/SystemSelectRemoteFileOrFolderDialog.html">SystemSelectRemoteFileOrFolderDialog</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/files/ui/dialogs/SystemSelectRemoteFileOrFolderDialog.html">SystemSelectRemoteFileOrFolderDialog</A></samp></TD>
|
||||
<TD>Allows users to select a remote file, or folder (configurable) using a dialog similar to what is used in Eclipse for local file or
|
||||
folder selection. Can be configured to allow user to select from any existing connection, or to be scoped to a particular connection,
|
||||
or even a particular folder in a particular connection.
|
||||
</TD>
|
||||
<TD align="center"><A href="browseFolderDialog.gif">Sample image</A></TD>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/files/ui/actions/SystemSelectRemoteFileAction.html">SystemSelectRemoteFileAction</A></samp> or
|
||||
<samp><A href="../../../com/ibm/etools/systems/files/ui/actions/SystemSelectRemoteFolderAction.html">SystemSelectRemoteFolderAction</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/files/ui/actions/SystemSelectRemoteFileAction.html">SystemSelectRemoteFileAction</A></samp> or
|
||||
<samp><A href="../../../org/eclipse/rse/files/ui/actions/SystemSelectRemoteFolderAction.html">SystemSelectRemoteFolderAction</A></samp></TD>
|
||||
</TR>
|
||||
</TBODY>
|
||||
</TABLE>
|
||||
|
|
|
|||
|
|
@ -16,8 +16,8 @@ or want to use the common RSE log file.
|
|||
|
||||
<h2>Using Your Own Log File</h2>
|
||||
<p>
|
||||
The log file support is encapsulated in a separate plugin, <b><samp>com.ibm.etools.systems.logging</samp></b>, which
|
||||
defines the primary <samp><A href="../../../com/ibm/etools/systems/logging/Logger.html">com.ibm.etools.systems.logging.Logger</a></samp> class that manages the log file.
|
||||
The log file support is encapsulated in a separate plugin, <b><samp>org.eclipse.rse.logging</samp></b>, which
|
||||
defines the primary <samp><A href="../../../org/eclipse/rse/logging/Logger.html">org.eclipse.rse.logging.Logger</a></samp> class that manages the log file.
|
||||
This log file support offers the ability to log the following types of log messages:</p>
|
||||
<ul>
|
||||
<li><b>Error</b>. These are serious errors detected by your programming logic.
|
||||
|
|
@ -73,10 +73,10 @@ preference page is supplied:</p>
|
|||
<P><IMG border="0" src="logPreferences.gif"></P>
|
||||
|
||||
<h2>Using The Common RSE Log File</h2>
|
||||
<p>To log your messages to the common RSE log file in <samp>.metadata\plugins\com.ibm.etools.systems.core</samp>,
|
||||
either base your plugin class on the <samp>com.ibm.etools.systems.core.SystemBasePlugin</samp> class and use
|
||||
<p>To log your messages to the common RSE log file in <samp>.metadata\plugins\org.eclipse.rse.core</samp>,
|
||||
either base your plugin class on the <samp>org.eclipse.rse.core.SystemBasePlugin</samp> class and use
|
||||
the inherited logging methods, or instead of instantiating your own <samp>Logging</samp> object, re-use the
|
||||
RSE-supplied logging object by calling <samp>getDefault().getLog()</samp> in the <samp>com.ibm.etools.systems.core.SystemBasePlugin</samp>
|
||||
RSE-supplied logging object by calling <samp>getDefault().getLog()</samp> in the <samp>org.eclipse.core.SystemBasePlugin</samp>
|
||||
class.
|
||||
</p>
|
||||
|
||||
|
|
|
|||
|
|
@ -16,17 +16,17 @@ and encapsulates this concept into massagers which can be re-used. A few are pre
|
|||
</p>
|
||||
|
||||
<h2>RSE Massager Interfaces</h2>
|
||||
<p>The <samp><A href="../../../com/ibm/etools/systems/core/ui/ISystemMassager.html">ISystemMassager</A></samp> interface is in package
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/ui/package-summary.html">com.ibm.etools.systems.core.ui</A></samp>.
|
||||
<p>The <samp><A href="../../../org/eclipse/rse/ui/ISystemMassager.html">ISystemMassager</A></samp> interface is in package
|
||||
<samp><A href="../../../org/eclipse/rse/ui/package-summary.html">org.eclipse.rse.ui</A></samp>.
|
||||
It is a very simple interface with one method:
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/ui/ISystemMassager.html#massage(java.lang.String)">public String massage(String text)</A></samp>.
|
||||
<samp><A href="../../../org/eclipse/rse/ui/ISystemMassager.html#massage(java.lang.String)">public String massage(String text)</A></samp>.
|
||||
Given input text, return the massaged text. While simple, by encapsulating this operation into an interface,
|
||||
you will be able to write re-usable dialogs that take a massager as input. Further, tricky massaging can be
|
||||
built as a re-usable object.
|
||||
</p>
|
||||
|
||||
<h2>RSE-Supplied Massagers</h2>
|
||||
<p>The RSE supplies the following massagers in package <samp><A href="../../../com/ibm/etools/systems/core/ui/package-summary.html">com.ibm.etools.systems.core.ui</A></samp>:
|
||||
<p>The RSE supplies the following massagers in package <samp><A href="../../../org/eclipse/rse/ui/package-summary.html">org.eclipse.rse.ui</A></samp>:
|
||||
</p>
|
||||
<BR>
|
||||
<TABLE border="1">
|
||||
|
|
@ -36,15 +36,15 @@ built as a re-usable object.
|
|||
<TH>Description</TH>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/MassagerFoldCase.html">MassagerFoldCase</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/MassagerFoldCase.html">MassagerFoldCase</A></samp></TD>
|
||||
<TD>Simply folds the text to uppercase or lowercase</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/MassagerFoldCaseOutsideQuotes.html">MassagerFoldCaseOutsideQuotes</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/MassagerFoldCaseOutsideQuotes.html">MassagerFoldCaseOutsideQuotes</A></samp></TD>
|
||||
<TD>Folds the text to uppercase or lowercase, except parts of the text that are surrounded by quotes or any given delimiter characters</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/MassagerFoldCaseUnlessQuoted.html">MassagerFoldCaseUnlessQuoted</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/MassagerFoldCaseUnlessQuoted.html">MassagerFoldCaseUnlessQuoted</A></samp></TD>
|
||||
<TD>Folds the text to uppercase or lowercase, unless the whole text is surrounded by quotes or any given delimiter character</TD>
|
||||
</TR>
|
||||
</TBODY>
|
||||
|
|
|
|||
|
|
@ -14,7 +14,7 @@
|
|||
<pre>
|
||||
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!DOCTYPE MessageFile SYSTEM "../com.ibm.etools.systems.core/messageFile.dtd">
|
||||
<!DOCTYPE MessageFile SYSTEM "../org.eclipse.rse.ui/messageFile.dtd">
|
||||
<!-- <I>This is an exammple of a message file used by SystemMessage and SystemMessageDialog</I> -->
|
||||
<MessageFile Version="1.0">
|
||||
<Component Name="Samples Plugin" Abbr="<B>SPP</B>">
|
||||
|
|
|
|||
|
|
@ -15,78 +15,78 @@ you use:
|
|||
</p>
|
||||
<ul>
|
||||
<li>Static methods in the
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html">com.ibm.etools.systems.core.SystemBasePlugin</A></samp>
|
||||
<samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html"org.eclipse.rse.core.SystemBasePlugin</A></samp>
|
||||
class to load the message file and extract messages from it.
|
||||
<li>Classes in the
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/ui/messages/package-summary.html">com.ibm.etools.systems.core.ui.messages</A></samp>
|
||||
<samp><A href="../../../org/eclipse/rse/ui/messages/package-summary.html">org.eclipse.rse.ui.messages</A></samp>
|
||||
package to do variable substitution, and display the messages to the user.
|
||||
</ul>
|
||||
|
||||
<h2>Methods for Parsing the Message File</h2>
|
||||
<p>Once you have defined your message file, you must update your plugin class to load it at startup time.
|
||||
To do this, simply call the static method
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#loadMessageFile(org.eclipse.core.runtime.IPluginDescriptor, java.lang.String)">loadMessageFile</a></samp>
|
||||
<samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#loadMessageFile(org.eclipse.core.runtime.IPluginDescriptor, java.lang.String)">loadMessageFile</a></samp>
|
||||
in the RSE-supplied <samp><a href="../plugin/uiPluginAPI.html">SystemBasePlugin</a></samp> class.
|
||||
<BR>
|
||||
<BR>
|
||||
After the message file is loaded into memory, you can extract messages from it by calling the static method
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#getMessage(com.ibm.etools.systems.core.ui.messages.SystemMessageFile, java.lang.String)">getMessage</a></samp>
|
||||
<samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#getMessage(org.eclipse.rse.ui.messages.SystemMessageFile, java.lang.String)">getMessage</a></samp>
|
||||
from the same <samp><a href="../plugin/uiPluginAPI.html">SystemBasePlugin</a></samp> class.
|
||||
</p>
|
||||
|
||||
<h2>Classes for Displaying Messages</h2>
|
||||
<p>The following classes are all defined in the <samp><A href="../../../com/ibm/etools/systems/core/ui/messages/package-summary.html">com.ibm.etools.systems.core.ui.messages</a></samp> package. </p>
|
||||
<p>The following classes are all defined in the <samp><A href="../../../org/eclipse/rse/ui/messages/package-summary.html">org.eclipse.rse.ui.messages</a></samp> package. </p>
|
||||
|
||||
<h3><A name="SystemMessageFile"></A>The <samp>SystemMessageFile</samp> Class</h3>
|
||||
<p>The <samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#loadMessageFile(org.eclipse.core.runtime.IPluginDescriptor, java.lang.String)">loadMessageFile</a></samp> method in <samp>SystemBasePlugin</samp>, returns an instance of
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/ui/messages/SystemMessageFile.html">SystemMessageFile</a></samp>,
|
||||
<p>The <samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#loadMessageFile(org.eclipse.core.runtime.IPluginDescriptor, java.lang.String)">loadMessageFile</a></samp> method in <samp>SystemBasePlugin</samp>, returns an instance of
|
||||
<samp><A href="../../../org/eclipse/rse/ui/messages/SystemMessageFile.html">SystemMessageFile</a></samp>,
|
||||
representing the parsed message file. It is methods in this which return individual messages.
|
||||
<h3><A name="SystemMessage"></A>The <samp>SystemMessage</samp> Class</h3>
|
||||
The <samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#getMessage(com.ibm.etools.systems.core.ui.messages.SystemMessageFile, java.lang.String)">getMessage</a></samp> method in <samp>SystemBasePlugin</samp> returns an instance of
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/ui/messages/SystemMessage.html">SystemMessage</a></samp>,
|
||||
The <samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#getMessage(org.eclipse.rse.ui.messages.SystemMessageFile, java.lang.String)">getMessage</a></samp> method in <samp>SystemBasePlugin</samp> returns an instance of
|
||||
<samp><A href="../../../org/eclipse/rse/ui/messages/SystemMessage.html">SystemMessage</a></samp>,
|
||||
representing an individual message from the message file.
|
||||
</p>
|
||||
<p>To do message <i>variable substitution</i>, call the appropriate overload of the <samp>makeSubstitution</samp> method in
|
||||
the <A href="../../../com/ibm/etools/systems/core/ui/messages/SystemMessage.html">message</A> object, passing as many parameters as there are unique substitution variables in the message.
|
||||
the <A href="../../../org/eclipse/rse/ui/messages/SystemMessage.html">message</A> object, passing as many parameters as there are unique substitution variables in the message.
|
||||
</p>
|
||||
<p>To get the first level message text, call <samp><A href="../../../com/ibm/etools/systems/core/ui/messages/SystemMessage.html#getLevelOneText()">getLevelOneText</a></samp> on the message object. To get
|
||||
the second level help, call <samp><A href="../../../com/ibm/etools/systems/core/ui/messages/SystemMessage.html#getLevelTwoText()">getLevelTwoText</a></samp>.
|
||||
<p>To get the first level message text, call <samp><A href="../../../org/eclipse/rse/ui/messages/SystemMessage.html#getLevelOneText()">getLevelOneText</a></samp> on the message object. To get
|
||||
the second level help, call <samp><A href="../../../org/eclipse/rse/ui/messages/SystemMessage.html#getLevelTwoText()">getLevelTwoText</a></samp>.
|
||||
</p>
|
||||
|
||||
<h3><A name="SystemMessageDialog"></A>The <samp>SystemMessageDialog</samp> Class</h3>
|
||||
<p>To display a message in a dialog, instantiate <samp><A href="../../../com/ibm/etools/systems/core/ui/messages/SystemMessageDialog.html">SystemMessageDialog</a></samp>, passing
|
||||
in a parent shell and the message object, and then call the appropriate <samp><A href="../../../com/ibm/etools/systems/core/ui/messages/SystemMessageDialog.html#open()">open</a></samp> method in the dialog object. Here is what the message
|
||||
<p>To display a message in a dialog, instantiate <samp><A href="../../../org/eclipse/rse/ui/messages/SystemMessageDialog.html">SystemMessageDialog</a></samp>, passing
|
||||
in a parent shell and the message object, and then call the appropriate <samp><A href="../../../org/eclipse/rse/ui/messages/SystemMessageDialog.html#open()">open</a></samp> method in the dialog object. Here is what the message
|
||||
dialog looks like, for a message of type Error (the type dictates the error icon):
|
||||
</p>
|
||||
<P><IMG border="0" src="msgDialog.gif" width="457" height="190"></P>
|
||||
|
||||
<h3><A name="ISystemMessageLine"></A>The <samp>ISystemMessageLine</samp> Interface</h3>
|
||||
<p>If you are extending the RSE class <samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemPromptDialog.html">SystemPromptDialog</a></samp> for dialogs,
|
||||
or <samp><A href="../../../com/ibm/etools/systems/core/ui/wizards/AbstractSystemWizardPage.html">AbstractSystemWizardPage</a></samp> for wizard pages
|
||||
or <samp><A href="../../../com/ibm/etools/systems/core/ui/propertypages/SystemBasePropertyPage.html">SystemBasePropertyPage</a></samp> for property pages, you can display the message to the
|
||||
user by calling the <samp><A href="../../../org/eclipse/rse/ui/messages/ISystemMessageLine.html#setErrorMessage(com.ibm.etools.systems.core.ui.messages.SystemMessage)">setErrorMessage</a></samp> method all these classes support. These classes all implement
|
||||
<p>If you are extending the RSE class <samp><A href="../../../org/eclipse/rse/ui/dialogs/SystemPromptDialog.html">SystemPromptDialog</a></samp> for dialogs,
|
||||
or <samp><A href="../../../org/eclipse/rse/ui/wizards/AbstractSystemWizardPage.html">AbstractSystemWizardPage</a></samp> for wizard pages
|
||||
or <samp><A href="../../../org/eclipse/rse/ui/propertypages/SystemBasePropertyPage.html">SystemBasePropertyPage</a></samp> for property pages, you can display the message to the
|
||||
user by calling the <samp><A href="../../../org/eclipse/rse/ui/messages/ISystemMessageLine.html#setErrorMessage(org.eclipse.rse.ui.messages.SystemMessage)">setErrorMessage</a></samp> method all these classes support. These classes all implement
|
||||
the interface <b><samp><A href="../../../org/eclipse/rse/ui/messages/ISystemMessageLine.html">ISystemMessageLine</a></samp></b>, which also includes the method <samp>clearErrorMessage</samp>. For non-error
|
||||
messages, use <samp><A href="../../../org/eclipse/rse/ui/messages/ISystemMessageLine.html#setMessage(com.ibm.etools.systems.core.ui.messages.SystemMessage)">setMessage</a></samp>
|
||||
messages, use <samp><A href="../../../org/eclipse/rse/ui/messages/ISystemMessageLine.html#setMessage(org.eclipse.rse.ui.messages.SystemMessage)">setMessage</a></samp>
|
||||
and <samp><A href="../../../org/eclipse/rse/ui/messages/ISystemMessageLine.html#clearMessage()">clearMessage</a></samp>.</p>
|
||||
<p>
|
||||
Here is what a system message issued in a <samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemPromptDialog.html">SystemPromptDialog</a></samp> dialog looks like:</p>
|
||||
Here is what a system message issued in a <samp><A href="../../../org/eclipse/rse/ui/dialogs/SystemPromptDialog.html">SystemPromptDialog</a></samp> dialog looks like:</p>
|
||||
<P><IMG border="0" src="msgLine_dialog.gif" width="264" height="125"></P>
|
||||
<p>The user can select the question mark icon on the right to see the full message dialog, and hence access the second level help for the message.
|
||||
<p>Here is what a system message issued in an <samp><A href="../../../com/ibm/etools/systems/core/ui/wizards/AbstractSystemWizardPage.html">AbstractSystemWizardPage</a></samp> looks like:</p>
|
||||
<p>Here is what a system message issued in an <samp><A href="../../../org/eclipse/rse/ui/wizards/AbstractSystemWizardPage.html">AbstractSystemWizardPage</a></samp> looks like:</p>
|
||||
<P><IMG border="0" src="msgLine_wizard.gif" width="439" height="98"></P>
|
||||
<p>If the user clicks the mouse on the message or icon, they will see the full message dialog for the message.</p>
|
||||
|
||||
<p>Here is what a system message issued in a <samp><A href="../../../com/ibm/etools/systems/core/ui/propertypages/SystemBasePropertyPage.html">SystemBasePropertyPage</a></samp> looks like:</p>
|
||||
<p>Here is what a system message issued in a <samp><A href="../../../org/eclipse/rse/ui/propertypages/SystemBasePropertyPage.html">SystemBasePropertyPage</a></samp> looks like:</p>
|
||||
<P><IMG border="0" src="msgLine_properties.gif" width="491" height="75"></P>
|
||||
<p>Again, if the user clicks the mouse on the message or icon, they will see the full message dialog for the message.</p>
|
||||
|
||||
<h2>Classes for Displaying Message Exceptions</h2>
|
||||
<p>The following class is defined in the <samp><A href="../../../com/ibm/etools/systems/model/package-summary.html">com.ibm.etools.systems.model</a></samp> package.
|
||||
<p>The following class is defined in the <samp><A href="../../../org/eclipse/rse/services/clientserver/messages/package-summary.html">org.eclipse.rse.services.clientserver.messages</a></samp> package.
|
||||
|
||||
<h3>The <samp>SystemMessageDialog</samp> Class</h3>
|
||||
<p>Many of the RSE APIs throw <samp><A href="../../../com/ibm/etools/systems/model/SystemMessageException.html">com.ibm.etools.systems.model.SystemMessageException</a></samp>, which
|
||||
encapsulates a system message object. To get the encapsulated message, call <samp><A href="../../../com/ibm/etools/systems/model/SystemMessageException.html#getSystemMessage()">getSystemMessage()</a></samp>.
|
||||
To display the message in an RSE message dialog box, simply call <samp><A href="../../../com/ibm/etools/systems/model/SystemMessageException.html#displayMessage()">displayMessage()</a></samp> on the exception object.
|
||||
<p>Many of the RSE APIs throw <samp><A href="../../../org/eclipse/rse/services/clientserver/messages/SystemMessageException.html">org.eclipse.rse.services.clientserver.messages.SystemMessageException</a></samp>, which
|
||||
encapsulates a system message object. To get the encapsulated message, call <samp><A href="../../../org/eclipse/rse/services/clientserver/messages/SystemMessageException.html#getSystemMessage()">getSystemMessage()</a></samp>.
|
||||
To display the message in an RSE message dialog box, simply call <samp><A href="../../../org/eclipse/rse/services/clientserver/messages/SystemMessageException.html#displayMessage()">displayMessage()</a></samp> on the exception object.
|
||||
To get the first-level text, call <samp>getMessage()</samp>, or <samp>getSystemMessage().getLevelOneText()</samp>
|
||||
</p>
|
||||
|
||||
|
|
@ -94,7 +94,7 @@ To get the first-level text, call <samp>getMessage()</samp>, or <samp>getSystemM
|
|||
<h2>Declaring the Messages</h2>
|
||||
<p>Declare the messages via the <samp>Message</samp> tag in a <a href="uiMessageFile.html">message file</a>, such as <samp>sampleMessages.xml</samp>
|
||||
<pre><?xml version="1.0" encoding='UTF-8'?>
|
||||
<!DOCTYPE MessageFile SYSTEM "../com.ibm.etools.systems.core/messageFile.dtd">
|
||||
<!DOCTYPE MessageFile SYSTEM "../org.eclipse.rse.ui/messageFile.dtd">
|
||||
<!-- This is an exammple of a message file used by SystemMessage and SystemMessageDialog -->
|
||||
<MessageFile Version="1.0">
|
||||
<Component Name="Samples Plugin" Abbr="<B>SPP</B>">
|
||||
|
|
@ -115,8 +115,8 @@ To get the first-level text, call <samp>getMessage()</samp>, or <samp>getSystemM
|
|||
<h2>Processing the Message File</h2>
|
||||
In your plugin class, declare a message file static variable, load the message file in the constructor, and
|
||||
supply a static method for retrieving a message from the file.
|
||||
<pre>import com.ibm.etools.systems.core.ui.messages.*; // <I>for message file classes</I>
|
||||
import com.ibm.etools.systems.core.*; // <I>for SystemBasePlugin</I>
|
||||
<pre>import org.eclipse.rse.ui.messages.*; // <I>for message file classes</I>
|
||||
import org.eclipse.rse.core.*; // <I>for SystemBasePlugin</I>
|
||||
<B>...</B>
|
||||
private static SystemMessageFile messageFile = null;
|
||||
<B>...</B>
|
||||
|
|
|
|||
|
|
@ -11,13 +11,13 @@
|
|||
<body bgcolor="#ffffff">
|
||||
<h1>RSE Model API</h1>
|
||||
<p>The front door to accessing the elements of the RSE model is the
|
||||
<A href="../../com/ibm/etools/systems/model/SystemRegistry.html">SystemRegistry</A>, which is a
|
||||
singleton object accessible via <A href="../../com/ibm/etools/systems/core/SystemPlugin.html#getTheSystemRegistry()">SystemPlugin.getTheSystemRegistry()</A>.
|
||||
<A href="../../org/eclipse/rse/model/SystemRegistry.html">SystemRegistry</A>, which is a
|
||||
singleton object accessible via <A href="../../org/eclipse/rse/model/SystemStartHere.html#getSystemRegistry()">SystemStartHere.getSystemRegistry()</A>.
|
||||
</p>
|
||||
<p>The system registry will get you access to profiles, connections and subsystem factories.
|
||||
From a <A href="../../com/ibm/etools/systems/subsystems/SubSystemFactory.html">subsystem factory</A> you can access subsystems, filter pools,
|
||||
From a <A href="../../org/eclipse/rse/core/subsystems/ISubSystemConfiguration.html">subsystem configuration</A> you can access subsystems, filter pools,
|
||||
user actions and compile commands.
|
||||
From <A href="../../com/ibm/etools/systems/subsystems/SubSystem.html">subsystems</A> you can access remote resources, as well
|
||||
From <A href="../../org/eclipse/rse/core/subsystems/ISubSystem.html">ISubSystem</A> you can access remote resources, as well
|
||||
as filter pools referenced by the subsystem.
|
||||
</p>
|
||||
</body>
|
||||
|
|
|
|||
|
|
@ -16,26 +16,26 @@ of using this as your base class is the inherited methods you can access.
|
|||
</p>
|
||||
<h2>Methods required in your plugin subclass</h2>
|
||||
<p>To use the RSE base plugin class
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html">com.ibm.etools.systems.core.SystemBasePlugin</A></samp>,
|
||||
<samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html">org.eclipse.rse.core.SystemBasePlugin</A></samp>,
|
||||
you subclass it for your own plugin class, and supply some key static methods of your own:
|
||||
</p>
|
||||
<ul>
|
||||
<li><samp>getDefault()</samp>. Return a singleton instance of your plugin.
|
||||
<li><samp>getResourceBundle()</samp>. Return the resource bundle for your plugin. This is stored in
|
||||
a static field, initialized in your constructor by calling the <samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#loadResourceBundle(org.eclipse.core.runtime.IPluginDescriptor, java.lang.String)">loadResourceBundle(...)</A></samp> inherited method.
|
||||
a static field, initialized in your constructor by calling the <samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#loadResourceBundle(org.eclipse.core.runtime.IPluginDescriptor, java.lang.String)">loadResourceBundle(...)</A></samp> inherited method.
|
||||
<li><samp>getString(String key)</samp>. Return a translated string by calling the inherited method
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#getString(java.util.ResourceBundle, java.lang.String)">getString(ResourceBundle rb, String key)</A></samp>, passing in the static resource bundle field.
|
||||
<samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#getString(java.util.ResourceBundle, java.lang.String)">getString(ResourceBundle rb, String key)</A></samp>, passing in the static resource bundle field.
|
||||
<li><samp>getPluginMessageFile()</samp>. Return your RSE message file instance, initialized in your
|
||||
constructor by calling <samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#loadMessageFile(org.eclipse.core.runtime.IPluginDescriptor, java.lang.String)">loadMessageFile(...)</A></samp>.
|
||||
constructor by calling <samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#loadMessageFile(org.eclipse.core.runtime.IPluginDescriptor, java.lang.String)">loadMessageFile(...)</A></samp>.
|
||||
<li><samp>getPluginMessage(String msgID)</samp>. Return the
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/ui/messages/SystemMessage.html">SystemMessage</A></samp> for the given ID, by
|
||||
<samp><A href="../../../org/eclipse/rse/services/clientserver/messages/SystemMessage.html">SystemMessage</A></samp> for the given ID, by
|
||||
calling the inherited method
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#getMessage(com.ibm.etools.systems.core.ui.messages.SystemMessageFile, java.lang.String)">getMessage(getPluginMessageFile(), msgId)</a></samp>. You will call this method often to get message objects.
|
||||
<samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#getMessage(org.eclipse.rse.services.clientserver.messages.SystemMessageFile, java.lang.String)">getMessage(getPluginMessageFile(), msgId)</a></samp>. You will call this method often to get message objects.
|
||||
</ul>
|
||||
<p>You may also override some RSE-supplied instance methods:
|
||||
<ul>
|
||||
<li><samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#initializeImageRegistry()">initializeImageRegistry()</A></samp>. Call
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#putImageInRegistry(java.lang.String, java.lang.String)">putImageInRegistry(String id, String imageFileName)</A></samp>
|
||||
<li><samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#initializeImageRegistry()">initializeImageRegistry()</A></samp>. Call
|
||||
<samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#putImageInRegistry(java.lang.String, java.lang.String)">putImageInRegistry(String id, String imageFileName)</A></samp>
|
||||
to load each of your images.
|
||||
</ul>
|
||||
</p>
|
||||
|
|
@ -50,31 +50,31 @@ to load each of your images.
|
|||
<h2>Methods inherited from the RSE base class</h2>
|
||||
<p>The methods you get access to by using the RSE-supplied base plugin class include:</p>
|
||||
<ul>
|
||||
<li><samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#getPluginId()">getPluginId()</A></samp>. Return this plugin's ID.
|
||||
<li><samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#getActiveWorkbenchShell()">getActiveWorkbenchShell()</A></samp>. Return the shell of the active workbench window.
|
||||
<li><samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#getActiveWorkbenchWindow()">getActiveWorkbenchWindow()</A></samp>. Return the active workbench window.
|
||||
<li><samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#getWorkspaceRoot()">getWorkspaceRoot()</A></samp>. Return the root of the workspace.
|
||||
<li><samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#getWorkspace()">getWorkspace()</A></samp>. Return the workspace root.
|
||||
<li><samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#getInstallLocation()">getInstallLocation()</A></samp>. Return the install directory for this plugin.
|
||||
<li><samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#getIconPath()">getIconPath()</A></samp>. Return the typical path for icons, relative to the plugin's folder: "icons"
|
||||
<li><samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#putImageInRegistry(java.lang.String, java.lang.String)">putImageInRegistry(String id, String fileName)</A></samp>. Load an image in the image registry, given the ID to retrieve it with, and its filename and path relative to this plugin's folder
|
||||
<li><samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#getImage(java.lang.String)">getImage(String id)</A></samp>. Return an Image given the ID with which it was registered in putImageInRegistry.
|
||||
<li><samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#getImageDescriptor(java.lang.String)">getImageDescriptor(String id)</A></samp>. Return an ImageDescriptor given the ID with which it was registered in putImageInRegistry.
|
||||
<li><samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#loadResourceBundle(org.eclipse.core.runtime.IPluginDescriptor, java.lang.String)">loadResourceBundle(IPluginDescriptor descriptor, String fileName)</A></samp>. Load a resource bundle, given its file name, relative to the given plugin's installation folder.
|
||||
<li><samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#loadResourceBundle(java.lang.String)">loadResourceBundle(String fileName)</A></samp>. Load a resource bundle, given its file name, relative to this plugin's installation folder.
|
||||
<li><samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#getString(java.util.ResourceBundle, java.lang.String)">getString(ResourceBundle rb, String id)</A></samp>. Return a translated string from a resource bundle, given its key ID.
|
||||
<li><samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#getString(java.util.ResourceBundle, java.lang.String, java.lang.String)">getString(ResourceBundle rb, String id, String default)</A></samp>. Return a translated string from a resource bundle, given its key ID. If key not found in the resource bundle, returns the given default string.
|
||||
<li><samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#loadMessageFile(org.eclipse.core.runtime.IPluginDescriptor, java.lang.String)">loadMessageFile(IPluginDescriptor descriptor,String fileName)</A></samp>. Parse an RSE-style message file into memory, given the plugin and message file name.
|
||||
<li><samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#getMessage(com.ibm.etools.systems.core.ui.messages.SystemMessageFile, java.lang.String)">getMessage(SystemMessageFile msgFile, String msgId)</A></samp>. Retrieve a SystemMessage object, given the message file that contains it, and its message ID including component and subcomponent abbreviations.
|
||||
<li><samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#scanForDuplicateMessages(com.ibm.etools.systems.core.ui.messages.SystemMessageFile)">scanForDuplicateMessages(SystemMessageFile msgFile)</A></samp>. Scan given message file for duplicate IDs. Typically only called during the development cycle.
|
||||
<li><samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#printMessages(com.ibm.etools.systems.core.ui.messages.SystemMessageFile, java.lang.String)">printMessages(SystemMessageFile msgFile, String fullyQualifiedTargetFile)</A></samp>. Generate an HTML file documenting the messages in the given message file, given the fully qualified name of the target HTML file.
|
||||
<li><samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#showProgrammerErrorMessage(java.lang.String)">showProgrammerErrorMessage(String msg)</A></samp>. Show a message to the user, when the message file support is not available.
|
||||
<li><samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#logInfo(java.lang.String)">logInfo(String message)</A></samp>. Log an informational message to the RSE's core log file (<samp>.....\.metadata\.plugins\com.ibm.etools.systems.core\.log</samp>).
|
||||
<li><samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#logWarning(java.lang.String)">logWarning(String message)</A></samp>. Log a warning message to the RSE's core log file (<samp>.....\.metadata\.plugins\com.ibm.etools.systems.core\.log</samp>).
|
||||
<li><samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#logError(java.lang.String)">logError(String message)</A></samp>. Log an error message to the RSE's core log file (<samp>.....\.metadata\.plugins\com.ibm.etools.systems.core\.log</samp>).
|
||||
<li><samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#logError(java.lang.String, java.lang.Throwable)">logError(String message, Throwable exception)</A></samp>. Log an error message resulting from an exception to the RSE's core log file (<samp>.....\.metadata\.plugins\com.ibm.etools.systems.core\.log</samp>).
|
||||
<li><samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#logDebugMessage(java.lang.String, java.lang.String)">logDebugMessage(String prefix, String message)</A></samp>. Log a debug (trace) message to the RSE's core log file (<samp>.....\.metadata\.plugins\com.ibm.etools.systems.core\.log</samp>).
|
||||
<li><samp><A href="../../../com/ibm/etools/systems/core/SystemBasePlugin.html#getLogger()">getLogger()</A></samp>.Return the Logger instance for the RSE default logging file (<samp>.....\.metadata\.plugins\com.ibm.etools.systems.core\.log</samp>).
|
||||
<li><samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#getPluginId()">getPluginId()</A></samp>. Return this plugin's ID.
|
||||
<li><samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#getActiveWorkbenchShell()">getActiveWorkbenchShell()</A></samp>. Return the shell of the active workbench window.
|
||||
<li><samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#getActiveWorkbenchWindow()">getActiveWorkbenchWindow()</A></samp>. Return the active workbench window.
|
||||
<li><samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#getWorkspaceRoot()">getWorkspaceRoot()</A></samp>. Return the root of the workspace.
|
||||
<li><samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#getWorkspace()">getWorkspace()</A></samp>. Return the workspace root.
|
||||
<li><samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#getInstallLocation()">getInstallLocation()</A></samp>. Return the install directory for this plugin.
|
||||
<li><samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#getIconPath()">getIconPath()</A></samp>. Return the typical path for icons, relative to the plugin's folder: "icons"
|
||||
<li><samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#putImageInRegistry(java.lang.String, java.lang.String)">putImageInRegistry(String id, String fileName)</A></samp>. Load an image in the image registry, given the ID to retrieve it with, and its filename and path relative to this plugin's folder
|
||||
<li><samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#getImage(java.lang.String)">getImage(String id)</A></samp>. Return an Image given the ID with which it was registered in putImageInRegistry.
|
||||
<li><samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#getImageDescriptor(java.lang.String)">getImageDescriptor(String id)</A></samp>. Return an ImageDescriptor given the ID with which it was registered in putImageInRegistry.
|
||||
<li><samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#loadResourceBundle(org.eclipse.core.runtime.IPluginDescriptor, java.lang.String)">loadResourceBundle(IPluginDescriptor descriptor, String fileName)</A></samp>. Load a resource bundle, given its file name, relative to the given plugin's installation folder.
|
||||
<li><samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#loadResourceBundle(java.lang.String)">loadResourceBundle(String fileName)</A></samp>. Load a resource bundle, given its file name, relative to this plugin's installation folder.
|
||||
<li><samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#getString(java.util.ResourceBundle, java.lang.String)">getString(ResourceBundle rb, String id)</A></samp>. Return a translated string from a resource bundle, given its key ID.
|
||||
<li><samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#getString(java.util.ResourceBundle, java.lang.String, java.lang.String)">getString(ResourceBundle rb, String id, String default)</A></samp>. Return a translated string from a resource bundle, given its key ID. If key not found in the resource bundle, returns the given default string.
|
||||
<li><samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#loadMessageFile(org.eclipse.core.runtime.IPluginDescriptor, java.lang.String)">loadMessageFile(IPluginDescriptor descriptor,String fileName)</A></samp>. Parse an RSE-style message file into memory, given the plugin and message file name.
|
||||
<li><samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#getMessage(org.eclipse.rse.services.clientserver.messages.SystemMessageFile, java.lang.String)">getMessage(SystemMessageFile msgFile, String msgId)</A></samp>. Retrieve a SystemMessage object, given the message file that contains it, and its message ID including component and subcomponent abbreviations.
|
||||
<li><samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#scanForDuplicateMessages(org.eclipse.rse.services.clientserver.messages.SystemMessageFile)">scanForDuplicateMessages(SystemMessageFile msgFile)</A></samp>. Scan given message file for duplicate IDs. Typically only called during the development cycle.
|
||||
<li><samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#printMessages(org.eclipse.rse.services.clientserver.messages.SystemMessageFile, java.lang.String)">printMessages(SystemMessageFile msgFile, String fullyQualifiedTargetFile)</A></samp>. Generate an HTML file documenting the messages in the given message file, given the fully qualified name of the target HTML file.
|
||||
<li><samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#showProgrammerErrorMessage(java.lang.String)">showProgrammerErrorMessage(String msg)</A></samp>. Show a message to the user, when the message file support is not available.
|
||||
<li><samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#logInfo(java.lang.String)">logInfo(String message)</A></samp>. Log an informational message to the RSE's core log file (<samp>.....\.metadata\.plugins\org.eclipse.rse.core\.log</samp>).
|
||||
<li><samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#logWarning(java.lang.String)">logWarning(String message)</A></samp>. Log a warning message to the RSE's core log file (<samp>.....\.metadata\.plugins\org.eclipse.rse.core\.log</samp>).
|
||||
<li><samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#logError(java.lang.String)">logError(String message)</A></samp>. Log an error message to the RSE's core log file (<samp>.....\.metadata\.plugins\org.eclipse.rse.core\.log</samp>).
|
||||
<li><samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#logError(java.lang.String, java.lang.Throwable)">logError(String message, Throwable exception)</A></samp>. Log an error message resulting from an exception to the RSE's core log file (<samp>.....\.metadata\.plugins\org.eclipse.rse.core\.log</samp>).
|
||||
<li><samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#logDebugMessage(java.lang.String, java.lang.String)">logDebugMessage(String prefix, String message)</A></samp>. Log a debug (trace) message to the RSE's core log file (<samp>.....\.metadata\.plugins\org.eclipse.rse.core\.log</samp>).
|
||||
<li><samp><A href="../../../org/eclipse/rse/core/SystemBasePlugin.html#getLogger()">getLogger()</A></samp>.Return the Logger instance for the RSE default logging file (<samp>.....\.metadata\.plugins\org.eclipse.rse.core\.log</samp>).
|
||||
</ul>
|
||||
</body>
|
||||
</html>
|
||||
|
|
|
|||
|
|
@ -13,7 +13,7 @@
|
|||
|
||||
<h2>RSE Preference Pages Category</h2>
|
||||
<p>All Remote System Explorer preference pages are rooted within the
|
||||
preferences category <samp>com.ibm.etools.systems.core.ui.preferences.RemoteSystemsPreferencePage</samp>,
|
||||
preferences category <samp>org.eclipse.rse.ui.preferences.RemoteSystemsPreferencePage</samp>,
|
||||
as shown here:</p>
|
||||
<P><IMG border="0" src="rsePreferences.gif"></P>
|
||||
|
||||
|
|
@ -32,20 +32,20 @@ editors" which know how to initialize, load and store their values from their pr
|
|||
<samp>initDefaults(store)</samp> method for each preference page class.
|
||||
</ol>
|
||||
<p>Should you need to query, or update, any RSE preferences you can do so via
|
||||
the getters and setters in <samp>com.ibm.etools.systems.core.SystemPreferencesManager</samp>.
|
||||
the getters and setters in <samp>org.eclipse.rse.core.SystemPreferencesManager</samp>.
|
||||
</p>
|
||||
<p>The RSE supplies a few field editors, complementing what JFace supplies
|
||||
in <samp>org.eclipse.jface.preference</samp>. The RSE-supplied field editors, and the
|
||||
RSE-supplied preferences pages, are all found in package <samp><A href="../../../com/ibm/etools/systems/core/ui/propertypages/package-summary.html">com.ibm.etools.systems.core.ui.propertypages</A></samp>:
|
||||
RSE-supplied preferences pages, are all found in package <samp><A href="../../../org/eclipse/rse/ui/propertypages/package-summary.html">org.eclipse.rse.ui.propertypages</A></samp>:
|
||||
</p>
|
||||
<ul>
|
||||
<li><b><samp><A href="../../../com/ibm/etools/systems/core/ui/propertypages/SystemBooleanFieldEditor.html">SystemBooleanFieldEditor</A></samp></b>. Extends <samp>BooleanFieldEditor</samp> to add support for tooltip text.
|
||||
<li><b><samp><A href="../../../org/eclipse/rse/ui/propertypages/SystemBooleanFieldEditor.html">SystemBooleanFieldEditor</A></samp></b>. Extends <samp>BooleanFieldEditor</samp> to add support for tooltip text.
|
||||
<p><IMG border="0" src="fldEditor_checkBox.gif"></p>
|
||||
<li><b><samp><A href="../../../com/ibm/etools/systems/core/ui/propertypages/SystemComboBoxFieldEditor.html">SystemComboBoxFieldEditor</A></samp></b>. Shows a combo box allowing the user to choose from a finite list of discrete possibilities.
|
||||
<li><b><samp><A href="../../../org/eclipse/rse/ui/propertypages/SystemComboBoxFieldEditor.html">SystemComboBoxFieldEditor</A></samp></b>. Shows a combo box allowing the user to choose from a finite list of discrete possibilities.
|
||||
<p><IMG border="0" src="fldEditor_comboBox.gif"></p>
|
||||
<li><b><samp><A href="../../../com/ibm/etools/systems/core/ui/propertypages/SystemKeyValueFieldEditor.html">SystemKeyValueFieldEditor</A></samp></b>. Shows a list of hard-coded keys, each of which supports a user-specifiable value.
|
||||
<li><b><samp><A href="../../../org/eclipse/rse/ui/propertypages/SystemKeyValueFieldEditor.html">SystemKeyValueFieldEditor</A></samp></b>. Shows a list of hard-coded keys, each of which supports a user-specifiable value.
|
||||
<p><IMG border="0" src="fldEditor_keyValue.gif"></p>
|
||||
<li><b><samp><A href="../../../com/ibm/etools/systems/core/ui/propertypages/SystemStringFieldEditor.html">SystemStringFieldEditor</A></samp></b>. For simple string preferences. Unlike the JFace string editor, this supports tooltip text and RSE validators and massagers on the typed text.
|
||||
<li><b><samp><A href="../../../org/eclipse/rse/ui/propertypages/SystemStringFieldEditor.html">SystemStringFieldEditor</A></samp></b>. For simple string preferences. Unlike the JFace string editor, this supports tooltip text and RSE validators and massagers on the typed text.
|
||||
<p><IMG border="0" src="fldEditor_string.gif"></p>
|
||||
</ul>
|
||||
<P><BR></P>
|
||||
|
|
|
|||
|
|
@ -16,7 +16,7 @@ of value.
|
|||
|
||||
<h2>RSE-Supplied Base Class for Property Pages</h2>
|
||||
<p>The RSE supplies a base class for property pages,
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/ui/propertypages/SystemBasePropertyPage.html">com.ibm.etools.systems.core.ui.propertypages.SystemBasePropertyPage</A></samp>,
|
||||
<samp><A href="../../../org/eclipse/rse/ui/propertypages/SystemBasePropertyPage.html">org.eclipse.rse.ui.propertypages.SystemBasePropertyPage</A></samp>,
|
||||
that extends the base eclipse property page <samp>org.eclipse.ui.dialogs.PropertyPage</samp>. The advantages
|
||||
of using this RSE-supplied class are:
|
||||
</p>
|
||||
|
|
@ -42,23 +42,23 @@ point, you need to know the class or, preferably, interface that the objects imp
|
|||
</TR>
|
||||
<TR>
|
||||
<TD>Profile</TD>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/model/SystemProfile.html">com.ibm.etools.systems.model.SystemProfile</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/model/ISystemProfile.html">org.eclipse.rse.model.ISystemProfile</A></samp></TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD>Connection</TD>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/model/SystemConnection.html">com.ibm.etools.systems.model.SystemConnection</A></samp></TD>
|
||||
<TD>Host</TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/model/IHost.html">org.eclipse.rse.model.IHost</A></samp></TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD>Subsystem</TD>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/subsystems/SubSystem.html">com.ibm.etools.systems.subsystems.SubSystem</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/core/subsystems/ISubSystem.html">org.eclipse.rse.core.subsystems.ISubSystem</A></samp></TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD>Filter pool reference</TD>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/filters/SystemFilterPoolReference.html">com.ibm.etools.systems.filters.SystemFilterPoolReference</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/filters/ISystemFilterPoolReference.html">org.eclipse.rse.filters.ISystemFilterPoolReference</A></samp></TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD>Filter reference</TD>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/filters/SystemFilterReference.html">com.ibm.etools.systems.filters.SystemFilterReference</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/filters/ISystemFilterReference.html">org.eclipse.rse.filters.ISystemFilterReference</A></samp></TD>
|
||||
</TR>
|
||||
</TBODY>
|
||||
</TABLE>
|
||||
|
|
|
|||
|
|
@ -10,22 +10,22 @@
|
|||
|
||||
<body bgcolor="#ffffff">
|
||||
<h1>RSE Remote Resource API</h1>
|
||||
<p>IBM supplies subsystems for accessing the file system and for executing commands, for
|
||||
<p>RSE supplies subsystems for accessing the file system and for executing commands, for
|
||||
all system types ("universally").
|
||||
</p>
|
||||
<p>
|
||||
To programmatically access the files in a remote system
|
||||
identified by a particular system connection, use the
|
||||
<A href="../../com/ibm/etools/systems/model/SystemRegistry.html">system registry</A> to get to the
|
||||
<A href="../../com/ibm/etools/systems/model/SystemRegistry.html#getFileSubSystem(com.ibm.etools.systems.model.SystemConnection)">file subsystem</A>
|
||||
for that connection. This <A href="../../com/ibm/etools/systems/subsystems/RemoteFileSubSystem.html">file subsystem</A> offers methods for accessing the remote files.
|
||||
<A href="../../org/eclipse/rse/model/ISystemRegistry.html">system registry</A> to get to the
|
||||
<A href="../../org/eclipse/rse/model/ISystemRegistry.html#getSubSystemsBySubSystemConfigurationCategory(String, org.eclipse.rse.model.IHost)">file subsystem</A>
|
||||
for that connection, by passing in the file category as a String. This <A href="../../org/eclipse/rse/subsystems/files/core/subsystems/IRemoteFileSubSystem.html">file subsystem</A> offers methods for accessing the remote files.
|
||||
</p>
|
||||
<p>
|
||||
Similarly, to programmatically run commands in a remote system
|
||||
identified by a particular system connection, use the
|
||||
<A href="../../com/ibm/etools/systems/model/SystemRegistry.html">system registry</A> to get to the
|
||||
<A href="../../com/ibm/etools/systems/model/SystemRegistry.html#getCmdSubSystem(com.ibm.etools.systems.model.SystemConnection)">command subsystem</A>
|
||||
for that connection. This <A href="../../com/ibm/etools/systems/subsystems/RemoteCmdSubSystem.html">command subsystem</A> offers methods for running remote commands,
|
||||
<A href="../../org/eclipse/rse/model/ISystemRegistry.html">system registry</A> to get to the
|
||||
<A href="../../org/eclipse/rse/model/ISystemRegistry.html#getSubSystemsBySubSystemConfigurationCategory(String, org.eclipse.rse.model.IHost)">command subsystem</A>
|
||||
for that connection, by passing in the command category as a String. This <A href="../../org/eclipse/rse/subsystems/shells/core/subsystems/IRemoteCmdSubSystem.html">command subsystem</A> offers methods for running remote commands,
|
||||
either in a new command shell or an existing command shell. You can also set environment variables
|
||||
using this subsytem object.
|
||||
</p>
|
||||
|
|
|
|||
|
|
@ -37,7 +37,7 @@ methods of your own.
|
|||
<h2>Logging</h2>
|
||||
<p>The Remote System Explorer comes with special support for <a href="logger/uiLoggerAPI.html">logging information</a> to a log file,
|
||||
for the purpose of problem determination for servicing your plugin. The log file support allows
|
||||
you to either log your messages to the common RSE log file in the <samp>.metadata\plugins\com.ibm.etools.systems.core</samp>
|
||||
you to either log your messages to the common RSE log file in the <samp>.metadata\plugins\org.eclipse.rse.core</samp>
|
||||
folder, or to define your own log file in your plugin metadata folder, if desired.
|
||||
</p>
|
||||
|
||||
|
|
@ -58,8 +58,8 @@ the RSE for remote resource access. This support involves defining an xml
|
|||
the messages, and using a set of
|
||||
<a href="messages/uiMessageAPI.html">supplied classes</a> to work with the messages.
|
||||
</p>
|
||||
<p>Before defining your own messages, you may wish to peruse the list of <a href="messages/uiMessagesCore.html">IBM-supplied messages</a> already defined
|
||||
by the RSE. The key benefit to using an existing message is translation, as these are already
|
||||
<p>Before defining your own messages, you may wish to peruse the list of <a href="messages/uiMessagesCore.html">RSE-supplied messages</a> that are
|
||||
already defined. The key benefit to using an existing message is translation, as these are already
|
||||
translated into many languages.
|
||||
</p>
|
||||
|
||||
|
|
@ -117,9 +117,9 @@ together with the RSE dialog and wizard support.
|
|||
|
||||
<p>Often we want to refresh the contents of the Remote Systems view or Table view from within our actions, to visualize
|
||||
changes to the selected resources. To do this, use the
|
||||
<samp><A href="../../com/ibm/etools/systems/model/SystemRegistry.html#fireRemoteResourceChangeEvent(int, java.lang.Object, java.lang.Object, com.ibm.etools.systems.subsystems.SubSystem, java.lang.String, org.eclipse.jface.viewers.Viewer)">method</a></samp>.
|
||||
<samp><A href="../../org/eclipse/rse/model/ISystemRegistry.html#fireRemoteResourceChangeEvent(int, java.lang.Object, java.lang.Object, org.eclipse.rse.core.subsystems.ISubSystem, java.lang.String, org.eclipse.jface.viewers.Viewer)">method</a></samp>.
|
||||
To get the system registry, use the
|
||||
<samp><A href="../../com/ibm/etools/systems/core/SystemPlugin.html#getTheSystemRegistry()">method</a></samp>.
|
||||
<samp><A href="../../org/eclipse/rse/model/SystemStartHere.html#getSystemRegistry()">method</a></samp>.
|
||||
</body>
|
||||
|
||||
</html>
|
||||
|
|
|
|||
|
|
@ -11,7 +11,7 @@
|
|||
<body bgcolor="#ffffff">
|
||||
<h1>RSE Validators API</h1>
|
||||
<p>Throughout an eclipse UI there are times when we need to validate what the user has typed in. Validators
|
||||
offer a way to encapsulate the error checking for a particular domain, so it can be re-used whereever the user
|
||||
offer a way to encapsulate the error checking for a particular domain, so it can be re-used wherever the user
|
||||
is prompted for this. This includes dialogs, property pages, preference pages, wizard pages and viewer
|
||||
cells. Eclipse's JFace offers two interfaces for this, one for viewer cells and one for the rest. In RSE,
|
||||
there is a single interface combining the requirements of both, so you can author a single validator that is
|
||||
|
|
@ -20,10 +20,10 @@ supplied to enhance re-use, such as the maximum length, which can be used to set
|
|||
</p>
|
||||
|
||||
<h2>RSE Validator Interfaces</h2>
|
||||
<p>All RSE validator interfaces and classes are in package <samp><A href="../../../com/ibm/etools/systems/core/ui/validators/package-summary.html">com.ibm.etools.systems.core.ui.validators</A></samp>.
|
||||
<p>All RSE validator interfaces and classes are in package <samp><A href="../../../org/eclipse/rse/ui/validators/package-summary.html">org.eclipse.rse.ui.validators</A></samp>.
|
||||
|
||||
<h3>ISystemValidator Interface</h3>
|
||||
<p>The primary validator interface is <samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ISystemValidator.html">ISystemValidator</A></samp>, which is extends <samp>org.eclipse.jface.dialogs.IInputValidator</samp>
|
||||
<p>The primary validator interface is <samp><A href="../../../org/eclipse/rse/ui/validators/ISystemValidator.html">ISystemValidator</A></samp>, which is extends <samp>org.eclipse.jface.dialogs.IInputValidator</samp>
|
||||
and <samp>org.eclipse.jface.viewers.ICellEditorValidator</samp>. Both parent interfaces define an <samp>isValid</samp> method,
|
||||
but the former takes a String while the latter takes an Object. They both return a String which is the error message if an
|
||||
error was detected, or null if no error detected. The <samp>ISystemValidator</samp> interface adds the following additional methods:
|
||||
|
|
@ -36,17 +36,17 @@ error was detected, or null if no error detected. The <samp>ISystemValidator</sa
|
|||
<TH>Description</TH>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp>public int <A href="../../../com/ibm/etools/systems/core/ui/validators/ISystemValidator.html#getMaximumNameLength()">getMaximumNameLength()</A></samp></TD>
|
||||
<TD><samp>public int <A href="../../../org/eclipse/rse/ui/validators/ISystemValidator.html#getMaximumNameLength()">getMaximumNameLength()</A></samp></TD>
|
||||
<TD>Returns the maximum length allowed for this text. Can be used to set text limit of text widgets.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp>public SystemMessage <A href="../../../com/ibm/etools/systems/core/ui/validators/ISystemValidator.html#getSystemMessage()">getSystemMessage()</A></samp></TD>
|
||||
<TD><samp>public SystemMessage <A href="../../../org/eclipse/rse/ui/validators/ISystemValidator.html#getSystemMessage()">getSystemMessage()</A></samp></TD>
|
||||
<TD>If <samp>isValid</samp> returns false, this returns a <samp>SystemMessage</samp> object that offers richer message support than just a string.
|
||||
Return null if you don't support <samp><A href="../messages/uiMessageAPI.html">SystemMessages</A></samp>.
|
||||
Callers don't need to use this if they use <samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ISystemValidator.html#validate(java.lang.String)">validate(String)</A></samp> instead of <samp>isValid(String)</samp>.</TD>
|
||||
Callers don't need to use this if they use <samp><A href="../../../org/eclipse/rse/ui/validators/ISystemValidator.html#validate(java.lang.String)">validate(String)</A></samp> instead of <samp>isValid(String)</samp>.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp>public SystemMessage <A href="../../../com/ibm/etools/systems/core/ui/validators/ISystemValidator.html#validate(java.lang.String)">validate(String text)</A></samp></TD>
|
||||
<TD><samp>public SystemMessage <A href="../../../org/eclipse/rse/ui/validators/ISystemValidator.html#validate(java.lang.String)">validate(String text)</A></samp></TD>
|
||||
<TD>An alternative to <samp>isValid</samp> if your validator does support <samp>SystemMessage</samp> objects versus simple strings for error messages.</TD>
|
||||
</TR>
|
||||
</TBODY>
|
||||
|
|
@ -54,7 +54,7 @@ error was detected, or null if no error detected. The <samp>ISystemValidator</sa
|
|||
|
||||
<h3>ISystemValidatorUniqueString Interface</h3>
|
||||
<p>Often our validation requires checking that the given text is unique, in some given list of existing things, like names say. To facilitate
|
||||
this, there is an interface <samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ISystemValidatorUniqueString.html">ISystemValidatorUniqueString</A></samp>, which extends <samp>ISystemValidator</samp> and adds some additional
|
||||
this, there is an interface <samp><A href="../../../org/eclipse/rse/ui/validators/ISystemValidatorUniqueString.html">ISystemValidatorUniqueString</A></samp>, which extends <samp>ISystemValidator</samp> and adds some additional
|
||||
methods required for uniqueness validation:
|
||||
</p>
|
||||
|
||||
|
|
@ -65,31 +65,31 @@ methods required for uniqueness validation:
|
|||
<TH>Description</TH>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp>public void <A href="../../../com/ibm/etools/systems/core/ui/validators/ISystemValidatorUniqueString.html#setCaseSensitive(boolean)">setCaseSensitive(boolean caseSensitive)</A></samp></TD>
|
||||
<TD><samp>public void <A href="../../../org/eclipse/rse/ui/validators/ISystemValidatorUniqueString.html#setCaseSensitive(boolean)">setCaseSensitive(boolean caseSensitive)</A></samp></TD>
|
||||
<TD>Specifies whether the test for an existing string should consider case or not.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp>public void <A href="../../../com/ibm/etools/systems/core/ui/validators/ISystemValidatorUniqueString.html#setExistingNamesList(java.lang.String[])">setExistingNamesList(String[] existingList)</A></samp></TD>
|
||||
<TD><samp>public void <A href="../../../org/eclipse/rse/ui/validators/ISystemValidatorUniqueString.html#setExistingNamesList(java.lang.String[])">setExistingNamesList(String[] existingList)</A></samp></TD>
|
||||
<TD>Sets the existing list to test against, as an array.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp>public void <A href="../../../com/ibm/etools/systems/core/ui/validators/ISystemValidatorUniqueString.html#setExistingNamesList(java.util.Vector)">setExistingNamesList(Vector existingList)</A></samp></TD>
|
||||
<TD><samp>public void <A href="../../../org/eclipse/rse/ui/validators/ISystemValidatorUniqueString.html#setExistingNamesList(java.util.Vector)">setExistingNamesList(Vector existingList)</A></samp></TD>
|
||||
<TD>Sets the existing list to test against, as a vector of Strings.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp>public String[] <A href="../../../com/ibm/etools/systems/core/ui/validators/ISystemValidatorUniqueString.html#getExistingNamesList()">getExistingNamesList()</A></samp></TD>
|
||||
<TD><samp>public String[] <A href="../../../org/eclipse/rse/ui/validators/ISystemValidatorUniqueString.html#getExistingNamesList()">getExistingNamesList()</A></samp></TD>
|
||||
<TD>Returns the existing list that is used to test against.</TD>
|
||||
</TR>
|
||||
</TBODY>
|
||||
</TABLE>
|
||||
<p>If you desire to create a unique string validator, you probably will start by subclassing <samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ValidatorUniqueString.html">ValidatorUniqueString</A></samp>.
|
||||
<p>If you desire to create a unique string validator, you probably will start by subclassing <samp><A href="../../../org/eclipse/rse/ui/validators/ValidatorUniqueString.html">ValidatorUniqueString</A></samp>.
|
||||
</p>
|
||||
|
||||
<h3>IValidatorRemoteSelection Interface</h3>
|
||||
<p>The third validator interface is <samp><A href="../../../com/ibm/etools/systems/core/ui/validators/IValidatorRemoteSelection.html">IValidatorRemoteSelection</A></samp>, which is specifically intended to be used
|
||||
<p>The third validator interface is <samp><A href="../../../org/eclipse/rse/ui/validators/IValidatorRemoteSelection.html">IValidatorRemoteSelection</A></samp>, which is specifically intended to be used
|
||||
in the remote resource selection dialogs supplied by the RSE. It allows you to decide when to enable the OK button, based on what
|
||||
is selected. It contains only the following method:</p>
|
||||
<samp>public SystemMessage <A href="../../../com/ibm/etools/systems/core/ui/validators/IValidatorRemoteSelection.html#isValid(com.ibm.etools.systems.model.SystemConnection, java.lang.Object[], com.ibm.etools.systems.core.ui.view.ISystemRemoteElementAdapter[])">isValid(SystemConnection selectedConnection, Object[] selectedObjects, ISystemRemoteElementAdapter[] remoteAdaptersForSelectedObject)</A>;</samp>
|
||||
<samp>public SystemMessage <A href="../../../org/eclipse/rse/ui/validators/IValidatorRemoteSelection.html#isValid(org.eclipse.rse.model.IHost, java.lang.Object[], org.eclipse.rse.ui.view.ISystemRemoteElementAdapter[])">isValid(SystemConnection selectedConnection, Object[] selectedObjects, ISystemRemoteElementAdapter[] remoteAdaptersForSelectedObject)</A>;</samp>
|
||||
<p>You typically won't implement this interface directly, but rather sublcass <samp>ValidatorRemoteSelection</samp>.</p>
|
||||
|
||||
<h3>Validator Samples</h3>
|
||||
|
|
@ -106,9 +106,9 @@ appropriate to simply subclass one of these RSE-supplied validators. All of them
|
|||
via setter calls, or subclassed, whichever is most convenient.</p>
|
||||
<p>All of these validators support rich <samp><A href="../messages/uiMessageAPI.html">SystemMessage</A></samp> objects, versus just simple strings for the error message. When used with the
|
||||
RSE dialog, property page or wizard page classes, you should call
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ISystemValidator.html#validate(java.lang.String)">validate(String)</A></samp> and call
|
||||
<samp><A href="../../../org/eclipse/rse/ui/messages/ISystemMessageLine.html#setErrorMessage(com.ibm.etools.systems.core.ui.messages.SystemMessage)">setErrorMessage</A></samp> with the result. When used
|
||||
in other places you should use <samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ISystemValidator.html#isValid(java.lang.String)">isValid(String)</A></samp> as it returns just the first-level text of the system message.</p>
|
||||
<samp><A href="../../../org/eclipse/rse/ui/validators/ISystemValidator.html#validate(java.lang.String)">validate(String)</A></samp> and call
|
||||
<samp><A href="../../../org/eclipse/rse/ui/messages/ISystemMessageLine.html#setErrorMessage(org.eclipse.rse.ui.messages.SystemMessage)">setErrorMessage</A></samp> with the result. When used
|
||||
in other places you should use <samp><A href="../../../org/eclipse/rse/ui/validators/ISystemValidator.html#isValid(java.lang.String)">isValid(String)</A></samp> as it returns just the first-level text of the system message.</p>
|
||||
<TABLE border="1">
|
||||
<TBODY>
|
||||
<TR>
|
||||
|
|
@ -116,104 +116,104 @@ in other places you should use <samp><A href="../../../com/ibm/etools/systems/co
|
|||
<TH>Description</TH>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ValidatorCompileCommandLabel.html">ValidatorCompileCommandLabel</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/validators/ValidatorCompileCommandLabel.html">ValidatorCompileCommandLabel</A></samp></TD>
|
||||
<TD>Validates the label for a compile command in the RSE.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ValidatorConnectionName.html">ValidatorConnectionName</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/validators/ValidatorConnectionName.html">ValidatorConnectionName</A></samp></TD>
|
||||
<TD>Validates the name of a connection in the RSE.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ValidatorFileName.html">ValidatorFileName</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/validators/ValidatorFileName.html">ValidatorFileName</A></samp></TD>
|
||||
<TD>Validates the name of a file in eclipse.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ValidatorFilterName.html">ValidatorFilterName</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/validators/ValidatorFilterName.html">ValidatorFilterName</A></samp></TD>
|
||||
<TD>Validates the name of a filter in the RSE.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ValidatorFilterPoolName.html">ValidatorFilterPoolName</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/validators/ValidatorFilterPoolName.html">ValidatorFilterPoolName</A></samp></TD>
|
||||
<TD>Validates the name of a filter pool in the RSE.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ValidatorFilterString.html">ValidatorFilterString</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/validators/ValidatorFilterString.html">ValidatorFilterString</A></samp></TD>
|
||||
<TD>Validates the contents of a filter string in the RSE.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ValidatorFolderName.html">ValidatorFolderName</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/validators/ValidatorFolderName.html">ValidatorFolderName</A></samp></TD>
|
||||
<TD>Validates the name of a folder in eclipse.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ValidatorIntegerInput.html">ValidatorIntegerInput</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/validators/ValidatorIntegerInput.html">ValidatorIntegerInput</A></samp></TD>
|
||||
<TD>Validates the given string is a valid integer.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ValidatorIntegerRangeInput.html">ValidatorIntegerRangeInput</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/validators/ValidatorIntegerRangeInput.html">ValidatorIntegerRangeInput</A></samp></TD>
|
||||
<TD>Validates the given string is a valid integer within a given range.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ValidatorLongInput.html">ValidatorLongInput</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/validators/ValidatorLongInput.html">ValidatorLongInput</A></samp></TD>
|
||||
<TD>Validates the given string is a valid long integer.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ValidatorLongRangeInput.html">ValidatorLongRangeInput</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/validators/ValidatorLongRangeInput.html">ValidatorLongRangeInput</A></samp></TD>
|
||||
<TD>Validates the given string is a valid long integer within a given range.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ValidatorPathName.html">ValidatorPathName</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/validators/ValidatorPathName.html">ValidatorPathName</A></samp></TD>
|
||||
<TD>Validates the given string is a valid folder path in eclipse.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ValidatorPortInput.html">ValidatorPortInput</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/validators/ValidatorPortInput.html">ValidatorPortInput</A></samp></TD>
|
||||
<TD>Validates the given string is a valid TCP/IP port number.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ValidatorProfileName.html">ValidatorProfileName</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/validators/ValidatorProfileName.html">ValidatorProfileName</A></samp></TD>
|
||||
<TD>Validates the name of a system profile in the RSE.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ValidatorRemoteSelection.html">ValidatorRemoteSelection</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/validators/ValidatorRemoteSelection.html">ValidatorRemoteSelection</A></samp></TD>
|
||||
<TD>This is a very special case abstract base class, for validators that decide the enablement of the OK button
|
||||
in the RSE-supplied remote resource selection dialogs.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ValidatorSourceType.html">ValidatorSourceType</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/validators/ValidatorSourceType.html">ValidatorSourceType</A></samp></TD>
|
||||
<TD>A validator for source types, such as a file type or "*.java". It is intended to be subclassed.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ValidatorSpecialChar.html">ValidatorSpecialChar</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/validators/ValidatorSpecialChar.html">ValidatorSpecialChar</A></samp></TD>
|
||||
<TD>A base class for validators that need to ensure the given string doesn't contain certain characters.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ValidatorSystemName.html">ValidatorSystemName</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/validators/ValidatorSystemName.html">ValidatorSystemName</A></samp></TD>
|
||||
<TD>A name validator, to be used when the name being prompted for must follow Java identifier rules.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ValidatorUniqueString.html">ValidatorUniqueString</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/validators/ValidatorUniqueString.html">ValidatorUniqueString</A></samp></TD>
|
||||
<TD>A base class, or configurable class, to be used for any validation that requires the string to be unique within a given list.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ValidatorUserActionCommand.html">ValidatorUserActionCommand</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/validators/ValidatorUserActionCommand.html">ValidatorUserActionCommand</A></samp></TD>
|
||||
<TD>Validates the command of a user defined action in the RSE.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ValidatorUserActionComment.html">ValidatorUserActionComment</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/validators/ValidatorUserActionComment.html">ValidatorUserActionComment</A></samp></TD>
|
||||
<TD>Validates the comment of a user defined action in the RSE.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ValidatorUserActionName.html">ValidatorUserActionName</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/validators/ValidatorUserActionName.html">ValidatorUserActionName</A></samp></TD>
|
||||
<TD>Validates the name of a user defined action in the RSE.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ValidatorUserId.html">ValidatorUserId</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/validators/ValidatorUserId.html">ValidatorUserId</A></samp></TD>
|
||||
<TD>Validates a user ID. Does only basic checking, intended to be subclassed.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ValidatorUserTypeName.html">ValidatorUserTypeName</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/validators/ValidatorUserTypeName.html">ValidatorUserTypeName</A></samp></TD>
|
||||
<TD>Validates the name of a named type in the RSE.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/validators/ValidatorUserTypeTypes.html">ValidatorUserTypeTypes</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/validators/ValidatorUserTypeTypes.html">ValidatorUserTypeTypes</A></samp></TD>
|
||||
<TD>Validates the type list of a named type in the RSE.</TD>
|
||||
</TR>
|
||||
</TBODY>
|
||||
|
|
|
|||
|
|
@ -15,10 +15,10 @@ Note that while that is all is does today, the power of encapsulation is that we
|
|||
checking in the future, and all dialogs or wizards that use the validator will pick up that change.
|
||||
<pre>
|
||||
|
||||
package com.ibm.etools.systems.samples.ui.frameworks.dialogs;
|
||||
import com.ibm.etools.systems.samples.*;
|
||||
import com.ibm.etools.systems.core.ui.messages.SystemMessage;
|
||||
import com.ibm.etools.systems.core.ui.validators.ISystemValidator;
|
||||
package org.eclipse.rse.samples.ui.frameworks.dialogs;
|
||||
import org.eclipse.rse.samples.*;
|
||||
import org.eclipse.rse.ui.messages.SystemMessage;
|
||||
import org.eclipse.rse.ui.validators.ISystemValidator;
|
||||
|
||||
/**
|
||||
* <I>A validator for a customer name. We simply ensure it is not empty, but this could easily be expanded.</I>
|
||||
|
|
@ -50,7 +50,7 @@ public class <B>SampleNameValidator</B> implements ISystemValidator
|
|||
|
||||
/**
|
||||
* <I>Required ISystemValidator interface method.</I>
|
||||
* <I>@see com.ibm.etools.systems.core.ui.validators.ISystemValidator#getSystemMessage()</I>
|
||||
* <I>@see org.eclipse.rse.ui.validators.ISystemValidator#getSystemMessage()</I>
|
||||
*/
|
||||
public SystemMessage <B>getSystemMessage</B>()
|
||||
{
|
||||
|
|
@ -59,7 +59,7 @@ public class <B>SampleNameValidator</B> implements ISystemValidator
|
|||
|
||||
/**
|
||||
* <I>Required ISystemValidator interface method.</I>
|
||||
* <I>@see com.ibm.etools.systems.core.ui.validators.ISystemValidator#validate(String)</I>
|
||||
* <I>@see org.eclipse.rse.ui.validators.ISystemValidator#validate(String)</I>
|
||||
*/
|
||||
public SystemMessage <B>validate</B>(String text)
|
||||
{
|
||||
|
|
|
|||
|
|
@ -14,9 +14,9 @@
|
|||
simply supplying unique messages.
|
||||
<pre>
|
||||
|
||||
package com.ibm.etools.systems.samples.ui.frameworks.dialogs;
|
||||
import com.ibm.etools.systems.core.ui.validators.ValidatorIntegerRangeInput;
|
||||
import com.ibm.etools.systems.samples.*;
|
||||
package org.eclipse.rse.samples.ui.frameworks.dialogs;
|
||||
import org.eclipse.rse.ui.validators.ValidatorIntegerRangeInput;
|
||||
import org.eclipse.rse.samples.*;
|
||||
|
||||
/**
|
||||
* <I>An example of a customized validator, that prompts for a birth year.</I>
|
||||
|
|
|
|||
|
|
@ -12,9 +12,9 @@
|
|||
<p>This is an example of a validator written by extending an existing RSE-supplied validator, and
|
||||
simply supplying unique messages.
|
||||
<pre>
|
||||
package com.ibm.etools.systems.samples.ui.frameworks.dialogs;
|
||||
import com.ibm.etools.systems.core.ui.validators.ValidatorIntegerRangeInput;
|
||||
import com.ibm.etools.systems.samples.*;
|
||||
package org.eclipse.rse.samples.ui.frameworks.dialogs;
|
||||
import org.eclipse.rse.ui.validators.ValidatorIntegerRangeInput;
|
||||
import org.eclipse.rse.samples.*;
|
||||
|
||||
/**
|
||||
* <I>An example of a customized validator, that prompts for a birth month.</I>
|
||||
|
|
|
|||
|
|
@ -13,9 +13,9 @@
|
|||
<p>This is an example of a validator written by extending an existing RSE-supplied validator, and
|
||||
simply supplying unique messages.
|
||||
<pre>
|
||||
package com.ibm.etools.systems.samples.ui.frameworks.dialogs;
|
||||
import com.ibm.etools.systems.core.ui.validators.ValidatorIntegerRangeInput;
|
||||
import com.ibm.etools.systems.samples.*;
|
||||
package org.eclipse.rse.samples.ui.frameworks.dialogs;
|
||||
import org.eclipse.rse.core.ui.validators.ValidatorIntegerRangeInput;
|
||||
import org.eclipse.rse.samples.*;
|
||||
|
||||
/**
|
||||
* <I>An example of a customized validator, that prompts for a birth day.</I>
|
||||
|
|
|
|||
|
|
@ -15,14 +15,14 @@
|
|||
and process the widgets in the client area. The RSE offers some help in this area in two ways:
|
||||
</p>
|
||||
<ol>
|
||||
<li>A <samp><A href="../../../com/ibm/etools/systems/core/ui/SystemWidgetHelpers.html">SystemWidgetHelpers</A></samp>
|
||||
<li>A <samp><A href="../../../org/eclipse/rse/ui/SystemWidgetHelpers.html">SystemWidgetHelpers</A></samp>
|
||||
class full of static methods to make it easier to create SWT widgets.
|
||||
<li>A few re-usable widgets that extend SWT.
|
||||
</ol>
|
||||
|
||||
<h2>SystemWidgetHelpers Class</h2>
|
||||
<p>The <samp><A href="../../../com/ibm/etools/systems/core/ui/SystemWidgetHelpers.html">SystemWidgetHelpers</A></samp>
|
||||
class in <samp><A href="../../../com/ibm/etools/systems/core/ui/package-summary.html">com.ibm.etools.systems.core.ui</A></samp>
|
||||
<p>The <samp><A href="../../../org/eclipse/rse/ui/SystemWidgetHelpers.html">SystemWidgetHelpers</A></samp>
|
||||
class in <samp><A href="../../../org/eclipse/rse/ui/package-summary.html">org.eclipse.rse.ui</A></samp>
|
||||
is chock full of static methods to simplify the work in populating a GridLayout composite with widgets. The GridLayout composite is the most
|
||||
flexible and useful of the layouts, yet the most work to code to. These methods will help with that. The methods include:
|
||||
</p>
|
||||
|
|
@ -38,7 +38,7 @@ flexible and useful of the layouts, yet the most work to code to. These methods
|
|||
</ul>
|
||||
|
||||
<h2>RSE-Supplied Widgets</h2>
|
||||
<p>The <samp><A href="../../../com/ibm/etools/systems/core/ui/widgets/package-summary.html">com.ibm.etools.systems.core.ui.widgets</A></samp>
|
||||
<p>The <samp><A href="../../../org/eclipse/rse/ui/widgets/package-summary.html">org.eclipse.rse.ui.widgets</A></samp>
|
||||
package contains some specialized widgets you may find a use for:
|
||||
</p>
|
||||
<TABLE border="1">
|
||||
|
|
@ -48,25 +48,25 @@ package contains some specialized widgets you may find a use for:
|
|||
<TH>Description</TH>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/widgets/SystemHistoryCombo.html">SystemHistoryCombo</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/widgets/SystemHistoryCombo.html">SystemHistoryCombo</A></samp></TD>
|
||||
<TD>A entry field that remembers its previous values and shows them in a dropdown so the user can easily re-select a previously typed value. The history is maintained for you, and is indexed by a key. This allows the combos to share history across numerous dialogs, property pages or wizard pages. The history can be bounded and pre-filled, and the user can clear the history at any time. This handy widget is used extensively within the RSE.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/widgets/InheritableEntryField.html">InheritableEntryField</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/widgets/InheritableEntryField.html">InheritableEntryField</A></samp></TD>
|
||||
<TD>An entry field with an left-right arrow beside it. When toggled left, the entry field is not editable and displays a supplied value. When toggled right, the entry field is editable. Useful in cases where the user can choose between an inherited or default value, or enter their own value.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/widgets/SystemPortPrompt.html">SystemPortPrompt</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/widgets/SystemPortPrompt.html">SystemPortPrompt</A></samp></TD>
|
||||
<TD>Uses the InheritableEntryField to prompt for a TCP/IP port, where toggling to the left means port 0, or let the "first available port".</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../../com/ibm/etools/systems/core/ui/widgets/SystemConnectionCombo.html">SystemConnectionCombo</A></samp></TD>
|
||||
<TD><samp><A href="../../../org/eclipse/rse/ui/widgets/SystemConnectionCombo.html">SystemConnectionCombo</A></samp></TD>
|
||||
<TD>This is a combo box that displays the currently defined RSE system connections. The list can be subset by system type or types. Further, you can optionally display a New button beside the combo that allows the user to create a new connection.</TD>
|
||||
</TR>
|
||||
</TBODY>
|
||||
</TABLE>
|
||||
<p>There are also many useful widgets related to the selection of remote files or folders, in package
|
||||
<samp><A href="../../../com/ibm/etools/systems/files/ui/widgets/package-summary.html">com.ibm.etools.systems.files.ui.widgets</A></samp>
|
||||
<samp><A href="../../../org/eclipse/rse/files/ui/widgets/package-summary.html">org.eclipse.rse.files.ui.widgets</A></samp>
|
||||
|
||||
<P><BR></P>
|
||||
</body>
|
||||
|
|
|
|||
|
|
@ -18,19 +18,19 @@ can offer help in creating wizards, just as it does in creating dialogs.
|
|||
|
||||
<h2>RSE-Supplied Base Classes for Wizards</h2>
|
||||
<p>The RSE offers the following classes, in package
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/ui/wizards/package-summary.html">com.ibm.etools.systems.core.ui.wizards</A></samp> to simplify the creation of wizards.</p>
|
||||
<samp><A href="../../../org/eclipse/rse/ui/wizards/package-summary.html">org.eclipse.rse.ui.wizards</A></samp> to simplify the creation of wizards.</p>
|
||||
|
||||
<h3>The <samp>AbstractSystemWizardPage</samp> class</h3>
|
||||
<p>The <samp><A href="../../../com/ibm/etools/systems/core/ui/wizards/AbstractSystemWizardPage.html">AbstractSystemWizardPage</A></samp> abstract base class extends the
|
||||
<p>The <samp><A href="../../../org/eclipse/rse/ui/wizards/AbstractSystemWizardPage.html">AbstractSystemWizardPage</A></samp> abstract base class extends the
|
||||
JFace <samp>WizardPage</samp> class to offer the following benefits to subclasses:</p>
|
||||
<ol>
|
||||
<li>Designed to work in conjunction with <samp><A href="../../../com/ibm/etools/systems/core/ui/wizards/AbstractSystemWizard.html">AbstractSystemWizard</A></samp>,
|
||||
<li>Designed to work in conjunction with <samp><A href="../../../org/eclipse/rse/ui/wizards/AbstractSystemWizard.html">AbstractSystemWizard</A></samp>,
|
||||
propogating settings from the wizard to the individual wizard pages.
|
||||
<li>Supports using the overall wizard page title as set
|
||||
by <samp><A href="../../../com/ibm/etools/systems/core/ui/wizards/AbstractSystemWizard.html#setWizardPageTitle(java.lang.String)">setWizardPageTitle(String)</A></samp>
|
||||
in <samp><A href="../../../com/ibm/etools/systems/core/ui/wizards/AbstractSystemWizard.html">AbstractSystemWizard</A></samp>,
|
||||
by <samp><A href="../../../org/eclipse/rse/ui/wizards/AbstractSystemWizard.html#setWizardPageTitle(java.lang.String)">setWizardPageTitle(String)</A></samp>
|
||||
in <samp><A href="../../../org/eclipse/rse/ui/wizards/AbstractSystemWizard.html">AbstractSystemWizard</A></samp>,
|
||||
if no title specified in the constructor.
|
||||
<li>Supports a <samp><A href="../../../com/ibm/etools/systems/core/ui/wizards/AbstractSystemWizardPage.html#setHelp(java.lang.String)">setHelp(String)</A></samp> method to set the wizard page's overall contextual help
|
||||
<li>Supports a <samp><A href="../../../org/eclipse/rse/ui/wizards/AbstractSystemWizardPage.html#setHelp(java.lang.String)">setHelp(String)</A></samp> method to set the wizard page's overall contextual help
|
||||
<li>Implements <samp><A
|
||||
href="../messages/uiMessageAPI.html#ISystemMessageLine">ISystemMessageLine</A></samp> so supports setting error messages as
|
||||
either strings or, preferably, <samp><A
|
||||
|
|
@ -38,34 +38,34 @@ JFace <samp>WizardPage</samp> class to offer the following benefits to subclasse
|
|||
<li>Supports automatic assignment of unique mnemonics for all input-capable controls on the page, to aid in accessibility.
|
||||
<li>Supports setting a default-focus control, which gets initial focus when the page is shown.
|
||||
<li>Supports helper methods to aid in population of the client area:
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/ui/wizards/AbstractSystemWizardPage.html#addSeparatorLine(org.eclipse.swt.widgets.Composite, int)">addSeparatorLine(Composite,int)</A></samp>,
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/ui/wizards/AbstractSystemWizardPage.html#addFillerLine(org.eclipse.swt.widgets.Composite, int)">addFillerLine(Composite,int)</A></samp> and
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/ui/wizards/AbstractSystemWizardPage.html#addGrowableFillerLine(org.eclipse.swt.widgets.Composite, int)">addGrowableFillerLine(Composite,int)</A></samp>.
|
||||
<samp><A href="../../../org/eclipse/rse/ui/wizards/AbstractSystemWizardPage.html#addSeparatorLine(org.eclipse.swt.widgets.Composite, int)">addSeparatorLine(Composite,int)</A></samp>,
|
||||
<samp><A href="../../../org/eclipse/rse/ui/wizards/AbstractSystemWizardPage.html#addFillerLine(org.eclipse.swt.widgets.Composite, int)">addFillerLine(Composite,int)</A></samp> and
|
||||
<samp><A href="../../../org/eclipse/rse/ui/wizards/AbstractSystemWizardPage.html#addGrowableFillerLine(org.eclipse.swt.widgets.Composite, int)">addGrowableFillerLine(Composite,int)</A></samp>.
|
||||
</ol>
|
||||
|
||||
|
||||
<h3><A name="AbstractSystemWizard"></A>The <samp>AbstractSystemWizard</samp> class</h3>
|
||||
<p>The <samp><A href="../../../com/ibm/etools/systems/core/ui/wizards/AbstractSystemWizard.html">AbstractSystemWizard</A></samp> abstract base class extends the JFace <samp>Wizard</samp>
|
||||
<p>The <samp><A href="../../../org/eclipse/rse/ui/wizards/AbstractSystemWizard.html">AbstractSystemWizard</A></samp> abstract base class extends the JFace <samp>Wizard</samp>
|
||||
class to offer the following benefits to subclasses:</p>
|
||||
<ol>
|
||||
<li>Designed to work in conjunction with the <samp><A href="../../../com/ibm/etools/systems/core/ui/actions/SystemBaseWizardAction.html">SystemBaseWizardAction</A></samp>,
|
||||
and <samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemWizardDialog.html">SystemWizardDialog</A></samp> classes, propogating settings
|
||||
<li>Designed to work in conjunction with the <samp><A href="../../../org/eclipse/rse/ui/actions/SystemBaseWizardAction.html">SystemBaseWizardAction</A></samp>,
|
||||
and <samp><A href="../../../org/eclipse/rse/ui/dialogs/SystemWizardDialog.html">SystemWizardDialog</A></samp> classes, propogating settings
|
||||
from these to the wizard, and further propogating those to the individual wizard pages.
|
||||
<li>The overall wizard title and image can be set via the constructor or setter methods.
|
||||
<li>Supports setting an input object, and getting an output object. This is exploited by the
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/ui/actions/SystemBaseWizardAction.html">SystemBaseWizardAction</A></samp> class, when this wizard is launched from a subclass of that action class.
|
||||
<li>Supports setting a wizard page title via <samp><A href="../../../com/ibm/etools/systems/core/ui/wizards/AbstractSystemWizard.html#setWizardPageTitle(java.lang.String)">setWizardPageTitle(String)</A></samp>, that all
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/ui/wizards/AbstractSystemWizardPage.html">AbstractSystemWizardPage</A></samp> pages will use by default for
|
||||
<samp><A href="../../../org/eclipse/rse/ui/actions/SystemBaseWizardAction.html">SystemBaseWizardAction</A></samp> class, when this wizard is launched from a subclass of that action class.
|
||||
<li>Supports setting a wizard page title via <samp><A href="../../../org/eclipse/rse/ui/wizards/AbstractSystemWizard.html#setWizardPageTitle(java.lang.String)">setWizardPageTitle(String)</A></samp>, that all
|
||||
<samp><A href="../../../org/eclipse/rse/ui/wizards/AbstractSystemWizardPage.html">AbstractSystemWizardPage</A></samp> pages will use by default for
|
||||
their title, if the non-title constructor is used for that page.
|
||||
<li>If being hosted by a <samp><A href="../../../com/ibm/etools/systems/core/ui/dialogs/SystemWizardDialog.html">SystemWizardDialog</A></samp>, supports dynamically
|
||||
updating the wizard size via <samp><A href="../../../com/ibm/etools/systems/core/ui/wizards/AbstractSystemWizard.html#updateSize()">updateSize()</A></samp>,
|
||||
<li>If being hosted by a <samp><A href="../../../org/eclipse/rse/ui/dialogs/SystemWizardDialog.html">SystemWizardDialog</A></samp>, supports dynamically
|
||||
updating the wizard size via <samp><A href="../../../org/eclipse/rse/ui/wizards/AbstractSystemWizard.html#updateSize()">updateSize()</A></samp>,
|
||||
if dynamic content is added to a wizard page, causing the page to grow beyond its initial size.
|
||||
<li>Supports a <samp><A href="../../../com/ibm/etools/systems/core/ui/wizards/AbstractSystemWizard.html#setHelp(java.lang.String)">setHelp(String)</A></samp> method to set the overall wizard's contextual help. This is propogated to each
|
||||
<samp><A href="../../../com/ibm/etools/systems/core/ui/wizards/AbstractSystemWizardPage.html">AbstractSystemWizardPage</A></samp> as it is added.
|
||||
<li>Supports a <samp><A href="../../../org/eclipse/rse/ui/wizards/AbstractSystemWizard.html#setHelp(java.lang.String)">setHelp(String)</A></samp> method to set the overall wizard's contextual help. This is propogated to each
|
||||
<samp><A href="../../../org/eclipse/rse/ui/wizards/AbstractSystemWizardPage.html">AbstractSystemWizardPage</A></samp> as it is added.
|
||||
<li>Supports setting the viewer that launched this wizard, as wizards often need to know this so they can update the UI upon Finish.
|
||||
<li>Supports a <samp><A href="../../../com/ibm/etools/systems/core/ui/wizards/AbstractSystemWizard.html#wasCancelled()">wasCancelled()</A></samp> method so callers can easily test if the wizard was cancelled by the user.
|
||||
<li>Supports a <samp><A href="../../../com/ibm/etools/systems/core/ui/wizards/AbstractSystemWizard.html#setMinimumPageSize(int, int)">setMinimumPageSize(int,int)</A></samp> method to set the minimum width and height of the wizard.
|
||||
<li>Supports a <samp><A href="../../../com/ibm/etools/systems/core/ui/wizards/AbstractSystemWizard.html#setPageError(org.eclipse.jface.wizard.IWizardPage)">setPageError(IWizardPage)</A></samp> method that can be called in performFinish when an error is detected on a
|
||||
<li>Supports a <samp><A href="../../../org/eclipse/rse/ui/wizards/AbstractSystemWizard.html#wasCancelled()">wasCancelled()</A></samp> method so callers can easily test if the wizard was cancelled by the user.
|
||||
<li>Supports a <samp><A href="../../../org/eclipse/rse/ui/wizards/AbstractSystemWizard.html#setMinimumPageSize(int, int)">setMinimumPageSize(int,int)</A></samp> method to set the minimum width and height of the wizard.
|
||||
<li>Supports a <samp><A href="../../../org/eclipse/rse/ui/wizards/AbstractSystemWizard.html#setPageError(org.eclipse.jface.wizard.IWizardPage)">setPageError(IWizardPage)</A></samp> method that can be called in performFinish when an error is detected on a
|
||||
non-current page. This issues a message telling the user there is an error on another page.
|
||||
</ol>
|
||||
|
||||
|
|
|
|||
|
|
@ -27,14 +27,12 @@ the information needed to enable them to in Remote System Explorer.
|
|||
<TD>For adding actions to the pulldown menu in any view's local toolbar, or to the toolbar itself.
|
||||
To use this you need to know the ID of the RSE views, for the <samp>targetID</samp> attribute: There are:
|
||||
<ul>
|
||||
<li><samp>com.ibm.etools.systems.core.ui.view.systemView</samp> for the primary
|
||||
<li><samp>org.eclipse.rse.ui.view.systemView</samp> for the primary
|
||||
<A href="view_RS.gif">Remote Systems</A> view.
|
||||
<li><samp>com.ibm.etools.systems.core.ui.view.teamView</samp> for the
|
||||
<li><samp>org.eclipse.rse.ui.view.teamView</samp> for the
|
||||
<A href="view_Team.gif">Team</A> view in the RSE perspective.
|
||||
<li><samp>com.ibm.etools.systems.core.ui.view.systemTableView</samp> for the
|
||||
<li><samp>org.eclipse.rse.ui.view.systemTableView</samp> for the
|
||||
<A href="view_Table.gif">Remote System Details</A> view in the RSE perspective.
|
||||
<li><samp>com.ibm.etools.systems.core.ui.view.commandsView</samp> for the
|
||||
<A href="view_Cmds.gif">Remote Commands</A> view in the RSE perspective.
|
||||
</ul>
|
||||
</TD>
|
||||
</TR>
|
||||
|
|
@ -44,10 +42,10 @@ the information needed to enable them to in Remote System Explorer.
|
|||
Remote System Explorer. To use this you need to know the class type
|
||||
of these objects for the <samp>objectClass</samp> attribute of the <samp><page></samp> element:
|
||||
<ul>
|
||||
<li>Connections: <samp><A href="../../com/ibm/etools/systems/model/SystemConnection.html">com.ibm.etools.systems.model.SystemConnection</A></samp>
|
||||
<li>SubSystems: <samp><A href="../../com/ibm/etools/systems/subsystems/SubSystem.html">com.ibm.etools.systems.subsystems.SubSystem</A></samp>
|
||||
<li>Filter Pools: <samp><A href="../../com/ibm/etools/systems/filters/SystemFilterPoolReference.html">com.ibm.etools.systems.filters.SystemFilterPoolReference</A></samp>
|
||||
<li>Filters: <samp><A href="../../com/ibm/etools/systems/filters/SystemFilterReference.html">com.ibm.etools.systems.filters.SystemFilterReference</A></samp>
|
||||
<li>Connections: <samp><A href="../../org/eclipse/rse/model/IHost.html"org.eclipse.rse.model.IHost</A></samp>
|
||||
<li>SubSystems: <samp><A href="../../org/eclipse/rse/core/subsystems/ISubSystem.html">org.eclipse.rse.core.subsystems.SubSystem</A></samp>
|
||||
<li>Filter Pools: <samp><A href="../../org/eclipse/rse/filters/ISystemFilterPoolReference.html">org.eclipse.rse.filters.ISystemFilterPoolReference</A></samp>
|
||||
<li>Filters: <samp><A href="../../org/eclipse/rse/filters/ISystemFilterReference.html">org.eclipse.rse.filters.ISystemFilterReference</A></samp>
|
||||
</ul>
|
||||
It is possible to scope your property pages to only appear for certain system types or subsystems, using
|
||||
the <samp><filter></samp> element. For example:<br>
|
||||
|
|
@ -56,7 +54,7 @@ the information needed to enable them to in Remote System Explorer.
|
|||
<page name="Team Info"
|
||||
class="samples.ui.propertypages.TeamFilterPropertyPage"
|
||||
id="samples.ui.pp.filter.team"
|
||||
objectClass="com.ibm.etools.systems.filters.SystemFilterReference" >
|
||||
objectClass="org.eclipse.rse.filters.ISystemFilterReference" >
|
||||
<b><filter name="subsystemFactoryId" value="samples.subsystems.factory"/></b>
|
||||
</page>
|
||||
</extension>
|
||||
|
|
@ -70,10 +68,10 @@ the information needed to enable them to in Remote System Explorer.
|
|||
To use this you need to know the class type of these objects for the <samp>objectClass</samp> attribute
|
||||
of the <objectContribution> element:
|
||||
<ul>
|
||||
<li>Connections: <samp><A href="../../com/ibm/etools/systems/model/SystemConnection.html">com.ibm.etools.systems.model.SystemConnection</A></samp>
|
||||
<li>SubSystems: <samp><A href="../../com/ibm/etools/systems/subsystems/SubSystem.html">com.ibm.etools.systems.subsystems.SubSystem</A></samp>
|
||||
<li>Filter Pools: <samp><A href="../../com/ibm/etools/systems/filters/SystemFilterPoolReference.html">com.ibm.etools.systems.filters.SystemFilterPoolReference</A></samp>
|
||||
<li>Filters: <samp><A href="../../com/ibm/etools/systems/filters/SystemFilterReference.html">com.ibm.etools.systems.filters.SystemFilterReference</A></samp>
|
||||
<li>Connections: <samp><A href="../../org/eclipse/rse/model/IHost.html"org.eclipse.rse.model.IHost</A></samp>
|
||||
<li>SubSystems: <samp><A href="../../org/eclipse/rse/core/subsystems/ISubSystem.html">org.eclipse.rse.core.subsystems.SubSystem</A></samp>
|
||||
<li>Filter Pools: <samp><A href="../../org/eclipse/rse/filters/ISystemFilterPoolReference.html">org.eclipse.rse.filters.ISystemFilterPoolReference</A></samp>
|
||||
<li>Filters: <samp><A href="../../org/eclipse/rse/filters/ISystemFilterReference.html">org.eclipse.rse.filters.ISystemFilterReference</A></samp>
|
||||
</ul>
|
||||
It is possible to scope your actions to only appear for certain system types or subsystems, using
|
||||
the <samp><filter></samp> element. For example:<br>
|
||||
|
|
@ -81,7 +79,7 @@ the information needed to enable them to in Remote System Explorer.
|
|||
<extension point="org.eclipse.ui.popupMenus">
|
||||
<objectContribution
|
||||
id ="samples.ui.actions.TeamFilterActions"
|
||||
objectClass="com.ibm.etools.systems.filters.SystemFilterReference">
|
||||
objectClass="org.eclipse.rse.filters.ISystemFilterReference">
|
||||
<b><filter name="subsystemFactoryId" value="samples.subsystems.factory"/></b>
|
||||
<action id="samples.ui.actions.TeamFilterAction1"
|
||||
label="Sample Team Filter Action"
|
||||
|
|
@ -130,11 +128,11 @@ on the <samp>category</samp> of the subsystem factory that created this object's
|
|||
You can specify multiple values if you comma-separate them.
|
||||
</ul>
|
||||
|
||||
<p>For system filter objects of type <samp>com.ibm.etools.systems.filters.SystemFilterReference</samp>,
|
||||
<p>For system filter objects of type <samp>org.eclipse.rse.filters.ISystemFilterReference</samp>,
|
||||
the following names are also supported:
|
||||
<ul>
|
||||
<li><b><samp>"filterType"</samp></b>. Will test the <i>value</i> for an exact match on the selected filter's
|
||||
untranslated type, as set internally. The only IBM-supplied subsystem to support multiple filter types is
|
||||
untranslated type, as set internally. The only RSE-supplied subsystem to support multiple filter types is
|
||||
the iSeries Objects subsystem for iSeries connections. It contains these types:
|
||||
<ul>
|
||||
<li><samp>"Library"</samp>.
|
||||
|
|
|
|||
|
|
@ -11,8 +11,8 @@
|
|||
|
||||
<body bgcolor="#ffffff">
|
||||
<h1>Plugging In Popup Menu Actions</h1>
|
||||
<p>The <samp><A href="../../doc/org_eclipse_rse_ui_popupMenus.html">com.ibm.etools.systems.core.popupMenus</a></samp> extension point is defined in the
|
||||
plugin <samp>com.ibm.etools.systems.core</samp>, and it is patterned
|
||||
<p>The <samp><A href="../../doc/org_eclipse_rse_ui_popupMenus.html">org.eclipse.rse.ui.popupMenus</a></samp> extension point is defined in the
|
||||
plugin <samp>org.eclipse.rse.ui</samp>, and it is patterned
|
||||
after Eclipse's <samp>org.eclipse.ui.popupMenus</samp> extension point. However, it is
|
||||
both simplified and extended specifically for remote objects.
|
||||
</p>
|
||||
|
|
@ -44,9 +44,9 @@ it will be created.
|
|||
<br>
|
||||
For the root cascading menu, you can also use this to specify a group within the remote object's pop-up,
|
||||
for where to place this cascading menu. The default is the <samp>additions</samp> group, which is near the
|
||||
bottom of the pop-up menu. The IBM-supplied groups for pop-up menus are listed shortly in Table 4. There are
|
||||
also a few IBM-supplied cascading menus listed in Table 4, which can be specified for the id prefix in order
|
||||
to add a cascading menu to an IBM-supplied cascading menu.
|
||||
bottom of the pop-up menu. The RSE-supplied groups for pop-up menus are listed shortly in Table 4. There are
|
||||
also a few RSE-supplied cascading menus listed in Table 4, which can be specified for the id prefix in order
|
||||
to add a cascading menu to an RSE-supplied cascading menu.
|
||||
</ul>
|
||||
<P>Within each <samp><menu></samp> element are one or more <b><samp><separator></samp></b> elements that partition the cascading
|
||||
menu into groups. Groups are simply named physical areas of the menu. The order in which they are defined is the order they
|
||||
|
|
@ -71,8 +71,8 @@ element. The attributes for <samp><action></samp> elements are:
|
|||
default location within the remote object's pop-up menu. This is a group name, optionally preceded by slash-delimited Ids for actions
|
||||
that go inside cascading menus, where each Id matches an id attribute from a previously specified <samp><menu></samp> element.
|
||||
If no menubarPath is specified, the action goes into the <samp><additions></samp> area of the object's popup menu, which is
|
||||
near the bottom of the pop-up menu. The IBM-supplied groups for remote object pop-up menus are listed in Table 4, as well as menu Ids
|
||||
for IBM-supplied cascading menus, should you wish to add an action to an IBM-supplied cascading menu.
|
||||
near the bottom of the pop-up menu. The RSE-supplied groups for remote object pop-up menus are listed in Table 4, as well as menu Ids
|
||||
for RSE-supplied cascading menus, should you wish to add an action to an RSE-supplied cascading menu.
|
||||
<li><b>enablesFor</b>. Tells when to enable this action based on how many items are selected. Typically, specify "1" for
|
||||
single-selection or "+" for multiple-selection. You can also change the enabled state of your action within your class,
|
||||
by calling the <samp>setEnabled(boolean)</samp> method or overriding the <samp>getEnabled(Object[] currentlySelected)</samp> method that is called
|
||||
|
|
@ -87,12 +87,12 @@ element, are the most difficult to master. The rules are reasonably simple thoug
|
|||
</p>
|
||||
<ol>
|
||||
<li>To have your action show up in the initial pop-up menu, just specify a group name on the <samp>menubarPath</samp> attribute. That name can be
|
||||
one of the IBM-supplied group names defined in Table 4, or your own group name, which will be created and appended to the end of the
|
||||
one of the RSE-supplied group names defined in Table 4, or your own group name, which will be created and appended to the end of the
|
||||
pop-up menu. The default group is <samp>"additions"</samp>.
|
||||
<br>Example: <samp>menubarPath="myGroup"</samp>
|
||||
<li>To have your action show up in a simple IBM-supplied cascading menu within the pop-up menu, in your <samp><action></samp> element,
|
||||
specify the IBM-supplied menu ID from Table 4 in the <samp>menubarPath</samp> attribute, then a slash followed by the name of a group. The only
|
||||
IBM-supplied group for cascading menus is <samp>"additions"</samp>. If you specify anything else for the group, the group will be created for you
|
||||
<li>To have your action show up in a simple RSE-supplied cascading menu within the pop-up menu, in your <samp><action></samp> element,
|
||||
specify the RSE-supplied menu ID from Table 4 in the <samp>menubarPath</samp> attribute, then a slash followed by the name of a group. The only
|
||||
RSE-supplied group for cascading menus is <samp>"additions"</samp>. If you specify anything else for the group, the group will be created for you
|
||||
at the bottom of the menu.
|
||||
<br>Example: <samp>menubarPath="menu.new/myGroup"</samp>
|
||||
<li>To have your action show up in a simple cascading menu of your own, first define the menu with a <samp><menu></samp> element,
|
||||
|
|
@ -112,8 +112,8 @@ specifying all the menu Ids up to the final menu, slash-separated, and then the
|
|||
|
||||
<h2>Programming Details</h2>
|
||||
<p>To use this extension point you will create a class that extends the
|
||||
<samp><A href="../../com/ibm/etools/systems/core/ui/actions/SystemAbstractPopupMenuExtensionAction.html">SystemAbstractPopupMenuExtensionAction</A></samp> class in the
|
||||
package <samp><A href="../../com/ibm/etools/systems/core/ui/actions/package-summary.html">com.ibm.etools.systems.core.ui.actions</A></samp>. This is your action class,
|
||||
<samp><A href="../../org/eclipse/rse/ui/actions/SystemAbstractPopupMenuExtensionAction.html">SystemAbstractPopupMenuExtensionAction</A></samp> class in the
|
||||
package <samp><A href="../../org/eclipse/rse/ui/actions/package-summary.html">org.eclipse.rse.ui.actions</A></samp>. This is your action class,
|
||||
and when the user selects your action, the <samp>run()</samp>
|
||||
method in your action class will be called. You will rarely extend the <samp>SystemAbstractPopupMenuExtensionAction</samp> base class
|
||||
directly, though. Instead there are subclasses of it that offer additional functionality for specific types of remote objects,
|
||||
|
|
@ -128,13 +128,13 @@ as shown here:
|
|||
<TH>Description</TH>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../com/ibm/etools/systems/core/ui/actions/SystemAbstractPopupMenuExtensionAction.html">SystemAbstractPopupMenuExtensionAction</A></samp> in
|
||||
<samp>com.ibm.etools.systems.core</samp> plugin</TD>
|
||||
<TD><samp><A href="../../org/eclipse/rse/ui/actions/SystemAbstractPopupMenuExtensionAction.html">SystemAbstractPopupMenuExtensionAction</A></samp> in
|
||||
<samp>org.eclipse.rse.ui</samp> plugin</TD>
|
||||
<TD>Base class offering generic support for any remote object pop-up menu action, for any system type.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../com/ibm/etools/systems/core/ui/actions/SystemAbstractRemoteFilePopupMenuExtensionAction.html">SystemAbstractRemoteFilePopupMenuExtensionAction</A></samp>
|
||||
in <samp>com.ibm.etools.systems.core</samp> plugin</TD>
|
||||
<TD><samp><A href="../../org/eclipse/rse/files/ui/actions/SystemAbstractRemoteFilePopupMenuExtensionAction.html">SystemAbstractRemoteFilePopupMenuExtensionAction</A></samp>
|
||||
in <samp>org.eclipse.rse.files.ui</samp> plugin</TD>
|
||||
<TD>Specialized base class offering specific support for any remote file object pop-up menu action, for any system type.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
|
|
|
|||
|
|
@ -11,8 +11,8 @@
|
|||
|
||||
<body bgcolor="#ffffff">
|
||||
<h1>Plugging In Property Pages</h1>
|
||||
<p>The <samp><A href="../../doc/org_eclipse_rse_ui_propertyPages.html">com.ibm.etools.systems.core.propertyPages</a></samp> extension point is defined in the
|
||||
plugin <samp>com.ibm.etools.systems.core</samp>, and it is patterned after Eclipse's <samp>org.Eclipse.ui.propertyPages</samp> extension point, but both
|
||||
<p>The <samp><A href="../../doc/org_eclipse_rse_ui_propertyPages.html">org.eclipse.rse.ui.propertyPages</a></samp> extension point is defined in the
|
||||
plugin <samp>org.eclipse.rse.ui</samp>, and it is patterned after Eclipse's <samp>org.eclipse.ui.propertyPages</samp> extension point, but both
|
||||
simplified and extended specifically for remote objects. <BR>
|
||||
What is a property page?
|
||||
It is a page that shows up in the Eclipse <A href="propertypage_figure2.gif">Properties dialog</A> that users
|
||||
|
|
@ -57,13 +57,13 @@ selected on the left side. The supplied classes are listed here:
|
|||
<TH>Description</TH>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../com/ibm/etools/systems/core/ui/propertypages/SystemAbstractPropertyPageExtensionAction.html">SystemAbstractPropertyPageExtensionAction</A></samp>
|
||||
in <samp>com.ibm.etools.systems.core</samp> plugin.</TD>
|
||||
<TD><samp><A href="../../org/eclipse/rse/ui/propertypages/SystemAbstractPropertyPageExtensionAction.html">SystemAbstractPropertyPageExtensionAction</A></samp>
|
||||
in <samp>org.eclipse.rse.ui</samp> plugin.</TD>
|
||||
<TD>Base class offering generic support for any remote object property page.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD><samp><A href="../../com/ibm/etools/systems/core/ui/propertypages/SystemAbstractRemoteFilePropertyPageExtensionAction.html">SystemAbstractRemoteFilePropertyPageExtensionAction</A></samp>
|
||||
in <samp>com.ibm.etools.systems.core</samp> plugin.</TD>
|
||||
<TD><samp><A href="../../org/eclipse/rse/files/ui/propertypages/SystemAbstractRemoteFilePropertyPageExtensionAction.html">SystemAbstractRemoteFilePropertyPageExtensionAction</A></samp>
|
||||
in <samp>org.eclipse.rse.files.ui</samp> plugin.</TD>
|
||||
<TD>Specialized base class offering specific support for any remote file object property page.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
|
|
|
|||
|
|
@ -11,32 +11,32 @@
|
|||
|
||||
<body bgcolor="#ffffff">
|
||||
<h1>Plugging In SubSystems</h1>
|
||||
<p>The <samp><A href="../../doc/org_eclipse_rse_ui_subsystemfactory.html">com.ibm.etools.systems.core.subsystemfactory</a></samp>
|
||||
extension point is defined in the plugin <samp>com.ibm.etools.systems.core</samp>.
|
||||
<p>The <samp><A href="../../doc/org_eclipse_rse_ui_subsystemConfiguration.html">org.eclipse.rse.ui.subsystemConfiguration</a></samp>
|
||||
extension point is defined in the plugin <samp>org.eclipse.rse.ui</samp>.
|
||||
This is the most complex extension point to use, but also the most powerful. It enables
|
||||
tool providers to register a class that creates subsystem objects, which appear under
|
||||
a connection when a connection is expanded in the Remote Systems view.
|
||||
For example, <A href="RSView_iSeries.gif">here is an iSeries connection</A> with four subsystems,
|
||||
each created by a subsystem factory registered with this extension point.
|
||||
each created by a subsystem configuration registered with this extension point.
|
||||
</p>
|
||||
<p>The <A href="../../doc/org_eclipse_rse_ui_subsystemfactory.html">extension markup</A> is quite simple for this extension point,
|
||||
as it has only one element, <b><samp><factory></samp></b>, with only a few simple attributes to supply:
|
||||
<p>The <A href="../../doc/org_eclipse_rse_ui_subsystemConfiguration.html">extension markup</A> is quite simple for this extension point,
|
||||
as it has only one element, <b><samp><configuration></samp></b>, with only a few simple attributes to supply:
|
||||
</p>
|
||||
<ul>
|
||||
<li><b>id</b>. Unique id for the extension, as required for all extensions. However, in this case it is used to create
|
||||
folders within the <samp>RemoteSystemsConnections</samp> project, where all Remote Systems Explorer data is stored.
|
||||
There is also a way to <A href="../../com/ibm/etools/systems/model/SystemRegistry.html#getSubSystemFactory(java.lang.String)">query</A> a subsystem factory
|
||||
object via its ID.<li><b>vendor</b>. Your company name, shown in properties dialog for subsystems created by this subsystem factory.
|
||||
<li><b>icon</b>. The icon displayed in the Remote Systems view for each subsystem created by this subsystem factory.
|
||||
There is also a way to <A href="../../org/eclipse/rse/model/ISystemRegistry.html#getSubSystemConfiguration(java.lang.String)">query</A> a subsystem configuration
|
||||
object via its ID.<li><b>vendor</b>. Your company name, shown in properties dialog for subsystems created by this subsystem configuration.
|
||||
<li><b>icon</b>. The icon displayed in the Remote Systems view for each subsystem created by this subsystem configuration.
|
||||
<li><b>iconlive</b>. The icon used when the subsystem is physically connected to its remote system.
|
||||
<li><b>name</b>. The name displayed in the Remote Systems view for each subsystem created by this subsystem factory.
|
||||
<li><b>systemtypes</b>. A semi-colon separated list of system types which this subsystem factory supports. When a user creates a
|
||||
connection, this factory will only be asked to create a subsystem for connections to systems of these types. The default is all
|
||||
<li><b>name</b>. The name displayed in the Remote Systems view for each subsystem created by this subsystem configuration.
|
||||
<li><b>systemtypes</b>. A semi-colon separated list of system types which this subsystem configuration supports. When a user creates a
|
||||
connection, this configuration will only be asked to create a subsystem for connections to systems of these types. The default is all
|
||||
system types.
|
||||
<li><b>category</b>. A name used to categorize this subsystem's functionality. Used by the <A href="popup.html">popupMenus</A>
|
||||
and <A href="propertypage.html">propertyPages</A> extension points to allow actions and property pages to be scoped to
|
||||
resources shown in subsystems of a particular category. Multiple subsystems can have the same category.
|
||||
<li><b>class</b>. A class implementing <A href="../../com/ibm/etools/systems/subsystems/SubSystemFactory.html">SubSystemFactory</A>
|
||||
<li><b>class</b>. A class implementing <A href="../../org/eclipse/rse/core/subsystems/ISubSystemConfiguration.html">ISubSystemConfiguration</A>
|
||||
interface, as described in the following programming details section.
|
||||
</ul>
|
||||
|
||||
|
|
@ -44,31 +44,31 @@ interface, as described in the following programming details section.
|
|||
<h2>Programming Details</h2>
|
||||
<p>It is important to remember what the purpose of a subsystem is, and how it fits in the overall RSE <A
|
||||
href="../Model.html">model</A>, so as to understand the programming details for supporting
|
||||
subsystems via this subsystem factory extension point. Minimumly speaking, this extension point requires a class that implements the interface
|
||||
<samp><A href="../../com/ibm/etools/systems/subsystems/SubSystemFactory.html"><B>SubSystemFactory</B></A></samp>.
|
||||
Ultimately, the intent of a subsystem <I>factory</I> is to provide individual
|
||||
subsystem <I>instances</I> to each connection, and the intent of a subsystem instance is to present remote resources for display or manipulation purposes. Thus, you must also create a class implementing the interface <samp><A href="../../com/ibm/etools/systems/subsystems/SubSystem.html"><B>SubSystem</B></A></samp>.
|
||||
subsystems via this subsystem configuration extension point. Minimally speaking, this extension point requires a class that implements the interface
|
||||
<samp><A href="../../org/eclipse/rse/core/subsystems/ISubSystemFactory.html"><B>ISubSystemFactory</B></A></samp>.
|
||||
Ultimately, the intent of a subsystem <I>configuration</I> is to provide individual
|
||||
subsystem <I>instances</I> to each connection, and the intent of a subsystem instance is to present remote resources for display or manipulation purposes. Thus, you must also create a class implementing the interface <samp><A href="../../org/eclipse/rse/core/subsystems/ISubSystem.html"><B>ISubSystem</B></A></samp>.
|
||||
<BR>
|
||||
The intent of each subsystem is to show remote resources from the remote system
|
||||
identified by the parent connection, for the user. (Subsystems can in fact be hidden, which means their their role is to return remote resources for programmatic purposes only.) When the first request is made for remote objects, the subsystem is asked to connect to the remote system if it is not already.
|
||||
This job is deferred to a <A href="../../com/ibm/etools/systems/subsystems/ISystem.html">system</A> object whose role it is to manage connecting and disconnecting
|
||||
to the remote physical system. By use of a <A href="../../com/ibm/etools/systems/subsystems/impl/AbstractSystemManager.html">system manager</a>,
|
||||
This job is deferred to a <A href="../../org/eclipse/rse/core/subsystems/IConnectorService.html">IConnectorService</A> object whose role it is to manage connecting and disconnecting
|
||||
to the remote physical system. By use of a <A href="../../org/eclipse/rse/core/subsystems/AbstractConnectorServiceManager.html">connector service manager</a>,
|
||||
one system can manage the live connections of multiple subsystems in the same system connection, should they happen to share the same communication pipe.
|
||||
If filters are <A href="../../com/ibm/etools/systems/subsystems/SubSystemFactory.html#supportsFilters()">supported</A>
|
||||
If filters are <A href="../../org/eclipse/rse/core/subsystems/ISubSystemConfiguration.html#supportsFilters()">supported</A>
|
||||
(the default), the first connection is made, and the remote resources are subsequently shown, when filters within the subsystem
|
||||
are expanded, which results in a call to
|
||||
<samp><A href="../../com/ibm/etools/systems/dftsubsystem/impl/DefaultSubSystemImpl.html#internalResolveFilterString(org.eclipse.core.runtime.IProgressMonitor, java.lang.String)">resolveFilterString</A></samp>
|
||||
<samp><A href="../../org/eclipse/rse/subsystems/files/core/subsystems/RemoteFileSubSystem.html#internalResolveFilterString(org.eclipse.core.runtime.IProgressMonitor, java.lang.String)">resolveFilterString</A></samp>
|
||||
in the subsystem object. <BR>
|
||||
Furthermore, you will want to supply your own
|
||||
<B><A
|
||||
href="../../com/ibm/etools/systems/filters/ui/actions/SystemNewFilterAction.html">new-filter</A></B> and
|
||||
<A href="../../com/ibm/etools/systems/filters/ui/actions/SystemChangeFilterAction.html"><B>change-filter</B></A> actions.
|
||||
href="../../org/eclipse/rse/filters/ui/actions/SystemNewFilterAction.html">new-filter</A></B> and
|
||||
<A href="../../org/eclipse/rse/filters/ui/actions/SystemChangeFilterAction.html"><B>change-filter</B></A> actions.
|
||||
If filters are not supported, then these remote resources are shown immediately when the subsystem itself is expanded, via a call to
|
||||
<samp><A href="../../com/ibm/etools/systems/subsystems/SubSystem.html#getChildren()">getChildren</A></samp>.
|
||||
<samp><A href="../../org/eclipse/rse/core/subsystems/ISubSystem.html#getChildren()">getChildren</A></samp>.
|
||||
Either way the resulting resources are displayed to the user. To facilitate the displaying of these objects in the RSE views, the objects
|
||||
themselves must implement the Eclipse IAdaptable interface (to enable the property sheet viewer) and there must be a specific RSE
|
||||
<B><A
|
||||
href="../../com/ibm/etools/systems/core/ui/view/AbstractSystemViewAdapter.html">view
|
||||
href="../../org/eclipse/rse/ui/view/AbstractSystemViewAdapter.html">view
|
||||
adapter</A></B>
|
||||
and an RSE <B><A
|
||||
href="../../org/eclipse/rse/ui/view/ISystemRemoteElementAdapter.html">remote-information
|
||||
|
|
@ -99,26 +99,26 @@ following summarizes the minimum set of classes you will be creating in order to
|
|||
<TH>Description</TH>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD>subsystem factory</TD>
|
||||
<TD><samp><A href="../../com/ibm/etools/systems/dftsubsystem/impl/DefaultSubSystemFactoryImpl.html">DefaultSubSystemFactoryImpl</A></samp></TD>
|
||||
<TD>subsystem configuration</TD>
|
||||
<TD><samp><A href="../../org/eclipse/rse/core/subsystems/SubSystemConfiguration.html">SubSystemConfiguration</A></samp></TD>
|
||||
<TD>The factory class responsible for creating instances of subsystem class</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD>subsystem</TD>
|
||||
<TD><samp><A href="../../com/ibm/etools/systems/dftsubsystem/impl/DefaultSubSystemImpl.html">DefaultSubSystemImpl</A></samp></TD>
|
||||
<TD><samp><A href="../../org/eclipse/rse/core/subsystems/SubSystem.html">SubSystem</A></samp></TD>
|
||||
<TD>The subsystem class. There will be one instance created for each connection. In addition to storing
|
||||
your unique attributes, this must return the remote resource objects when a filter is expanded within the
|
||||
subsystem. How that communication with the remote system is done is left up to you.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD>system</TD>
|
||||
<TD><samp><A href="../../com/ibm/etools/systems/subsystems/impl/AbstractSystem.html">AbstractSystem</A></samp></TD>
|
||||
<TD><samp><A href="../../org/eclipse/rse/core/subsystems/AbstractConnectorService.html">AbstractConnectorService</A></samp></TD>
|
||||
<TD>Represents and manages a live connection to the remote system, doing the connecting and disconnecting.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD>system manager</TD>
|
||||
<TD><samp><A href="../../com/ibm/etools/systems/subsystems/impl/AbstractSystemManager.html">AbstractSystemManager</A></samp></TD>
|
||||
<TD>Manages a single system instance that is shared among multiple subsystems in a single connection. Even if you only have a single subsystem factory, it is useful to use this in
|
||||
<TD><samp><A href="../../org/eclipse/rse/core/subsystems/AbstractConnectorServiceManager.html">AbstractConnectorServiceManager</A></samp></TD>
|
||||
<TD>Manages a single system instance that is shared among multiple subsystems in a single connection. Even if you only have a single subsystem configuration it is useful to use this in
|
||||
case you later add additional factories, and their subsystems share the same communication pipe. To enable this, all your subsystem classes need to implement a unique interface of your own creation.</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
|
|
@ -128,8 +128,8 @@ following summarizes the minimum set of classes you will be creating in order to
|
|||
</TR>
|
||||
<TR>
|
||||
<TD>new-filter wizard</TD>
|
||||
<TD><samp><A href="../../com/ibm/etools/systems/filters/ui/actions/SystemNewFilterAction.html">SystemNewFilterAction</A></samp> and
|
||||
<samp><A href="../../com/ibm/etools/systems/filters/ui/SystemFilterStringEditPane.html">SystemFilterStringEditPane</A></samp></TD>
|
||||
<TD><samp><A href="../../org/eclipse/rse/ui/filters/actions/SystemNewFilterAction.html">SystemNewFilterAction</A></samp> and
|
||||
<samp><A href="../../org/eclipse/rse/ui/filters/SystemFilterStringEditPane.html">SystemFilterStringEditPane</A></samp></TD>
|
||||
<TD>Displays a wizard prompting for a new filter. Filters contain filter strings, which are up to each subsystem to design and interpret. The New Filter wizard
|
||||
prompts for a single filter string (more can be added in change mode). Typically you subclass <samp>SystemFilterStringEditPane</samp> to create your own
|
||||
prompt for the filter string information, and then subclass <samp>SystemNewFilterAction</samp> so as to configure the default New Filter wizard to use
|
||||
|
|
@ -137,15 +137,15 @@ following summarizes the minimum set of classes you will be creating in order to
|
|||
</TR>
|
||||
<TR>
|
||||
<TD>change-filter dialog</TD>
|
||||
<TD><samp><A href="../../com/ibm/etools/systems/filters/ui/actions/SystemChangeFilterAction.html">SystemChangeFilterAction</A></samp> and
|
||||
<samp><A href="../../com/ibm/etools/systems/filters/ui/SystemFilterStringEditPane.html">SystemFilterStringEditPane</A></samp></TD>
|
||||
<TD><samp><A href="../../org/eclipse/rse/ui/filters/actions/SystemChangeFilterAction.html">SystemChangeFilterAction</A></samp> and
|
||||
<samp><A href="../../org/eclipse/rse/ui/filters/SystemFilterStringEditPane.html">SystemFilterStringEditPane</A></samp></TD>
|
||||
<TD>Displays a dialog prompting to change an existing filter. The default dialog allows the user to create and edit filter strings. Typically, you
|
||||
override the <samp>SystemChangeFilterAction</samp> class, and configure the dialog to use the same edit pane used in the New Filter wizard.
|
||||
</TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD>remote element adapter</TD>
|
||||
<TD><samp><A href="../../com/ibm/etools/systems/core/ui/view/AbstractSystemViewAdapter.html">AbstractSystemViewAdapter</A></samp> and
|
||||
<TD><samp><A href="../../org/eclipse/rse/ui/view/AbstractSystemViewAdapter.html">AbstractSystemViewAdapter</A></samp> and
|
||||
<samp><A href="../../org/eclipse/rse/ui/view/ISystemRemoteElementAdapter.html">ISystemRemoteElementAdapter</A></samp>
|
||||
</TD>
|
||||
<TD>The view adapter is an amalgamation of all the required information needed to populate the RSE views. You will define one class per unique remote object interface or class, and in it you will override methods to return the remote object's label, image, popup-menu actions, property sheet properties and children (if expandable). You can also decide whether to enable common RSE popup menu actions like rename, delete and refresh. <BR>Your view adapter will usually also implement the remote adapter interface, enabling the many common RSE capabilities to work, such as the copy, paste, drag and drop, and more. </TD>
|
||||
|
|
@ -157,9 +157,9 @@ following summarizes the minimum set of classes you will be creating in order to
|
|||
<p>Implementing a subsystem involves the following steps, in the following order:</p>
|
||||
<OL>
|
||||
<li>Creating an interface for your subsystem. It can, and often is, an empty interface.</li>
|
||||
<li>Creating a subclass of <A href="../../com/ibm/etools/systems/subsystems/impl/AbstractSystem.html">AbstractSystem</A>.
|
||||
<li>Creating a subclass of <A href="../../org/eclipse/rse/core/subsystems/AbstractConnectorService.html">AbstractConnectorService</A>.
|
||||
The code here will interact as necessary with your subsystem to manage the live connection to the remote system.</li>
|
||||
<li>Creating a subclass of <A href="../../com/ibm/etools/systems/subsystems/impl/AbstractSystemManager.html">AbstractSystemManager</A>.
|
||||
<li>Creating a subclass of <A href="../../org/eclipse/rse/core/subsystems/AbstractConnectorServiceManager.html">AbstractConnectorServiceManager</A>.
|
||||
The code here will re-use the same system object from step 2 for all subsystems that implement the interface from step 1, within the same connection.</li>
|
||||
<li>Designing the classes to represent the remote resources (your <i>model</i>) that you will show from your subsystem.
|
||||
Each must implement the <samp>org.eclipse.core.runtime.IAdaptable</samp> interface from Eclipse.
|
||||
|
|
@ -172,27 +172,27 @@ following summarizes the minimum set of classes you will be creating in order to
|
|||
can parse it into its constituent pieces via getter methods. It should also support a default constructor and setting of constituent pieces via setter methods,
|
||||
and the generation of the filter string via toString().
|
||||
</li>
|
||||
<li>Creating a subclass of <A href="../../com/ibm/etools/systems/dftsubsystem/impl/DefaultSubSystemImpl.html">DefaultSubSystemImpl</A>
|
||||
<li>Creating a subclass of <A href="../../org/eclipse/rse/core/subsystems/SubSystem.html">SubSystem</A>
|
||||
that implements the interface you designed in step 1. This will:
|
||||
<ul>
|
||||
<li>return a singleton instance of the system manager from step 3 in its <A href="../../com/ibm/etools/systems/dftsubsystem/impl/DefaultSubSystemImpl.html#getSystemManager()">getSystemManager</A> method,
|
||||
<li>manage persistent properties via calls to the inherited <A href="../../com/ibm/etools/systems/dftsubsystem/impl/DefaultSubSystemImpl.html#setVendorAttribute(java.lang.String, java.lang.String, java.lang.String)">setVendorAttribute</A>
|
||||
and <A href="../../com/ibm/etools/systems/dftsubsystem/impl/DefaultSubSystemImpl.html#getVendorAttribute(java.lang.String, java.lang.String)">getVendorAttribute</A> methods,
|
||||
<li>use your communications layer to return instances of your model objects in its <A href="../../com/ibm/etools/systems/dftsubsystem/impl/DefaultSubSystemImpl.html#internalResolveFilterString(org.eclipse.core.runtime.IProgressMonitor, java.lang.String)">internalResolveFilterString</A> method.
|
||||
<li>return a singleton instance of the system manager from step 3 in its <A href="../../org/eclipse/rse/core/subsystems/SubSystem.html#getSystemManager()">getSystemManager</A> method,
|
||||
<li>manage persistent properties via calls to the inherited <A href="../../org/eclipse/rse/core/subsystems/SubSystem.html#setVendorAttribute(java.lang.String, java.lang.String, java.lang.String)">setVendorAttribute</A>
|
||||
and <A href="../../org/eclipse/rse/core/subsystems/SubSystem.htmll#getVendorAttribute(java.lang.String, java.lang.String)">getVendorAttribute</A> methods,
|
||||
<li>use your communications layer to return instances of your model objects in its <A href="../../org/eclipse/rse/core/subsystems/SubSystem.html.html#internalResolveFilterString(org.eclipse.core.runtime.IProgressMonitor, java.lang.String)">internalResolveFilterString</A> method.
|
||||
The input to this is one or more strings such as you designed in step 5. It will return all remote resources matching the criteria captured in the input filter string.
|
||||
You may also find the <A href="../../com/ibm/etools/systems/core/clientserver/NamePatternMatcher.html">com.ibm.etools.systems.core.clientserver.NamePatternMatcher</a>
|
||||
You may also find the <A href="../../org/eclipse/rse/services/clientserver/NamePatternMatcher.html">org.eclipse.rse.services.clientserver.NamePatternMatcher</a>
|
||||
class to be handy in comparing a generic pattern to a particular input. This class is in the <samp>runtime/clientserver.jar</samp> file,
|
||||
and has no eclipse-dependencies, so it can be used in your client subsystem code, or your server-side code.
|
||||
</ul>
|
||||
</li>
|
||||
<li>Creating a subclass of <A href="../../com/ibm/etools/systems/dftsubsystem/impl/DefaultSubSystemFactoryImpl.html">DefaultSubSystemFactoryImpl.</A></li>
|
||||
<li>Defining your <A href="../../doc/org_eclipse_rse_ui_subsystemfactory.html">subsystemfactory extension</a> in your <samp>plugin.xml</samp> file.</li>
|
||||
<li>Creating a subclass of <A href="../../org/eclipse/rse/core/subsystems/SubSystemConfiguration.html">DefaultSubSystemFactoryImpl.</A></li>
|
||||
<li>Defining your <A href="../../doc/org_eclipse_rse_ui_subsystemConfiguration.html">subsystemConfiguration extension</a> in your <samp>plugin.xml</samp> file.</li>
|
||||
<li>For each remote resource class you created in step 4, you need to create an adapter class, which extends
|
||||
<A href="../../com/ibm/etools/systems/core/ui/view/AbstractSystemViewAdapter.html">AbstractSystemViewAdapter</A> and which
|
||||
<A href="../../org/eclipse/rse/ui/view/AbstractSystemViewAdapter.html">AbstractSystemViewAdapter</A> and which
|
||||
implements <A href="../../org/eclipse/rse/ui/view/ISystemRemoteElementAdapter.html">ISystemRemoteElementAdapter</A>.
|
||||
</li>
|
||||
<li>Register your adapters with the platform. First you create an
|
||||
adapter class that extends <samp><a href="../../com/ibm/etools/systems/core/ui/view/AbstractSystemRemoteAdapterFactory.html">AbstractSystemRemoteAdapterFactory</a></samp>
|
||||
adapter class that extends <samp><a href="../../org/eclipse/rse/ui/view/AbstractSystemRemoteAdapterFactory.html">AbstractSystemRemoteAdapterFactory</a></samp>
|
||||
and implements interface <samp><b>org.eclipse.core.runtime.IAdapterFactory</b></samp>. Next,
|
||||
in the <samp>startup()</samp> method of your plugin class, add code to instantiate the class and register the object with
|
||||
the platform adapter manager, once for each class in your resource model. For example:
|
||||
|
|
@ -211,28 +211,28 @@ following summarizes the minimum set of classes you will be creating in order to
|
|||
change these for your subsystem, you need to:
|
||||
<ol>
|
||||
<li type="i">Create your own
|
||||
<a href="../../com/ibm/etools/systems/filters/ui/SystemFilterStringEditPane.html">filter string edit pane</a>
|
||||
<a href="../../org/eclipse/rse/ui/filters/SystemFilterStringEditPane.html">filter string edit pane</a>
|
||||
subclass that contains your own GUI prompts as desired.
|
||||
<li type="i">Create your own
|
||||
<a href="../../com/ibm/etools/systems/filters/ui/actions/SystemNewFilterAction.html">new-filter wizard action</a>
|
||||
<a href="../../org/eclipse/rse/ui/filters/actions/SystemNewFilterAction.html">new-filter wizard action</a>
|
||||
subclass, and configure it to use your own edit pane subclass by overriding
|
||||
<samp><a href="../../com/ibm/etools/systems/filters/ui/actions/SystemNewFilterAction.html#configureNewFilterWizard(com.ibm.etools.systems.filters.ui.dialogs.SystemNewFilterWizard)">configureNewFilterWizard</a></samp>
|
||||
and in it calling <samp><a href="../../com/ibm/etools/systems/filters/ui/dialogs/SystemNewFilterWizard.html#setFilterStringEditPane(com.ibm.etools.systems.filters.ui.SystemFilterStringEditPane)">setFilterStringEditPane</a></samp>
|
||||
<samp><a href="../../org/eclipse/rse/ui/filters/actions/SystemNewFilterAction.html#configureNewFilterWizard(org.eclipse.rse.ui.filters.dialogs.SystemNewFilterWizard)">configureNewFilterWizard</a></samp>
|
||||
and in it calling <samp><a href="../../org/eclipse/rse/ui/filters/dialogs/SystemNewFilterWizard.html#setFilterStringEditPane(org.eclipse.rse.ui.filters.SystemFilterStringEditPane)">setFilterStringEditPane</a></samp>
|
||||
on the given wizard.
|
||||
<li type="i">Create your own
|
||||
<a href="../../com/ibm/etools/systems/filters/ui/actions/SystemChangeFilterAction.html">change-filter action</a>
|
||||
<a href="../../org/eclipse/rse/ui/filters/actions/SystemChangeFilterAction.html">change-filter action</a>
|
||||
subclass, and configure it to use your own edit pane subclass by overriding
|
||||
<samp><a href="../../com/ibm/etools/systems/filters/ui/actions/SystemChangeFilterAction.html#configureFilterDialog(com.ibm.etools.systems.filters.ui.dialogs.SystemChangeFilterDialog)">configureFilterDialog</a></samp>
|
||||
and in it calling <samp><a href="../../com/ibm/etools/systems/filters/ui/dialogs/SystemChangeFilterDialog.html#setFilterStringEditPane(com.ibm.etools.systems.filters.ui.SystemFilterStringEditPane)">setFilterStringEditPane</a></samp>
|
||||
<samp><a href="../../org/eclipse/rse/ui/filters/actions/SystemChangeFilterAction.html#configureFilterDialog(org.eclipse.rse.ui.filters.dialogs.SystemChangeFilterDialog)">configureFilterDialog</a></samp>
|
||||
and in it calling <samp><a href="../../org/eclipse/rse/ui/filters/dialogs/SystemChangeFilterDialog.html#setFilterStringEditPane(org.eclipse.rse.ui.filters.SystemFilterStringEditPane)">setFilterStringEditPane</a></samp>
|
||||
on the given dialog.
|
||||
<li type="i">Override the <samp><a href="../../com/ibm/etools/systems/dftsubsystem/impl/DefaultSubSystemFactoryImpl.html#getNewFilterPoolFilterAction(com.ibm.etools.systems.filters.SystemFilterPool, org.eclipse.swt.widgets.Shell)">getNewFilterPoolFilterAction(SystemFilterPool, Shell)</a></samp>
|
||||
<li type="i">Override the <samp><a href="../../org/eclipse/rse/ui/view/SubSystemFactoryAdapter.html#getNewFilterPoolFilterAction(org.eclipse.rse.filters.ISystemFilterPool, org.eclipse.swt.widgets.Shell)">getNewFilterPoolFilterAction(SystemFilterPool, Shell)</a></samp>
|
||||
method in your subsystem factory, to return an instance of your new-filter action.
|
||||
You can actually avoid creating an action subclass if you choose, by calling the configuration methods
|
||||
in the RSE-supplied <a href="../../com/ibm/etools/systems/filters/ui/actions/SystemNewFilterAction.html">new-filter action class</a>.
|
||||
<li type="i">Override the <samp><a href="../../com/ibm/etools/systems/dftsubsystem/impl/DefaultSubSystemFactoryImpl.html#getChangeFilterAction(com.ibm.etools.systems.filters.SystemFilter, org.eclipse.swt.widgets.Shell)">getChangeFilterAction(SystemFilter, Shell)</a></samp>
|
||||
in the RSE-supplied <a href="../../org/eclipse/rse/ui/filters/actions/SystemNewFilterAction.html">new-filter action class</a>.
|
||||
<li type="i">Override the <samp><a href="../../org/eclipse/rse/ui/view/SubSystemFactoryAdapter.html#getChangeFilterAction(org.eclipse.rse.filters.ISystemFilter, org.eclipse.swt.widgets.Shell)">getChangeFilterAction(SystemFilter, Shell)</a></samp>
|
||||
method in your subsystem factory, to return an instance of your change-filter action.
|
||||
You can actually avoid creating an action subclass if you choose, by calling the configuration methods
|
||||
in the RSE-supplied <a href="../../com/ibm/etools/systems/filters/ui/actions/SystemChangeFilterAction.html">change-filter action class</a>.
|
||||
in the RSE-supplied <a href="../../org/eclipse/rse/ui/filters/actions/SystemChangeFilterAction.html">change-filter action class</a>.
|
||||
</ol>
|
||||
</li>
|
||||
</OL>
|
||||
|
|
|
|||
|
|
@ -11,8 +11,8 @@
|
|||
|
||||
<body bgcolor="#ffffff">
|
||||
<h1>Plugging In System Types</h1>
|
||||
<p>The <samp><A href="../../doc/org_eclipse_rse_ui_systemtype.html">com.ibm.etools.systems.core.systemtype</a></samp> extension point is defined in the
|
||||
plugin <samp>com.ibm.etools.systems.core</samp>. It enables new system types to be
|
||||
<p>The <samp><A href="../../doc/org_eclipse_rse_ui_systemtype.html">org.eclipse.rse.ui.systemType</a></samp> extension point is defined in the
|
||||
plugin <samp>org.eclipse.rse.ui</samp>. It enables new system types to be
|
||||
defined in the Remote System Explorer's <A href="NewConnection.gif">New
|
||||
Connection wizard</A>, such that users can define connections to systems of that type. For example,
|
||||
you might define a new system type of "Solaris" or "RedHat" or some other specific type
|
||||
|
|
@ -26,7 +26,7 @@ type, and two icons - one icon for connections to that systems of that type, and
|
|||
adorned icon that is used when there is a live connection to that particular system.
|
||||
</p>
|
||||
<p>
|
||||
When youcreates a new connection, the Remote System Explorer framework will consult
|
||||
When you create a new connection, the Remote System Explorer framework will consult
|
||||
each registered <A href="subsystem.html">subsystem extension point</A> to see if it supports
|
||||
that connection's system type, and if so the extension point's subsystem factory class
|
||||
will be used to create a new subsystem within the new connection. Thus, when the user
|
||||
|
|
|
|||
|
|
@ -33,7 +33,7 @@ manipulate the resources directly on the remote system. The
|
|||
actions that are available depend on the type of system you are
|
||||
connecting to and the way the resource is recognized. For
|
||||
example, your selections can define
|
||||
a filter string to find all files that match *.c in a partcular
|
||||
a filter string to find all files that match *.c in a particular
|
||||
directory. </p>
|
||||
<div class="p">When you access the list by expanding the filter, you
|
||||
can see all the files that match that filter and you can perform
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue