This project contains the source code for the Java client library
to allow apps access caches in the Application Container Cloud Service (ACCS) of Oracle's Cloud Platform.
To create an Application Cache, see the documentation
Install these before building the Java client library:
-
Java SE Development Kit (JDK)
- Java SE Downloads
- Install the latest Java SE JDK available
-
Maven 3.2.5 or above installed and configured
Build the Java client by running these commands:
- Clone the repository
git clone https://github.com/oracle/accs-caching-java-sdk.git
- Change to the directory
cd accs-caching-java-sdk
- Build the client
mvn clean install
If you do not wish to run the local functional tests, run this command:
mvn clean install -DskipTests
If you wish to create a 'shaded' jar, run this command:
mvn clean install -DskipTests -P shade
The directory cache-client-examples contains two sub-projects that show how to use the client API.
The sub-directory cache-client-examples/appcache-example contains an example using the client API which can be deployed to ACCS.
The sub-directory cache-client-examples/local-session-provider-example contains an example showing how to use the
the client API (including full API functionality) against a LocalSessionProvider without having to deploy to ACCS.
To add a dependency on the cache-client-api in your Maven projects, include this dependency.
```
<dependency>
<groupId>com.oracle.cloud.caching</groupId>
<artifactId>cache-client-api</artifactId>
<version>1.0.0</version>
</dependency>
```
For further information on using the Java API within your applications deployed on ACCS, see the documentation.
This is an open source project and we welcome contributions. See CONTRIBUTING for details.
You may not use the identified files except in compliance with the Universal Permissive License (UPL), Version 1.0 (the "License.")
You may obtain a copy of the License at https://opensource.org/licenses/UPL. A copy of the license is also reproduced in LICENSE.md