io.micronaut.inject.writer

Interface ClassWriterOutputVisitor

All Known Implementing Classes:

AbstractClassWriterOutputVisitor, AnnotationProcessingOutputVisitor, DirectoryClassWriterOutputVisitor

public interface ClassWriterOutputVisitor

Interface to be consumed by class writers allowing visiting file names and returning appropriate streams.

Author:

Graeme Rocher

Method Summary

Modifier and Type	Method and Description
void	finish() Finish writing and flush any service entries to disk.
default Map<String,Set<String>>	getServiceEntries() The META-INF/services entries to write.
OutputStream	visitClass(String classname) Visits a new class and returns the output stream with which should be written the bytes of the class to be generated.
Optional<GeneratedFile>	visitGeneratedFile(String path) Visit a file that will be generated within the generated sources directory.
Optional<GeneratedFile>	visitMetaInfFile(String path) Visit a file within the META-INF directory of the classes directory.
default void	visitServiceDescriptor(Class type, String classname) Allows adding a class that will be written to the META-INF/services file under the given type and class name.
void	visitServiceDescriptor(String type, String classname) Allows adding a class that will be written to the META-INF/services file under the given type and class name.

Method Detail

visitClass

OutputStream visitClass(String classname)
                 throws IOException

Visits a new class and returns the output stream with which should be written the bytes of the class to be generated.

Parameters:

classname - the fully qualified classname

Returns:

the output stream to write to

Throws:

IOException - if an error occurs creating the output stream

visitServiceDescriptor

void visitServiceDescriptor(String type,
                            String classname)

Allows adding a class that will be written to the META-INF/services file under the given type and class name.

Parameters:

type - the fully qualified service name

classname - the fully qualified classname

Throws:

IOException - If the file couldn't be created

visitMetaInfFile

Optional<GeneratedFile> visitMetaInfFile(String path)

Visit a file within the META-INF directory of the classes directory.

Parameters:

path - The path to the file

Returns:

An optional file it was possible to create it

Throws:

IOException - If the file couldn't be created

visitGeneratedFile

Optional<GeneratedFile> visitGeneratedFile(String path)

Visit a file that will be generated within the generated sources directory.

Parameters:

path - The path

Returns:

The file if it was possible to create it

finish

void finish()

Finish writing and flush any service entries to disk.

getServiceEntries

default Map<String,Set<String>> getServiceEntries()

The META-INF/services entries to write.

Returns:

A map of service to class entries

visitServiceDescriptor

default void visitServiceDescriptor(Class type,
                                    String classname)

Allows adding a class that will be written to the META-INF/services file under the given type and class name.

Parameters:

type - The service type

classname - the fully qualified classname

Throws:

IOException - If the file couldn't be created