mirror of
https://github.com/eclipse-cdt/cdt
synced 2025-07-09 01:55:24 +02:00
282 lines
11 KiB
XML
282 lines
11 KiB
XML
<?xml version='1.0' encoding='UTF-8'?>
|
|
<!-- Schema file written by PDE -->
|
|
<schema targetNamespace="org.eclipse.rse.ui">
|
|
<annotation>
|
|
<appInfo>
|
|
<meta.schema plugin="org.eclipse.rse.ui" id="subsystemConfigurations" name="Subsystem Configurations"/>
|
|
</appInfo>
|
|
<documentation>
|
|
This extension point allows tool-writers to extend the capability
|
|
of the Remote System Explorer,
|
|
by identifying a subsystem configuration that produces a subsystem
|
|
whenever a new connection is created.
|
|
This subsystem appears under the connection when it is expanded
|
|
in the Remote Systems view of
|
|
the Remote System Explorer perspective. The subsystem configuration
|
|
is called by the Remote System
|
|
framework when the user creates a new connection, when the connection's
|
|
system type is one of the
|
|
types identified as supported by this subsystem configuration extension.
|
|
|
|
<p>
|
|
There is one subsystem
|
|
object per connection, and the role of a subsystem is to allow
|
|
users to work with remote resources
|
|
for the remote system identified by the containing connection.
|
|
Defining a subsystem configuration involves more than the single subsystem
|
|
configuration class. There must
|
|
also be a subsystem class defined, and a system class defined.
|
|
There may also be other classes
|
|
defined, such as classes for the content area of wizards for
|
|
defining filters, user actions
|
|
and compile commands, if the subsystem configuration wishes to support
|
|
these. See the developer documentation for the Remote System Explorer
|
|
for documentation details on defining
|
|
subsystems.
|
|
</documentation>
|
|
</annotation>
|
|
|
|
<element name="extension">
|
|
<annotation>
|
|
<documentation>
|
|
(no description available)
|
|
</documentation>
|
|
</annotation>
|
|
<complexType>
|
|
<sequence>
|
|
<element ref="configuration" minOccurs="1" maxOccurs="unbounded"/>
|
|
</sequence>
|
|
<attribute name="point" type="string" use="required">
|
|
<annotation>
|
|
<documentation>
|
|
|
|
</documentation>
|
|
</annotation>
|
|
</attribute>
|
|
<attribute name="id" type="string">
|
|
<annotation>
|
|
<documentation>
|
|
|
|
</documentation>
|
|
</annotation>
|
|
</attribute>
|
|
<attribute name="name" type="string">
|
|
<annotation>
|
|
<documentation>
|
|
|
|
</documentation>
|
|
</annotation>
|
|
</attribute>
|
|
</complexType>
|
|
</element>
|
|
|
|
<element name="configuration">
|
|
<annotation>
|
|
<appInfo>
|
|
<meta.element labelAttribute="name" icon="icon"/>
|
|
</appInfo>
|
|
<documentation>
|
|
This element defines a subsystem configuration to the Remote System Explorer framework.
|
|
</documentation>
|
|
</annotation>
|
|
<complexType>
|
|
<attribute name="id" type="string" use="required">
|
|
<annotation>
|
|
<documentation>
|
|
A unique ID for this subsystem configuration. This will be used by persistency
|
|
as a folder name for information contained by the subsystem configuration, or by any of its subsystems.
|
|
</documentation>
|
|
</annotation>
|
|
</attribute>
|
|
<attribute name="vendor" type="string" use="required">
|
|
<annotation>
|
|
<documentation>
|
|
Name of the vendor supplying this subsystem configuration.
|
|
</documentation>
|
|
<appInfo>
|
|
<meta.attribute translatable="true"/>
|
|
</appInfo>
|
|
</annotation>
|
|
</attribute>
|
|
<attribute name="icon" type="string" use="required">
|
|
<annotation>
|
|
<documentation>
|
|
The icon to dipslay for subsystems of this configuration, when not connected.
|
|
Specify the path of the .gif file, relative to your plugin directory.
|
|
</documentation>
|
|
<appInfo>
|
|
<meta.attribute kind="resource"/>
|
|
</appInfo>
|
|
</annotation>
|
|
</attribute>
|
|
<attribute name="iconlive" type="string" use="required">
|
|
<annotation>
|
|
<documentation>
|
|
The icon to display for subsystems of this configuration, when there is a live connection. This
|
|
is usually derived from the normal icon, but adorned with a bright green arrow. Specify
|
|
a path to the icon's .gif file, relative to your plugin directory.
|
|
</documentation>
|
|
<appInfo>
|
|
<meta.attribute kind="resource"/>
|
|
</appInfo>
|
|
</annotation>
|
|
</attribute>
|
|
<attribute name="class" type="string" use="required">
|
|
<annotation>
|
|
<documentation>
|
|
A class that implements <samp>org.eclipse.rse.core.subsystems.ISubSystemConfiguration</samp>.
|
|
It is recommended to extend <samp>org.eclipse.rse.core.subsystems.SubSystemConfiguration</samp> or <samp>org.eclipse.rse.core.servicesubsystem.ServiceSubSystemConfiguration</samp>.
|
|
</documentation>
|
|
<appInfo>
|
|
<meta.attribute kind="java" basedOn="org.eclipse.rse.core.subsystems.SubSystemConfiguration:org.eclipse.rse.core.subsystems.ISubSystemConfiguration"/>
|
|
</appInfo>
|
|
</annotation>
|
|
</attribute>
|
|
<attribute name="name" type="string" use="required">
|
|
<annotation>
|
|
<documentation>
|
|
Translatable name for subsystems created by this configuration.
|
|
These appear immediately under a connection when the connection is expanded in the Remote Systems view of the Remote System Explorer perspective.
|
|
</documentation>
|
|
<appInfo>
|
|
<meta.attribute translatable="true"/>
|
|
</appInfo>
|
|
</annotation>
|
|
</attribute>
|
|
<attribute name="description" type="string" use="required">
|
|
<annotation>
|
|
<documentation>
|
|
Translatable description for subsystems created by this configuration.
|
|
These appear in configuration and properties pages for subsystems.
|
|
</documentation>
|
|
<appInfo>
|
|
<meta.attribute translatable="true"/>
|
|
</appInfo>
|
|
</annotation>
|
|
</attribute>
|
|
<attribute name="systemTypes" type="string">
|
|
<annotation>
|
|
<documentation>
|
|
A semicolon separated list of system type names that subsystems from this configuration support.
|
|
For example, "Unix;Linux". If not specified, defaults to all system types.
|
|
</documentation>
|
|
</annotation>
|
|
</attribute>
|
|
<attribute name="category" type="string">
|
|
<annotation>
|
|
<documentation>
|
|
This optional attribute allows subsystem providers to classify
|
|
the type of remote resources
|
|
that are listed by this subsystem configuration. It is possible for
|
|
multiple subsystem factories to
|
|
support the same remote resource category. This category is used
|
|
in the popupMenus and
|
|
propertyPages extension points, to scope actions and property
|
|
pages to only remote resources
|
|
of a particular category, via their <samp>subsystemconfigurationCategory</samp> attribute.
|
|
For example, if listing database resources
|
|
you might specify a
|
|
category of "database".
|
|
</documentation>
|
|
</annotation>
|
|
</attribute>
|
|
<attribute name="systemClass" type="string">
|
|
<annotation>
|
|
<documentation>
|
|
Optional.
|
|
</documentation>
|
|
<appInfo>
|
|
<meta.attribute kind="java" basedOn="org.eclipse.rse.core.subsystems.IConnectorService"/>
|
|
</appInfo>
|
|
</annotation>
|
|
</attribute>
|
|
<attribute name="priority" type="string">
|
|
<annotation>
|
|
<documentation>
|
|
This optional attribute determines the order in which subsystems appear in the New Connection wizard and RSE views. Integer values are allowed. Subsystems with lower number will appear first in the RSE tree. Subsystems that do not define the priority attribute will be appended last to the list of subsystems.
|
|
|
|
Note that ServiceSubSystems that share the same service should always use the same priority, since their service implementation can change at runtime. The following priorities are used by the predefined subsystems: files=100, processes=200, shells=300.
|
|
</documentation>
|
|
</annotation>
|
|
</attribute>
|
|
</complexType>
|
|
</element>
|
|
|
|
<annotation>
|
|
<appInfo>
|
|
<meta.section type="examples"/>
|
|
</appInfo>
|
|
<documentation>
|
|
Example of using this extension point:
|
|
|
|
<p>
|
|
<pre>
|
|
<extension
|
|
point="org.eclipse.rse.ui.subsystemConfigurations">
|
|
<configuration
|
|
systemTypes="Unix;Linux;Local"
|
|
name="Databases"
|
|
icon="icons/dbsubsys.gif"
|
|
iconlive="icons/dbsubsyslive.gif"
|
|
id="com.acme.tools.mypkg.myconfiguration"
|
|
class="com.acme.tools.db.DBSubSystemFactory"
|
|
category="databases"
|
|
vendor="ACME"
|
|
>
|
|
</configuration>
|
|
</extension>
|
|
</pre>
|
|
</p>
|
|
|
|
<p>Defining the xml for the extension point is easy. There is a fair amount to know about
|
|
creating the classes needed for a subsystem configuration, however. For this information, consult
|
|
the Remote System Explorer developer documention, including the JavaDoc for the supplied
|
|
classes and interfaces for this task.
|
|
</p>
|
|
</documentation>
|
|
</annotation>
|
|
|
|
<annotation>
|
|
<appInfo>
|
|
<meta.section type="apiInfo"/>
|
|
</appInfo>
|
|
<documentation>
|
|
The provider of subsystem factories must implement the interface
|
|
<samp>org.eclipse.rse.core.subsystems.ISubSystemConfiguration</samp>,
|
|
although it is not recommended to create a new class from scratch.
|
|
Rather, it is highly recommended
|
|
to use the supplied base class <samp>org.eclipse.rse.core.subsystems.SubSystemConfiguration</samp>.
|
|
This base class pre-supplies much functionality, including support for
|
|
persisting properties and metadata, and support for filters.
|
|
</documentation>
|
|
</annotation>
|
|
|
|
<annotation>
|
|
<appInfo>
|
|
<meta.section type="implementation"/>
|
|
</appInfo>
|
|
<documentation>
|
|
All supplied subsystems are implemented via use of this extension point.
|
|
See the <samp>plugin.xml</samp> files for plugins
|
|
<samp>org.eclipse.rse.subsystems.files.dstore</samp> and
|
|
<samp>org.eclipse.rse.subsystems.processes.dstore</samp>
|
|
for examples.
|
|
</documentation>
|
|
</annotation>
|
|
|
|
<annotation>
|
|
<appInfo>
|
|
<meta.section type="copyright"/>
|
|
</appInfo>
|
|
<documentation>
|
|
Copyright (c) 2002, 2006 IBM Corporation. All Rights Reserved.
|
|
This program and the accompanying materials are made available under the terms
|
|
of the Eclipse Public License v1.0 which accompanies this distribution, and is
|
|
available at http://www.eclipse.org/legal/epl-v10.html
|
|
|
|
Contributors:
|
|
IBM Corporation - initial API and implementation
|
|
</documentation>
|
|
</annotation>
|
|
|
|
</schema>
|