Contents

List of Examples

List of Figures

List of Tables

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents
• Conventions

Part I Coherence for C++

1 Requirements, Installation, and Deployment for Coherence for C++

• Package Requirements
• Supported Environments
• Installing Coherence for C++
• Building Coherence-Based Applications
  • Compiler Settings
  • Coherence Header Files
  • Linking
  • Runtime Library and Search Path
• Deploying Coherence for C++

2 Understanding the Coherence C++ Object Model

• Using the Object Model
  • Coherence Namespaces
  • Understanding the Base Object
  • Automatically Managed Memory
    • Referencing Managed Objects
    • Using handles
    • Managed Object Instantiation
  • Managed Strings
    • String Instantiation
    • Auto-Boxed Strings
  • Type Safe Casting
    • Down Casting
  • Managed Arrays
  • Collection Classes
  • Managed Exceptions
  • Object Immutability
  • Integrating Existing Classes into the Object Model
• Writing New Managed Classes
  • Specification-Based Managed Class Definition
  • Equality, Hashing, Cloning, Immutability, and Serialization
  • Threading
  • Weak References
  • Virtual Constructors
  • Advanced Handle Types
  • Thread Safety
    • Synchronization and Notification
    • Thread Safe Handles
    • Escape Analysis
    • Thread-Local Allocator
• Diagnostics and Troubleshooting
  • Thread Dumps
  • Memory Leak Detection
  • Memory Corruption Detection
• Application Launcher - Sanka
  • Command line syntax
  • Built-in Executables
  • Sample Custom Executable Class

3 Building Integration Objects for C++ Clients

• POF Intrinsics
• Serialization Options
  • Managed<T> (Free-Function Serialization)
  • PortableObject (Self-Serialization)
  • PofSerializer (External Serialization)
• POF Registration
• Need for Java Classes
• Performance

4 Configuration and Usage for C++ Clients

• General Instructions
• Implementing the C++ Application
• Compiling and Linking the Application
• Configure Paths
• Configure Coherence*Extend
  • Configure Coherence*Extend in the Cluster
  • Configuring Coherence*Extend on the Client
  • Connection Error Detection and Failover
• Configuring and Using the Coherence for C++ Client Library
  • Setting the Configuration File Location with an Environment Variable
  • Setting the Configuration File Location Programmatically
• Operational Configuration File (tangosol-coherence-override.xml)
• Configuring a Logger
• Launching a Coherence DefaultCacheServer Proxy

5 Understanding the Coherence for C++ API

• CacheFactory
• NamedCache
• QueryMap
• ObservableMap
• InvocableMap
• Filter
• Value Extractors
• Entry Processors
• Entry Aggregators

6 Sample Applications for C++ Clients

• Prerequisites for Building and Running the Sample Applications
• Starting a Coherence Proxy Service and Cache Server
• Building the Sample Applications
• Starting a Sample Application
• Running the hellogrid Example
• Running the console Example
• Running the contacts Example

7 Configuring a Local Cache for C++ Clients

• Configuring the Local Cache
• Obtaining a Local Cache Reference for C++ Clients
• Cleaning Up Resources Associated with a LocalCache

8 Configuring a Near Cache for C++ Clients

• Configuring the Near Cache
• Obtaining a Near Cache Reference with C++
• Cleaning up Resources Associated with a Near Cache

9 Perform Continuous Query for C++ Clients

• Uses of Continuous Query Caching
• The Coherence Continuous Query Cache
• Defining a Continuous Query Cache
• Cleaning up Resources Associated with a Continuous Query Cache
• Caching Only Keys, or Caching Both Keys and Values
  • CacheValues Property and Event Listeners
  • Using ReflectionExtractor with Continuous Query Caches
• Listening to the Continuous Query Cache
  • Avoiding Unexpected Results
  • Achieving a Stable Materialized View
  • Support for Synchronous and Asynchronous Listeners
• Making the Continuous Query Cache Read-Only

10 Query the Cache for C++ Clients

• Query Functionality
• Simple Queries
  • Querying Partitioned Caches
  • Querying Near Caches
• Query Concepts
• Queries Involving Multi-Value Attributes
• ChainedExtractor

11 Remote Invocation Service for C++ Clients

• Configuring and Using the Remote Invocation Service
• Registering Invocable Implementation Classes

12 Deliver Events for Changes as they Occur (C++)

• Listener Interface and Event Object
• Caches and Classes that Support Events
• Signing Up for all Events
• MultiplexingMapListener
• Configuring a MapListener for a Cache
• Signing Up for Events on Specific Identities
• Filtering Events
• "Lite" Events
• Advanced: Listening to Queries
• Advanced: Synthetic Events
• Advanced: Backing Map Events
• Advanced: Synchronous Event Listeners
• Summary

Part II Coherence for .NET

13 Requirements, Installation and Deployment for Coherence for .NET

• Package Requirements
• Installation
• Deployment

14 Configuration and Usage for .NET Clients

• General Instructions
• Configuring Coherence*Extend
  • Configuring Coherence*Extend in the Cluster
  • Configuring Coherence*Extend on the Client
  • Connection Error Detection and Failover

15 Building Integratable Objects for .NET Clients

• Configuring a POF Context
  • Creating an IPortableObject Implementation (.NET)
  • Creating a PortableObject Implementation (Java)
  • Registering Custom Types on the .NET Client
  • Registering Custom Types in the Cluster
  • Evolvable Portable User Types
  • Making Types Portable Without Modification
• Configuring and Using the Coherence for .NET Client Library
  • CacheFactory
  • IConfigurableCacheFactory
  • DefaultConfigurableCacheFactory
  • Logger
  • Using the Common.Logging Library
  • INamedCache
  • IQueryCache
  • IObservableCache
  • IInvocableCache
  • Filters
  • Value Extractors
  • Entry Processors
  • Entry Aggregators
• Launching a Coherence DefaultCacheServer Process

16 Configuring a Local Cache for .NET Clients

• Configuring the Local Cache
• Obtaining a Local Cache Reference for .NET Clients
• Cleaning Up Resources Associated with a LocalCache

17 Configuring a Near Cache for .NET Clients

• Configuring the Near Cache
• Obtaining a Near Cache Reference with .NET
• Cleaning up Resources Associated with a NearCache

18 Continuous Query Cache for .NET Clients

• Uses of Continuous Query Caching
• The Continuous Query Cache
• Constructing a Continuous Query Cache
• Cleaning up Resources Associated with a ContinuousQueryCache
• Semi- and Fully-Materialized Views
• Listening to a Continuous Query Cache
  • Achieving a Stable Materialized View
  • Support for Synchronous and Asynchronous Listeners
• Making a Continuous Query Cache Read-Only

19 Remote Invocation Service for .NET Clients

• Configuring and Using the Remote Invocation Service

20 Special Considerations—Windows Forms Applications for .NET Clients

21 Special Considerations—Web Applications for .NET Clients

22 Network Filters for .NET Clients

• Custom Filters
• Configuring Filters

23 Sample Windows Forms Application for .NET Clients

• General Instructions
• Create a Windows Application Project
• Add a Reference to the Coherence for .NET Library
• Create an App.config File
• Create Coherence for .NET Configuration Files
• Create and Design the Application
• Implement the Application

24 Sample Web Application for .NET Clients

• General Instructions
• Create an ASP.NET Project
• Add a Reference to the Coherence for .NET Library
• Configure the Web.config File
• Create Coherence for .NET Configuration Files
• Create the Web Form
• Implement the Web Application
  • Global.asax File
  • Business Object Definition
  • Service Layer Implementation
  • Code-behind the ASP.NET Page

A Sample C++ Applications

• Sample Code for the hellogrid Example
• Sample Code for the console Example
• Sample Code for the contacts Example
  • ContactInfo.hpp
  • ContactInfo.cpp
  • ContactInfoSerializer.cpp
  • contacts.cpp