com.facebook.buck.parser.api

Class BuildFileManifestPojoizer

java.lang.Object

com.facebook.buck.parser.api.BuildFileManifestPojoizer

public class BuildFileManifestPojoizer
extends Object

Utility class to convert parser-created objects to equivalent POJO-typed objects

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	BuildFileManifestPojoizer.PojoTransformer Container to hold transformation function for classes assignable to a provided class.

Method Summary

Modifier and Type	Method and Description
BuildFileManifestPojoizer	addPojoTransformer(BuildFileManifestPojoizer.PojoTransformer customTransformer) Add a custom transformer to BuildFileManifestPojoizer.
Object	convertToPojo(Object parserObj) Recursively convert parser-created objects into equivalent POJO objects.
static BuildFileManifestPojoizer	of() Create an instance of BuildFileManifestPojoizer

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

of

public static BuildFileManifestPojoizer of()

Create an instance of BuildFileManifestPojoizer

addPojoTransformer

public BuildFileManifestPojoizer addPojoTransformer(BuildFileManifestPojoizer.PojoTransformer customTransformer)

Add a custom transformer to BuildFileManifestPojoizer. If a type specified in this transfomer matches the type of parser object, the transformation function is invoked. It is expected for transformation function to return POJO-type accepted by BuildFileManifest.

This utility exists mainly to decouple some specific types known to some parser only, from generic parser API

This method effectively makes BuildFileManifestPojoizer mutable. This is only because the implementation of the transformer may want to recursively call convertToPojo(java.lang.Object) so BuildFileManifestPojoizer should be constructed beforehand.

convertToPojo

public Object convertToPojo(Object parserObj)

Recursively convert parser-created objects into equivalent POJO objects. All collections are replaced with Immutable collections. So, by contract, only the following collections are allowed to be in converted objects: ImmutableList, ImmutableSet, ImmutableSortedSet, ImmutableMap, ImmutableSortedMap. Any of concrete implementation of those abstract immutable collections is allowed.

Other allowed types are primitive Java types, Optional, and classes from com.facebook.buck.parser.api package.

This function is allowed to be called from transformer function for full recursion

Examples: SkylarkDict is replaced with ImmutableMap, SkylarkList is replaced with ImmutableList recursively