Home Library FTPClient
Introduction
Home Library FTPClient is a Java library providing a simple interface to Home Library WebApp.
This library has following features:
- Current Directory: returns the pathname of the current working directory.
- Change Directory: to changes the current working directory.
- Change Directory Up: to changes the current working directory to the parent one.
- Create Directory: to create a directory in the root or in a subfolder.
- List Directory: to list the content of a directory.
- Upload file: to upload a file in a directory.
- Remove files and folders: to remove a file or a directory (including subdirectories).
- Test: a simple test to check the correct behavior of the features above.
The following sections will discuss each of these commands in turn, and discuss how to use them with Home Library FTPClient.
Configuration File
Home Library CLI is equipped with a simple configuration file to set the parameters and initial settings.
The fields are:
- URL_REPOSITORY: the URL of Home Library WebApp.
- USERNAME: username to connect to Home Library WebApp.
- PASSWORD: password to connect to Home Library WebApp.
- LOGIN: the portal login of the user who is using the library.
- ROOT_PATH : the ROOT of the VRE folder where the files and directory will be created.
The Configuration File cannot be modified by the final user, but it allows to use the CLI in different context.
Usage
Prerequisites
Home Library FTPClient is Java library, you only need a Java 7 JDK.
Download the library
The library is available here:
Download the jar to your local repository and add its dependencies:
Version
The current release of the Home Library FTPClient is 1.0.0.
Maven Artifact
The Home Library FTPClient library is available as a Maven artifact.
To include it in your project, add this dependency to your pom:
<dependency> <groupId>org.gcube.data.access</groupId> <artifactId>home-library-ftpclient</artifactId> <version>[1.0.0-SNAPSHOT,2.0.0-SNAPSHOT)</version> </dependency>
FTPClient
A FTPClient is created with:
FTPClient client = new FTPClient();
Run the test
To check the correct behavior of all features:
void test()
Example:
client.test();
Current Directory
To know the current working directory:
public String currentDirectory()
Example:
client.currentDirectory();
Change directory
To changes the current working directory.
void changeDirectory(String path)
Where:
- path: the path to the new working directory.
Example:
String mySubFolder = .. client.changeDirectory(mySubFolder);
Change directory up
To changes the current working directory to the parent one.
void changeDirectoryUp()
Example:
client.changeDirectoryUp();
Create a directory
To create a new remote directory in the current working one.
void createDirectory(String directoryName, String description)
Where:
- directoryName: the name of the new folder.
- description: the description for the new directory.
Example:
String myDir = .. String description = .. client.createDirectory(myDir, description);
Upload a file
To upload a file, if it does not already exist:
void upload(File file, String name, String description)
Where:
- file: the file to upload
- name: a name for the file
- description: a description for the file
OR
To upload an array of bytes that represents a file:
void upload(byte[] bFile, String name, String description)
Where:
- bFile: an array of bytes that represents a file
- name: a name for the file
- description: a description for the file
Example:
File myFile = .. client.upload(myFile, myFile.getName(), "my new file");
List a directory
To list the content of the current directory:
FTPFile[] list()
Example:
FTPFile[] myFiles = client.list();
FTPFile represents the files in a remote FTP directory, as described in FTPFile.
Remove files
To remove files:
void deleteFile(String path)
Where:
- path: the path of the file to remove.
Example:
String myFilename = .. client.deleteFile(myFilename);
Remove directories
To remove directories:
void deleteDirectory(String path)
Where:
- path: the path of the directory to remove.
Example:
FTPClient client = .. String myDir = .. client.deleteDirectory(myDir);
FTPFile
A FTPFile represents the files in a remote FTP directory.
Get Path
To get the path of the current file or folder:
String getPath()
Example:
FTPFile file = .. file.getPath();
Get Name
To get the name of the current file or folder
String getName()
Example:
FTPFile file = .. file.getName();
Is Folder
To know if the current file is a folder:
Boolean isFolder()
Example:
FTPFile file = .. file.isFolder();
