Руководство по объектам данных Java
1. обзор
Объекты данных Java - это API, разработанный для сохранения объектно-ориентированных данных в любой базе данных и обеспечения удобного языка запросов с использованием синтаксиса Java.
В этой статье мы рассмотрим, как использовать API JDO для сохранения наших объектов в базе данных.
2. Зависимости и настройка Maven
Мы собираемся использовать API DataNucleus JDO, который обновлен и предлагает полную поддержку API JDO 3.2.
Давайте добавим в наш файлpom.xml следующую зависимость:
org.datanucleus
javax.jdo
3.2.0-m6
org.datanucleus
datanucleus-core
5.1.0-m2
org.datanucleus
datanucleus-api-jdo
5.1.0-m2
org.datanucleus
datanucleus-rdbms
5.1.0-m2
org.datanucleus
datanucleus-xml
5.0.0-release
Последние версии зависимостей можно найти здесь:javax.jdo,datanucleus-core,datanucleus-api-jdo,datanucleus-rdbms иdatanucleus-xml.
3. модель
Мы собираемся сохранить наши данные в базе данных, и прежде чем мы сможем это сделать, нам нужно создать класс, который будет использоваться JDO для хранения наших данных.
Для этого нам нужно создать класс с некоторыми свойствами и аннотировать его@PersistentCapable:
@PersistenceCapable
public class Product {
@PrimaryKey
@Persistent(valueStrategy = IdGeneratorStrategy.INCREMENT)
long id;
String name;
Double price = 0.0;
// standard constructors, getters, setters
}
Мы также аннотировали наш первичный ключ и выбранную стратегию.
Как только мы создадим наш объект, нам нужно запустить энхансер, чтобы сгенерировать байт-код, требуемый JDO. Используя Maven, мы можем запустить эту команду:
mvn datanucleus:enhance
Этот шаг является обязательным. В противном случае мы получаем ошибку времени компиляции, что класс не улучшен.
Конечно, это можно сделать автоматически во время сборки Maven:
org.datanucleus
datanucleus-maven-plugin
5.0.2
JDO
${basedir}/datanucleus.properties
${basedir}/log4j.properties
true
process-classes
enhance
Последнюю версию плагина можно найти здесь:datanucleus-maven-plugin
4. Сохраняющиеся объекты
Мы получаем доступ к базе данных, используя фабрику JDO, которая дает нам менеджер транзакций, который отвечает за выполнение транзакций:
PersistenceManagerFactory pmf = new JDOPersistenceManagerFactory(pumd, null);
PersistenceManager pm = pmf.getPersistenceManager();
Транзакции используются, чтобы разрешить откат в случае ошибки:
Transaction tx = pm.currentTransaction();
Мы совершаем наши транзакции внутри блокаtry/catch:
Product product = new Product("Tablet", 80.0);
pm.makePersistent(product);
В нашем блокеfinally мы определяем эти операции, которые должны выполняться в случае сбоя.
Если по какой-либо причине транзакция не может быть завершена, мы делаем откат, а также закрываем соединение с базой данных с помощьюpm.close():
finally {
if (tx.isActive()) {
tx.rollback();
}
pm.close();
}
Чтобы подключить нашу программу к базе данных, нам нужно создатьpersistence-unit во время выполнения, чтобы указать постоянные классы, тип базы данных и параметры подключения:
PersistenceUnitMetaData pumd = new PersistenceUnitMetaData(
"dynamic-unit", "RESOURCE_LOCAL", null);
pumd.addClassName("com.example.jdo.Product");
pumd.setExcludeUnlistedClasses();
pumd.addProperty("javax.jdo.option.ConnectionDriverName", "org.h2.Driver");
pumd
.addProperty("javax.jdo.option.ConnectionURL", "jdbc:h2:mem:mypersistence");
pumd.addProperty("javax.jdo.option.ConnectionUserName", "sa");
pumd.addProperty("javax.jdo.option.ConnectionPassword", "");
pumd.addProperty("datanucleus.autoCreateSchema", "true");
5. Чтение объектов
Чтобы прочитать данные из нашей базы данных в нашем блоке транзакций, мы создаем запрос. Затем мы сохраняем эти элементы в коллекцию JavaList, которая будет содержать в памяти копию информации из постоянного хранилища.
Диспетчер сохраняемости дает нам доступ к интерфейсу запросов, который позволяет нам взаимодействовать с базой данных:
Query q = pm.newQuery(
"SELECT FROM " + Product.class.getName() + " WHERE price < 1");
List products = (List) q.execute();
Iterator iter = products.iterator();
while (iter.hasNext()) {
Product p = iter.next();
// show the product information
}
6. Обновление объектов
Для обновления объектов в базе данных нам нужно найти объекты, которые мы хотим обновить, используя запрос, затем мы обновляем результаты запроса и фиксируем транзакцию:
Query query = pm.newQuery(Product.class, "name == \"Phone\"");
Collection result = (Collection) query.execute();
Product product = (Product) result.iterator().next();
product.setName("Android Phone");
7. Удаление объектов
Подобно процедуре обновления, мы сначала ищем объект, а затем удаляем его с помощью диспетчера сохраняемости. В этих ситуациях JDO обновляет постоянное хранилище:
Query query = pm.newQuery(Product.class, "name == \"Android Phone\"");
Collection result = (Collection) query.execute();
Product product = (Product) result.iterator().next();
pm.deletePersistent(product);
8. XML-хранилища данных
Используя плагин XML, мы можем использовать файлы XML для сохранения наших данных.
Мы указываем нашConnectionURL, указывая, что это файл XML, и указываем имя файла: __
pumdXML.addProperty("javax.jdo.option.ConnectionURL", "xml:file:myPersistence.xml");
Хранилище данных XML не поддерживает свойство автоинкремента, поэтому нам нужно создать другой класс:
@PersistenceCapable()
public class ProductXML {
@XmlAttribute
private long productNumber = 0;
@PrimaryKey
private String name = null;
private Double price = 0.0;
// standard getters and setters
Аннотация@XmlAttribute означает, что она появится в XML-файле как атрибут элемента.
Давайте создадим и сохраним наш продукт:
ProductXML productXML = new ProductXML(0,"Tablet", 80.0);
pm.makePersistent(productXML);
Мы получаем продукт, хранящийся в файле XML:
Tablet
80.0
8.1. Восстановить объекты из XML-хранилища данных
Мы можем восстановить наши объекты из файла XML, используя запрос:
Query q = pm.newQuery("SELECT FROM " + ProductXML.class.getName());
List products = (List) q.execute();
И затем мы используем итератор для взаимодействия с каждым объектом.
9. JDO запросы
JDOQL - это объектно-ориентированный язык запросов, предназначенный для выполнения запросов с использованием объектов Java.
9.1. Декларативный JDOQL
Используя декларативный запрос, мы объявляем параметры и устанавливаем их с помощью Java, это обеспечивает безопасность типов:
Query qDJDOQL = pm.newQuery(Product.class);
qDJDOQL.setFilter("name == 'Tablet' && price == price_value");
qDJDOQL.declareParameters("double price_value");
List resultsqDJDOQL = qDJDOQL.setParameters(80.0).executeList();
9.2. SQL
JDO предоставляет механизм для выполнения стандартных запросов SQL:
Query query = pm.newQuery("javax.jdo.query.SQL", "SELECT * FROM PRODUCT");
query.setClass(Product.class);
List results = query.executeList();
Мы используемjavax.jdo.query.SQL в качестве одного параметра для объекта запроса, а второй параметр - это сам SQL.
9.3. JPQL
JDO также предоставляет механизм для выполнения запросов JPA. Мы можем использовать полный синтаксис языка запросов JPA:
Query q = pm.newQuery("JPQL",
"SELECT p FROM " + Product.class.getName() + " p WHERE p.name = 'Laptop'");
List results = (List) q.execute();
10. Резюме
В этом уроке мы:
-
создал простое приложение CRUD, которое использует JDO
-
сохранены и получены наши данные в формате XML
-
изучены общие механизмы запросов
Как всегда, вы можете найти код из статьиover on Github.