ro.isdc.wro.model.resource.processor.decorator

Class LazyProcessorDecorator

java.lang.Object

ro.isdc.wro.util.AbstractDecorator<LazyInitializer<ResourcePreProcessor>>

ro.isdc.wro.model.resource.processor.decorator.LazyProcessorDecorator

All Implemented Interfaces:

Destroyable, ImportAware, MinimizeAware, ResourcePostProcessor, ResourcePreProcessor, ResourceProcessorAware, SupportAware, SupportedResourceTypeAware, ObjectDecorator<LazyInitializer<ResourcePreProcessor>>

public final class LazyProcessorDecorator
extends AbstractDecorator<LazyInitializer<ResourcePreProcessor>>
implements ResourceProcessorAware

Decorates a LazyInitializer which creates a processor. Allows defer the initialization of the decorated processor, making it unnecessary dependency unless it is really used.

Since:

1.4.6

Author:

Alex Objelean

Constructor Summary

Constructors

Constructor and Description
LazyProcessorDecorator(LazyInitializer<ResourcePreProcessor> processor)

Method Summary

Methods

Modifier and Type	Method and Description
void	destroy() Destroy this object or any other internal state created during initialization.
SupportedResourceType	getSupportedResourceType()
boolean	isImportAware()
boolean	isMinimize()
boolean	isSupported()
void	process(Reader reader, Writer writer) Perform actual resource processing.
void	process(Resource resource, Reader reader, Writer writer) Process a content supplied by a reader and perform some sort of processing.
String	toString()

Methods inherited from class ro.isdc.wro.util.AbstractDecorator

getDecoratedObject, getOriginalDecoratedObject, getOriginalDecoratedObject

Methods inherited from class java.lang.Object

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

Constructor Detail

LazyProcessorDecorator

public LazyProcessorDecorator(LazyInitializer<ResourcePreProcessor> processor)

Method Detail

process

public void process(Resource resource,
           Reader reader,
           Writer writer)
             throws IOException

Process a content supplied by a reader and perform some sort of processing. It is important to know that you should use reader for processing instead of trying to access the resource original content using Resource, because this way you can ignore the other preProcessors from the chain.
It is not require to explicitly handle exception. When the processing fails, the following can happen:

• the exception is wrapped in RuntimeException and the processing chain is interrupted (by default)
• content remains unchanged (if WroConfiguration.isIgnoreFailingProcessor() is true)

It is not required to close the reader and writers, because these will be closed for you.

Specified by:

process in interface ResourcePreProcessor

Parameters:

resource - the original resource as it found in the model.

reader - Reader used to read processed resource content.

writer - Writer where used to write processed results.

Throws:

IOException - when an exception occurs. The future version will change the exception type to Exception, because any exception may occur during processing. The processing failure will be handled based on value of WroConfiguration.isIgnoreFailingProcessor() configuration flag.

process

public void process(Reader reader,
           Writer writer)
             throws IOException

Perform actual resource processing. The content to be processed is read from source Reader and is written to destination Writer. It is the client responsibility to close both: Reader and writer.

Specified by:

process in interface ResourcePostProcessor

Parameters:

reader - source stream.

writer - destination stream.

Throws:

IOException

getSupportedResourceType

public SupportedResourceType getSupportedResourceType()

Specified by:

getSupportedResourceType in interface SupportedResourceTypeAware

Returns:

SupportedResourceType to be used by processor.

isMinimize

public boolean isMinimize()

Specified by:

isMinimize in interface MinimizeAware

Returns:

true if the processor implementing this method performs some kind of minification.

isSupported

public boolean isSupported()

Specified by:

isSupported in interface SupportAware

Returns:

true if the implementor of this interface is supported.

isImportAware

public boolean isImportAware()

Specified by:

isImportAware in interface ImportAware

Returns:

flag indicating if the implementor of this interface should process also imported (referred by @import directive) resources.

destroy

public void destroy()
             throws Exception

Destroy this object or any other internal state created during initialization.

Specified by:

destroy in interface Destroyable

Throws:

Exception - if the destroy operation failed.

toString

public String toString()

Overrides:

toString in class AbstractDecorator<LazyInitializer<ResourcePreProcessor>>