ServerStorage

Minimal FTP server database

Description

ServerStorage is an example of a minimalistic FTP server database class, using SQLiteOpenHelper for database management.

ServerStorage is used in AndPlug music player application for Android devices.

Table of Contents

• Prerequisites
• Installation
• Testing
• Usage
• Example
• Credits
• Release History
• License

Prerequisites

• Android 4.0.3 (API Level: 15) or later (ICE_CREAM_SANDWICH_MR1)
• Android Gradle Plugin 8.11.1 or later (gradle:8.11.1)

Installation

1. Check out a local copy of ServerStorage repository
2. Build library with Gradle, using Android Studio or directly from the command line

Testing

ServerStorage includes a set of instrumented unit tests.

Instrumented tests

Located under ftplib/src/androidTest.

These tests are run on a hardware device or emulator, and verifies correct operation of the ServerStorage implementation.

Usage

ServerStorage is controlled through the following class:

• ServerStorage - FTP server database class

Example

Create new ServerStorage instance, including new database:

import com.omicronapplications.serverlib.ServerStorage;

ServerStorage storage = new ServerStorage(getApplicationContext(), "ftp", 1);

Add FTP server to database:

FTPServer server = new FTPServer("server.com", 22, "user", "password", "/");
storage.addServer(server);

Update FTP server name in database:

List<FTPServer> list = storage.getServers();
FTPServer server = list.get(0);
server.setHost("other.com");
storage.editServer(server);

Delete FTP server from database:

storage.deleteServer(server);

Delete server database completely:

storage.deleteStorage();

Credits

Copyright (C) 2019-2025 Fredrik Claesson

Release History

• 1.0.0 Initial release
• 1.1.0 Migrated to AndroidX
• 1.2.0 Change to Apache License Version 2.0
• 1.3.0 Target Android 15 (API level 35)

License

ServerStorage is licensed under Apache License Version 2.0.