Examples of javolution.util.Index

javolution.util.Index

This class represents a unique index which can be used instead of java.lang.Integer for primitive data types collections. For example:[code] class SparseVector { FastMap _elements = new FastMap(); ... }[/code]

Unicity is guaranteed and direct equality (==) can be used in place of object equality (Index.equals(Object)).

Indices have no adverse effect on the garbage collector (persistent instances), but should not be used for large integer values as that would increase the permanent memory footprint significantly.

RTSJ: Instance of this classes are allocated in ImmortalMemory. Indices can be pre-allocated at start-up to avoid run-time allocation delays by configuring {@link #INITIAL_FIRST} and/or {@link #INITIAL_LAST} or through {@link #setMinimumRange}.

@author Jean-Marie Dautelle @version 5.1, July 26, 2007

     * @return <code>true</code> if a reference is written;
     *         <code>false</code> if a new identifier is written.
     */
    public boolean writeReference(Object obj, XMLFormat.OutputElement xml)
            throws XMLStreamException {
        Index id = (Index) _objectToId.get(obj);
        if (id == null) { // New identifier.
            id = Index.valueOf(_counter++);
            _objectToId.put(obj, id);
            _tmp.clear().append(id.intValue());
            if (_idURI == null) {
                xml.getStreamWriter().writeAttribute(toCsq(_idName),
                        _tmp);
            } else {
                xml.getStreamWriter().writeAttribute(toCsq(_idURI),
                        toCsq(_idName), _tmp);
            }
            return false;
        }
        _tmp.clear().append(id.intValue());
        if (_refURI == null) {
            xml._writer
                    .writeAttribute(toCsq(_refName), _tmp);
        } else {
            xml._writer.writeAttribute(toCsq(_refURI),

     * @return <code>true</code> if a reference is written;
     *         <code>false</code> if a new identifier is written.
     */
    public boolean writeReference(Object obj, XMLFormat.OutputElement xml)
            throws XMLStreamException {
        Index id = (Index) _objectToId.get(obj);
        if (id == null) { // New identifier.
            id = Index.of(_counter++);
            _objectToId.put(obj, id);
            _tmp.clear().append(id.intValue());
            if (_idURI == null) {
                xml.getStreamWriter().writeAttribute(_idName, _tmp);
            } else {
                xml.getStreamWriter().writeAttribute(_idURI, _idName, _tmp);
            }
            return false;
        }
        _tmp.clear().append(id.intValue());
        if (_refURI == null) {
            xml._writer.writeAttribute(_refName, _tmp);
        } else {
            xml._writer.writeAttribute(_refURI, _refName, _tmp);
        }

Examples of javolution.util.Index

Related Classes of javolution.util.Index