Coherence Configuration Enhancements - Part 3 - Creating Custom Configuration Namespaces

Coherence 12.1.2 Configuration EnhancementsPart 3: Creating Custom Configuration NamespacesBrian OliverSenior Consulting Member of StaffCloud Application Foundation - Oracle Coherence

Oracle Fusion Middleware 12c Cloud Application Foundation

Coherence 12.1.2

The following is intended to outline our general product direction. It is intended for information purposes only, and may not be incorporated into any contract. It is not a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. The development, release, and timing of any features or functionality described for Oracle’s products remains at the sole discretion of Oracle.

The Agenda…

Coherence 12.1.2 ConfigurationEnhancements…• Your First Custom Configuration Namespace

– HelloWorld for Namespaces!

• Coherence Cache Configuration Model– Important JavaDocs!

• Summary

Your First Custom Configuration Namespace…

The Hello World Example<cache-config xmlns="http://xmlns.oracle.com/coherence/coherence-cache-config" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance” xmlns:helloworld=“class://HelloWorldNamespaceHandler” xsi:schemaLocation="http://xmlns.oracle.com/coherence/coherence-cache-config coherence-cache-config.xsd">

<helloworld:greeting>Gudday</helloworld:greeting>

<caching-scheme-mapping> <cache-mapping> <cache-name>dist-*</cache-name> <scheme-name>distributed-scheme</scheme-name> </cache-mapping> </caching-scheme-mapping>

<caching-schemes> <distributed-scheme> <scheme-name>distributed-scheme</scheme-name> <service-name>DistributedCache</service-name>

<backing-map-scheme> <local-scheme/> </backing-map-scheme> <autostart>true</autostart> </distributed-scheme> </caching-schemes></cache-config>

The Hello World Example<cache-config xmlns="http://xmlns.oracle.com/coherence/coherence-cache-config" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance” xmlns:helloworld=“class://HelloWorldNamespaceHandler” xsi:schemaLocation="http://xmlns.oracle.com/coherence/coherence-cache-config coherence-cache-config.xsd">

<helloworld:greeting>Gudday</helloworld:greeting>

<caching-scheme-mapping> <cache-mapping> <cache-name>dist-*</cache-name> <scheme-name>distributed-scheme</scheme-name> </cache-mapping> </caching-scheme-mapping>

<caching-schemes> <distributed-scheme> <scheme-name>distributed-scheme</scheme-name> <service-name>DistributedCache</service-name>

<backing-map-scheme> <local-scheme/> </backing-map-scheme> <autostart>true</autostart> </distributed-scheme> </caching-schemes></cache-config>

Your First Custom Configuration Namespace…

• Four Steps to Writing and Using Namespaces1. Create a NamespaceHandler

• Extend com.tangosol.config.xml.AbstractNamespaceHandler• Or implement com.tangosol.config.xml.NamespaceHandler

2. Create XSD for the Namespace (optional)

3. Develop Xml Content Processors for your custom Xml Content

4. Leverage Coherence Lifecycle Events (optional)

A Basic HelloWorldNamespaceHandler

import com.tangosol.config.xml.AbstractNamespaceHandler;import com.tangosol.config.xml.ProcessingContext;import com.tangosol.run.xml.XmlElement;

import java.net.URI;

/** * A Simple Hello World NamespaceHandler. * * @author Brian Oliver */public class HelloWorldNamespaceHandler extends AbstractNamespaceHandler{ @Override public void onStartNamespace(ProcessingContext context, XmlElement element, String prefix, URI uri) { super.onStartNamespace(context, element, prefix, uri);

System.out.println("Hello World Namespace Started"); }}

What about <helloworld:greeting/>?

• The Detail…– The Configuration Framework delegates Xml content processing to

NamespaceHandler provided Content “processors”– Xml Content Processors “process” Xml content that belongs to a

namespace

• So… We must define an appropriate Xml ElementProcessor for the <helloworld:greeting> element in our NamespaceHandler

HelloWorldNamespaceHandlerpublic class HelloWorldNamespaceHandler extends AbstractNamespaceHandler{ @Override public void onStartNamespace(ProcessingContext context, XmlElement element, String prefix, URI uri) { super.onStartNamespace(context, element, prefix, uri); System.out.println("Hello World Namespace Started"); }

@XmlSimpleName("greeting") public static class GreetingProcessor implements ElementProcessor<Void> { @Override public Void process(ProcessingContext context, XmlElement element) throws ConfigurationException { System.out.println(”Greeting was [" + element.getString() + “]”); return null; } }}

AbstractNamespaceHandler…

• Provides auto discovery of Xml Processors using Annotations– Supports manual registration through explicit calls

• Internally tracks known Processors

• Provides default behaviors for unknown Xml Content

• Advanced… – Can “inject” values into Objects– Can “create” values from known Xml content types– Can “auto-create” Processors for Annotated Types

AbstractNamespaceHandler classpublic abstract class AbstractNamespaceHandler implements com.tangosol.config.xml.NamespaceHandler { public AbstractNamespaceHandler(); . . .

public void registerProcessor(Class<?> processorClass); public void registerProcessor(String localName, ElementProcessor<?> processor); public void registerProcessor(String localName, AttributeProcessor<?> processor);

public <T> void registerElementType(String localName, Class<T> elementClass); public <T> void registerAttributeType(String localName, Class<T> attributeClass);

protected AttributeProcessor<?> onUnknownAttribute(XmlAttribute attribute); protected ElementProcessor<?> onUnknownElement(XmlElement element);

. . .}

Hello World in Action!

Custom Configuration Namespace Development

• How to think about the Cache Configuration XML…– When “processed” Xml Content “produces” a specific type of instance– The Framework processes Xml documents to produce “configurations”

– For Example:<cache-config> produces a CacheConfig

<class-scheme> produces a ClassScheme

<distributed-scheme> produces a DistributedScheme

Coherence 12.1.2 Custom Configuration Namespaces

• How to think about the Cache Configuration XML?– NamespaceHandlers define Element/Attribute Processors for XML in a

Namespace

• ElementProcessor<?>’s…– Are responsible for processing Xml Elements to produce values

• AttributeProcessor<?>’s…– Are responsible for processing Xml Attributes to produce values

Important Packages…

• The com.tangosol.coherence.config package– Defines the runtime configuration model for Coherence 12.1.2– Defines the Coherence Cache Configuration Namespace Handler– Defines the Coherence Xml Element and Attribute Processors– Defines Classes produced by the *Processors

• The com.tangosol.config package– Defines the Configuration Framework for Coherence 12.1.2– The core framework that processes Xml Documents

Summary

• Coherence 12.1.2 introduces Custom Namespace Configurations– Allows integration of third-party frameworks directly into Coherence– Allows independent development of extensions– Allows customization of Coherence

Next Part?

• Developing a Cron service using Custom Namespaces– Leverage the Coherence Configuration Framework– Leverage the Coherence Configuration Model– Leverage the Coherence Configuration Lifecycle

Join the Coherence Community

http://coherence.oracle.com

@OracleCoherence

/OracleCoherence

blogs.oracle.com/OracleCoherence

Group: Oracle Coherence Users

/OracleCoherence

coherence.oracle.com/display/CSIGCoherence Special Interest Group

The proceeding is intended to outline our general product direction. It is intended for information purposes only, and may not be incorporated into any contract. It is not a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. The development, release, and timing of any features or functionality described for Oracle’s products remains at the sole discretion of Oracle.

Coherence 12.1.2 Configuration EnhancementsPart 3: Creating Custom Configuration NamespacesBrian OliverSenior Consulting Member of StaffCloud Application Foundation - Oracle Coherence

Oracle Fusion Middleware 12c Cloud Application Foundation

Coherence 12.1.2

Coherence Configuration Enhancements - Part 3 - Creating Custom Configuration Namespaces

Technology

Transcript of Coherence Configuration Enhancements - Part 3 - Creating Custom Configuration Namespaces

IST346: Namespaces Directories Documentation.

Namespaces in SPKI

LSA2 - 02 Namespaces

Autoloading & Namespaces

Linux network namespaces

XML Namespaces

The way to run virtualized containers Kata Containers · Containers 101 Host Linux kernel namespaces Process namespaces Process namespaces Process CPU Memory Network Storage

Namespaces in the Wild2

Generic Orders and Order Menus. Learning Objectives Understand construction and configuration of generic orders and order menus. Be familiar with namespaces.

IFLA Namespaces

WinJS Classes and Namespaces

Namespaces for Kazimir

Spring in Action - pudn.comread.pudn.com/downloads166/ebook/759918/springonaction.pdfWhat’s new in Spring 2 • New/extensible configuration namespaces • Easier AOP and support

Mastering Namespaces in PHP

Chapter 3: XML Namespaces. Chapter 3 Objectives Why you need namespaces What namespaces are, conceptually and how they solve the problem of naming clashes.

WORKING WITH NAMESPACES

Setting Up Namespaces

Namespaces and Autoloading

Literal Notation for Arrays and Namespaces AdámBrudzewsky · for Arrays and Namespaces AdámBrudzewsky. 1 #dyalog17 Literal Notation for Arrays and Namespaces adam@dyalog.com Literal

Oracle Fusion Middleware 12c - Oracle Coherence Community · • The com.tangosol.coherence.config package… – Defines the runtime* configuration model for Coherence 12.1.2 –