Remote File Types
Identifier:
org.eclipse.rse.subsystems.files.core.remoteFileTypes
Since:
3.0
Description:
This extension point is used to register information about whether particular file types should be considered to contain text or binary data.
This information is important as it will determine how files will be transferred. The exact meaning of how the transfer of text files differs from binary
files depends on the actual file service implementation. In general, though, services will strive to change the encoding of remote text files during transfer
such that it matches the local platform default encoding.
Specific encoding conversions also depend on provided extensions to the
org.eclipse.rse.services.codePageConverters
extension point.
For example, transferring files from a remote dstore Linux host to a local Windows client, the file service may convert text files from
UTF-8 encoding to Windows cp1252 encoding, and convert remote LF only line endings to local CRLF line endings.
The benefit of this conversion is that local (external) tools may operate on transferred files in the RSE
files cache without having to worry about encodings.
Providers may provide an extension for this extension point. No code beyond the XML extension declaration is required.
See also the org.eclipse.team.core.fileTypes extension point which provides similar information for Repository providers.
Configuration Markup:
<!ELEMENT extension (
remoteFileTypes*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
>
<!ELEMENT remoteFileTypes EMPTY>
<!ATTLIST remoteFileTypes
extension CDATA #REQUIRED
type (text|binary)
priority CDATA #IMPLIED
>
-
extension - the file extension being identified by this contribution.
-
type - one of either "text" or "binary", identifying the contents of files matching the value of extension.
-
priority - Priority used if there are more than one match of a file type. Integer values are allowed.
In case of more than one matching file type, the with lower priority number will be used.
If no priority is specified, the default value will be
Integer.MAX_VALUE
.
Examples:
Copyright (c) 2006, 2007 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 https://www.eclipse.org/legal/epl-v10.html
Contributors:
IBM Corporation - initial API and implementation