Module org.postgresql.pljava

Package org.postgresql.pljava

Interface Adjusting.XML.Source<T extends Source>

All Superinterfaces:

Adjusting.XML.Parsing<Adjusting.XML.Source<T>>, Source

All Known Subinterfaces:

Adjusting.XML.DOMSource, Adjusting.XML.SAXSource, Adjusting.XML.StAXSource

Enclosing class:

Adjusting.XML

public static interface Adjusting.XML.Source<T extends Source>
extends Adjusting.XML.Parsing<Adjusting.XML.Source<T>>, Source

Adjusting version of javax.xml.transform.Source, allowing various parser features to be configured before calling get() to obtain the usable Source object.

Passing this class itself to an SQLXML object's getSource method, as in

 Source src = sqx.getSource(Adjusting.XML.Source.class);

will allow the implementation to choose the particular subtype of Source it will return. To obtain a Source of a particular desired type, pass the class literal of one of the subtypes Adjusting.XML.SAXSource, Adjusting.XML.StAXSource, or Adjusting.XML.DOMSource.

The get() method can only be called once. The adjusting methods inherited from Adjusting.XML.Parsing can only be called before get().

Although this extends javax.xml.transform.Source, implementing classes will likely throw exceptions from the Source-specific methods for getting and setting system IDs. Those methods, if needed, should be called on the Source object obtained from get().

Method Summary

Modifier and Type	Method	Description
T	get()	Returns an object of the expected Source subtype reflecting any adjustments made with the other methods.

Methods inherited from interface org.postgresql.pljava.Adjusting.XML.Parsing

accessExternalDTD, accessExternalSchema, allowDTD, defaults, elementAttributeLimit, entityExpansionLimit, entityReplacementLimit, entityResolver, expandEntityReferences, externalGeneralEntities, externalParameterEntities, lax, loadExternalDTD, maxElementDepth, maxGeneralEntitySizeLimit, maxParameterEntitySizeLimit, maxXMLNameLimit, schema, setFirstSupportedFeature, setFirstSupportedProperty, totalEntitySizeLimit, xIncludeAware

Methods inherited from interface javax.xml.transform.Source

getSystemId, isEmpty, setSystemId

Method Details

get

T get()
throws SQLException

Returns an object of the expected Source subtype reflecting any adjustments made with the other methods.

Refer to the Parsing class description and the lax() method for how any exceptions caught while applying best-effort adjustments are handled.

Returns:

an implementing object of the expected Source subtype

Throws:

SQLException - for any reason that getSource might have thrown when supplying the corresponding non-Adjusting subtype of Source, or for reasons saved while applying adjustments.