ECF Filetransfer Provider Bundle

Introduction

The ECF File Transfer Provider bundle implements file retrieval based upon the standard JVM protocols (http, https, file, jar).

Bundle-SymbolicName: org.eclipse.ecf.provider.filetransfer

Bundle-Version: 1.0.0

Dependencies

Required ECF Bundles: org.eclipse.ecf, org.eclipse.ecf.filetransfer

Required Runtime Bundles: org.eclipse.equinox.common, org.eclipse.equinox.registry

Required Packages: org.osgi.framework, org.osgi.service.log, org.osgi.util.tracker, org.osgi.service.url, org.eclipse.osgi.util

Required Execution Environment: J2SE-1.3, CDC-1.0/Foundation 1.0

Approximate Code Size: 26K

Exported Packages

org.eclipse.ecf.provider.filetransfer.identity

org.eclipse.ecf.provider.filetransfer.retrieve

Extension Points

URL Stream Handler Service

• org.eclipse.ecf.provider.filetransfer.fileTransferProtocolFactory
  • Description: The file transfer protocol factory allows ECF file transfer protocol factories to be defined for handling given protocols.
  • Example Usage:

      <fileTransferProtocolFactory
            class="org.eclipse.ecf.provider.filetransfer.httpclient.HttpClientRetrieveFileTransferFactory"
            protocol="https">
      </fileTransferProtocolFactory>

OSGI Services

Retrieve File Transfer Factory

Service Interface: org.eclipse.ecf.filetransfer.service.IRetrieveFileTransferFactory

Description: Gives access to creating IRetrieveFileTransfer instances, which can be used to initiate asynchronous file retrieval.

Service Access Example:

 ServiceTracker fileRetrieveTracker = new ServiceTracker(context,IRetrieveFileTransferFactory.class.getName(),null);
 fileRetrieveTracker.open();
 IRetrieveFileTransferFactory retrieveFactory = (IRetrieveFileTransferFactory) fileRetrieveFactory.getService();
 IRetrieveFileTransfer retrieve = retrieveFactory.newInstance();
 // Use retrieve to initiate file transfer

Source Access

Project Set: Anonymous, Committer

Source Browsing

• Bundle Source

• Bundle Manifest