[id='cache-configuration_{context}']
= Cache configuration

You can create declarative cache configuration in XML, JSON, and YAML format.

All declarative caches must conform to the {brandname} schema.
Configuration in JSON format must follow the structure of an XML configuration, elements correspond to objects and attributes correspond to fields.

[IMPORTANT]
====
{brandname} restricts characters to a maximum of `255` for a cache name or a cache template name.
If you exceed this character limit, {brandname} throws an exception.
Write succinct cache names and cache template names.
====

[IMPORTANT]
====
A file system might set a limitation for the length of a file name, so ensure that a cache's name does not exceed this limitation.
If a cache name exceeds a file system's naming limitation, general operations or initialing operations towards that cache might fail. 
Write succinct file names.
====

[discrete]
== Distributed caches

.XML
[source,xml,options="nowrap",subs=attributes+,role="primary"]
----
include::xml/distributed_cache.xml[]
----

.JSON
[source,json,options="nowrap",subs=attributes+,role="secondary"]
----
include::json/distributed_cache.json[]
----

.YAML
[source,yaml,options="nowrap",subs=attributes+,role="secondary"]
----
include::yaml/distributed_cache.yaml[]
----

[discrete]
== Replicated caches

.XML
[source,xml,options="nowrap",subs=attributes+,role="primary"]
----
include::xml/replicated_cache.xml[]
----

.JSON
[source,json,options="nowrap",subs=attributes+,role="secondary"]
----
include::json/replicated_cache.json[]
----

.YAML
[source,yaml,options="nowrap",subs=attributes+,role="secondary"]
----
include::yaml/replicated_cache.yaml[]
----

[discrete]
== Multiple caches

.XML
[source,xml,options="nowrap",subs=attributes+]
----
include::xml/infinispan_caches.xml[]
----

.YAML
[source,yaml,options="nowrap",subs=attributes+]
----
include::yaml/infinispan_caches.yaml[]
----

.JSON
[source,json,options="nowrap",subs=attributes+]
----
include::json/infinispan_caches.json[]
----

[role="_additional-resources"]
.Additional resources
* link:{configdocroot}[{brandname} configuration schema reference]
* link:http://infinispan.org/schemas/infinispan-config-{infinispanversion}.xsd[infinispan-config-{infinispanversion}.xsd]
