Knowledge Book — революционный плагин для работы с базами данных

Knowledge Book представляет собой минималистичное решение для Java-разработчиков, стремящихся заменить стандартные локальные YML-файлы на мощную базу данных MongoDB. Этот инструмент идеально подходит для создания современных плагинов, требующих надёжного хранения информации.

Как это работает

Плагин использует продвинутый API MongoDB для автоматического преобразования Java-классов в документы базы данных. Основная его задача — обеспечить плавную интеграцию этой функциональности в ваши проекты.

Пример преобразования Java = в документ MongoDB

package to.lodestone.example.data;

import com.fasterxml.jackson.annotation.JsonProperty;
import to.lodestone.knowledgebook.annotation.Collection;

@Collection(name = "person_collection")
public class Person {

    @JsonProperty("fullName")
    private String fullName;

    @JsonProperty("socialSecurityNumber")
    private String socialSecurityNumber;

    // Конструктор для Knowledge Book, чтобы создать пустой объект
    public Person() {

    }

    public Person(String fullName, String socialSecurityNumber) {
        this.fullName = fullName;
        this.socialSecurityNumber = socialSecurityNumber;
    }

    @JsonProperty("fullName")
    public void setFullName(String fullName) {
        this.fullName = fullName;
    }

    @JsonProperty("fullName")
    public String getFullName() {
        return fullName;
    }

    @JsonProperty("socialSecurityNumber")
    public void setSocialSecurityNumber(String socialSecurityNumber) {
        this.socialSecurityNumber = socialSecurityNumber;
    }

    @JsonProperty("socialSecurityNumber")
    public String getSocialSecurityNumber() {
        return socialSecurityNumber;
    }
}

Интеграция в ваш плагин

Вот как просто можно использовать Knowledge Book в вашем собственном проекте:

package to.lodestone.example;

import org.bukkit.plugin.java.JavaPlugin;
import org.mongojack.JacksonMongoCollection;
import to.lodestone.conquest.data.Person;
import to.lodestone.knowledgebook.IKnowledgeBookAPI;
import to.lodestone.knowledgebook.KBHook;

public class TestPlugin extends JavaPlugin {

    private KBHook kbHook;
    @Override
    public void onEnable() {
        this.kbHook = new KBHook(this);

        JacksonMongoCollection<Person> personCollection = this.kbHook.api().getOrCreateCollection(Person.class);
        personCollection.insertOne(new Person("John Doe", "4355678656"));
    }

    public IKnowledgeBookAPI db() {
        return kbHook.api();
    }
}

После запуска сервера автоматически создаётся коллекция с именем "person_collection", содержащая новый документ Person со всей предоставленной вами информацией.

ВАЖНО: Для корректной работы плагина необходимо правильно указать переменные в файле конфигурации:

database: null
connectionString: null