использования - Поддерживаемые версии Java 2. Установка - Как добавить sqltoy в проект Maven/Gradle - Настройка зависимостей 3. Базовое использование - Создание объекта конфигурации - Выполнение SQL-запросов - Обработка результатов 4. Продвинутые возможности - Динамическое управление соединением - Интеграция с другими системами - Расширенные настройки 5. API справочник - Описание всех методов и классов - Примеры использования 6. Часто задаваемые вопросы - Решение распространённых проблем - Советы по оптимизации производительности 7. Отладка и решение ошибок - Анализ сообщений об ошибках - Логирование действий 8. Приложения - Полезные примеры кода - Шаблоны решений задач 9. Лицензия - Условия использования библиотеки 10. Контакты - Способы связи с разработчиками - Возможность участия в развитии проекта
Инструкция по использованию Sqltoy
В процессе разработки мне пришлось искать информацию о некоторых API, где были указаны входные параметры, но отсутствовали примеры использования. Это создает значительные трудности в работе, поэтому я рекомендую добавить простые примеры для большинства API.
Например, когда я искал API, связанные с обновлением данных, хотел использовать метод обновления через шаблон. При поиске метода updateByQuery возникли сложности. Входной параметр entityClass позволяет Sqltoy определить таблицу, которую требуется модифицировать, а entityUpdate представляет собой данные, которые будут изменены. Но где указывается шаблон для обновления? После исследования было установлено, что шаблон обновления также должен быть указан в условии where параметра entityUpdate. Для новичков это может потребовать значительных усилий для понимания, если бы в документации присутствовали примеры, то понять было бы намного легче.