Package org.nuxeo.ecm.webengine.model.impl

Class ModuleImpl

java.lang.Object

org.nuxeo.ecm.webengine.model.impl.ModuleImpl

All Implemented Interfaces:

MessagesProvider, Module

public class ModuleImpl
extends Object
implements Module

The default implementation for a web configuration.

Author:

Bogdan Stefanescu

Field Summary

Fields

Modifier and Type	Field	Description
protected ModuleConfiguration	configuration
protected DirectoryStack	dirStack
protected WebEngine	engine
protected ConcurrentMap<String,ScriptFile>	fileCache
protected LinkRegistry	linkReg
protected Messages	messages
protected ResourceType	rootType	Deprecated. Use WebApplication to declare modules - modules may have multiple roots
protected com.sun.jersey.server.impl.inject.ServerInjectableProviderContext	sic
protected String	skinPathPrefix
protected ModuleImpl	superModule
protected Object	typeLock
protected TypeRegistry	typeReg

Constructor Summary

Constructors

Constructor	Description
ModuleImpl(WebEngine engine, ModuleImpl superModule, ModuleConfiguration config, com.sun.jersey.server.impl.inject.ServerInjectableProviderContext sic)

Method Summary

Modifier and Type	Method	Description
TypeRegistry	createTypeRegistry()	TODO There are no more reasons to lazy load the type registry since module are lazy loaded.
protected ScriptFile	findFile(String path)
void	flushCache()
void	flushRootResourcesCache()	Deprecated. resources are deprecated - you should use a jax-rs application to declare more resources.
void	flushSkinCache()
void	flushTypeCache()
List<LinkDescriptor>	getActiveLinks(Resource context, String category)
AdapterType	getAdapter(Resource ctx, String name)	Gets the named adapter definition for the given resource.
List<String>	getAdapterNames(Resource ctx)	Gets the list of adapter names that applies to the given resource.
AdapterType[]	getAdapters()	Gets the adapters registered within this module.
List<AdapterType>	getAdapters(Resource ctx)	Gets the list of adapters that applies to the given resource.
List<String>	getEnabledAdapterNames(Resource ctx)	Gets the list of adapter names that are enabled for the given context.
List<AdapterType>	getEnabledAdapters(Resource ctx)	Gets the list of adapters that are enabled for the given context.
WebEngine	getEngine()
ScriptFile	getFile(String path)	Gets a file using the configured directory stack.
LinkRegistry	getLinkRegistry()
List<LinkDescriptor>	getLinks(String category)
String	getMediaTypeId(javax.ws.rs.core.MediaType mt)
Messages	getMessages()
Map<String,String>	getMessages(String language)
ModuleConfiguration	getModuleConfiguration()
String	getName()
Set<String>	getNatures()
List<ResourceBinding>	getResourceBindings()
File	getRoot()
Resource	getRootObject(WebContext ctx)	Deprecated. Use WebApplication to declare modules
ResourceType	getRootType()	Deprecated. Use WebApplication to declare modules
static File	getSkinDir(File moduleDir)
String	getSkinPathPrefix()	Get the path prefix to be used from templates to prepend to links to static resources.
ScriptFile	getSkinResource(String path)	Gets a skin resource input stream.
ModuleImpl	getSuperModule()
String	getTemplateFileExt()
ResourceType	getType(String typeName)	Gets a ResourceType instance given its name.
TypeRegistry	getTypeRegistry()
ResourceType[]	getTypes()	Gets the types registered within this module.
boolean	hasNature(String natureId)
boolean	isDerivedFrom(String moduleName)
boolean	isHeadless()	Whether or not this module has a GUI and should be listed in available GUI module list.
Class<?>	loadClass(String className)	Loads a class given its name.
void	loadConfiguration()
protected void	loadDirectoryStack()
void	reloadMessages()
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

engine

protected final WebEngine engine

typeLock

protected final Object typeLock

typeReg

protected volatile TypeRegistry typeReg

configuration

protected final ModuleConfiguration configuration

sic

protected final com.sun.jersey.server.impl.inject.ServerInjectableProviderContext sic

superModule

protected final ModuleImpl superModule

linkReg

protected LinkRegistry linkReg

skinPathPrefix

protected final String skinPathPrefix

rootType

@Deprecated
protected ResourceType rootType

Deprecated.

Use WebApplication to declare modules - modules may have multiple roots

messages

protected Messages messages

dirStack

protected DirectoryStack dirStack

fileCache

protected ConcurrentMap<String,ScriptFile> fileCache

Constructor Detail

ModuleImpl

public ModuleImpl(WebEngine engine,
                  ModuleImpl superModule,
                  ModuleConfiguration config,
                  com.sun.jersey.server.impl.inject.ServerInjectableProviderContext sic)

Method Detail

isHeadless

public boolean isHeadless()

Whether or not this module has a GUI and should be listed in available GUI module list. For example, REST modules usually don't have a GUI.

Returns:

true if headless (no GUI is provided), false otherwise

getNatures

public Set<String> getNatures()

Returns:

the natures, or null if no natures were specified

hasNature

public boolean hasNature(String natureId)

getEngine

public WebEngine getEngine()

Specified by:

getEngine in interface Module

getName

public String getName()

Specified by:

getName in interface Module

getSuperModule

public ModuleImpl getSuperModule()

Specified by:

getSuperModule in interface Module

getModuleConfiguration

public ModuleConfiguration getModuleConfiguration()

getRootType

@Deprecated
public ResourceType getRootType()

Deprecated.

Use WebApplication to declare modules

getRootObject

@Deprecated
public Resource getRootObject(WebContext ctx)

Deprecated.

Use WebApplication to declare modules

Specified by:

getRootObject in interface Module

getSkinPathPrefix

public String getSkinPathPrefix()

Description copied from interface: Module

Get the path prefix to be used from templates to prepend to links to static resources.

This prefix is exposed to templates as ${skinPath}.

Specified by:

getSkinPathPrefix in interface Module

Returns:

the skin path prefix. never null.

getTypeRegistry

public TypeRegistry getTypeRegistry()

loadClass

public Class<?> loadClass(String className)
                   throws ClassNotFoundException

Description copied from interface: Module

Loads a class given its name.

The scripting class loader will be used to load the class.

Specified by:

loadClass in interface Module

Parameters:

className - the class name

Returns:

the class instance

Throws:

ClassNotFoundException

getType

public ResourceType getType(String typeName)

Description copied from interface: Module

Gets a ResourceType instance given its name.

The web type lookup is performed in the following order:

1. First the annotated Groovy classes are checked. (web/ directory)
2. Then the configuration type registry corresponding

Specified by:

getType in interface Module

Parameters:

typeName - the type name

Returns:

the web type instance

getTypes

public ResourceType[] getTypes()

Description copied from interface: Module

Gets the types registered within this module.

Specified by:

getTypes in interface Module

Returns:

the types. Cannot be null.

getAdapters

public AdapterType[] getAdapters()

Description copied from interface: Module

Gets the adapters registered within this module.

Specified by:

getAdapters in interface Module

Returns:

the adapters. Cannot be null.

getAdapter

public AdapterType getAdapter(Resource ctx,
                              String name)

Description copied from interface: Module

Gets the named adapter definition for the given resource.

Specified by:

getAdapter in interface Module

Parameters:

ctx - the target resource

name - the adapter name

Returns:

the adapter if any adapter with that name applies for that resource otherwise throws an exception

getAdapterNames

public List<String> getAdapterNames(Resource ctx)

Description copied from interface: Module

Gets the list of adapter names that applies to the given resource.

Specified by:

getAdapterNames in interface Module

Parameters:

ctx - the context resource

Returns:

the list of adapters Cannot be null.

getAdapters

public List<AdapterType> getAdapters(Resource ctx)

Description copied from interface: Module

Gets the list of adapters that applies to the given resource.

Specified by:

getAdapters in interface Module

Parameters:

ctx - the context resource

Returns:

the list of adapters Cannot be null.

getEnabledAdapterNames

public List<String> getEnabledAdapterNames(Resource ctx)

Description copied from interface: Module

Gets the list of adapter names that are enabled for the given context.

Enabled services are those adapters which can be accessed in the current security context.

Specified by:

getEnabledAdapterNames in interface Module

Parameters:

ctx - the context resource

Returns:

the list of adapters. Cannot be null.

getEnabledAdapters

public List<AdapterType> getEnabledAdapters(Resource ctx)

Description copied from interface: Module

Gets the list of adapters that are enabled for the given context.

Enabled adapters are those adapters which can be accessed in the current security context.

Specified by:

getEnabledAdapters in interface Module

Parameters:

ctx - the context resource

Returns:

the list of adapter.s Cannot be null.

getMediaTypeId

public String getMediaTypeId(javax.ws.rs.core.MediaType mt)

Specified by:

getMediaTypeId in interface Module

getResourceBindings

public List<ResourceBinding> getResourceBindings()

Specified by:

getResourceBindings in interface Module

isDerivedFrom

public boolean isDerivedFrom(String moduleName)

Specified by:

isDerivedFrom in interface Module

loadConfiguration

public void loadConfiguration()

getLinks

public List<LinkDescriptor> getLinks(String category)

Specified by:

getLinks in interface Module

getActiveLinks

public List<LinkDescriptor> getActiveLinks(Resource context,
                                           String category)

Specified by:

getActiveLinks in interface Module

getLinkRegistry

public LinkRegistry getLinkRegistry()

getTemplateFileExt

public String getTemplateFileExt()

Specified by:

getTemplateFileExt in interface Module

flushSkinCache

public void flushSkinCache()

flushTypeCache

public void flushTypeCache()

flushRootResourcesCache

@Deprecated
public void flushRootResourcesCache()

Deprecated.

resources are deprecated - you should use a jax-rs application to declare more resources.

flushCache

public void flushCache()

Specified by:

flushCache in interface Module

getSkinDir

public static File getSkinDir(File moduleDir)

loadDirectoryStack

protected void loadDirectoryStack()

getFile

public ScriptFile getFile(String path)

Description copied from interface: Module

Gets a file using the configured directory stack. Each directory in the stack is asked for the file until a file is found. If no file is found, returns null.

Note that the implementation may cache the results. To clear any cached data, you should call the Module.flushCache() method.

Specified by:

getFile in interface Module

Parameters:

path - the file path

Returns:

null if no file found otherwise the file

findFile

protected ScriptFile findFile(String path)
                       throws IOException

Parameters:

path - a normalized path (absolute path)

Throws:

IOException

getSkinResource

public ScriptFile getSkinResource(String path)
                           throws IOException

Description copied from interface: Module

Gets a skin resource input stream. This must not cache resources. This method is using the module stacking directory to find the resource.

Specified by:

getSkinResource in interface Module

Throws:

IOException

createTypeRegistry

public TypeRegistry createTypeRegistry()

TODO There are no more reasons to lazy load the type registry since module are lazy loaded. Type registry must be loaded at module creation

getRoot

public File getRoot()

Specified by:

getRoot in interface Module

reloadMessages

public void reloadMessages()

getMessages

public Messages getMessages()

Specified by:

getMessages in interface Module

getMessages

public Map<String,String> getMessages(String language)

Specified by:

getMessages in interface MessagesProvider

Specified by:

getMessages in interface Module

toString

public String toString()

Overrides:

toString in class Object