ro.isdc.wro.extensions.processor.js
Class CJsonProcessor

java.lang.Object
  ro.isdc.wro.extensions.processor.js.CJsonProcessor

All Implemented Interfaces:

ResourcePostProcessor, ResourcePreProcessor

@Minimize
@SupportedResourceType(value=JS)
public class CJsonProcessor
extends Object
implements ResourcePreProcessor, ResourcePostProcessor

A processor using cjson compression algorithm: http://stevehanov.ca/blog/index.php?id=104.

Since:

1.3.8

Author:

Alex Objelean

Field Summary

static String	ALIAS_PACK
static String	ALIAS_UNPACK

Constructor Summary

CJsonProcessor(boolean pack)
Private constructor, prevent instantiation.

Method Summary

protected CJson	newEngine()
protected void	onException(WroRuntimeException e) Invoked when a processing exception occurs.
static CJsonProcessor	packProcessor()
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.
static CJsonProcessor	unpackProcessor()

Methods inherited from class java.lang.Object

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

Field Detail

ALIAS_PACK

public static final String ALIAS_PACK

See Also:

Constant Field Values

ALIAS_UNPACK

public static final String ALIAS_UNPACK

See Also:

Constant Field Values

Constructor Detail

CJsonProcessor

public CJsonProcessor(boolean pack)

Private constructor, prevent instantiation.

Method Detail

packProcessor

public static CJsonProcessor packProcessor()

unpackProcessor

public static CJsonProcessor unpackProcessor()

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.

onException

protected void onException(WroRuntimeException e)

Invoked when a processing exception occurs.

newEngine

protected CJson newEngine()

Returns:

the CJson engine implementation. Override it to provide a different version of the json.hpack.js library. Useful for upgrading the processor outside the wro4j release.

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