org.eclipse.jetty.webapp

Class MetaData

java.lang.Object

org.eclipse.jetty.webapp.MetaData

public class MetaData
extends Object

MetaData All data associated with the configuration and deployment of a web application.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MetaData.OriginInfo

Field Summary

Fields

Modifier and Type	Field and Description
protected Map<Resource,List<DiscoveredAnnotation>>	_annotations
protected List<DescriptorProcessor>	_descriptorProcessors
protected boolean	_metaDataComplete
protected List<Resource>	_orderedContainerResources
protected List<Resource>	_orderedWebInfResources
protected Ordering	_ordering
protected Map<String,MetaData.OriginInfo>	_origins
protected WebDescriptor	_webDefaultsRoot
protected Map<String,FragmentDescriptor>	_webFragmentNameMap
protected Map<Resource,FragmentDescriptor>	_webFragmentResourceMap
protected List<FragmentDescriptor>	_webFragmentRoots
protected List<Resource>	_webInfClasses
protected List<Resource>	_webInfJars
protected List<WebDescriptor>	_webOverrideRoots
protected WebDescriptor	_webXmlRoot
protected boolean	allowDuplicateFragmentNames
static Resource	NON_FRAG_RESOURCE
static String	ORDERED_LIBS

Constructor Summary

Constructors

Constructor and Description
MetaData()

Method Summary

Methods

Modifier and Type	Method and Description
void	addContainerResource(Resource jar)
void	addDescriptorProcessor(DescriptorProcessor p)
void	addDiscoveredAnnotation(DiscoveredAnnotation annotation) Add an annotation that has been discovered on a class, method or field within a resource eg a jar or dir.
void	addDiscoveredAnnotations(List<DiscoveredAnnotation> annotations) Annotations not associated with a WEB-INF/lib fragment jar.
void	addFragment(Resource jarResource, Resource xmlResource) Add a web-fragment.xml
void	addOverride(Resource override)
void	addWebInfJar(Resource newResource)
void	clear() Empty ready for reuse
List<Resource>	getContainerResources()
FragmentDescriptor	getFragment(Resource jar)
FragmentDescriptor	getFragment(String name)
List<FragmentDescriptor>	getFragments()
Resource	getJarForFragment(String name)
Map<String,FragmentDescriptor>	getNamedFragments()
List<FragmentDescriptor>	getOrderedFragments()
List<Resource>	getOrderedWebInfJars()
Ordering	getOrdering()
Origin	getOrigin(String name)
Descriptor	getOriginDescriptor(String name)
MetaData.OriginInfo	getOriginInfo(String name)
Map<String,MetaData.OriginInfo>	getOrigins()
List<WebDescriptor>	getOverrideWebs()
WebDescriptor	getWebDefault()
List<Resource>	getWebInfClassesDirs()
List<Resource>	getWebInfJars()
WebDescriptor	getWebXml()
boolean	isAllowDuplicateFragmentNames()
boolean	isDistributable()
boolean	isMetaDataComplete()
void	orderFragments()
void	removeDescriptorProcessor(DescriptorProcessor p)
void	resolve(WebAppContext context) Resolve all servlet/filter/listener metadata from all sources: descriptors and annotations.
void	setAllowDuplicateFragmentNames(boolean allowDuplicateFragmentNames)
void	setDefaults(Resource webDefaults)
void	setOrdering(Ordering o)
void	setOrigin(String name, Annotation annotation, Class<?> annotated)
void	setOrigin(String name, Descriptor d)
void	setOriginAPI(String name)
void	setWebInfClassesDirs(List<Resource> dirs)
void	setWebXml(Resource webXml)

Methods inherited from class java.lang.Object

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

Field Detail

ORDERED_LIBS

public static final String ORDERED_LIBS

See Also:

Constant Field Values

NON_FRAG_RESOURCE

public static final Resource NON_FRAG_RESOURCE

_origins

protected Map<String,MetaData.OriginInfo> _origins

_webDefaultsRoot

protected WebDescriptor _webDefaultsRoot

_webXmlRoot

protected WebDescriptor _webXmlRoot

_webOverrideRoots

protected final List<WebDescriptor> _webOverrideRoots

_metaDataComplete

protected boolean _metaDataComplete

_descriptorProcessors

protected final List<DescriptorProcessor> _descriptorProcessors

_webFragmentRoots

protected final List<FragmentDescriptor> _webFragmentRoots

_webFragmentNameMap

protected final Map<String,FragmentDescriptor> _webFragmentNameMap

_webFragmentResourceMap

protected final Map<Resource,FragmentDescriptor> _webFragmentResourceMap

_annotations

protected final Map<Resource,List<DiscoveredAnnotation>> _annotations

_webInfClasses

protected final List<Resource> _webInfClasses

_webInfJars

protected final List<Resource> _webInfJars

_orderedContainerResources

protected final List<Resource> _orderedContainerResources

_orderedWebInfResources

protected final List<Resource> _orderedWebInfResources

_ordering

protected Ordering _ordering

allowDuplicateFragmentNames

protected boolean allowDuplicateFragmentNames

Constructor Detail

MetaData

public MetaData()

Method Detail

clear

public void clear()

Empty ready for reuse

setDefaults

public void setDefaults(Resource webDefaults)
                 throws Exception

Throws:

Exception

setWebXml

public void setWebXml(Resource webXml)
               throws Exception

Throws:

Exception

addOverride

public void addOverride(Resource override)
                 throws Exception

Throws:

Exception

addFragment

public void addFragment(Resource jarResource,
               Resource xmlResource)
                 throws Exception

Add a web-fragment.xml

Parameters:

jarResource - the jar the fragment is contained in

xmlResource - the resource representing the xml file

Throws:

Exception

addDiscoveredAnnotations

public void addDiscoveredAnnotations(List<DiscoveredAnnotation> annotations)

Annotations not associated with a WEB-INF/lib fragment jar. These are from WEB-INF/classes or the ??container path??

Parameters:

annotations -

addDiscoveredAnnotation

public void addDiscoveredAnnotation(DiscoveredAnnotation annotation)

Add an annotation that has been discovered on a class, method or field within a resource eg a jar or dir. This method is synchronized as it is anticipated that it may be called by many threads during the annotation scanning phase.

Parameters:

annotation -

addDescriptorProcessor

public void addDescriptorProcessor(DescriptorProcessor p)

removeDescriptorProcessor

public void removeDescriptorProcessor(DescriptorProcessor p)

orderFragments

public void orderFragments()

resolve

public void resolve(WebAppContext context)
             throws Exception

Resolve all servlet/filter/listener metadata from all sources: descriptors and annotations.

Throws:

Exception

isDistributable

public boolean isDistributable()

getWebXml

public WebDescriptor getWebXml()

getOverrideWebs

public List<WebDescriptor> getOverrideWebs()

getWebDefault

public WebDescriptor getWebDefault()

getFragments

public List<FragmentDescriptor> getFragments()

getOrderedWebInfJars

public List<Resource> getOrderedWebInfJars()

getOrderedFragments

public List<FragmentDescriptor> getOrderedFragments()

getOrdering

public Ordering getOrdering()

setOrdering

public void setOrdering(Ordering o)

getFragment

public FragmentDescriptor getFragment(Resource jar)

getFragment

public FragmentDescriptor getFragment(String name)

getJarForFragment

public Resource getJarForFragment(String name)

getNamedFragments

public Map<String,FragmentDescriptor> getNamedFragments()

getOrigin

public Origin getOrigin(String name)

getOriginInfo

public MetaData.OriginInfo getOriginInfo(String name)

getOriginDescriptor

public Descriptor getOriginDescriptor(String name)

setOrigin

public void setOrigin(String name,
             Descriptor d)

setOrigin

public void setOrigin(String name,
             Annotation annotation,
             Class<?> annotated)

setOriginAPI

public void setOriginAPI(String name)

isMetaDataComplete

public boolean isMetaDataComplete()

addWebInfJar

public void addWebInfJar(Resource newResource)

getWebInfJars

public List<Resource> getWebInfJars()

getContainerResources

public List<Resource> getContainerResources()

addContainerResource

public void addContainerResource(Resource jar)

setWebInfClassesDirs

public void setWebInfClassesDirs(List<Resource> dirs)

getWebInfClassesDirs

public List<Resource> getWebInfClassesDirs()

isAllowDuplicateFragmentNames

public boolean isAllowDuplicateFragmentNames()

setAllowDuplicateFragmentNames

public void setAllowDuplicateFragmentNames(boolean allowDuplicateFragmentNames)

getOrigins

public Map<String,MetaData.OriginInfo> getOrigins()