Хранилища данных

Хранилище представляет собой базу данных или любой другой источник данных в приложении.

Jmix предоставляет JpaDataStore, которое хранит сущности JPA в реляционной базе данных. Это основной механизм персистентности в приложениях Jmix. Когда в этом руководстве упоминается хранилище данных, всегда имеется в виду JpaDataStore, если явно не указано иное.

Основное хранилище

При создании нового проекта Jmix в Studio у него есть одно хранилище данных main, подключенное к реляционной базе данных. Параметры подключения указаны в следующих свойствах приложения:

main.datasource.url = jdbc:hsqldb:file:.jmix/hsqldb/sample
main.datasource.username = sa
main.datasource.password =
main.liquibase.change-log=datamodel/ex1/liquibase/changelog.xml

Используйте интерфейс Studio для настройки подключения к базе данных.

Основной класс приложения содержит соответствующее объявление бина JDBC DataSource:

@Bean
@Primary
@ConfigurationProperties("main.datasource")
DataSourceProperties dataSourceProperties() {
    return new DataSourceProperties();
}

@Bean
@Primary
@ConfigurationProperties("main.datasource.hikari")
DataSource dataSource(DataSourceProperties dataSourceProperties) {
    return dataSourceProperties.initializeDataSourceBuilder().build();
}

Все сущности JPA по умолчанию связаны с основным хранилищем данных.

Дополнительные хранилища

Для работы с несколькими базами данных необходимы дополнительные хранилища данных.

Определите дополнительные хранилища данных в интерфейсе Studio.

У каждого дополнительного хранилища есть уникальное имя, которое указано в списке свойства приложения jmix.core.additional-stores, разделенном запятыми. Параметры подключения к базе данных имеют имя хранилища в качестве префикса. В приведенных ниже примерах настроено дополнительное хранилище locations:

jmix.core.additional-stores = locations,inmem

locations.datasource.url = jdbc:hsqldb:file:.jmix/hsqldb/locations
locations.datasource.username = sa
locations.datasource.password =
locations.liquibase.change-log=datamodel/ex1/liquibase/locations-changelog.xml

Для каждого дополнительного хранилища Studio создает класс конфигурации Spring и определяет в нем JDBC DataSource и другие необходимые бины:

@Configuration
public class LocationsStoreConfiguration {

    @Bean
    @ConfigurationProperties("locations.datasource")
    DataSourceProperties locationsDataSourceProperties() {
        return new DataSourceProperties();
    }

    @Bean
    @ConfigurationProperties(prefix = "locations.datasource.hikari")
    DataSource locationsDataSource(@Qualifier("locationsDataSourceProperties") DataSourceProperties properties) {
        return properties.initializeDataSourceBuilder().build();
    }

    @Bean
    LocalContainerEntityManagerFactoryBean locationsEntityManagerFactory(
            @Qualifier("locationsDataSource") DataSource dataSource,
            JpaVendorAdapter jpaVendorAdapter,
            DbmsSpecifics dbmsSpecifics,
            JmixModules jmixModules,
            Resources resources) {
        return new JmixEntityManagerFactoryBean("locations", dataSource, jpaVendorAdapter, dbmsSpecifics, jmixModules, resources);
    }

    @Bean
    JpaTransactionManager locationsTransactionManager(@Qualifier("locationsEntityManagerFactory") EntityManagerFactory entityManagerFactory) {
        return new JmixTransactionManager("locations", entityManagerFactory);
    }

    @Bean("locationsLiquibaseProperties")
    @ConfigurationProperties(prefix = "locations.liquibase")
    public LiquibaseProperties locationsLiquibaseProperties() {
        return new LiquibaseProperties();
    }

    @Bean("locationsLiquibase")
    public SpringLiquibase locationsLiquibase(@Qualifier("locationsDataSource") DataSource dataSource,
                                              @Qualifier("locationsLiquibaseProperties") LiquibaseProperties liquibaseProperties) {
        return JmixLiquibaseCreator.create(dataSource, liquibaseProperties);
    }
}

Чтобы связать сущность с дополнительным хранилищем данных, используйте аннотацию @Store на классе сущностей:

@Store(name = "locations")
@JmixEntity
@Table(name = "SAMPLE_COUNTRY")
@Entity(name = "sample_Country")
public class Country {

Studio добавляет аннотацию @Store при выборе дополнительного хранилища данных для сущности в дизайнере сущностей.

В приведенном выше примере сущность Country будет храниться в базе данных, подключенной в качестве хранилища данных locations.

Нестандартные хранилища

Нестандартное хранилище данных может помочь вам работать с некоторыми сущностями DTO так же, как и с сущностями JPA – с помощью DataManager. Если сущность DTO связана с нестандартным хранилищем данных, DataManager делегирует операции CRUD этому хранилищу и использует его при поддержке ссылок на DTO из других сущностей.

Давайте рассмотрим процесс создания нестандартного хранилища данных. Представим неперсистентную сущность Metric и хранилище в памяти для нее.

Создайте класс, реализующий интерфейс DataStore. Класс должен быть prototype бином Spring. Приведенный ниже пример демонстрирует примитивную реализацию, которая способна хранить в памяти сущности различных типов.
```
@Component("sample_InMemoryStore")
@Scope(BeanDefinition.SCOPE_PROTOTYPE)
public class InMemoryStore implements DataStore {
    // ...
}
```
Создайте класс, реализующий интерфейс StoreDescriptor. Класс должен быть singleton бином Spring и его метод getBeanName() должен возвращать имя бина реализации хранилища данных, созданного на предыдущем шаге:
```
@Component("sample_InMemoryStoreDescriptor")
public class InMemoryStoreDescriptor implements StoreDescriptor {

    @Override
    public String getBeanName() {
        return "sample_InMemoryStore";
    }

    @Override
    public boolean isJpa() {
        return false;
    }
}
```
Добавьте имя хранилища данных (в данном случае это inmem) в свойство jmix.core.additionalStores:
```
jmix.core.additional-stores = locations,inmem
```
Задайте имя бина StoreDescriptor в свойстве jmix.core.storeDescriptor_<store_name>:
```
jmix.core.store-descriptor_inmem = sample_InMemoryStoreDescriptor
```
Добавьте к сущности аннотацию @Store:
```
@Store(name = "inmem") (1)
@JmixEntity(name = "sample_Metric", annotatedPropertiesOnly = true) (2)
public class Metric {
```
1 Аннотация @Store указывает имя хранилища.

2 Подробности см. в описании @JmixEntity.
Теперь вы можете сохранять и загружать сущность с помощью DataManager, и он будет делегировать операции CRUD нестандартному хранилищу данных:
```
Metric metric = dataManager.create(Metric.class);
metric.setName("test");
metric.setValue(10.0);
dataManager.save(metric);

Metric metric1 = dataManager.load(Id.of(metric)).one();
```
Кроме того, если другая сущность ссылается на Metric, экземпляр Metric будет загружаться автоматически при обращении к ссылочному атрибуту.

1	Аннотация `@Store` указывает имя хранилища.
2	Подробности см. в описании @JmixEntity.