Red Hat Summit Red Hat SummitSupportoConsoleSviluppatoriInizia una provaContatti

Questo contenuto non è disponibile nella lingua selezionata.

Chapter 380. YAML SnakeYAML DataFormat

Available as of Camel version 2.17

YAML is a Data Format to marshal and unmarshal Java objects to and from YAML.

For YAML to object marshalling, Camel provides integration with three popular YAML libraries:

Every library requires adding the special camel component (see "Dependency…​" paragraphs further down). By default Camel uses the SnakeYAML library.

380.1. YAML Options
Copia collegamento

The YAML SnakeYAML dataformat supports 11 options, which are listed below.

Expand
NameDefaultJava TypeDescription

library

SnakeYAML

YAMLLibrary

Which yaml library to use. By default it is SnakeYAML

unmarshalTypeName

 

String

Class name of the java type to use when unarmshalling

constructor

 

String

BaseConstructor to construct incoming documents.

representer

 

String

Representer to emit outgoing objects.

dumperOptions

 

String

DumperOptions to configure outgoing objects.

resolver

 

String

Resolver to detect implicit type

useApplicationContextClassLoader

true

Boolean

Use ApplicationContextClassLoader as custom ClassLoader

prettyFlow

false

Boolean

Force the emitter to produce a pretty YAML document when using the flow style.

allowAnyType

false

Boolean

Allow any class to be un-marshaled

typeFilter

 

List

Set the types SnakeYAML is allowed to un-marshall

contentTypeHeader

false

Boolean

Whether the data format should set the Content-Type header with the type from the data format if the data format is capable of doing so. For example application/xml for data formats marshalling to XML, or application/json for data formats marshalling to JSon etc.

380.2. Spring Boot Auto-Configuration
Copia collegamento

The component supports 12 options, which are listed below.

Expand
NameDescriptionDefaultType

camel.dataformat.yaml-snakeyaml.allow-any-type

Allow any class to be un-marshaled

false

Boolean

camel.dataformat.yaml-snakeyaml.constructor

BaseConstructor to construct incoming documents.

 

String

camel.dataformat.yaml-snakeyaml.content-type-header

Whether the data format should set the Content-Type header with the type from the data format if the data format is capable of doing so. For example application/xml for data formats marshalling to XML, or application/json for data formats marshalling to JSon etc.

false

Boolean

camel.dataformat.yaml-snakeyaml.dumper-options

DumperOptions to configure outgoing objects.

 

String

camel.dataformat.yaml-snakeyaml.enabled

Enable yaml-snakeyaml dataformat

true

Boolean

camel.dataformat.yaml-snakeyaml.library

Which yaml library to use. By default it is SnakeYAML

 

YAMLLibrary

camel.dataformat.yaml-snakeyaml.pretty-flow

Force the emitter to produce a pretty YAML document when using the flow style.

false

Boolean

camel.dataformat.yaml-snakeyaml.representer

Representer to emit outgoing objects.

 

String

camel.dataformat.yaml-snakeyaml.resolver

Resolver to detect implicit type

 

String

camel.dataformat.yaml-snakeyaml.type-filter

Set the types SnakeYAML is allowed to un-marshall

 

List

camel.dataformat.yaml-snakeyaml.unmarshal-type-name

Class name of the java type to use when unarmshalling

 

String

camel.dataformat.yaml-snakeyaml.use-application-context-class-loader

Use ApplicationContextClassLoader as custom ClassLoader

true

Boolean

Warning

SnakeYAML can load any class from YAML definition which may lead to security breach so by default, SnakeYAML DataForma restrict the object it can load to standard Java objects like List or Long. If you want to load custom POJOs you need to add theirs type to SnakeYAML DataFormat type filter list. If your source is trusted, you can set the property allowAnyType to true so SnakeYAML DataForma won’t perform any filter on the types.

380.3. Using YAML data format with the SnakeYAML library
Copia collegamento

  • Turn Object messages into yaml then send to MQSeries 

    from("activemq:My.Queue")
  .marshal().yaml()
  .to("mqseries:Another.Queue");
    Copy to Clipboard Toggle word wrap 
    from("activemq:My.Queue")
  .marshal().yaml(YAMLLibrary.SnakeYAML)
  .to("mqseries:Another.Queue");
    Copy to Clipboard Toggle word wrap

  • Restrict classes to be loaded from YAML 

    // Creat a SnakeYAMLDataFormat instance
SnakeYAMLDataFormat yaml = new SnakeYAMLDataFormat();

// Restrict classes to be loaded from YAML
yaml.addTypeFilters(TypeFilters.types(MyPojo.class, MyOtherPojo.class));

from("activemq:My.Queue")
  .unmarshal(yaml)
  .to("mqseries:Another.Queue");
    Copy to Clipboard Toggle word wrap

380.4. Using YAML in Spring DSL
Copia collegamento

When using Data Format in Spring DSL you need to declare the data formats first. This is done in the DataFormats XML tag. 

<dataFormats>
  <!--
    here we define a YAML data format with the id snake and that it should use
    the TestPojo as the class type when doing unmarshal. The unmarshalTypeName
    is optional
  -->
  <yaml
    id="snake"
    library="SnakeYAML"
    unmarshalTypeName="org.apache.camel.component.yaml.model.TestPojo"/>

  <!--
    here we define a YAML data format with the id snake-safe which restricts the
    classes to be loaded from YAML to TestPojo and those belonging to package
    com.mycompany
  -->
  <yaml id="snake-safe">
    <typeFilter value="org.apache.camel.component.yaml.model.TestPojo"/>
    <typeFilter value="com.mycompany\..*" type="regexp"/>
  </yaml>
</dataFormats>
Copy to Clipboard Toggle word wrap

And then you can refer to those ids in the route: 

  <route>
    <from uri="direct:unmarshal"/>
    <unmarshal>
      <custom ref="snake"/>
    </unmarshal>
    <to uri="mock:unmarshal"/>
  </route>
  <route>
    <from uri="direct:unmarshal-safe"/>
    <unmarshal>
      <custom ref="snake-safe"/>
    </unmarshal>
    <to uri="mock:unmarshal-safe"/>
  </route>
Copy to Clipboard Toggle word wrap

380.5. Dependencies for SnakeYAML
Copia collegamento

To use YAML in your camel routes you need to add the a dependency on camel-snakeyaml which implements this data format.

If you use maven you could just add the following to your pom.xml, substituting the version number for the latest & greatest release (see the download page for the latest versions). 

<dependency>
  <groupId>org.apache.camel</groupId>
  <artifactId>camel-snakeyaml</artifactId>
  <version>${camel-version}</version>
</dependency>
Copy to Clipboard Toggle word wrap
Torna in cima
Red Hat logoGithubredditYoutubeTwitter

Formazione

Prova, acquista e vendi

Community

Informazioni sulla documentazione di Red Hat

Aiutiamo gli utenti Red Hat a innovarsi e raggiungere i propri obiettivi con i nostri prodotti e servizi grazie a contenuti di cui possono fidarsi. Esplora i nostri ultimi aggiornamenti.

Rendiamo l’open source più inclusivo

Red Hat si impegna a sostituire il linguaggio problematico nel codice, nella documentazione e nelle proprietà web. Per maggiori dettagli, visita il Blog di Red Hat.

Informazioni su Red Hat

Forniamo soluzioni consolidate che rendono più semplice per le aziende lavorare su piattaforme e ambienti diversi, dal datacenter centrale all'edge della rete.

Theme

© 2025 Red Hat