com.trolltech.qt.xml
Class QXmlNamespaceSupport

java.lang.Object
  extended by com.trolltech.qt.internal.QSignalEmitterInternal
      extended by com.trolltech.qt.QSignalEmitter
          extended by com.trolltech.qt.QtJambiObject
              extended by com.trolltech.qt.xml.QXmlNamespaceSupport
All Implemented Interfaces:
QtJambiInterface, java.lang.Cloneable

public class QXmlNamespaceSupport
extends QtJambiObject
implements java.lang.Cloneable

The QXmlNamespaceSupport class is a helper class for XML readers which want to include namespace support. You can set the prefix for the current namespace with setPrefix(), and get the list of current prefixes (or those for a given URI) with prefixes(). The namespace URI is available from uri(). Use pushContext() to start a new namespace context, and popContext() to return to the previous namespace context. Use splitName() or processName() to split a name into its prefix and local name.

See also:
Namespace Support via Features.


Nested Class Summary
static class QXmlNamespaceSupport.ProcessedName
           
static class QXmlNamespaceSupport.SplitName
           
 
Nested classes/interfaces inherited from class com.trolltech.qt.QSignalEmitter
QSignalEmitter.AbstractSignal, QSignalEmitter.PrivateSignal0, QSignalEmitter.PrivateSignal1, QSignalEmitter.PrivateSignal2, QSignalEmitter.PrivateSignal3, QSignalEmitter.PrivateSignal4, QSignalEmitter.PrivateSignal5, QSignalEmitter.PrivateSignal6, QSignalEmitter.PrivateSignal7, QSignalEmitter.PrivateSignal8, QSignalEmitter.PrivateSignal9, QSignalEmitter.Signal0, QSignalEmitter.Signal1, QSignalEmitter.Signal2, QSignalEmitter.Signal3, QSignalEmitter.Signal4, QSignalEmitter.Signal5, QSignalEmitter.Signal6, QSignalEmitter.Signal7, QSignalEmitter.Signal8, QSignalEmitter.Signal9
 
Nested classes/interfaces inherited from class com.trolltech.qt.internal.QSignalEmitterInternal
com.trolltech.qt.internal.QSignalEmitterInternal.AbstractSignalInternal
 
Field Summary
 
Fields inherited from class com.trolltech.qt.internal.QSignalEmitterInternal
currentSender
 
Constructor Summary
QXmlNamespaceSupport()
          Constructs a QXmlNamespaceSupport.
 
Method Summary
 QXmlNamespaceSupport clone()
          This method is reimplemented for internal reasons
 void popContext()
          Reverts to the previous namespace context.
 java.lang.String prefix(java.lang.String arg__1)
          Returns one of the prefixes mapped to the namespace URI uri.
 java.util.List prefixes()
          Returns a list of all the prefixes currently declared.
 java.util.List prefixes(java.lang.String arg__1)
          This is an overloaded member function, provided for convenience.
 QXmlNamespaceSupport.ProcessedName processName(java.lang.String qname, boolean isAttribute)
          Processes a raw XML 1.0 name in the current context by removing the prefix and looking it up among the prefixes currently declared.
 void pushContext()
          Starts a new namespace context.
 void reset()
          Resets this namespace support object ready for reuse.
 void setPrefix(java.lang.String arg__1, java.lang.String arg__2)
          This function declares a prefix pre in the current namespace context to be the namespace URI uri.
 QXmlNamespaceSupport.SplitName splitName(java.lang.String qname)
          Splits the name qname at the '.' and returns the prefix prefix and the local name.
 java.lang.String uri(java.lang.String arg__1)
          Looks up the prefix prefix in the current context and returns the currently-mapped namespace URI.
 
Methods inherited from class com.trolltech.qt.QtJambiObject
dispose, disposed, equals, finalize, reassignNativeResources, tr, tr, tr
 
Methods inherited from class com.trolltech.qt.QSignalEmitter
blockSignals, disconnect, disconnect, signalsBlocked, signalSender, thread
 
Methods inherited from class com.trolltech.qt.internal.QSignalEmitterInternal
__qt_signalInitialization
 
Methods inherited from class java.lang.Object
getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface com.trolltech.qt.QtJambiInterface
disableGarbageCollection, nativeId, nativePointer, reenableGarbageCollection, setJavaOwnership
 

Constructor Detail

QXmlNamespaceSupport

public QXmlNamespaceSupport()
Constructs a QXmlNamespaceSupport.

Method Detail

popContext

public final void popContext()
Reverts to the previous namespace context.

Normally, you should pop the context at the end of each XML element. After popping the context, all namespace prefix mappings that were previously in force are restored.

See also:
pushContext().


prefix

public final java.lang.String prefix(java.lang.String arg__1)
Returns one of the prefixes mapped to the namespace URI uri.

If more than one prefix is currently mapped to the same URI, this function makes an arbitrary selection; if you want all of the prefixes, use prefixes() instead.

Note: to check for a default prefix, use the uri() function with an argument of "".

See also:
setPrefix().


prefixes

public final java.util.List prefixes()
Returns a list of all the prefixes currently declared.

If there is a default prefix, this function does not return it in the list; check for the default prefix using uri() with an argument of "".


prefixes

public final java.util.List prefixes(java.lang.String arg__1)
This is an overloaded member function, provided for convenience.

Returns a list of all prefixes currently declared for the namespace URI uri.

The "xml:" prefix is included. If you only want one prefix that is mapped to the namespace URI, and you don't care which one you get, use the prefix() function instead.

Note: The empty (default) prefix is never included in this list; to check for the presence of a default namespace, call uri() with "" as the argument.


pushContext

public final void pushContext()
Starts a new namespace context.

Normally, you should push a new context at the beginning of each XML element: the new context automatically inherits the declarations of its parent context, and it also keeps track of which declarations were made within this context.

See also:
popContext().


reset

public final void reset()
Resets this namespace support object ready for reuse.


setPrefix

public final void setPrefix(java.lang.String arg__1,
                            java.lang.String arg__2)
This function declares a prefix pre in the current namespace context to be the namespace URI uri. The prefix remains in force until this context is popped, unless it is shadowed in a descendant context.

Note that there is an asymmetry in this library. prefix() does not return the default "" prefix, even if you have declared one; to check for a default prefix, you must look it up explicitly using uri(). This asymmetry exists to make it easier to look up prefixes for attribute names, where the default prefix is not allowed.

See also:
prefix().


uri

public final java.lang.String uri(java.lang.String arg__1)
Looks up the prefix prefix in the current context and returns the currently-mapped namespace URI. Use the empty string ("") for the default namespace.


processName

public final QXmlNamespaceSupport.ProcessedName processName(java.lang.String qname,
                                                            boolean isAttribute)
Processes a raw XML 1.0 name in the current context by removing the prefix and looking it up among the prefixes currently declared.

qname is the raw XML 1.0 name to be processed. isAttribute is true if the name is an attribute name.

Note that attribute names are processed differently than element names: an unprefixed element name gets the default namespace (if any), while an unprefixed attribute name does not.


splitName

public final QXmlNamespaceSupport.SplitName splitName(java.lang.String qname)
Splits the name qname at the '.' and returns the prefix prefix and the local name.


clone

public QXmlNamespaceSupport clone()
This method is reimplemented for internal reasons

Overrides:
clone in class java.lang.Object