Package org.bson.codecs.pojo

Class PojoCodecProvider.Builder

  • Enclosing class:
    PojoCodecProvider

    public static final class PojoCodecProvider.Builder
extends Object
    A Builder for the PojoCodecProvider

    • Method Detail

      • build

        public PojoCodecProvider build​()
        Creates the PojoCodecProvider with the classes or packages that configured and registered.
        Returns:
        the Provider
        See Also:
        register(Class...)

      • automatic

        public PojoCodecProvider.Builder automatic​(boolean automatic)
        Sets whether the provider should automatically try to create a ClassModel for any class that is requested.

        Note: As Java Beans are convention based, when using automatic settings the provider should be the last provider in the registry.

        Parameters:
        automatic - whether to automatically create ClassModels or not.
        Returns:
        this

      • conventions

        public PojoCodecProvider.Builder conventions​(List<Convention> conventions)
        Sets the conventions to use when creating ClassModels from classes or packages.
        Parameters:
        conventions - a list of conventions
        Returns:
        this

      • register

        public PojoCodecProvider.Builder register​(Class<?>... classes)
        Registers a classes with the builder for inclusion in the Provider.

        Note: Uses reflection for the property mapping. If no conventions are configured on the builder the Conventions.DEFAULT_CONVENTIONS will be used.

        Parameters:
        classes - the classes to register
        Returns:
        this

      • register

        public PojoCodecProvider.Builder register​(ClassModel<?>... classModels)
        Registers classModels for inclusion in the Provider.
        Parameters:
        classModels - the classModels to register
        Returns:
        this

      • register

        public PojoCodecProvider.Builder register​(String... packageNames)
        Registers the packages of the given classes with the builder for inclusion in the Provider. This will allow classes in the given packages to mapped for use with PojoCodecProvider.

        Note: Uses reflection for the field mapping. If no conventions are configured on the builder the Conventions.DEFAULT_CONVENTIONS will be used.

        Parameters:
        packageNames - the package names to register
        Returns:
        this

      • register

        public PojoCodecProvider.Builder register​(PropertyCodecProvider... providers)
        Registers codec providers that receive the type parameters of properties for instances encoded and decoded by a PojoCodec handled by this provider.

        Note that you should prefer working with the CodecRegistry/CodecProvider hierarchy. Providers should only be registered here if a codec needs to be created for custom container types like optionals and collections. Support for types Map and Collection are built-in so explicitly handling them is not necessary.

        Parameters:
        providers - property codec providers to register
        Returns:
        this
        Since:
        3.6