Package org.infinispan.protostream.impl

Class AnnotatedDescriptorImpl

java.lang.Object

org.infinispan.protostream.impl.AnnotatedDescriptorImpl

All Implemented Interfaces:

AnnotatedDescriptor

Direct Known Subclasses:

FieldDescriptor, ReservableDescriptor

public abstract class AnnotatedDescriptorImpl
extends Object
implements AnnotatedDescriptor

Since:

2.0

Field Summary

Fields

Modifier and Type	Field	Description
protected Map<String,AnnotationElement.Annotation>	annotations	The annotations found in the documentation.
protected final String	documentation	The (optional) documentation comment.
protected String	fullName
private static final Log	log
protected final String	name
protected Map<String,Object>	processedAnnotations	The annotation metadata objects created by the AnnotationMetadataCreator based on the annotations found in the documentation text.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AnnotatedDescriptorImpl(String name, String fullName, String documentation)

Method Summary

Modifier and Type	Method	Description
protected abstract AnnotationConfiguration	getAnnotationConfig(AnnotationElement.Annotation annotation)	Subclasses are responsible for fetching the AnnotationConfiguration from the appropriate config (it it exists) and to validate that the target is suitable.
Map<String,AnnotationElement.Annotation>	getAnnotations()
protected Configuration.AnnotationsConfig	getAnnotationsConfig()
final String	getDocumentation()	Return the documentation text associated with this descriptor.
final String	getFullName()	Return the full name of the descriptor.
final String	getName()	Return the name of the descriptor.
<T> T	getProcessedAnnotation(String annotationName)	Get the 'processed' annotation object created by the registered AnnotationMetadataCreator or null if the annotation is missing or no AnnotationMetadataCreator was registered.
private void	normalizeValues(AnnotationElement.Annotation annotation, AnnotationConfiguration annotationConfig)
private void	processAnnotations()	Extract annotations by parsing the documentation comment and run the configured AnnotationMetadataCreators.
private void	validateAttribute(AnnotationElement.Annotation annotation, AnnotationElement.Attribute attribute, AnnotationAttributeConfiguration attributeConfig, AnnotationElement.Value value)
private void	validateAttributes(AnnotationElement.Annotation annotation, AnnotationConfiguration annotationConfig)

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.infinispan.protostream.descriptors.AnnotatedDescriptor

getFileDescriptor

Field Details

log

private static final Log log

name

protected final String name

fullName

protected String fullName

documentation

protected final String documentation

The (optional) documentation comment.

annotations

protected Map<String,AnnotationElement.Annotation> annotations

The annotations found in the documentation.

processedAnnotations

protected Map<String,Object> processedAnnotations

The annotation metadata objects created by the AnnotationMetadataCreator based on the annotations found in the documentation text.

Constructor Details

AnnotatedDescriptorImpl

protected AnnotatedDescriptorImpl(String name,
 String fullName,
 String documentation)

Method Details

getName

public final String getName()

Description copied from interface: AnnotatedDescriptor

Return the name of the descriptor.

Specified by:

getName in interface AnnotatedDescriptor

Returns:

the name of the descriptor (never null)

getFullName

public final String getFullName()

Description copied from interface: AnnotatedDescriptor

Return the full name of the descriptor.

Specified by:

getFullName in interface AnnotatedDescriptor

Returns:

the name of the descriptor (never null)

getDocumentation

public final String getDocumentation()

Description copied from interface: AnnotatedDescriptor

Return the documentation text associated with this descriptor.

Specified by:

getDocumentation in interface AnnotatedDescriptor

Returns:

the documentation text or null if not present

processAnnotations

private void processAnnotations()
                         throws AnnotationParserException

Extract annotations by parsing the documentation comment and run the configured AnnotationMetadataCreators.

Throws:

AnnotationParserException - if annotation parsing fails

validateAttributes

private void validateAttributes(AnnotationElement.Annotation annotation,
 AnnotationConfiguration annotationConfig)

validateAttribute

private void validateAttribute(AnnotationElement.Annotation annotation,
 AnnotationElement.Attribute attribute,
 AnnotationAttributeConfiguration attributeConfig,
 AnnotationElement.Value value)

normalizeValues

private void normalizeValues(AnnotationElement.Annotation annotation,
 AnnotationConfiguration annotationConfig)

getAnnotationsConfig

protected Configuration.AnnotationsConfig getAnnotationsConfig()

getAnnotationConfig

protected abstract AnnotationConfiguration getAnnotationConfig(AnnotationElement.Annotation annotation)
                                                        throws DescriptorParserException

Subclasses are responsible for fetching the AnnotationConfiguration from the appropriate config (it it exists) and to validate that the target is suitable.

Returns:

null if the annotation is not found

Throws:

DescriptorParserException - is the annotation target is not suitable for this descriptor

getAnnotations

public Map<String,AnnotationElement.Annotation> getAnnotations()
                                                        throws AnnotationParserException

Specified by:

getAnnotations in interface AnnotatedDescriptor

Throws:

AnnotationParserException

getProcessedAnnotation

public <T> T getProcessedAnnotation(String annotationName)
                             throws AnnotationParserException

Description copied from interface: AnnotatedDescriptor

Get the 'processed' annotation object created by the registered AnnotationMetadataCreator or null if the annotation is missing or no AnnotationMetadataCreator was registered.

Specified by:

getProcessedAnnotation in interface AnnotatedDescriptor

Type Parameters:

T - the expected type of the object created by the AnnotationMetadataCreator

Parameters:

annotationName - the name of the annotation

Returns:

the 'processed' annotation object or null if not found

Throws:

AnnotationParserException - if parsing of annotations fails