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, binary or xml 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 and xml 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. File types that are specified as xml will normally transfer as binary but will have it's encoding determined via inspection of the text.

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|xml)

priority  CDATA #IMPLIED

>


Examples:

API Information:
There is no code to implement for this extension point.


Copyright (c) 2006, 2010 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 David McKnight (IBM) - [283033] remoteFileTypes extension point should include "xml" type