org.fcrepo.server.security.xacml.pdp.finder.policy

Class PolicyReader

java.lang.Object

org.fcrepo.server.security.xacml.pdp.finder.policy.PolicyReader

All Implemented Interfaces:

org.xml.sax.ErrorHandler

public class PolicyReader
extends java.lang.Object
implements org.xml.sax.ErrorHandler

This class is provided as a utility for reading policies from common, simple sources: InputStreams, Files, and URL s. It can optionally schema validate the policies.

Note: some of this functionality was previously provided in org.jboss.security.xacml.sunxacml.finder.impl.FilePolicyModule, but as of the 2.0 release, that class has been removed. This new PolicyReader class provides much better functionality for loading policies.

Since:

2.0

Author:

Seth Proctor

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	POLICY_SCHEMA_PROPERTY The property which is used to specify the schema file to validate against (if any).

Constructor Summary

Constructors

Constructor and Description
PolicyReader() Creates a PolicyReader that does not schema-validate policies.
PolicyReader(java.io.File schemaFile) Creates a PolicyReader that may schema-validate policies.

Method Summary

Methods

Modifier and Type	Method and Description
void	error(org.xml.sax.SAXParseException exception) Standard handler routine for the XML parsing.
void	fatalError(org.xml.sax.SAXParseException exception) Standard handler routine for the XML parsing.
org.w3c.dom.Document	readPolicy(byte[] input)
org.w3c.dom.Document	readPolicy(java.io.File file) Tries to read an XACML policy or policy set from the given file.
org.w3c.dom.Document	readPolicy(java.io.InputStream input) Tries to read an XACML policy or policy set from the given stream.
org.w3c.dom.Document	readPolicy(java.net.URL url) Tries to read an XACML policy or policy set based on the given URL.
void	warning(org.xml.sax.SAXParseException exception) Standard handler routine for the XML parsing.

Methods inherited from class java.lang.Object

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

Field Detail

POLICY_SCHEMA_PROPERTY

public static final java.lang.String POLICY_SCHEMA_PROPERTY

The property which is used to specify the schema file to validate against (if any). Note that this isn't used directly by PolicyReader , but is referenced by many classes that use this class to load policies.

See Also:

Constant Field Values

Constructor Detail

PolicyReader

public PolicyReader()

Creates a PolicyReader that does not schema-validate policies.

Parameters:

finder - a PolicyFinder that is used by policy sets, which may be null only if no references are used

PolicyReader

public PolicyReader(java.io.File schemaFile)

Creates a PolicyReader that may schema-validate policies.

Parameters:

schemaFile - the schema file used to validate policies, or null if schema validation is not desired

Method Detail

readPolicy

public org.w3c.dom.Document readPolicy(java.io.File file)
                                throws org.jboss.security.xacml.sunxacml.ParsingException

Tries to read an XACML policy or policy set from the given file.

Parameters:

file - the file containing the policy to read

Returns:

a (potentially schema-validated) policy loaded from the given file

Throws:

org.jboss.security.xacml.sunxacml.ParsingException - if an error occurs while reading or parsing the policy

readPolicy

public org.w3c.dom.Document readPolicy(java.io.InputStream input)
                                throws org.jboss.security.xacml.sunxacml.ParsingException

Tries to read an XACML policy or policy set from the given stream.

Parameters:

input - the stream containing the policy to read

Returns:

a (potentially schema-validated) policy loaded from the given file

Throws:

org.jboss.security.xacml.sunxacml.ParsingException - if an error occurs while reading or parsing the policy

readPolicy

public org.w3c.dom.Document readPolicy(byte[] input)
                                throws org.jboss.security.xacml.sunxacml.ParsingException

Throws:

org.jboss.security.xacml.sunxacml.ParsingException

readPolicy

public org.w3c.dom.Document readPolicy(java.net.URL url)
                                throws org.jboss.security.xacml.sunxacml.ParsingException

Tries to read an XACML policy or policy set based on the given URL. This may be any resolvable URL, like a file or http pointer.

Parameters:

url - a URL pointing to the policy to read

Returns:

a (potentially schema-validated) policy loaded from the given file

Throws:

org.jboss.security.xacml.sunxacml.ParsingException - if an error occurs while reading or parsing the policy, or if the URL can't be resolved

warning

public void warning(org.xml.sax.SAXParseException exception)
             throws org.xml.sax.SAXException

Standard handler routine for the XML parsing.

Specified by:

warning in interface org.xml.sax.ErrorHandler

Parameters:

exception - information on what caused the problem

Throws:

org.xml.sax.SAXException

error

public void error(org.xml.sax.SAXParseException exception)
           throws org.xml.sax.SAXException

Standard handler routine for the XML parsing.

Specified by:

error in interface org.xml.sax.ErrorHandler

Parameters:

exception - information on what caused the problem

Throws:

org.xml.sax.SAXException - always to halt parsing on errors

fatalError

public void fatalError(org.xml.sax.SAXParseException exception)
                throws org.xml.sax.SAXException

Standard handler routine for the XML parsing.

Specified by:

fatalError in interface org.xml.sax.ErrorHandler

Parameters:

exception - information on what caused the problem

Throws:

org.xml.sax.SAXException - always to halt parsing on errors