it.unimi.dsi.parser
Interface ParsingFactory

All Known Implementing Classes:

HTMLFactory, WellFormedXmlFactory

public interface ParsingFactory

A set of coherent methods to turn element-type, attribute and entity names to unique interned instances.

The BulletParser needs a way to turn a name (for an element type, attribute, or entity) into a corresponding object of type Element, Attribute or Entity, respectively. The returned element must be an interned, unique representation.

For instance, the standard factory for HTML parsing has ready-made interned versions of all names in the (X)HTML specification, and returns them upon request, but other policies are possible. For instance, instances of WellFormedXmlFactory intern every seen name, without reference to a data type (except for entities, in which case the HTML set is used).

The idea of factoring out the creation of interned counterparts of SGML/XML syntactical objects is due to Fabien Campagne.

Since:

1.0.2

Author:

Sebastiano Vigna

Method Summary

Attribute	getAttribute(MutableString name) Returns the Attribute associated to a name.
Element	getElement(MutableString name) Returns the Element associated to a name.
Entity	getEntity(MutableString name) Returns the Entity associated to a name.

Method Detail

getElement

Element getElement(MutableString name)

Returns the Element associated to a name.

Parameters:

name - the name of an element type.

Returns:

the corresponding interned Element object.

getAttribute

Attribute getAttribute(MutableString name)

Returns the Attribute associated to a name.

Parameters:

name - the name of an attribute.

Returns:

the corresponding interned Attribute object.

getEntity

Entity getEntity(MutableString name)

Returns the Entity associated to a name.

Parameters:

name - the name of an entity.

Returns:

the corresponding interned Entity object.