DbLib 0.2.1

Library that includes ORMlite engine, SQLite and MySQL drivers

  1. This site uses cookies. By continuing to use this site, you are agreeing to our use of cookies. Learn More.
Dismiss Notice
We welcome you on our site. This site is devoted to the Nukkit project and all that is connected with him. Here you can communicate, download plugins, also many other things get acquainted! Register the account right now :3
  1. fromgate
    DbLib is a library, that allows to get access to database simply.

    Features
    • Provides acces to popular database engines: SQLite and MySQL;
    • Includes popular library ORMLite, that provides access to database without using SQL-queries;
    • Organizes universal data storage for all plugins, that uses DbLib. Server owner must configure DbLib once and all plugins that use DbLib will work fine!

    How to use plugin (Server owners must read this)
    If any plugin requires a DbLib you just need to download and install it. Usually it will be enough. But if you going to use to MySQL or another sqlite file you need to configure plugin (Read at Config section)

    Note for plugin developers
    ORMLite is popular engine, that provides access to databases using ORM technique. Practically it means that you can read and save data into dabase without writing SQL-queries.

    DbLib also include database drivers:
    • SQLite driver
    • MySQL driver
    If you would not like to use ORMLite, you can use MySQL (or SQLite) drivers as usually, using JDBC provided by Java.

    How to connect to universal DbLib storage

    DbLib suggests to use universal database (by default it is a file nukkit.db, located in sever folder or MySQL database defined by user) for all plugins. If DbLib installed on server you don't need to think about database drivers, urls, names and passwords.

    Here is example of creating new table (check API section for more info):

    Code:
      public boolean connectToDbLib(){
    if (this.getServer().getPluginManager().getPlugin("DbLib") == null){
    this.getLogger().info(TextFormat.RED+"DbLib plugin not found");
    return false;
    }
    connectionSource = DbLib.getConnectionSource();
    if (connectionSource == null) return false;
    try {
    passDao =  DaoManager.createDao(connectionSource, PasswordsTable.class);
    TableUtils.createTableIfNotExists(connectionSource, PasswordsTable.class);
    } catch (Exception e) {
    return false;
    }
    return true;
    }
    But if you going to use any other database you must use this method:

    Code:
    DbLib.getConnectionSoruce(String url, String userName, String password)
    DbLib — это библиотека, позволяющая получить простой доступ к базам данных.

    Особенности
    • Обеспечивает доступ к самым популярным хранилищам - SQLite и MySQL;
    • Включает в себя популярную библиотеку ORMLite, обеспечивающую возможность доступа к базе данных без использования SQL-запросов;
    • Позволяет организовать единое хранилище для всех плагинов, при этом ни пользователям достаточно будет один раз настроить DbLib, а не настраивать все плагины, работающие с базами данных.
    Использование плагина (для серверо-держателей)
    Если какой-то плагин просит установить DbLib, то в большинстве случаев, достаточно будет... просто его установить. И тогда все плагины, которые использую DbLib будут готовы к работе. Однако, если Вы хотите использовать для хранения данных MySQL, то Вам потребуется настроить плагин (см. раздел Настройка - Config)

    Информация для разработчиков
    DbLib включает в себя:
    • ORMLite - популярный движок, реализующий доступ к базам данных по технологии ORM. На практике это позволяет описав модель данных производить работу с любой БД, поддерживаемой ORM. В нашем случае — это SQLite и MySQL.
    • Драйвер SQLite - для доступа к базам в формате sqlite
    • Драйвер MySQL - для работы с базами данных MySQL
    Это позволяет работать с базами данных как через ORMLite, так и напрямую через средства JDBC с указанными драйверами. Наличие ORMLite не накладывает никаких ограничений.

    Получение доступа к стандартному хранилищу DbLib
    DbLib предлагает использовать единое хранилище (файл nukkit.db или базу MySQL, определяемую пользователем) для всех плагинов.

    Code:
      public boolean connectToDbLib(){
    if (this.getServer().getPluginManager().getPlugin("DbLib") == null){
    this.getLogger().info(TextFormat.RED+"DbLib plugin not found");
    return false;
    }
    connectionSource = DbLib.getConnectionSource();
    if (connectionSource == null) return false;
    try {
    passDao =  DaoManager.createDao(connectionSource, PasswordsTable.class);
    TableUtils.createTableIfNotExists(connectionSource, PasswordsTable.class);
    } catch (Exception e) {
    return false;
    }
    return true;
    }
    Если Вы планируете использовать другую базу данных, то можно воспользоваться методом:

    Code:
    DbLib.getConnectionSoruce(String url, String userName, String password)
    Это позволит использовать ORMLite с любой базой данных.
    twixi likes this.

Recent Reviews

  1. j0sky
    j0sky
    5/5,
    Version: 0.1.3
    Отлично.
  2. Hoang Xuan An
    Hoang Xuan An
    5/5,
    Version: 0.1.2
    10/10 MySQL option ;)
    1. fromgate
      Author's Response
      Thank you :)
  3. impact
    impact
    5/5,
    Version: 0.0.1
    Теперь наконец можно плагины с подключением к БД делать :3