Go to main content
1/55
Contents
List of Examples
List of Figures
List of Tables
Title and Copyright Information
Preface
Audience
Documentation Accessibility
Related Documents
Conventions
What's New in This Guide
New and Changed Features for 12
c
(12.1.3)
Other Significant Changes in This Document for 12
c
(12.1.3)
New and Changed Features for 12
c
(12.1.2)
Other Significant Changes in This Document for 12
c
(12.1.2)
Part I Getting Started
1
Introduction to Coherence
1.1
Basic Concepts
1.1.1
Clustered Data Management
1.1.2
A single API for the logical layer, XML configuration for the physical layer
1.1.3
Caching Strategies
1.1.4
Data Storage Options
1.1.5
Serialization Options
1.1.6
Configurability and Extensibility
1.1.7
Namespace Hierarchy
1.2
Read/Write Caching
1.2.1
NamedCache
1.2.2
Requirements for Cached Objects
1.2.3
NamedCache Usage Patterns
1.3
Querying the Cache
1.4
Invocation Service
1.5
Event Programming
1.6
Transactions
1.7
HTTP Session Management
1.8
Object-Relational Mapping Integration
1.9
C++/.NET Integration
1.10
Management and Monitoring
2
Installing Oracle Coherence for Java
2.1
System Requirements
2.2
Performing a Coherence Installation
2.2.1
Running the Coherence Installer
2.2.1.1
Performing a Coherence Installation In Graphical Mode
2.2.1.2
Performing a Coherence Installation In Silent Mode
2.2.2
Running the Coherence Quick Installer
2.2.3
Running the Coherence Supplemental Installer
2.2.4
Installing Coherence with WebLogic Server
2.3
Browsing the Installation Directory
2.4
Setting Environment Variables
2.5
Running Coherence for the First Time
2.5.1
Create a Basic Cluster
2.5.2
Create a Cache
2.6
Integration with Maven
2.7
Deinstalling Coherence
3
Understanding Configuration
3.1
Overview of the Default Configuration Files
3.2
Specifying an Operational Configuration File
3.2.1
Using the Default Operational Override File
3.2.2
Specifying an Operational Override File
3.2.3
Defining Override Files for Specific Operational Elements
3.2.4
Viewing Which Operational Override Files are Loaded
3.3
Specifying a Cache Configuration File
3.3.1
Using a Default Cache Configuration File
3.3.2
Overriding the Default Cache Configuration File
3.3.3
Using the Cache Configuration File System Property
3.3.4
Viewing Which Cache Configuration File is Loaded
3.4
Specifying a POF Configuration File
3.4.1
Overriding the Default POF Configuration File
3.4.2
Using the POF Configuration File System Property
3.4.3
Combining Multiple POF Configuration Files
3.4.4
Viewing Which POF Configuration Files are Loaded
3.5
Specifying Management Configuration Files
3.5.1
Specifying a Custom Report Group Configuration File
3.5.1.1
Overriding the Default Report Group Configuration File
3.5.1.2
Using the Report Group Configuration File System Property
3.5.2
Specifying an MBean Configuration File
3.5.2.1
Using the Default MBean Configuration Override File
3.5.2.2
Using the MBean Configuration File System Property
3.5.3
Viewing Which Management Configuration Files are Loaded
3.6
Disabling Schema Validation
3.7
Understanding the XML Override Feature
3.7.1
Using the Predefined Override Files
3.7.2
Defining Custom Override Files
3.7.3
Defining Multiple Override Files for the Same Element
3.8
Changing Configuration Using System Properties
3.8.1
Using Preconfigured System Properties
3.8.2
Creating Custom System Properties
4
Building Your First Coherence Application
4.1
Task 1: Define the Example Cache
4.2
Task 2: Configure and Start the Example Cluster
4.3
Task 3: Create and Run a Basic Coherence Standalone Application
4.3.1
Create the Sample Standalone Application
4.3.2
Run the Sample Standalone Application
4.3.3
Verify the Example Cache
4.4
Task 4: Create and Run a Basic Coherence JavaEE Web Application
4.4.1
Create the Sample Web Application
4.4.2
Deploy and Run the Sample Web Application
4.4.3
Verify the Example Cache
4.5
Using JDeveloper for Coherence Development
4.5.1
Running Coherence in JDeveloper
4.5.2
Viewing Thread Dumps in JDeveloper
4.5.3
Creating Configuration Files in JDeveloper
5
Debugging in Coherence
5.1
Overview of Debugging in Coherence
5.2
Configuring Logging
5.2.1
Changing the Log Level
5.2.2
Changing the Log Destination
5.2.2.1
Sending Log Messages to a File
5.2.3
Changing the Log Message Format
5.2.4
Setting the Logging Character Limit
5.2.5
Using JDK Logging for Coherence Logs
5.2.6
Using Log4J Logging for Coherence Logs
5.2.7
Using SLF4J for Coherence Logs
5.3
Performing Remote Debugging
5.4
Troubleshooting Coherence-Based Applications
5.4.1
Using Coherence Logs
5.4.2
Using JMX Management and Coherence Reports
5.4.3
Using JVM Options to Help Debug
5.4.4
Capturing Thread Dumps
5.4.5
Capturing Heap Dumps
5.4.6
Monitoring the Operating System
Part II Using Coherence Clusters
6
Introduction to Coherence Clusters
6.1
Cluster Overview
6.2
Understanding TCMP
6.3
Understanding Clustered Services
7
Setting Up a Cluster
7.1
Overview of Setting Up Clusters
7.2
Specifying a Cluster's Name
7.3
Specifying a Cluster Member's Identity
7.4
Configuring Multicast Communication
7.4.1
Specifying a Cluster's Multicast Address
7.4.1.1
Changing the Multicast Socket Interface
7.4.2
Disabling Multicast Communication
7.4.3
Specifying the Multicast Time-to-Live
7.4.4
Specifying the Multicast Join Timeout
7.4.5
Changing the Multicast Threshold
7.5
Specifying a Cluster Member's Unicast Address
7.6
Using Well Known Addresses
7.6.1
Specifying WKA Member Addresses
7.6.2
Specifying a WKA Address Provider
7.7
Enabling Single-Server Mode
7.8
Configuring Death Detection
7.8.1
Changing TCP-Ring Settings
7.8.2
Changing the Heartbeat Interval
7.8.3
Disabling Death Detection
7.9
Specifying Cluster Priorities
7.9.1
Specifying a Cluster Member's Priority
7.9.2
Specifying Communication Thread Priorities
7.9.3
Specifying Thread Priorities for Services
8
Starting and Stopping Cluster Members
8.1
Starting Cache Servers
8.1.1
Overview of the DefaultCacheServer Class
8.1.2
Starting Cache Servers From the Command Line
8.1.3
Starting Cache Servers Programmatically
8.2
Starting Cache Clients
8.2.1
Disabling Local Storage
8.2.2
Using the CacheFactory Class to Start a Cache Client
8.3
Stopping Cluster Members
8.3.1
Stopping Cluster Members From the Command Line
8.3.2
Stopping Cache Servers Programmatically
8.4
Performing a Rolling Restart
8.4.1
Prerequisites to Performing a Rolling Restart
8.4.2
Restarting Cache Servers for a Rolling Restart
9
Dynamically Managing Cluster Membership
9.1
Overview of Managing Cluster Membership
9.2
Using the Cluster and Service Objects
9.3
Using the Member Object
9.4
Listening to Member Events
10
Tuning TCMP Behavior
10.1
Overview of TCMP Data Transmission
10.2
Throttling Data Transmission
10.2.1
Adjusting Packet Flow Control Behavior
10.2.2
Disabling Packet Flow Control
10.2.3
Adjusting Packet Traffic Jam Behavior
10.3
Bundling Packets to Reduce Load
10.4
Changing Packet Retransmission Behavior
10.4.1
Changing the Packet Resend Interval
10.4.2
Changing the Packet Resend Timeout
10.4.3
Configuring Packet Acknowledgment Delays
10.5
Configuring the Size of the Packet Buffers
10.5.1
Understanding Packet Buffer Sizing
10.5.2
Configuring the Outbound Packet Buffer Size
10.5.3
Configuring the Inbound Packet Buffer Size
10.6
Adjusting the Maximum Size of a Packet
10.7
Changing the Packet Speaker Volume Threshold
10.8
Configuring the Incoming Message Handler
10.8.1
Changing the Time Variance
10.8.2
Disabling Negative Acknowledgments
10.9
Using Network Filters
10.9.1
Using the Compression Filter
10.9.1.1
Enabling the Compression Filter for Specific Services
10.9.1.2
Enabling the Compression Filter for All Services
10.9.1.3
Configuring the Compression Filter
10.9.2
Using Custom Network Filters
10.9.2.1
Declaring a Custom Filter
10.9.2.2
Enabling a Custom Filter for Specific Services
10.9.2.3
Enabling a Custom Filter for All Services
10.10
Changing the TCMP Socket Provider Implementation
10.10.1
Using the TCP Socket Provider
10.10.2
Using the SDP Socket Provider
10.10.3
Using the SSL Socket Provider
11
Using the Service Guardian
11.1
Overview
11.2
Configuring the Service Guardian
11.2.1
Setting the Guardian Timeout
11.2.1.1
Setting the Guardian Timeout for All Threads
11.2.1.2
Setting the Guardian Timeout Per Service Type
11.2.1.3
Setting the Guardian Timeout Per Service Instance
11.2.2
Using the Timeout Value From the PriorityTask API
11.2.3
Setting the Guardian Service Failure Policy
11.2.3.1
Setting the Guardian Failure Policy for All Threads
11.2.3.2
Setting the Guardian Failure Policy Per Service Type
11.2.3.3
Setting the Guardian Failure Policy Per Service Instance
11.2.3.4
Enabling a Custom Guardian Failure Policy
11.3
Issuing Manual Guardian Heartbeats
Part III Using Caches
12
Introduction to Coherence Caches
12.1
Understanding Distributed Caches
12.2
Understanding Replicated Caches
12.3
Understanding Optimistic Caches
12.4
Understanding Near Caches
12.5
Understanding Local Caches
12.6
Understanding Remote Caches
12.7
Summary of Cache Types
13
Configuring Caches
13.1
Overview
13.2
Defining Cache Mappings
13.2.1
Using Exact Cache Mappings
13.2.2
Using Name Pattern Cache Mappings
13.3
Defining Cache Schemes
13.3.1
Defining Distributed Cache Schemes
13.3.2
Defining Replicated Cache Schemes
13.3.3
Defining Optimistic Cache Schemes
13.3.4
Defining Local Cache Schemes
13.3.4.1
Controlling the Growth of a Local Cache
13.3.4.2
Specifying a Custom Eviction Policy
13.3.5
Defining Near Cache Schemes
13.3.5.1
Near Cache Invalidation Strategies
13.4
Using Scheme Inheritance
13.5
Using Cache Scheme Properties
13.6
Using Parameter Macros
13.6.1
Using User-Defined Parameter Macros
13.6.2
Using Predefined Parameter Macros
14
Implementing Storage and Backing Maps
14.1
Cache Layers
14.2
Local Storage
14.3
Operations
14.4
Capacity Planning
14.5
Using Partitioned Backing Maps
14.6
Using the Elastic Data Feature to Store Data
14.6.1
Journaling Overview
14.6.2
Defining Journal Schemes
14.6.2.1
Configuring a RAM Journal Backing Map
14.6.2.2
Configuring a Flash Journal Backing Map
14.6.2.3
Referencing a Journal Scheme
14.6.2.4
Using Journal Expiry and Eviction
14.6.2.5
Using a Journal Scheme for Backup Storage
14.6.2.6
Enabling a Custom Map Implementation for a Journal Scheme
14.6.3
Changing Journaling Behavior
14.6.3.1
Configuring the RAM Journal Resource Manager
14.6.3.2
Configuring the Flash Journal Resource Manager
14.7
Using Asynchronous Backup
14.8
Using Delta Backup
14.8.1
Enabling Delta Backup
14.8.2
Enabling a Custom Delta Backup Compressor
15
Caching Data Sources
15.1
Overview of Caching Data Sources
15.1.1
Pluggable Cache Store
15.1.2
Read-Through Caching
15.1.3
Write-Through Caching
15.1.4
Write-Behind Caching
15.1.4.1
Write-Behind Requirements
15.1.5
Refresh-Ahead Caching
15.2
Selecting a Cache Strategy
15.2.1
Read-Through/Write-Through versus Cache-Aside
15.2.2
Refresh-Ahead versus Read-Through
15.2.3
Write-Behind versus Write-Through
15.3
Creating a Cache Store Implementation
15.4
Plugging in a Cache Store Implementation
15.5
Sample Cache Store Implementation
15.6
Sample Controllable Cache Store Implementation
15.7
Implementation Considerations
15.7.1
Idempotency
15.7.2
Write-Through Limitations
15.7.3
Cache Queries
15.7.4
Re-entrant Calls
15.7.5
Cache Server Classpath
15.7.6
CacheStore Collection Operations
15.7.7
Connection Pools
16
Serialization Paged Cache
16.1
Understanding Serialization Paged Cache
16.2
Configuring Serialization Paged Cache
16.3
Optimizing a Partitioned Cache Service
16.4
Configuring for High Availability
16.5
Configuring Load Balancing and Failover
16.6
Supporting Huge Caches
17
Using Quorum
17.1
Overview of Using Quorum
17.2
Using the Cluster Quorum
17.2.1
Configuring the Cluster Quorum Policy
17.3
Using the Partitioned Cache Quorums
17.3.1
Configuring the Partitioned Cache Quorum Policy
17.4
Using the Proxy Quorum
17.4.1
Configuring the Proxy Quorum Policy
17.5
Using Custom Action Policies
17.5.1
Enabling Custom Action Policies
17.5.2
Enabling the Custom Failover Access Policy
18
Cache Configurations by Example
18.1
Local Caches (accessible from a single JVM)
18.1.1
In-memory Cache
18.1.2
Size Limited In-memory Cache
18.1.3
In-memory Cache with Expiring Entries
18.1.4
In-memory Cache with Disk Based Overflow
18.1.5
NIO In-memory Cache
18.1.6
Cache on Disk
18.1.7
Size Limited Cache on Disk
18.1.8
Persistent Cache on Disk
18.1.9
Cache of a Database
18.2
Clustered Caches (accessible from multiple JVMs)
18.2.1
Partitioned Cache
18.2.2
Partitioned Cache with Overflow
18.2.3
Partitioned Cache with Journal Storage
18.2.4
Partitioned Cache of a Database
18.2.5
Partitioned Cache with a Serializer
18.2.6
Near Cache
18.2.7
Replicated Cache
18.2.8
Replicated Cache with Overflow
19
Extending Cache Configuration Files
19.1
Introduction to Extending Cache Configuration Files
19.2
Declaring XML Namespaces
19.3
Creating Namespace Handlers
19.3.1
Implementing the Namespace Handler Interface
19.3.2
Extending the Namespace Handler Abstract Class
19.3.2.1
Registering Processors
19.3.2.2
Using Injection to Process Element Content
19.4
Example: the JNDI Resource Namespace Handler
19.4.1
Create the JNDI Resource Namespace Handler
19.4.2
Declare the JNDI Namespace Handler
19.4.3
Use the JNDI Resource Namespace Handler
Part IV Performing Data Grid Operations
20
Using Portable Object Format
20.1
Understanding Serialization in Coherence
20.2
Overview of POF Serialization
20.3
Using the POF API to Serialize Objects
20.3.1
Implementing the PortableObject Interface
20.3.2
Implementing the PofSerializer Interface
20.3.3
Guidelines for Assigning POF Indexes
20.3.4
Using POF Object References
20.3.4.1
Enabling POF Object References
20.3.4.2
Registering POF Object Identities for Circular and Nested Objects
20.3.5
Registering POF Objects
20.3.6
Configuring Coherence to Use the ConfigurablePofContext Class
20.3.6.1
Configure the ConfigurablePofContext Class Per Service
20.3.6.2
Configure the ConfigurablePofContext Class for All Services
20.3.6.3
Configure the ConfigurablePofContext Class For the JVM
20.4
Using POF Annotations to Serialize Objects
20.4.1
Annotating Objects for POF Serialization
20.4.2
Registering POF Annotated Objects
20.4.3
Generating a POF Configuration File
20.4.4
Enabling Automatic Indexing
20.4.5
Providing a Custom Codec
20.5
Using POF Extractors and POF Updaters
20.5.1
Navigating a POF object
20.5.2
Using POF Extractors
20.5.3
Using POF Updaters
20.6
Serializing Keys Using POF
21
Pre-Loading a Cache
21.1
Bulk Loading Data Into a Cache
21.2
Performing Distributed Bulk Loading
21.2.1
A Distributed Bulk Loading Example
22
Querying Data In a Cache
22.1
Query Overview
22.1.1
Query Concepts
22.2
Performing Queries
22.2.1
Efficient Processing of Filter Results
22.3
Using Query Indexes
22.3.1
Creating an Index
22.3.2
Creating User-Defined Indexes
22.3.2.1
Implementing the MapIndex Interface
22.3.2.2
Implementing the IndexAwareExtractor Interface
22.3.2.3
Using a Conditional Index
22.4
Performing Batch Queries
22.5
Performing Queries on Multi-Value Attributes
22.6
Using Chained Extractors
22.7
Evaluating Query Cost and Effectiveness
22.7.1
Creating Query Records
22.7.2
Interpreting Query Records
22.7.2.1
Query Explain Plan Record
22.7.2.2
Query Trace Record
22.7.3
Running The Query Record Example
23
Using Continuous Query Caching
23.1
Overview of Using Continuous Query Caching
23.1.1
Understanding Use Cases for Continuous Query Caching
23.2
Understanding the Continuous Query Cache Implementation
23.3
Constructing a Continuous Query Cache
23.3.1
Cleaning up the resources associated with a ContinuousQueryCache
23.4
Caching only keys, or caching both keys and values
23.4.1
CacheValues Property and Event Listeners
23.5
Listening to the ContinuousQueryCache
23.5.1
Achieving a Stable Materialized View
23.5.2
Support for Synchronous and Asynchronous Listeners
23.6
Making the ContinuousQueryCache Read-Only
24
Processing Data In a Cache
24.1
Overview of Processing Data In a Cache
24.1.1
Performing Targeted Processing
24.1.2
Performing Parallel Processing
24.1.3
Performing Query-Based Processing
24.1.4
Performing Data-Grid-Wide Processing
24.2
Using Agents for Targeted, Parallel and Query-Based Processing
24.2.1
Processing Entries in Multiple Caches
24.2.2
Ignoring the Results of an Entry Processor
24.2.3
Processing Entries Asynchronously
24.3
Performing Data Grid Aggregation
24.4
Performing Node-Based Processing
24.5
Using a Work Manager
25
Using Map Events
25.1
Overview of Map Events
25.1.1
Listener Interface and Event Object
25.1.2
Understanding Event Guarantees
25.1.3
Caches and Classes that Support Events
25.2
Signing Up for All Events
25.3
Using an Inner Class as a MapListener
25.4
Configuring a MapListener For a Cache
25.5
Signing Up For Events On Specific Identities
25.6
Filtering Events
25.7
Using Lite Events
25.8
Listening to Queries
25.8.1
Filtering Events Versus Filtering Cached Data
25.9
Using Synthetic Events
25.10
Using Backing Map Events
25.10.1
Producing Readable Backing MapListener Events from Distributed Caches
25.11
Using Synchronous Event Listeners
26
Controlling Map Operations with Triggers
26.1
Overview of Map Triggers
26.2
A Map Trigger Example
27
Using Live Events
27.1
Overview of Live Events
27.2
Understanding Live Event Types
27.2.1
Understanding Partitioned Cache Events
27.2.1.1
Entry Events
27.2.1.2
Entry Processor Events
27.2.2
Understanding Partitioned Service Events
27.2.2.1
Transfer Events
27.2.2.2
Transaction Events
27.2.3
Understanding Lifecycle Events
27.3
Handling Live Events
27.3.1
Creating Event Interceptors
27.3.2
Understanding Event Threading
27.3.3
Registering Event Interceptors
27.3.3.1
Registering Event Interceptors For a Specific Cache
27.3.3.2
Registering Event Interceptors For a Partitioned Service
27.3.3.3
Registering Event Interceptors For a Cache Configuration Factory
27.3.3.4
Using Custom Registration
27.3.3.5
Guidelines for Registering Event Interceptors
27.3.4
Chaining Event Interceptors
27.3.4.1
Specifying an Event Interceptor Chain Order
28
Using Coherence Query Language
28.1
Understanding Coherence Query Language Syntax
28.1.1
Query Syntax Basics
28.1.1.1
Using Path-Expressions
28.1.1.2
Using Bind Variables
28.1.1.3
Using Key and Value Pseudo-Functions
28.1.1.4
Using Aliases
28.1.1.5
Using Quotes with Literal Arguments
28.1.2
Retrieving Data
28.1.2.1
Retrieving Data from the Cache
28.1.2.2
Filtering Entries in a Result Set
28.1.3
Managing the Cache Lifecycle
28.1.3.1
Creating a Cache
28.1.3.2
Writing a Serialized Representation of a Cache to a File
28.1.3.3
Loading Cache Contents from a File
28.1.3.4
Removing a Cache from the Cluster
28.1.4
Working with Cache Data
28.1.4.1
Aggregating Query Results
28.1.4.2
Changing Existing Values
28.1.4.3
Inserting Entries in the Cache
28.1.4.4
Deleting Entries in the Cache
28.1.5
Working with Indexes
28.1.5.1
Creating an Index on the Cache
28.1.5.2
Removing an Index from the Cache
28.1.6
Issuing Multiple Query Statements
28.1.6.1
Processing Query Statements in Batch Mode
28.1.7
Viewing Query Cost and Effectiveness
28.2
Using the CohQL Command-Line Tool
28.2.1
Starting the Command-line Tool
28.2.2
Using Command-Line Tool Arguments
28.2.3
A Command-Line Example
28.3
Building Filters in Java Programs
28.4
Additional Coherence Query Language Examples
28.4.1
Simple SELECT * FROM Statements that Highlight Filters
28.4.2
Complex Queries that Feature Projection, Aggregation, and Grouping
28.4.3
UPDATE Examples
28.4.4
Key and Value Pseudo-Function Examples
29
Performing Transactions
29.1
Overview of Transactions
29.2
Using Explicit Locking for Data Concurrency
29.3
Using Entry Processors for Data Concurrency
29.4
Using the Transaction Framework API
29.4.1
Defining Transactional Caches
29.4.2
Performing Cache Operations within a Transaction
29.4.2.1
Using the NamedCache API
29.4.2.2
Using the Connection API
29.4.3
Creating Transactional Connections
29.4.4
Using Transactional Connections
29.4.4.1
Using Auto-Commit Mode
29.4.4.2
Setting Isolation Levels
29.4.4.3
Using Eager Mode
29.4.4.4
Setting Transaction Timeout
29.4.5
Using the OptimisticNamedCache Interface
29.4.6
Configuring POF When Performing Transactions
29.4.7
Configuring Transactional Storage Capacity
29.4.8
Performing Transactions from Java Extend Clients
29.4.8.1
Create an Entry Processor for Transactions
29.4.8.2
Configure the Cluster-Side Transaction Caches
29.4.8.3
Configure the Client-Side Remote Cache
29.4.8.4
Use the Transactional Entry Processor from a Java Client
29.4.9
Viewing Transaction Management Information
29.4.9.1
CacheMBeans for Transactional Caches
29.4.9.2
TransactionManagerBean
29.5
Using the Coherence Resource Adapter
29.5.1
Performing Cache Operations within a Transaction
29.5.1.1
Creating a Coherence Connection
29.5.1.2
Getting a Named Cache
29.5.1.3
Demarcating Transaction Boundaries
29.5.2
Packaging the Application
29.5.2.1
Configure the Connection Factory Resource Reference
29.5.2.2
Configure the Resource Adapter Module Reference
29.5.2.3
Include the Required Libraries
29.5.3
Using the Coherence Cache Adapter for Transactions
30
Working with Partitions
30.1
Specifying Data Affinity
30.1.1
Overview of Data Affinity
30.1.2
Specifying Data Affinity with a KeyAssociation
30.1.3
Specifying Data Affinity with a KeyAssociator
30.1.4
Deferring the Key Association Check
30.1.5
Example of Using Affinity
30.2
Changing the Number of Partitions
30.3
Changing the Partition Distribution Strategy
30.3.1
Specifying a Partition Assignment Strategy
30.3.2
Enabling a Custom Partition Assignment Strategy
31
Managing Thread Execution
31.1
Overview of Priority Tasks
31.2
Setting Priority Task Timeouts
31.2.1
Configuring Execution Timeouts
31.2.2
Command Line Options
31.3
Creating Priority Task Execution Objects
31.3.1
APIs for Creating Priority Task Objects
31.3.2
Errors Thrown by Task Timeouts
32
Constraints on Re-entrant Calls
32.1
Overview of Constraints on Re-Entrant Calls
32.2
Re-entrancy, Services, and Service Threads
32.2.1
Parent-Child Object Relationships
32.2.2
Avoiding Deadlock
32.3
Re-entrancy and Listeners
Part V Using the Coherence JCache Implementation
33
Introduction to Coherence JCache
33.1
Overview of the Coherence JCache Implementation
33.2
Comparison of JCache and NamedCache Features
33.3
Dependencies for Coherence JCache
33.4
Overview of Configuration for the Coherence JCache Provider
33.5
JCache Primer
33.5.1
What is JCache
33.5.2
JCache Caching Providers and Cache Managers
33.5.3
JCache Caches
33.5.4
JCache Cache Configuration
33.5.5
JCache Custom Programming
33.5.6
JCache Management
34
Building Your First Coherence JCache Application
34.1
Task 1: Create a Simple Object
34.2
Task 2: Store the Object in a Local Cache
34.2.1
Create the Sample JCache Application
34.2.2
Run the Sample JCache Application
34.3
Task 3: Configure an Example Cluster
34.4
Task 4: Store the Object in a Partitioned Cache
34.4.1
Start the Example Cache Server
34.4.2
Run The Application
34.4.3
Verify the Cache
34.5
Task 5: Store the Object in a Pass-Through Cache
34.5.1
Define the Example Cache
34.5.2
Start the Example Cache Server
34.5.3
Run the Application
34.5.4
Verify the Cache
35
Performing Basic Coherence JCache Tasks
35.1
Specifying Coherence as the JCache Provider
35.2
Creating Coherence JCache Caches
35.2.1
Creating Local Caches
35.2.2
Creating Partitioned Caches
35.2.3
Creating Pass-Through Caches
35.2.4
Using Native Coherence Functionality from JCache
35.2.4.1
Accessing NamedCache Instances from JCache
35.2.4.2
Using Coherence Configuration with JCache
35.3
Configuring Coherence JCache Caches
35.3.1
Setting Store-By Semantics
35.3.2
Setting Cache Entry Types
35.3.3
Setting Cache Expiry
35.3.4
Enabling Read-Through and Write-Through Caching
35.3.5
Enabling Management
35.4
Performing Cache Operations
35.5
Using Read-Through and Write-Through Caching
35.5.1
Providing a Read-Through Implementation
35.5.1.1
Pre-Loading a Cache
35.5.2
Providing a Write-Through Implementation
35.6
Configuring a JCache POF Configuration file
35.7
Viewing JCache Management Information
35.7.1
Understanding the CacheConfiguration MBean
35.7.1.1
Attributes
35.7.1.2
Operations
35.7.2
Understanding the CacheStatistics MBean
35.7.2.1
Attributes
35.7.2.2
Operations
35.7.3
Changing the Refresh Interval for Partitioned Cache Statistics
36
Using JCache Events
36.1
Overview of Using JCache Events
36.2
Creating Event Listeners
36.3
Creating Event Filters
36.4
Registering Event Listeners and Filters
36.4.1
Registering Event Listeners and Filters During Cache Configuration
36.4.2
Registering Event Listeners and Filters at Runtime
37
Processing JCache Entries
37.1
Overview of Processing JCache Entries
37.2
Creating Entry Processors
37.3
Using Entry Processors
37.3.1
Invoking Entry Processors for a Single Key
37.3.2
Invoking Entry Processors for Multiple Keys
Part VI Appendices
A
Operational Configuration Elements
A.1
Operational Deployment Descriptor
A.2
Operational Override File
Element Reference
access-controller
address-provider
address-providers
authorized-hosts
cache-factory-builder-config
callback-handler
cluster-config
cluster-quorum-policy
coherence
configurable-cache-factory-config
filter
filters
flashjournal-manager
flow-control
host-range
identity-asserter
identity-manager
identity-transformer
incoming-message-handler
init-param
init-params
instance
journaling-config
key-store
license-config
logging-config
management-config
mbean
mbeans
mbean-filter
member-identity
multicast-listener
notification-queueing
outgoing-message-handler
outstanding-packets
packet-buffer
packet-bundling
packet-delivery
packet-publisher
packet-size
packet-speaker
pause-detection
provider
ramjournal-manager
reporter
security-config
serializer
serializers
service
Initialization Parameter Settings
service-guardian
services
shutdown-listener
socket-address
socket-provider
socket-providers
ssl
tcp-ring-listener
traffic-jam
trust-manager
unicast-listener
volume-threshold
well-known-addresses
Attribute Reference
B
Cache Configuration Elements
B.1
Cache Configuration Deployment Descriptor
Element Reference
acceptor-config
address-provider
async-store-manager
authorized-hosts
back-scheme
backing-map-scheme
backup-storage
bdb-store-manager
bundle-config
cache-config
cache-mapping
cache-service-proxy
cachestore-scheme
caching-scheme-mapping
caching-schemes
class-scheme
custom-store-manager
defaults
distributed-scheme
external-scheme
flashjournal-scheme
front-scheme
http-acceptor
identity-manager
incoming-message-handler
initiator-config
init-param
init-params
instance
interceptor
interceptors
invocation-scheme
invocation-service-proxy
key-associator
key-partitioning
key-store
listener
local-address
local-scheme
memcached-acceptor
name-service-addresses
near-scheme
nio-file-manager
nio-memory-manager
operation-bundling
optimistic-scheme
outgoing-message-handler
overflow-scheme
paged-external-scheme
partition-listener
partitioned-quorum-policy-scheme
provider
proxy-config
proxy-scheme
proxy-quorum-policy-scheme
ramjournal-scheme
read-write-backing-map-scheme
remote-addresses
remote-cache-scheme
remote-invocation-scheme
replicated-scheme
resource-config
serializer
socket-address
socket-provider
ssl
tcp-acceptor
tcp-initiator
transactional-scheme
trust-manager
Attribute Reference
C
POF User Type Configuration Elements
C.1
POF Configuration Deployment Descriptor
Element Index
default-serializer
init-param
init-params
pof-config
serializer
user-type
user-type-list
D
System Property Overrides
D.1
Overview of System Property Overrides
D.2
Override Example
D.3
Preconfigured Override Values
E
The PIF-POF Binary Format
E.1
Overview of the PIF-POF Binary Format
E.2
Stream Format
E.2.1
Integer Values
E.2.2
Type Identifiers
E.3
Binary Formats for Predefined Types
E.3.1
Int
E.3.1.1
Coercion of Integer Types
E.3.2
Decimal
E.3.3
Floating Point
E.3.4
Boolean
E.3.5
Octet
E.3.6
Octet String
E.3.7
Char
E.3.8
Char String
E.3.9
Date
E.3.10
Year-Month Interval
E.3.11
Time
E.3.12
Time Interval
E.3.13
Date-Time
E.3.13.1
Coercion of Date and Time Types
E.3.14
Day-Time Interval
E.3.15
Collections
E.3.16
Arrays
E.3.17
Sparse Arrays
E.3.18
Key-Value Maps (Dictionaries)
E.3.19
Identity
E.3.20
Reference
E.4
Binary Format for User Types
E.4.1
Versioning of User Types
Scripting on this page enhances content navigation, but does not change the content in any way.