org.nhindirect.policy.impl.machine

Class StackMachineCompiler

java.lang.Object

org.nhindirect.policy.impl.machine.StackMachineCompiler

All Implemented Interfaces:

Compiler

public class StackMachineCompiler
extends Object
implements Compiler

Implementation of the Compiler interface that generates opcodes used by the StackMachine execution engine.

This implementation traverses that expression tree and generates a vector of opcodes using a reverse policy notation strategy .

Since:

1.0

Author:

Greg Meyer

Constructor Summary

Constructors

Constructor and Description
StackMachineCompiler() Default constructor

Method Summary

Methods

Modifier and Type	Method and Description
Vector<Opcode>	compile(X509Certificate cert, PolicyExpression expression) Compiles the given certificate and a parsed PolicyExpression tree in a series of executables Opcode objects.
Collection<String>	getCompilationReport() Gets a collection of compilation issues.
boolean	isReportModeEnabled() Indicates whether or not the compiler is in report mode.
void	setReportModeEnabled(boolean reportMode) Sets or removes the compiler from report mode.

Methods inherited from class java.lang.Object

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

Constructor Detail

StackMachineCompiler

public StackMachineCompiler()

Default constructor

Method Detail

compile

public Vector<Opcode> compile(X509Certificate cert,
                     PolicyExpression expression)
                       throws PolicyProcessException

Compiles the given certificate and a parsed PolicyExpression tree in a series of executables Opcode objects.

Implementations should be thread same meaning multiple expressions can be compiled concurrently with the same compiler.

Specified by:

compile in interface Compiler

Parameters:

cert - The certificate that will be evaluated for policy compliance.

expression - The parsed expression tree.

Returns:

A vector of Opcode objects that are fed into an ExecutionEngine for final evaluation of policy compliance.

Throws:

PolicyProcessException - Thrown if a required certificate attribute does not exist in the given certification. However, this exception is suppressed if the compiler is placed into report model.

setReportModeEnabled

public void setReportModeEnabled(boolean reportMode)

Sets or removes the compiler from report mode. When in report mode, the compiler will not fail if required attributes are missing from the certificate.

Specified by:

setReportModeEnabled in interface Compiler

Parameters:

reportMode - true if the compiler is to be set into report mode. false otherwise

isReportModeEnabled

public boolean isReportModeEnabled()

Indicates whether or not the compiler is in report mode.

Specified by:

isReportModeEnabled in interface Compiler

Returns:

true if the compiler is in report mode. false otherwise

getCompilationReport

public Collection<String> getCompilationReport()

Gets a collection of compilation issues. This report can only be generated if the compiler is in report mode.

The collection is reset each time a compilation occurs. For concurrent compilation, the generated report is specific to the thread that compilation process was executed on.

Specified by:

getCompilationReport in interface Compiler

Returns:

A collection of compilation issues. If no issues were found or the compiler was not in report mode, then an empty collection is returned.