ACCS Application Cache GRPC Support

GRPC and Google Protocol Buffers files for cache-client-api.

License	Common Development and Distribution License 1.0 ("CDDL")
Categories	Caching Data CLI User Interface
GroupId	com.oracle.cloud.caching
ArtifactId	cache-client-protocol
Last Version	1.0.0
Release Date	Mar 15, 2017
Type	jar
Description	ACCS Application Cache GRPC Support GRPC and Google Protocol Buffers files for cache-client-api.

Download cache-client-protocol

Filename	Size
cache-client-protocol-1.0.0.pom
cache-client-protocol-1.0.0.jar	176 KB
cache-client-protocol-1.0.0-sources.jar	31 KB
cache-client-protocol-1.0.0-javadoc.jar	53 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.oracle.cloud.caching/cache-client-protocol/ -->
<dependency>
    <groupId>com.oracle.cloud.caching</groupId>
    <artifactId>cache-client-protocol</artifactId>
    <version>1.0.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.oracle.cloud.caching/cache-client-protocol/
implementation 'com.oracle.cloud.caching:cache-client-protocol:1.0.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.oracle.cloud.caching/cache-client-protocol/
implementation ("com.oracle.cloud.caching:cache-client-protocol:1.0.0")

Apache Buildr

'com.oracle.cloud.caching:cache-client-protocol:jar:1.0.0'

Apache Ivy

<dependency org="com.oracle.cloud.caching" name="cache-client-protocol" rev="1.0.0">
  <artifact name="cache-client-protocol" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.oracle.cloud.caching', module='cache-client-protocol', version='1.0.0')
)

Scala SBT

libraryDependencies += "com.oracle.cloud.caching" % "cache-client-protocol" % "1.0.0"

Leiningen

[com.oracle.cloud.caching/cache-client-protocol "1.0.0"]

Dependencies

compile (9)

Group / Artifact	Type	Version
io.grpc : grpc-netty	jar	1.1.1
io.grpc : grpc-protobuf	jar	1.1.1
io.grpc : grpc-core	jar	1.1.1
io.grpc : grpc-stub	jar	1.1.1
org.glassfish.jersey.media : jersey-media-json-jackson	jar	2.22.1
com.fasterxml.jackson.core : jackson-annotations	jar	2.5.4
com.fasterxml.jackson.core : jackson-core	jar	2.5.4
com.fasterxml.jackson.core : jackson-databind	jar	2.5.4
org.glassfish.jersey.core : jersey-common	jar	2.22.1

Project Modules

There are no modules declared in this project.

Java Client Caching SDK for Oracle Application Container Cloud Service

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

Prerequisites

Install these before building the Java client library:

1. Java SE Development Kit (JDK)

   • Java SE Downloads
   • Install the latest Java SE JDK available

2. Maven 3.2.5 or above installed and configured

   • Download instructions
   • Installation instructions

Build Instructions

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

Running the examples

The directory cache-client-examples contains two sub-projects that show how to use the client API.

Deployable ACCS example

The sub-directory cache-client-examples/appcache-example contains an example using the client API which can be deployed to ACCS.

LocalSessionProvider Example

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.

Referencing the API from Maven Projects

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>
   ```

Further Information

For further information on using the Java API within your applications deployed on ACCS, see the documentation.

Contributing

This is an open source project and we welcome contributions. See CONTRIBUTING for details.

License

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

Oracle

Open Source at Oracle

Versions

Version
1.0.0 Mar 15, 2017