Skip to content

Latest commit

 

History

History
215 lines (184 loc) · 7.84 KB

README.md

File metadata and controls

215 lines (184 loc) · 7.84 KB

SQLiteToExcel

This is a Light weight Library to Convert SQLite Database to Excel and Convert Excel to SQLite.

Featured In

Android Arsenal

Sample App

The sample app in the repository is available on Google Play:

Get it on Google Play

Features

1.0.3

Added Pull Request from https://github.com/cleathley

  1. Added the ability to provide a custom formatter to the export.
  2. Added the ability to exclude columns from the export.
  3. Added pretty name mapping to export

1.0.2

  1. Added support to add new column from excel while importing, if the column is not exists.

1.0.1

  1. Added Functionality to Import Excel into SQLite Database.
  2. Added Functionality to Export Blob into Image.
  3. Added Functionality to Export List of tables specified.

How to Download

add the following library in your app level gradle file

implementation 'com.ajts.androidmads.SQLite2Excel:library:1.0.4'

How to Use

The steps to use this Library

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

Export SQLite to Excel

This line is used to save the exported file in default location.
SqliteToExcel sqliteToExcel = new SqliteToExcel(this, "helloworld.db");
This line is used to save the exported file in used preferred location.
SqliteToExcel sqliteToExcel = new SqliteToExcel(this, "helloworld.db", directory_path);
This code snippet is used to Export a single table in a database to Excel Sheet
sqliteToExcel.exportSingleTable("table1", "table1.xls", new SQLiteToExcel.ExportListener() {
     @Override
     public void onStart() {

     }
     @Override
     public void onCompleted(String filePath) {
     
     }
     @Override
     public void onError(Exception e) {

     }
});
This following code snippet is used to Export a list of table in a database to Excel Sheet
sqliteToExcel.exportSpecificTables(tablesList, "table1.xls", new SQLiteToExcel.ExportListener() {
     @Override
     public void onStart() {

     }
     @Override
     public void onCompleted(String filePath) {
     
     }
     @Override
     public void onError(Exception e) {

     }
});
This code snippet is used to Export a every table in a database to Excel Sheet
sqliteToExcel.exportAllTables("table1.xls", new SQLiteToExcel.ExportListener() {
     @Override
     public void onStart() {

     }
     @Override
     public void onCompleted(String filePath) {
     
     }
     @Override
     public void onError(Exception e) {

     }
});
This code snippet shows how to exclude columns from the export (the resulting export file may not be able to be imported)
ArrayList<String> columnsToExclude = new ArrayList<String>();
columnsToExclude.add("income_id");
sqliteToExcel.setExcludeColumns(columnsToExclude);
...
sqliteToExcel.export...
This code snippet shows how to pretty names (either sheet names or column names (the resulting export file may not be able to be imported)
HashMap<String, String> prettyNameMapping = new HashMap<String, String>();
prettyNameMapping.put("income_date", "Date");
sqliteToExcel.setPrettyNameMapping(prettyNameMapping);
...
sqliteToExcel.export...
This code snippet shows how to format the value for a column on export (if you want to convert ID's or whatnot to be better displayed)
sqliteToExcel.setCustomFormatter(new SQLiteToExcel.ExportCustomFormatter() {
    @Override
    public String process(String columnName, String value) {
        switch(columnName) {
            case "income_type_id":
                int v = Integer.parseInt(value);
                switch(v) {
                    case 10:
                        value = "Sale";
                        break;
                    ...
                    default:
                        value = "Unknown";
                        break;
                }
                break;
        }
        return value;
    }
});

Import Excel into Database

The following snippet is used to initialize the library for Importing Excel

ExcelToSQLite excelToSQLite = new ExcelToSQLite(getApplicationContext(), "helloworld.db");

or To drop table while importing the Excel, use the following

ExcelToSQLite excelToSQLite = new ExcelToSQLite(getApplicationContext(), "helloworld.db", true);
The following code is used to Import Excel from Assets
excelToSQLite.importFromAsset("assetFileName.xls", new ExcelToSQLite.ImportListener() {
	@Override
	public void onStart() {

	}

	@Override
	public void onCompleted(String dbName) {

	}

	@Override
	public void onError(Exception e) {

	}
});
The following code is used to Import Excel from user directory
excelToSQLite.importFromFile(directory_path, new ExcelToSQLite.ImportListener() {
	@Override
	public void onStart() {

	}

	@Override
	public void onCompleted(String dbName) {

	}

	@Override
	public void onError(Exception e) {

	}
});

Proguard for SQLite2XL

-dontwarn org.apache.poi.**

Using SQLite2XL

Mail me with your Google Play URL and I'll add your app to the list :)

Icon Developed By App
AJTechsoft Invoicer
CubanApps Facturas Rápidas

Wiki

Please visit the wiki for a complete guide on SQLite2XL.

Quick Solution

  • If you find that the exported excel is not opened, read the following issue #7
  • Unable to generate signed APK when proguard is enabled, read the following issue #8

License

MIT License

Copyright (c) 2017 AndroidMad / Mushtaq M A

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
documentation files (the "Software"), to deal in the Software without restriction, including without limitation
the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software,
and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.