net.shibboleth.utilities.java.support.xml

Class SchemaBuilder

java.lang.Object

net.shibboleth.utilities.java.support.xml.SchemaBuilder

@NotThreadSafe
public class SchemaBuilder
extends java.lang.Object

A class for building a Schema from a set of inputs, allowing for manipulation of the underlying factory.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SchemaBuilder.SchemaLanguage Language of the schema files.

Field Summary

Fields

Modifier and Type	Field and Description
private boolean	alreadyBuilt One time-init flag.
private org.xml.sax.ErrorHandler	errorHandler Custom error handler.
private java.util.Map<java.lang.String,java.lang.Boolean>	features Features to set on factory.
private org.slf4j.Logger	log Class logger.
private java.util.Map<java.lang.String,java.lang.Object>	properties Properties to set on factory.
private org.w3c.dom.ls.LSResourceResolver	resourceResolver Mechanism for resolving nested resources like included/imported schemas.
private SchemaBuilder.SchemaLanguage	schemaLang Language of schemas.
private java.util.List<javax.xml.transform.Source>	sources Sources of schema material compatible with JAXP.

Constructor Summary

Constructors

Constructor and Description
SchemaBuilder() Constructor.

Method Summary

Modifier and Type	Method and Description
SchemaBuilder	addSchema(java.io.InputStream schemaSource) Add schemas from the given schema input streams.
SchemaBuilder	addSchema(Resource resource) Add schemas from the given schema resource.
SchemaBuilder	addSchema(javax.xml.transform.Source schemaSource) Add schemas from the given schema sources.
javax.xml.validation.Schema	buildSchema() Build a schema from the given schema sources.
SchemaBuilder	resetSchemas() Clear the schemas to be included.
SchemaBuilder	setErrorHandler(org.xml.sax.ErrorHandler handler) Set a custom error handler to use.
void	setFeature(java.lang.String name, boolean value) Set a feature for the SchemaFactory to be built.
void	setProperty(java.lang.String name, java.lang.Object object) Set the value of a property for the SchemaFactory to be built.
SchemaBuilder	setResourceResolver(org.w3c.dom.ls.LSResourceResolver resolver) Set the resource resolver to use for included/imported schemas.
SchemaBuilder	setSchemaLanguage(SchemaBuilder.SchemaLanguage lang) Set the schema language.
void	setSchemaResources(java.util.Collection<Resource> schemaResources) Set the schemas to load from the given schema resources (replaces any previously added).
void	setSchemas(java.util.Collection<javax.xml.transform.Source> schemaSources) Set the schemas to load from the given schema sources (replaces any previously added).

Methods inherited from class java.lang.Object

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

Field Detail

log

@Nonnull
private final org.slf4j.Logger log

Class logger.

schemaLang

@Nonnull
private SchemaBuilder.SchemaLanguage schemaLang

Language of schemas.

sources

@Nonnull
 @NonnullElements
private java.util.List<javax.xml.transform.Source> sources

Sources of schema material compatible with JAXP.

resourceResolver

@Nullable
private org.w3c.dom.ls.LSResourceResolver resourceResolver

Mechanism for resolving nested resources like included/imported schemas.

errorHandler

@Nullable
private org.xml.sax.ErrorHandler errorHandler

Custom error handler.

features

@Nonnull
private java.util.Map<java.lang.String,java.lang.Boolean> features

Features to set on factory.

properties

@Nonnull
private java.util.Map<java.lang.String,java.lang.Object> properties

Properties to set on factory.

alreadyBuilt

private boolean alreadyBuilt

One time-init flag.

Constructor Detail

SchemaBuilder

public SchemaBuilder()

Constructor.

Method Detail

setSchemaLanguage

@Nonnull
public SchemaBuilder setSchemaLanguage(@Nonnull
                                                SchemaBuilder.SchemaLanguage lang)

Set the schema language.

Parameters:

lang - the schema language

Returns:

this builder

setResourceResolver

@Nonnull
public SchemaBuilder setResourceResolver(@Nullable
                                                  org.w3c.dom.ls.LSResourceResolver resolver)

Set the resource resolver to use for included/imported schemas.

If not set, the default resolver will prevent lookup of any schemas not explicitly added.

Parameters:

resolver - resource resolver

Returns:

this builder

setErrorHandler

@Nonnull
public SchemaBuilder setErrorHandler(@Nullable
                                              org.xml.sax.ErrorHandler handler)

Set a custom error handler to use.

If not set, a default handler will be used that logs errors before throwing exceptions.

Parameters:

handler - error handler

Returns:

this builder

setFeature

public void setFeature(@Nonnull @NotEmpty
                       java.lang.String name,
                       boolean value)

Set a feature for the SchemaFactory to be built.

Parameters:

name - The feature name, which is a non-null fully-qualified URI.

value - The requested value of the feature (true or false).

See Also:

SchemaFactory.setFeature(String, boolean)

setProperty

public void setProperty(@Nonnull @NotEmpty
                        java.lang.String name,
                        @Nullable
                        java.lang.Object object)

Set the value of a property for the SchemaFactory to be built.

Parameters:

name - The property name, which is a non-null fully-qualified URI.

object - The requested value for the property.

See Also:

SchemaFactory.setProperty(String, Object)

resetSchemas

@Nonnull
public SchemaBuilder resetSchemas()

Clear the schemas to be included.

Returns:

this builder

setSchemas

@Nonnull
public void setSchemas(@Nonnull @NullableElements
                                java.util.Collection<javax.xml.transform.Source> schemaSources)

Set the schemas to load from the given schema sources (replaces any previously added).

If the caller wishes to ensure the schemas are loaded in a particular order, the Collection implementation provided must be one that preserves order. The method will add the sources in the order returned by the collection.

Parameters:

schemaSources - schema sources

setSchemaResources

@Nonnull
public void setSchemaResources(@Nonnull @NullableElements
                                        java.util.Collection<Resource> schemaResources)

Set the schemas to load from the given schema resources (replaces any previously added).

If the caller wishes to ensure the schemas are loaded in a particular order, the Collection implementation provided must be one that preserves order. The method will add the sources in the order returned by the collection.

Parameters:

schemaResources - schema resources

addSchema

@Nonnull
public SchemaBuilder addSchema(@Nonnull
                                        java.io.InputStream schemaSource)

Add schemas from the given schema input streams.

Parameters:

schemaSource - schema input stream

Returns:

this builder

addSchema

@Nonnull
public SchemaBuilder addSchema(@Nonnull
                                        javax.xml.transform.Source schemaSource)

Add schemas from the given schema sources.

Parameters:

schemaSource - schema source

Returns:

this builder

addSchema

@Nonnull
public SchemaBuilder addSchema(@Nonnull
                                        Resource resource)

Add schemas from the given schema resource.

Parameters:

resource - schema input resource

Returns:

this builder

buildSchema

@Nonnull
public javax.xml.validation.Schema buildSchema()
                                                 throws org.xml.sax.SAXException

Build a schema from the given schema sources.

This method is thread-safe, although the various mutating methods to establish the state of the object are not.

Returns:

the constructed schema

Throws:

org.xml.sax.SAXException - thrown if there is a problem converting the schema sources into a schema