|
1 | | -[](https://mvnrepository.com/artifact/software.xdev/template-placeholder) |
2 | | -[](https://github.com/xdev-software/template-placeholder/actions/workflows/check-build.yml?query=branch%3Adevelop) |
3 | | -[](https://sonarcloud.io/dashboard?id=xdev-software_template-placeholder) |
| 1 | +[](https://mvnrepository.com/artifact/software.xdev/eclipse-store-afs-ibm-cos) |
| 2 | +[](https://github.com/xdev-software/eclipse-store-afs-ibm-cos/actions/workflows/check-build.yml?query=branch%3Adevelop) |
| 3 | +[](https://sonarcloud.io/dashboard?id=xdev-software_eclipse-store-afs-ibm-cos) |
4 | 4 |
|
5 | | -# template-placeholder |
| 5 | +# eclipse-store-afs-ibm-cos |
6 | 6 |
|
| 7 | +A connector for the [EclipseStore](https://eclipsestore.io/) which allows storing data in the [IBM Cloud Object Storage](https://www.ibm.com/cloud/object-storage). |
| 8 | + |
| 9 | +It uses the [IBM-provided Java SDK](https://github.com/IBM/ibm-cos-sdk-java). |
| 10 | + |
| 11 | +The connector works virtually identical to the [AWS S3 Connector](https://docs.eclipsestore.io/manual/storage/storage-targets/blob-stores/aws-s3.html) of EclipseStore but for IBM COS instead of AWS S3. |
| 12 | + |
| 13 | +To easily handle multiple processes using a single IBM COS instance, we implemented the [SingleAccessManager](eclipse-store-afs-ibm-cos/src/main/java/software/xdev/eclipse/store/afs/ibm/access/SingleAccessManager.java). |
| 14 | +It manages access by creating tokens and checking for other tokens. For more information see [the demo application](eclipse-store-afs-ibm-cos-demo/src/main/java/software/xdev/ApplicationWithSingleAccess.java). |
7 | 15 |
|
8 | 16 | ## Installation |
9 | | -[Installation guide for the latest release](https://github.com/xdev-software/template-placeholder/releases/latest#Installation) |
| 17 | + |
| 18 | +[Installation guide for the latest release](https://github.com/xdev-software/eclipse-store-afs-ibm-cos/releases/latest#Installation) |
| 19 | + |
| 20 | +## Supported EclipseStore versions |
| 21 | + |
| 22 | +To find out the currently supported EclipseStore version of the connector have a look at its ``compile`` dependencies and search for ``org.eclipse.store``.<br/> |
| 23 | +This can be done inside an IDE (e.g. IntelliJ IDEA), via a Maven Web explorer (e.g. [mvnrepository.com](https://mvnrepository.com/artifact/software.xdev/eclipse-store-afs-ibm-cos)) or - for the latest version - have a look into the [``Dependencies``](./README.md#dependencies-and-licenses) section below.<br/> |
| 24 | +As an alternative you can also check the [changelog](./CHANGELOG.md). |
| 25 | + |
| 26 | +If you are using a different, not listed version of EclipseStore this shouldn't be a problem.<br/> |
| 27 | +Usually you can simply exclude the dependent version of EclipseStore. |
10 | 28 |
|
11 | 29 | ## Support |
12 | | -If you need support as soon as possible and you can't wait for any pull request, feel free to use [our support](https://xdev.software/en/services/support). |
| 30 | + |
| 31 | +If you need support as soon as possible, and you can't wait for any pull request, feel free to use [our support](https://xdev.software/en/services/support). |
13 | 32 |
|
14 | 33 | ## Contributing |
| 34 | + |
15 | 35 | See the [contributing guide](./CONTRIBUTING.md) for detailed instructions on how to get started with our project. |
16 | 36 |
|
17 | 37 | ## Dependencies and Licenses |
18 | | -View the [license of the current project](LICENSE) or the [summary including all dependencies](https://xdev-software.github.io/template-placeholder/dependencies) |
| 38 | +View the [license of the current project](LICENSE) or the [summary including all dependencies](https://xdev-software.github.io/eclipse-store-afs-ibm-cos/dependencies) |
0 commit comments