Oracle Coherence 12.2.1.4.0

https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4
Admin
Oracle Coherence is a distributed cache and in-memory data grid solution used by applications for...
Tokens:2,883,134
Snippets:20,859
Trust Score:9.7
Update:1 month ago
Show doc for...
Tokens:
Raw
### Start Cache Server for Live Events Example

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/install/running-coherence-examples.html

Start at least two cache server nodes for the live events example. Each execution starts a new cluster node.

```bash
bin/run-cache-server events
```

--------------------------------

### Run Persistence Example

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/install/running-coherence-examples.html

Execute the persistence example after starting cache servers. The output will be displayed in the command window.

```shell
bin/run-cache-server persistence
```

```shell
bin/run persistence
```

```shell
bin/run persistence notifications
```

```shell
bin/run persistence
```

```shell
CTRL+C
```

```shell
bin/run persistence parallel
```

--------------------------------

### Run Security Example

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/install/running-coherence-examples.html

Execute the security example after starting the cache server with proxy enabled. The output will be displayed in the command window.

```bash
bin/run security
```

--------------------------------

### Start Cache Server for Security Example

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/install/running-coherence-examples.html

Start a cache server that also runs a proxy service for Coherence*Extend clients. This is required for the security example.

```bash
bin/run-cache-server security
```

--------------------------------

### Run Live Events Example

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/install/running-coherence-examples.html

Execute the live events example after starting the required cache servers. The output will be displayed in the command window.

```bash
bin/run events
```

--------------------------------

### Run Contacts Example

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/install/running-coherence-examples.html

Execute the contacts example after starting the cache server. The output will be displayed in the command window.

```bash
bin/run contacts
```

--------------------------------

### JFR Start Command Example

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/rest-reference/op-management-coherence-cluster-members-memberidentifier-diagnostic-cmd-jfrcmd-post.html

Example of starting a JFR recording with specified options for name, duration, and filename. The target directory must exist on the node.

```shell
jfrStart?options=name=myJfr,duration=60s,filename=$jfrFolder/myRecording.jfr
```

--------------------------------

### Run Security Example (.NET)

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/install/running-coherence-examples.html

Start cache servers with the security configuration and then run the security project from Visual Studio or execute the contacts.exe. This example requires Coherence for .NET and Visual Studio.

```shell
bin/run-cache-server security
```

```shell
contacts.exe
```

--------------------------------

### Run Contacts Example (.NET)

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/install/running-coherence-examples.html

Start cache servers and then run the contacts project from Visual Studio or execute the contacts.exe. This example requires Coherence for .NET and Visual Studio.

```shell
bin/run-cache-server
```

```shell
contacts.exe
```

--------------------------------

### Run Java 8 Features Example

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/install/running-coherence-examples.html

Execute the Java 8 features example after starting a cache server. Inspect the output and refer to the code in the specified directory.

```bash
bin/run java8
```

--------------------------------

### PartitionSet Iteration Example

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/cplus-reference/_partition_set_8hpp-source.html

This example demonstrates how to iterate over all marked partitions in a PartitionSet. It uses a loop to find the next marked partition starting from a given index.

```cpp
int32_t nPartition = 0;
while ((nPartition = next(nPartition)) >= 0)
    {
    // process partition nPartition
    }
```

--------------------------------

### Run Coherence Supplemental Installer

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/install/installing-oracle-coherence-java.html

Execute the supplemental installer JAR file to install API documentation and code examples. This is typically used as part of a script for silent installation.

```shell
java -jar fmw_version_coherence_quick_supplemental.jar
```

--------------------------------

### Run Asynchronous Features Example

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/install/running-coherence-examples.html

Execute the asynchronous features example after starting a cache server. Inspect the output and refer to the code in the specified directory.

```bash
bin/run async
```

--------------------------------

### Start Oracle Coherence Graphical Installer

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/install/installing-oracle-coherence-java.html

Execute this command from the directory containing the Coherence JAR file to launch the graphical installation program. Ensure JAVA_HOME/bin is in your system's PATH.

```shell
java -jar fmw_version_coherence.jar
```

--------------------------------

### Target .NET Framework 4.0 for Examples

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/release-notes/bugs-fixed-and-enhancements-this-release.html

The `.csproj` files for the .NET examples bundled in the Java install have been updated to target .NET Framework 4.0.

```xml
<Project ToolsVersion="12.0" DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <Import Project="$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props" Condition="Exists('$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props')" />
  <PropertyGroup>
    <Configuration Condition=" '$(Configuration)' == '' ">
    Debug</Configuration>
    <Platform Condition=" '$(Platform)' == '' ">
    AnyCPU</Platform>
    <ProjectGuid>{...</ProjectGuid>
    <OutputType>Library</OutputType>
    <AppDesignerFolder>Properties</AppDesignerFolder>
    <RootNamespace>Coherence.Examples</RootNamespace>
    <AssemblyName>Coherence.Examples</AssemblyName>
    <TargetFrameworkVersion>v4.0</TargetFrameworkVersion>
    <FileAlignment>512</FileAlignment>
  </PropertyGroup>
  ...
</Project>
```

--------------------------------

### Start Cache Server and HTTP Proxy

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/install/running-coherence-examples.html

This command starts a cache server and an HTTP proxy for the Coherence REST examples. The application will automatically load the home page in the default browser.

```bash
mvn exec:exec -DhttpProxy
```

--------------------------------

### Start Cache Factory Instance

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/manage/using-jmx-manage-oracle-coherence.html

Execute the `coherence` script to start a cache factory instance. This is a prerequisite for starting the HTML adapter.

```batch
COHERENCE_HOME\bin\coherence

```

--------------------------------

### Get Entries with OrFilter (Like)

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/develop-remote-clients/using-coherence-net-client-library.html

Retrieves cache entries matching either of two LikeFilter conditions. This example finds entries ending with 'an' (case-insensitive) or starting with 'An' (case-sensitive).

```csharp
OrFilter    orFilter = new OrFilter(new LikeFilter(IdentityExtractor.Instance, "%an", '\', false), new LikeFilter(IdentityExtractor.Instance, "An%", '\', true));
ICollection entries  = cache.GetEntries(orFilter);
```

--------------------------------

### Perform Coherence Quick Installation using Current Directory as ORACLE_HOME

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/install/installing-oracle-coherence-java.html

Execute the quick installer from an empty directory, which will then be used as the ORACLE_HOME.

```bash
cd /oracle
java -jar /tmp/fmw_version_coherence_quick.jar
```

--------------------------------

### C++ WriteBuffer getWriteBuffer(size32_t of) Example

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/cplus-reference/_write_buffer_8hpp-source.html

Obtains a new WriteBuffer that represents a portion of the current buffer, starting from the specified offset. This is equivalent to getting a sub-buffer with the maximum possible capacity from that offset. Throws IndexOutOfBoundsException if the offset exceeds the maximum capacity.

```cpp
return getWriteBuffer(of, getMaximumCapacity() - of);

```

--------------------------------

### Start Federated Caching ClusterB

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/install/running-coherence-examples.html

Start the second cluster node for the federated caching example.

```bash
bin/run-cache-server federation ClusterB
```

--------------------------------

### Start Federated Caching ClusterA

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/install/running-coherence-examples.html

Start the first cluster node for the federated caching example.

```bash
bin/run-cache-server federation ClusterA
```

--------------------------------

### Run Security Example on Windows

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/install/running-coherence-examples.html

Execute the 'security' example on a Windows system. Ensure a cache server with proxy service is running.

```shell
bin\run.cmd security
```

--------------------------------

### Cache Server Startup Script Example

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/administer-http-sessions/using-coherenceweb-other-application-servers.html

This script configures the cache server for out-of-process deployment. It sets memory, classpath, management remote, cache configuration, and local storage properties.

```bash
java -server -Xms512m -Xmx512m 
-cp <Coherence installation dir>/lib/coherence.jar:<Coherence installation dir>/lib/coherence-web.jar -Dcoherence.management.remote=true -Dcoherence.cacheconfig=default-session-cache-config.xml 
-Dcoherence.session.localstorage=true com.tangosol.net.DefaultCacheServer
```

--------------------------------

### Start VisualVM

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/manage/using-jmx-manage-oracle-coherence.html

Launch VisualVM to manage Coherence MBeans locally. Ensure VISUALVM_HOME is set correctly.

```shell
VISUALVM_HOME\bin\visualvm
```

--------------------------------

### Run Contacts Example on Windows

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/install/running-coherence-examples.html

Execute the 'contacts' example on a Windows system. Ensure a cache server with proxy service is running.

```shell
bin\run.cmd contacts
```

--------------------------------

### Example GET Operation Request and Response

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/develop-remote-clients/performing-grid-operations-rest.html

Demonstrates a client outbound GET request for a 'name' attribute and the corresponding inbound JSON response.

```http
* Client out-bound request
> GET http://127.0.0.1:8080/dist-test-sepj/1;p=name
> Accept: application/json

* Client in-bound response
< 200
< Transfer-Encoding: chunked
< Content-Type: application/json
< 
{"name":"Mark"}
```

--------------------------------

### Start Cache Server Programmatically using main

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/develop-applications/starting-and-stopping-cluster-members.html

Start a cache server programmatically by invoking the `main` method of the `DefaultCacheServer` class. This is useful for applications that need to perform custom setup before starting the server.

```java
String[] args = new String[]{"my-cache-config.xml", "5"};
DefaultCacheServer.main(args);
```

--------------------------------

### Build and Run Archiver Example

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/install/running-coherence-examples.html

Build the archiver example, update its configuration, and then run it. Ensure the JSch library is downloaded and extracted.

```shell
bin/build archiver
```

```shell
bin/run archiver
```

--------------------------------

### Start Cache Server with Custom Configuration and Libraries

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/administer/deploying-coherence-applications.html

Starts a single cache server using specified configuration files and custom library classes. Ensure configuration files are found before coherence.jar if using default names.

```shell
java -server -Xms4g -Xmx4g -cp APPLICATION_HOME\config;APPLICATION_HOME\lib\myClasses.jar;COHERENCE_HOME\lib\coherence.jar com.tangosol.net.DefaultCacheServer
```

--------------------------------

### Run the Hello World Application

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/develop-applications/building-your-first-coherence-application.html

Execute the compiled Coherence application. This command starts a cache node and interacts with the 'hello-example' cache. Ensure COHERENCE_HOME is set correctly and the distributed storage is disabled locally.

```shell
java -cp COHERENCE_HOME\config;COHERENCE_HOME\lib\coherence.jar -Dcoherence.distributed.localstorage=false com.examples.HelloWorld
```

--------------------------------

### Sample Commands to Create User, Grant Permissions, and Enable Logging

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/integrate/integrating-oracle-coherence-goldengate-hotcache.html

Use these Oracle Database commands to create a user, grant necessary permissions, and enable supplemental logging for GoldenGate integration.

```sql
CREATE USER csdemo IDENTIFIED BY csdemo;
GRANT DBA TO csdemo;
grant alter session to csdemo;
grant create session to csdemo;
grant flashback any table to csdemo;
grant select any dictionary to csdemo;
grant select any table to csdemo;
grant select any transaction to csdemo;
grant unlimited tablespace to csdemo;
ALTER DATABASE ADD SUPPLEMENTAL LOG DATA;
```

--------------------------------

### Enable Access Controller via System Property

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/secure/using-access-controller.html

This command-line example demonstrates enabling the access controller by setting the `coherence.security` system property to `true`.

```bash
-Dcoherence.security=true

```

--------------------------------

### REST GET Operation Examples

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/develop-remote-clients/building-your-first-coherence-rest-application.html

Illustrates various GET requests to retrieve data from the 'dist-http-example' cache, including specific entries, filtered entries, and aggregated data.

```http
GET http://localhost:8080/api/dist-http-example/1.json
```

```http
GET http://localhost:8080/api/dist-http-example/1.xml
```

```http
GET http://localhost:8080/api/dist-http-example/entries?q=name is 'chris'
```

```http
GET http://localhost:8080/api/dist-http-example/1.json;p=name
```

```http
GET http://localhost:8080/api/dist-http-example/count()
```

```http
GET http://localhost:8080/api/dist-http-example/double-average(age)
```

--------------------------------

### Restore Original PofContext Example

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/cplus-reference/classcoherence_1_1io_1_1pof_1_1_pof_buffer_reader.html

Demonstrates how to temporarily switch to a new PofContext and then restore the original one. This is an advanced usage pattern for PofReader.

```cpp
PofContext::View vCtxOrig = hReader->getPofContext();
// switch to another PofContext
PofContext::View vCtxNew = ...;
hReader->setContext(vCtxNew);
// read POF data using the reader
...
// restore the original PofContext
hReader->setPofContext(vCtxOrig);
```

--------------------------------

### Limit Direct Query Results with Start and Count Parameters

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/develop-remote-clients/performing-grid-operations-rest.html

Use the 'start' and 'count' query parameters to specify a subset of results for a direct query. This example retrieves entries matching 'age < 18'.

```http
GET http://host:port/persons;start=0;count=10?q=age%3C18
```

--------------------------------

### Perform Coherence Quick Installation with Custom Inventory Location

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/install/installing-oracle-coherence-java.html

Run the quick installer, specifying a custom location for the oraInst.loc inventory pointer file.

```bash
java -jar fmw_version_coherence_quick.jar -invPtrLoc /MyDirectory/oraInst.loc
```

--------------------------------

### Limit Named Query Results with Start and Count Parameters

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/develop-remote-clients/performing-grid-operations-rest.html

Use the 'start' and 'count' matrix parameters to specify a subset of results for a named query. This example retrieves the first 10 entries sorted by name.

```http
http://host:port/persons/minors;start=0;count=10;order=name:asc
```

--------------------------------

### RegisterHit

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/net-reference/html/fc1fad14-2301-66f8-d1c2-bd83fa957750.htm

Registers a cache hit, recording the time when a get operation started. This method is part of the SimpleCacheStatistics class.

```APIDOC
## RegisterHit

### Description
Registers a cache hit, recording the time when a get operation started. This method is part of the SimpleCacheStatistics class.

### Method
`public virtual void RegisterHit(long startMillis)`

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
None

### Response
#### Success Response
None (void method)

#### Response Example
None
```

--------------------------------

### Start CacheFactory command-line tool

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/develop-applications/building-your-first-coherence-jcache-application.html

Starts a standalone cache factory instance with the necessary classpath and system properties to connect to the cluster.

```bash
java -Dcoherence.cacheconfig=coherence-jcache-cache-config.xml 
-Dcoherence.distributed.localstorage=false 
-cp APPLICATION_HOME\config;APPLICATION_HOME\person.jar;
COHERENCE_HOME\lib\cache-api.jar;COHERENCE_HOME\lib\coherence-jcache.jar;
COHERENCE_HOME\lib\coherence.jar com.tangosol.net.CacheFactory
```

--------------------------------

### Sample GoldenGate Capture ggsci Script

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/integrate/integrating-oracle-coherence-goldengate-hotcache.html

This `ggsci` script demonstrates a comprehensive setup for capturing table changes. It includes starting the manager, configuring extract parameters, managing trail files, and starting the capture process.

```bash
start mgr
DBLOGIN USERID csdemo, PASSWORD csdemo
STOP EXTRACT cs-cap
DELETE EXTRACT cs-cap
ADD TRANDATA csdemo.*
ADD EXTRACT cs-cap, integrated tranlog, begin now
SHELL rm -f dirdat/cs*
ADD EXTTRAIL dirdat/cs, EXTRACT cs-cap
start cs-cap

```

--------------------------------

### Start Cache Server with Default Configuration

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/develop-applications/understanding-configuration.html

Starts a cache server using the default coherence-cache-config.xml file found on the classpath. Ensure the configuration file precedes coherence.jar in the classpath.

```bash
java -cp COHERENCE_HOME;COHERENCE_HOME\lib\coherence.jar com.tangosol.net.DefaultCacheServer
```

--------------------------------

### Start CohQL Command-Line Tool

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/develop-applications/using-coherence-query-language.html

Launches the CohQL command-line tool on Windows. Assumes Coherence is installed in C:/coherence.

```bash
C:/coherence/bin/query.cmd
```

--------------------------------

### Using System Properties in Configuration

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/release-notes/bugs-fixed-and-enhancements-this-release.html

Demonstrates how to use system properties with default values for configuration elements in Coherence.

```xml
${system.property default_value}
```

--------------------------------

### Get Cluster Information

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/manage/using-jmx-manage-oracle-coherence.html

This example demonstrates how to retrieve cluster information using a cURL request to the Coherence management API.

```APIDOC
## GET /management/coherence/cluster

### Description
Retrieves detailed information about the Coherence cluster, including its members, version, and status.

### Method
GET

### Endpoint
/management/coherence/cluster

### Parameters
None

### Request Example
```bash
curl -i -X GET http://127.0.0.1:63660/management/coherence/cluster
```

### Response
#### Success Response (200)
- **links** (array) - Links to related management resources.
- **refreshTime** (string) - The timestamp when the cluster information was last refreshed.
- **licenseMode** (string) - The current license mode of the Coherence cluster.
- **clusterSize** (integer) - The number of members in the cluster.
- **localMemberId** (integer) - The ID of the local member.
- **version** (string) - The version of Oracle Coherence.
- **running** (boolean) - Indicates if the cluster is running.
- **clusterName** (string) - The name of the Coherence cluster.
- **membersDeparted** (array) - A list of members that have departed the cluster.
- **memberIds** (array) - A list of IDs of the current members.
- **membersDepartureCount** (integer) - The count of member departures.
- **members** (array) - A list of strings describing the cluster members.
- **oldestMemberId** (integer) - The ID of the oldest member in the cluster.
- **type** (string) - The type of resource, typically 'Cluster'.

#### Response Example
```json
{
	"links": [
		{
			"rel": "parent",
			"href": "http://127.0.0.1:63660/management/coherence"
		},
		{
			"rel": "self",
			"href": "http://127.0.0.1:63660/management/coherence/cluster"
		},
		{
			"rel": "canonical",
			"href": "http://127.0.0.1:63660/management/coherence/cluster"
		},
		{
			"rel": "services",
			"href": "http://127.0.0.1:63660/management/coherence/cluster/services"
		},
		{
			"rel": "caches",
			"href": "http://127.0.0.1:63660/management/coherence/cluster/caches"
		},
		{
			"rel": "members",
			"href": "http://127.0.0.1:63660/management/coherence/cluster/members"
		},
		{
			"rel": "management",
			"href": "http://127.0.0.1:63660/management/coherence/cluster/management"
		},
		{
			"rel": "journal",
			"href": "http://127.0.0.1:63660/management/coherence/cluster/journal"
		},
		{
			"rel": "hotcache",
			"href": "http://127.0.0.1:63660/management/coherence/cluster/hotcache"
		},
		{
			"rel": "webApplications",
			"href": "http://127.0.0.1:63660/management/coherence/cluster/webApplications"
		}
	],
	"refreshTime": "2018-12-12T18:04:34.225-05:00",
	"licenseMode": "Development",
	"clusterSize": 1,
	"localMemberId": 1,
	"version": "19.1.0.0.0",
	"running": true,
	"clusterName": "MyCluster",
	"membersDeparted": [],
	"memberIds": [1],
	"membersDepartureCount": 0,
	"members": ["Member(Id=1, Timestamp=2018-12-12 18:01:38.132, Address=127.0.0.1:63621, MachineId=46461, Location=site:Burlington,rack:100A,process:12124,member:COH-001, Role=Cache Server)"],
	"oldestMemberId": 1,
	"type": "Cluster"
}
```
```

--------------------------------

### Example Output: Loaded MBean Configuration Override File

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/develop-applications/understanding-configuration.html

This example shows the log output confirming that an MBean configuration override file has been loaded. This message helps verify that Coherence is using the specified MBean configuration, especially when using custom override files.

```log
Loaded operational overrides from resource "file:/D:/coherence/custom-mbeans.xml"
```

--------------------------------

### Example GET Request for Named Query

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/develop-remote-clients/rest-configuration-elements.html

Demonstrates how to execute a named query against a cache using a REST URL. The query can accept parameters.

```http
GET http://host:port/cacheName/namedQuery?param1=value1,param2=value2...
```

--------------------------------

### Install Coherence*Web Application

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/administer-http-sessions/using-coherenceweb-other-application-servers.html

Run this command to install the Coherence*Web application, replacing `<app-path>` with the full path to your application.

```bash
java -jar webInstaller.jar <app-path> -install
```

--------------------------------

### Start Cache Server (Windows)

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/develop-remote-clients/building-your-first-coherence-rest-application.html

Starts a Coherence cache server process on Windows. Ensure the classpath includes configuration files, the Person.class, and all dependency libraries.

```bash
java -cp DEV_ROOT\config;DEV_ROOT;DEV_ROOT\libs\dependencies; 
COHERENCE_HOME\coherence-rest.jar -Dcoherence.clusterport=8090 
-Dcoherence.ttl=0 
-Dcoherence.cacheconfig=DEV_ROOT\config\example-server-config.xml 
com.tangosol.net.DefaultCacheServer
```

--------------------------------

### getBufferOutput

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/cplus-reference/classcoherence_1_1io_1_1_abstract_write_buffer.html

Gets a BufferOutput object to write data to this buffer starting at a particular offset. Each call to this method will return a new BufferOutput object.

```APIDOC
## getBufferOutput (size32_t of=0)

### Description
Get a BufferOutput object to write data to this buffer starting at a particular offset. Note that each call to this method will return a new BufferOutput object, with the possible exception being that a zero-length non-resizing WriteBuffer could always return the same instance (since it is not writable).

### Method
virtual BufferOutput::Handle

### Parameters
#### Path Parameters
- **of** (size32_t) - The offset of the first octet of this buffer that the BufferOutput will write to. Defaults to 0.

### Returns
A BufferOutput that will write to this buffer.
```

--------------------------------

### JCache Example Application

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/develop-applications/building-your-first-coherence-jcache-application.html

A Java application demonstrating how to get a caching provider, create a cache manager, configure a cache, and perform put/get operations.

```java
package com.examples;

import javax.cache.Cache;
import javax.cache.CacheManager;
import javax.cache.Caching;
import javax.cache.configuration.MutableConfiguration;
import javax.cache.spi.CachingProvider;

public class JCacheExample {
   public static void main(String[] args) 
   {
      CachingProvider cachingProvider = Caching.getCachingProvider();
      CacheManager cacheManager = cachingProvider.getCacheManager();
             
      MutableConfiguration<String, Object> config = 
         new MutableConfiguration<String, Object>();
      config.setStoreByValue(true).setTypes(String.class, Object.class);

      Cache<String, Object> cache = cacheManager.createCache("MyCache", config);

      Person p = new Person("John","Doe",24);
        
      String key = "k";
      Person value = p;
         
      cache.put(key, value);
      System.out.println("\n Cache: " + cache.getName() + " contains: " +
            cache.get(key) + "\n");

      cacheManager.close();
   }
}
```

--------------------------------

### processAll Implementation Example

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/cplus-reference/classcoherence_1_1util_1_1_invocable_map_1_1_entry_processor.html

Provides a semantic equivalent for the processAll method, demonstrating how to iterate through a set of entries and process them individually, collecting results in a HashMap.

```cpp
Map::Handle hMapResults = HashMap::create();
Iterator::Handle hIter = vSetEntries->iterator();
while (iter->hasNext)
    {
    InvocableMap::Entry::Handle hEntry =
            cast<InvocableMap::Entry::Handle>(hIter->next());
    hMapResults->put(hEntry->getKey(), process(hEntry));
    }
return hMapResults;
```

--------------------------------

### Get NamedCache Instance (Java)

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/develop-remote-clients/introduction-coherenceextend.html

Java clients obtain a NamedCache instance using the CacheFactory.getCache method. This is a common starting point for cache operations.

```Java
NamedCache cache = CacheFactory.getCache("dist-extend");
```

--------------------------------

### Create Keystore with Principals using keytool

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/secure/using-access-controller.html

Generate a keystore file and add principals for the Java Security framework and Oracle Coherence using the 'keytool' utility.

```bash
keytool -genkey -v -keystore ./keystore.jks -storepass password -alias admin
-keypass password -dname CN=Administrator,O=MyCompany,L=MyCity,ST=MyState

keytool -genkey -v -keystore ./keystore.jks -storepass password -alias manager
-keypass password -dname CN=Manager,OU=MyUnit

keytool -genkey -v -keystore ./keystore.jks -storepass password -alias worker
-keypass password -dname CN=Worker,OU=MyUnit
```

--------------------------------

### Configure WKA Address Provider with Initialization Parameters

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/develop-applications/setting-cluster.html

This example shows how to pass initialization parameters to an AddressProvider implementation.

```xml
<?xml version='1.0'?>

<coherence xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xmlns="http://xmlns.oracle.com/coherence/coherence-operational-config"
   xsi:schemaLocation="http://xmlns.oracle.com/coherence/coherence-operational-config
   coherence-operational-config.xsd">
   <cluster-config>
      <unicast-listener>
         <well-known-addresses>
            <address-provider>
               <class-name>package.MyAddressProvider</class-name>
               <init-params>
                  <init-param>
                     <param-name>iMaxTime</param-name>
                     <param-value>2000</param-value>
                  </init-param>
               </init-params>
            </address-provider>
         </well-known-addresses>
      </unicast-listener>
   </cluster-config>
</coherence>

```

--------------------------------

### Get List of Caches via REST API

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/rest-reference/quick-start.html

This example shows how to use cURL to retrieve a list of all caches on the cluster using the Coherence REST API.

```APIDOC
## Get List of Caches

### Description
Retrieves a list of all caches configured on the Coherence cluster using the REST API.

### Method
GET

### Endpoint
`/management/coherence/cluster/caches`

### Request Example
```bash
curl -i -X GET http://127.0.0.1:30000/management/coherence/cluster/caches
```

### Response Example (Success - 200 OK)
```json
{
	"links": [
		{
			"rel": "parent",
			"href": "http://127.0.0.1:30000/management/coherence/cluster"
		},
		{
			"rel": "self",
			"href": "http://127.0.0.1:30000/management/coherence/cluster/caches"
		},
		{
			"rel": "canonical",
			"href": "http://127.0.0.1:30000/management/coherence/cluster/caches"
		}
	],
	"items": [
		{
			"links": [
				{
					"rel": "parent",
					"href": "http://127.0.0.1:30000/management/coherence/cluster/caches"
				},
				{
					"rel": "self",
					"href": "http://127.0.0.1:30000/management/coherence/cluster/caches/hello-example"
				},
				{
					"rel": "canonical",
					"href": "http://127.0.0.1:30000/management/coherence/cluster/caches/hello-example"
				},
				{
					"rel": "members",
					"href": "http://127.0.0.1:30000/management/coherence/cluster/caches/hello-example/members"
				}
			],
			"name": "hello-example"
		}
	]
}
```
```

--------------------------------

### Register a cache hit - C#

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/net-reference/html/fc1fad14-2301-66f8-d1c2-bd83fa957750.htm

Call this method to register a cache hit, providing the start time of the get operation in milliseconds. This is part of the SimpleCacheStatistics class.

```csharp
public virtual void RegisterHit(
	long startMillis
)
```

--------------------------------

### Build Coherence REST Examples

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/install/running-coherence-examples.html

Execute this command to clean, compile, and build the Coherence REST examples.

```bash
mvn clean compile
```

--------------------------------

### Get Next List Element

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/cplus-reference/classcoherence_1_1util_1_1_linked_list_1_1_list_element.html

A helper method to find a ListElement at a specified position within a linked list. It requires the starting element and the desired index.

```cpp
template<class T>
static TypedHandle< T >
nextElement(const TypedHandle< T > &thElement,
            size32_t c)
```

--------------------------------

### Start Cache Server using java -jar

Source: https://docs.oracle.com/en/middleware/fusion-middleware/coherence/12.2.1.4/develop-applications/starting-and-stopping-cluster-members.html

Use this command to start a cache server instance from the command line for testing and demonstration purposes.

```shell
java -jar COHERENCE_HOME\lib\coherence.jar
```
Tokens:
Raw