Package: ReloadableDataSource

ReloadableDataSource

Coverage

1: /*
2: * JOPA
3: * Copyright (C) 2024 Czech Technical University in Prague
4: *
5: * This library is free software; you can redistribute it and/or
6: * modify it under the terms of the GNU Lesser General Public
7: * License as published by the Free Software Foundation; either
8: * version 3.0 of the License, or (at your option) any later version.
9: *
10: * This library is distributed in the hope that it will be useful,
11: * but WITHOUT ANY WARRANTY; without even the implied warranty of
12: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13: * Lesser General Public License for more details.
14: *
15: * You should have received a copy of the GNU Lesser General Public
16: * License along with this library.
17: */
18: package cz.cvut.kbss.ontodriver;
19:
20: import cz.cvut.kbss.ontodriver.exception.OntoDriverException;
21:
22: /**
23: * Allows to reload data from the underlying storage.
24: * <p>
25: * This is especially meant for reloading data from text files (e.g. OWL, TTL), which might have been changed externally
26: * and the application may want to reload the file contents so that it works with the most recent data.
27: */
28: public interface ReloadableDataSource extends DataSource {
29:
30: /**
31: * Reloads data from the underlying storage, if possible.
32: * <p>
33: * Does nothing if the underlying storage does not support reloading or it is not necessary (e.g. when connected
34: * to a remote triple store).
35: *
36: * @throws OntoDriverException If an error occurs when reloading data
37: * @throws IllegalStateException If called on a closed data source
38: */
39: void reload() throws OntoDriverException;
40: }