APIdia Launch Partner
Top Description Fields Constructors Methods
sun.net.ftp

public abstract Class FtpClientProvider

extends Object
Class Inheritance
Known Direct Subclasses
sun.net.ftp.impl.DefaultFtpClientProvider
Imports
java.util.ServiceConfigurationError
Service provider class for FtpClient. Sub-classes of FtpClientProvider provide an implementation of FtpClient and associated classes. Applications do not normally use this class directly. See provider() for how providers are found and loaded.
Since
1.7

Field Summary

Modifier and TypeField and Description
private static final Object
lock

private static FtpClientProvider
provider

Constructor Summary

AccessConstructor and Description
protected
FtpClientProvider()

Initializes a new instance of this class.

Method Summary

Modifier and TypeMethod and Description
public abstract FtpClient

Returns:

The created FtpClient.
createFtpClient()

Creates a FtpClient from this provider.

private static boolean
loadProviderAsService()

private static boolean
loadProviderFromProperty()

public static FtpClientProvider

Returns:

The system-wide default FtpClientProvider
provider()

Returns the system wide default FtpClientProvider for this invocation of the Java virtual machine.

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

lockback to summary
private static final Object lock
providerback to summary
private static FtpClientProvider provider

Constructor Detail

FtpClientProviderback to summary
protected FtpClientProvider()

Initializes a new instance of this class.

Method Detail

createFtpClientback to summary
public abstract FtpClient createFtpClient()

Creates a FtpClient from this provider.

Returns:FtpClient

The created FtpClient.

loadProviderAsServiceback to summary
private static boolean loadProviderAsService()
loadProviderFromPropertyback to summary
private static boolean loadProviderFromProperty()
providerback to summary
public static FtpClientProvider provider()

Returns the system wide default FtpClientProvider for this invocation of the Java virtual machine.

The first invocation of this method locates the default provider object as follows:

  1. If the system property java.net.FtpClientProvider is defined then it is taken to be the fully-qualified name of a concrete provider class. The class is loaded and instantiated; if this process fails then an unspecified unchecked error or exception is thrown.

  2. If a provider class has been installed in a jar file that is visible to the system class loader, and that jar file contains a provider-configuration file named java.net.FtpClientProvider in the resource directory META-INF/services, then the first class name specified in that file is taken. The class is loaded and instantiated; if this process fails then an unspecified unchecked error or exception is thrown.

  3. Finally, if no provider has been specified by any of the above means then the system-default provider class is instantiated and the result is returned.

Subsequent invocations of this method return the provider that was returned by the first invocation.

Returns:FtpClientProvider

The system-wide default FtpClientProvider