fable::Confable Class Reference

Inheritance diagram for fable::Confable:

Public Member Functions
	Confable (const Confable &) noexcept
	Confable (Confable &&) noexcept=default
Confable &	operator= (const Confable &other) noexcept
Confable &	operator= (Confable &&other) noexcept
virtual void	reset_schema ()
Schema &	schema ()
const Schema &	schema () const
virtual void	validate_or_throw (const Conf &c) const
virtual bool	validate (const Conf &c, std::optional< SchemaError > &err) const
virtual void	from_conf (const Conf &c)
virtual void	to_json (Json &j) const
Json	to_json () const

Protected Member Functions
virtual Schema	schema_impl ()

Member Function Documentation

from_conf()

void Confable::from_conf ( const Conf &  c )

virtual

Deserialize a Confable from a Conf.

Unless you have special needs, it is recommended to implement

Schema schema_impl()

and use the default implementation of this.

Reimplemented in cloe::Frustum, cloe::Command, cloe::component::NormalDistribution< T >, cloe::utility::ContactMap< D >, cloe::utility::ContactMap< Duration >, cloe::Stack, cloe::VehicleConf, cloe::FromSimulator, and cloe::PersistentConfable.

Here is the call graph for this function:

Here is the caller graph for this function:

reset_schema()

void Confable::reset_schema ( )

virtual

Reset the internal schema cache.

This causes schema_impl to be called next time the schema is requested.

Reimplemented in cloe::Stack.

Here is the caller graph for this function:

schema() [1/2]

Schema & Confable::schema

(

)

Return the object schema for deserialization.

This method uses schema_impl under the hood, which the object should implement.

Here is the call graph for this function:

Here is the caller graph for this function:

schema() [2/2]

const Schema & Confable::schema

(

)

const

Return the object schema for description and validation.

This method uses schema_impl under the hood, which the object should implement.

Here is the call graph for this function:

schema_impl()

Schema Confable::schema_impl ( )

protectedvirtual

Return a new instance of the schema for this object.

This schema is then stored in schema_. This is called every time the object is created or moved, since Schema contains references to fields that (should be) in the object.

Reimplemented in cloe::component::NormalDistribution< T >, cloe::LaneBoundary, and cloe::Frustum.

Here is the caller graph for this function:

to_json() [1/2]

Json Confable::to_json

(

)

const

Serialize a Confable to Json.

Here is the caller graph for this function:

to_json() [2/2]

void Confable::to_json ( Json &  j ) const

virtual

Serialize a Confable to Json.

Note: If you implement this type, make sure to either use CONFABLE_FRIENDS or a using Confable::to_json statement in your derived type.

Reimplemented in cloe::LaneBoundary, and cloe::Frustum.

Here is the call graph for this function:

validate()

bool Confable::validate ( const Conf &  c, std::optional< SchemaError > &  err  ) const

virtual

Validate a Conf without applying it and without throwing.

By default, this uses the validate() method on schema(). If you want to guarantee anything extending beyond what's possible with schema, you can do that here.

This method should NOT call from_conf without also overriding from_conf to prevent infinite recursion.

This method should not reset err unless the method returns false.

Parameters

c	JSON to validate
err	reference to store error in

Returns

true if validate successful

Reimplemented in cloe::Stack, and cloe::LoggingConf.

Here is the call graph for this function:

Here is the caller graph for this function:

validate_or_throw()

void Confable::validate_or_throw ( const Conf &  c ) const

virtual

Validate a Conf without applying it.

By default, this uses the validate_or_throw() method on schema(). If you want to guarantee anything extending beyond what's possible with schema, you can do that here.

This method should NOT call from_conf without also overriding from_conf to prevent infinite recursion.

Reimplemented in cloe::Stack.

Here is the call graph for this function:

Here is the caller graph for this function:

---

The documentation for this class was generated from the following files:

• /home/docs/checkouts/readthedocs.org/user_builds/cloe/checkouts/develop/fable/include/fable/confable.hpp
• /home/docs/checkouts/readthedocs.org/user_builds/cloe/checkouts/develop/fable/src/fable/confable.cpp