org.codehaus.griffon.runtime.core.artifact

Class AbstractArtifactManager

java.lang.Object

org.codehaus.griffon.runtime.core.artifact.AbstractArtifactManager

All Implemented Interfaces:

ArtifactManager

Direct Known Subclasses:

DefaultArtifactManager

public abstract class AbstractArtifactManager
extends java.lang.Object
implements ArtifactManager

Base implementation of the ArtifactManager interface.

Since:

2.0.0

Author:

Andres Almiray

Field Summary

Fields

Modifier and Type	Field and Description
protected static java.lang.String	ERROR_ARTIFACT_HANDLER_NULL

Fields inherited from interface griffon.core.artifact.ArtifactManager

EMPTY_GRIFFON_CLASS_LIST

Constructor Summary

Constructors

Constructor and Description
AbstractArtifactManager()

Method Summary

Modifier and Type	Method and Description
protected abstract java.util.Map<java.lang.String,java.util.List<java.lang.Class<? extends GriffonArtifact>>>	doLoadArtifactMetadata()
<A extends GriffonArtifact> GriffonClass	findGriffonClass(A artifact) Finds an artifact by class.
GriffonClass	findGriffonClass(java.lang.Class<? extends GriffonArtifact> clazz) Finds an artifact by class.
GriffonClass	findGriffonClass(java.lang.Class<? extends GriffonArtifact> clazz, java.lang.String type) Finds an artifact by class and type.
GriffonClass	findGriffonClass(java.lang.String fqClassName) Finds an artifact by name.
GriffonClass	findGriffonClass(java.lang.String name, java.lang.String type) Finds an artifact by name and type.
java.util.List<GriffonClass>	getAllClasses() Finds all artifact classes.
java.util.Set<java.lang.String>	getAllTypes() Finds all supported artifact types.
protected java.util.Map<java.lang.String,ArtifactHandler>	getArtifactHandlers()
java.util.List<GriffonClass>	getClassesOfType(java.lang.String type) Finds all artifacts of an specific type.
protected boolean	isArtifactTypeSupported(java.lang.String type)
protected <A extends GriffonArtifact> boolean	isClassOfType(java.lang.String type, java.lang.Class<A> clazz)
void	loadArtifactMetadata() Reads the artifacts definitions file from the classpath.
<A extends GriffonArtifact> A	newInstance(java.lang.Class<A> clazz) Creates a new instance of the specified class and type. Triggers the ApplicationEvent.NEW_INSTANCE with the following parameters clazz - the Class of the object instance -> the object that was created
<A extends GriffonArtifact> A	newInstance(GriffonClass griffonClass) Creates a new instance of the specified class and type. Triggers the ApplicationEvent.NEW_INSTANCE with the following parameters clazz - the Class of the object instance -> the object that was created
void	registerArtifactHandler(ArtifactHandler artifactHandler) Registers an ArtifactHandler by type.
void	unregisterArtifactHandler(ArtifactHandler artifactHandler) Removes an ArtifactHandler by type.

Methods inherited from class java.lang.Object

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

Field Detail

ERROR_ARTIFACT_HANDLER_NULL

protected static final java.lang.String ERROR_ARTIFACT_HANDLER_NULL

See Also:

Constant Field Values

Constructor Detail

AbstractArtifactManager

public AbstractArtifactManager()

Method Detail

getArtifactHandlers

@Nonnull
protected java.util.Map<java.lang.String,ArtifactHandler> getArtifactHandlers()

loadArtifactMetadata

public final void loadArtifactMetadata()

Description copied from interface: ArtifactManager

Reads the artifacts definitions file from the classpath.

Should call initialize() on artifact handlers if there are any registered already.

Specified by:

loadArtifactMetadata in interface ArtifactManager

getAllTypes

@Nonnull
public java.util.Set<java.lang.String> getAllTypes()

Description copied from interface: ArtifactManager

Finds all supported artifact types.

Specified by:

getAllTypes in interface ArtifactManager

Returns:

a Set of all available artifact types. Never returns null.

newInstance

@Nonnull
public <A extends GriffonArtifact> A newInstance(@Nonnull
                                                          GriffonClass griffonClass)

Description copied from interface: ArtifactManager

Creates a new instance of the specified class and type.
Triggers the ApplicationEvent.NEW_INSTANCE with the following parameters

• clazz - the Class of the object
• instance -> the object that was created

Specified by:

newInstance in interface ArtifactManager

Parameters:

griffonClass - the GriffonClass for which an instance must be created

Returns:

a newly instantiated object of type clazz. Implementations must be sure to trigger an event of type ApplicationEvent.NEW_INSTANCE.

newInstance

@Nonnull
public <A extends GriffonArtifact> A newInstance(@Nonnull
                                                          java.lang.Class<A> clazz)

Description copied from interface: ArtifactManager

Creates a new instance of the specified class and type.
Triggers the ApplicationEvent.NEW_INSTANCE with the following parameters

• clazz - the Class of the object
• instance -> the object that was created

Specified by:

newInstance in interface ArtifactManager

Parameters:

clazz - the Class for which an instance must be created

Returns:

a newly instantiated object of type clazz. Implementations must be sure to trigger an event of type ApplicationEvent.NEW_INSTANCE.

doLoadArtifactMetadata

@Nonnull
protected abstract java.util.Map<java.lang.String,java.util.List<java.lang.Class<? extends GriffonArtifact>>> doLoadArtifactMetadata()

registerArtifactHandler

public void registerArtifactHandler(@Nonnull
                                    ArtifactHandler artifactHandler)

Description copied from interface: ArtifactManager

Registers an ArtifactHandler by type.

Should call initialize() on the handler.

Specified by:

registerArtifactHandler in interface ArtifactManager

Parameters:

artifactHandler - an ArtifactHandler

unregisterArtifactHandler

public void unregisterArtifactHandler(@Nonnull
                                      ArtifactHandler artifactHandler)

Description copied from interface: ArtifactManager

Removes an ArtifactHandler by type.

Specified by:

unregisterArtifactHandler in interface ArtifactManager

Parameters:

artifactHandler - an ArtifactHandler

isArtifactTypeSupported

protected boolean isArtifactTypeSupported(@Nonnull
                                          java.lang.String type)

findGriffonClass

@Nullable
public GriffonClass findGriffonClass(@Nonnull
                                               java.lang.String name,
                                               @Nonnull
                                               java.lang.String type)

Description copied from interface: ArtifactManager

Finds an artifact by name and type.

Example: findGriffonClass("Book", "controller") will return an artifact class that describes BookController.

Specified by:

findGriffonClass in interface ArtifactManager

Parameters:

name - the name of the artifact, e.g. 'Book'

type - the type of the artifact, e.g. 'controller'

Returns:

the GriffonClass associated with the artifact is there's a match, null otherwise.

findGriffonClass

@Nullable
public GriffonClass findGriffonClass(@Nonnull
                                               java.lang.Class<? extends GriffonArtifact> clazz,
                                               @Nonnull
                                               java.lang.String type)

Description copied from interface: ArtifactManager

Finds an artifact by class and type.

Example: findGriffonClass(BookController, "controller") will return an artifact class that describes BookController.

Specified by:

findGriffonClass in interface ArtifactManager

Parameters:

clazz - the name of the artifact, e.g. com.acme.BookController

type - the type of the artifact, e.g. 'controller'

Returns:

the GriffonClass associated with the artifact is there's a match, null otherwise.

findGriffonClass

@Nullable
public <A extends GriffonArtifact> GriffonClass findGriffonClass(@Nonnull
                                                                           A artifact)

Description copied from interface: ArtifactManager

Finds an artifact by class.

Example: findGriffonClass(aBookControllerInstance) will return an artifact class that describes BookController.

Specified by:

findGriffonClass in interface ArtifactManager

Parameters:

artifact - an artifact instance

Returns:

the GriffonClass associated with the artifact is there's a match, null otherwise.

findGriffonClass

@Nullable
public GriffonClass findGriffonClass(@Nonnull
                                               java.lang.Class<? extends GriffonArtifact> clazz)

Description copied from interface: ArtifactManager

Finds an artifact by class.

Example: findGriffonClass(BookController) will return an artifact class that describes BookController.

Specified by:

findGriffonClass in interface ArtifactManager

Parameters:

clazz - a Class instance

Returns:

the GriffonClass associated with the artifact is there's a match, null otherwise.

findGriffonClass

@Nullable
public GriffonClass findGriffonClass(@Nonnull
                                               java.lang.String fqClassName)

Description copied from interface: ArtifactManager

Finds an artifact by name.

Example: findGriffonClass("BookController") will return an artifact class that describes BookController.

Specified by:

findGriffonClass in interface ArtifactManager

Parameters:

fqClassName - full qualified class name

Returns:

the GriffonClass associated with the artifact is there's a match, null otherwise.

getClassesOfType

@Nonnull
public java.util.List<GriffonClass> getClassesOfType(@Nonnull
                                                              java.lang.String type)

Description copied from interface: ArtifactManager

Finds all artifacts of an specific type.

Example: getClassesOfType("controller") will return all artifact classes that describe controllers.

Specified by:

getClassesOfType in interface ArtifactManager

Parameters:

type - an artifact type, e.g. 'controller'

Returns:

a List of matching artifacts or an empty List if no match. Never returns null.

getAllClasses

@Nonnull
public java.util.List<GriffonClass> getAllClasses()

Description copied from interface: ArtifactManager

Finds all artifact classes.

Specified by:

getAllClasses in interface ArtifactManager

Returns:

a List of all available GriffonClass instances. Never returns null.

isClassOfType

protected <A extends GriffonArtifact> boolean isClassOfType(@Nonnull
                                                            java.lang.String type,
                                                            @Nonnull
                                                            java.lang.Class<A> clazz)