Package eu.bandm.tools.tdom.runtime

Class SelectedIntegersAttribute

java.lang.Object

eu.bandm.tools.tdom.runtime.TypedNode<TypedExtension>

eu.bandm.tools.tdom.runtime.TypedAttribute<Integer>

eu.bandm.tools.tdom.runtime.SelectedIntegersAttribute

public abstract class SelectedIntegersAttribute
extends TypedAttribute<Integer>

Base class for all generated classes which realize an Attribute with a type which is defined as a disjunction of integer values, like

 
  <!ATTLIST element
      f (1 | 2 | 4 | 8 | 16 | -7) #IMPLIED
   >
  

Normally this is realized as an EnumerationAttribute. But this requires an Enumeration Type, and double conversions (item type to string to integer, and backwards). So with the PI

 
  <?tdom selectedIntegers element@f ?>
     -- or in case of common attributes:
  <?tdom selectedIntegers @f ?>
  

.. this class can explicitly be chosen as a more convenient implementation. (This explicitness is required for backward and forward compatibility!)

Nested Class Summary

Nested classes/interfaces inherited from class eu.bandm.tools.tdom.runtime.TypedAttribute

TypedAttribute.__PreAtts, TypedAttribute.SafeValues

Nested classes/interfaces inherited from class eu.bandm.tools.tdom.runtime.TypedNode

TypedNode.ParseListener<E extends TypedElement<?,?>>

Field Summary

Fields inherited from class eu.bandm.tools.tdom.runtime.TypedAttribute

__preAtts, emptyAttributes, mutable, safeValues, specified, value

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	SelectedIntegersAttribute()
protected	SelectedIntegersAttribute(@Opt Integer value)
protected	SelectedIntegersAttribute(@Opt String value)

Method Summary

Modifier and Type	Method	Description
protected void	checkValue(Integer i)	Check routine for the validity of the attributes' intended value.
(package private) final void	decode(DecodingInputStream in, TypedExtension ext)	DOCME
final void	encode(EncodingOutputStream out, TypedExtension ext)	DOCME
int	getMax()	DOCME
int	getMin()	DOCME
final String	getStringValue(Integer v)	Returns the textual representation of a possible attribute value (not null), as it would be contained literally in a possible XML text representation.
String	getTypeString()	The definition text for the "type" of the attribute in the original DTD.
abstract SortedSet<Integer>	getValidInts()	DOCME
boolean	isValid(int i)	DOCME
static int	parse(String vs)	Aux Method for parsing an integer to the base 10.
static int	parse(String vs, int base)	Aux Method for parsing an integer to a given base.

Methods inherited from class eu.bandm.tools.tdom.runtime.TypedAttribute

assertSetAttrValid, assertSetAttrValid, checkRequired, clearValue, find, find, getDefaultValue, getLocalName, getNamespaceName, getNamespaceURI, getStringValue, getTagName, getValue, isFixed, isOptional, isRequired, isSpecified, makeUnspecified, put, setValue

Methods inherited from class eu.bandm.tools.tdom.runtime.TypedNode

asBigDecimal, asBigDecimal, asBigDecimal, asBigDecimal, asBigInteger, asBigInteger, asBigInteger, asBigInteger, asBoolean, asBoolean, asDouble, asDouble, asDouble, asDouble, asFloat, asFloat, asFloat, asFloat, asHexInt, asHexInt, asHexInt, asHexInt, asInt, asInt, asInt, asInt, asLong, asLong, asLong, asLong, asTrimmedString, asTrimmedString, asTrimmedString, asTrimmedString, checkPlus, checkPlus, checkStar, checkStar, checkStrict, encode, encodeOptional, encodePlus, encodePlus, encodeStar, encodeStar, extractEthereals, getLocation, getPCData, setLocation, setLocation, setLocation

Methods inherited from class java.lang.Object

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

Constructor Details

SelectedIntegersAttribute

protected SelectedIntegersAttribute()

SelectedIntegersAttribute

protected SelectedIntegersAttribute(@Opt
 @Opt Integer value)
                             throws TdomAttributeSyntaxException

Throws:

TdomAttributeSyntaxException

SelectedIntegersAttribute

protected SelectedIntegersAttribute(@Opt
 @Opt String value)
                             throws TdomAttributeSyntaxException

Throws:

TdomAttributeSyntaxException

Method Details

getTypeString

public String getTypeString()

The definition text for the "type" of the attribute in the original DTD.

Specified by:

getTypeString in class TypedAttribute<Integer>

isValid

public boolean isValid(int i)

DOCME

getValidInts

public abstract SortedSet<Integer> getValidInts()

DOCME

getMin

public int getMin()

DOCME

getMax

public int getMax()

DOCME

checkValue

protected void checkValue(Integer i)
                   throws TdomAttributeSyntaxException

Check routine for the validity of the attributes' intended value. Is a call-back, implemented by the sub-classes. Is called only here, by two constructors and the TypedAttribute.setValue(V) method. The value null means "absent" for #IMPLIED attributes and passes the test.

Specified by:

checkValue in class TypedAttribute<Integer>

Parameters:

i - the value to test; maybe null.

Throws:

TdomAttributeSyntaxException - iff the value does not match the type of the XML attribute, including a forbidden Null.

parse

public static int parse(String vs,
 int base)
                 throws IllegalArgumentException

Aux Method for parsing an integer to a given base. Maps NumberFormatException to IllegalArgumentException.

Throws:

IllegalArgumentException

parse

public static int parse(String vs)
                 throws IllegalArgumentException

Aux Method for parsing an integer to the base 10. Maps NumberFormatException to IllegalArgumentException.

Throws:

IllegalArgumentException

getStringValue

public final String getStringValue(Integer v)

Returns the textual representation of a possible attribute value (not null), as it would be contained literally in a possible XML text representation. Since the textual representation of a String is the string itself, this method is relevant for enumeration types only (Later: also for "entity" types, but these are not yet supported.)

Specified by:

getStringValue in class TypedAttribute<Integer>

Returns:

(never null) the textual representation of this attribute value, as it would be contained literally in a possible XML text representation.

encode

public final void encode(EncodingOutputStream out,
 TypedExtension ext)
                  throws IOException

DOCME

Specified by:

encode in class TypedNode<TypedExtension>

Throws:

IOException

decode

final void decode(DecodingInputStream in,
 TypedExtension ext)
           throws IOException,
TdomAttributeSyntaxException

DOCME

Specified by:

decode in class TypedAttribute<Integer>

Throws:

IOException

TdomAttributeSyntaxException