Documentación de Velneo
25
25
  • Introducción
  • Velneo
    • ¿Qué es velneo?
    • Requerimientos de Velneo
    • Notas de la versión
    • Funcionalidades comunes a los componentes de Velneo
      • Instalación
      • Conexión con Velneo vServer
      • Cambiar el estilo de visualización
      • Ver u ocultar barras de herramientas
      • Mensajería interna entre usuarios
      • Soporte de alta resolución (HighDPI)
      • Carpetas de trabajo de los componentes de Velneo
      • Numeración de versiones de Velneo
      • Certificado de firma digital para componentes de Windows
    • Tipos de archivo generados por Velneo
  • Velneo vDevelop
    • ¿Qué es Velneo vDevelop?
    • Interfaz de Velneo vDevelop
    • Lista de teclas aceleradoras de Velneo vDevelop
    • Soluciones y proyectos
    • Control y edición de proyectos
    • Herencia
    • Inspectores
    • Proyectos objetos y editores
      • Objeto
      • De proyecto de datos
        • Indice complejo
        • Tabla
          • Actualización
          • Campo
          • Enlace
          • Indice
          • Plural
          • Traspaso de campo
          • Trigger
        • Tabla estática
        • Variable
      • De proyecto de aplicación
        • Acción
        • Alternador de lista
        • Arbol visor de tablas
        • Bloc de formularios
        • Casillero
        • Cesta
        • ComboView
        • Control SVG
        • Dispositivo serie
        • Formulario
          • Controles de visualización
            • Texto estático
            • Nombre de campo
            • Visor HTML
            • Dibujo
            • Imagen SVG
            • Caja de grupo
            • Menú arbolado
            • Barra de progreso
            • Reloj
            • Manómetro
            • Termómetro
          • Controles de edición
            • Caja de texto
            • Caja de texto enriquecido
            • Data catcher edit
            • Edición alfabética
            • Edición fecha
            • Edición fecha/hora
            • Edición fórmula
            • Edición hora
            • Edición numérica
            • Edición senda fichero
            • Edición senda directorio
            • Objeto dibujo
          • Controles de entrada
            • Botón
            • Botón de check
            • Botón de radio
            • Calendario
            • ComboBox
            • Deslizador
            • Dial
            • ListBox
            • Rueda
          • Contenedores
            • Área de scroll
            • Caja de formularios
            • Pila de formularios
            • Separador de formularios
            • Splitter
            • Vista de datos
          • Layout
          • Tree widget
          • Controles SVG
          • Fichas de extensión
        • Formulario QML
        • Gráfico
        • Imagen SVG
        • Impresora lógica
        • Informe
          • Editor de informes
          • Agrupamiento
          • Sección
          • Cálculo
        • Informe personalizable
          • Diseñando un informe personalizable básico
          • Diseño avanzado
          • Diseñando un informe personalizable
          • Añadiendo orígenes de datos
          • Añadiendo elementos al informe
          • Características avanzadas
          • Etiquetas
          • Asistente de scripts
          • Impresión de gráficos
          • Opciones html
        • ListView
        • Lista QML
        • Localizador
        • Marco
        • Menú
        • Multivista
        • Protocolo TCP-IP
        • Rejilla
          • Propiedades de columna
        • Rejilla avanzada
        • Toolbar
        • ViewFlow
        • Sub-objetos de vistas de datos
          • Conexión de evento
          • Drop
          • Inserción
          • Manejador de evento
      • Comunes a proyecto de datos y de aplicación
        • Búsqueda
        • Cola
        • Constante
        • Dibujo
        • Esquema de tablas
        • Fichero adjunto
        • Función
        • Librería externa
        • Lupa
        • Proceso
          • Comandos de base de datos
            • API
            • Bases de datos externas
            • Búsquedas
            • Campos (grupo de comandos)
            • Cestas
            • Fichas
            • Fichas seleccionadas
            • Listas
            • Tablas
            • Tubos
          • Básicos
            • Controles de flujo
            • Debug
            • Ejecución
            • Salida/retornos
            • Scripts (grupo de comandos)
            • Transacciones (comandos)
            • Variables
          • Comunicación
            • Internet
            • Protocolo TCP
            • Puerto serie
            • SDV
          • Interfaz
            • Acciones (comandos)
            • Control
            • Diálogos
            • Formularios - comandos
            • Localizadores
            • Objeto - grupo de comandos
            • Ventana principal
            • Vista de datos - comandos
          • Sistema
            • Comandos de Sistema
            • Configuración
            • Directorios
            • Ficheros
        • Tubo de ficha
        • Tubo de lista
        • Variable local
      • Editores
        • Asistente de fórmulas
          • Operadores
          • Funciones estándar
            • Funciones API
            • Funciones básicas
            • Funciones de cadenas
              • Expresiones regulares
            • Funciones científicas
            • Funciones de Cliente-servidor
            • Funciones de color
            • Funciones de códigos
            • Funciones de directorios
            • Funciones de fechas
            • Funciones de ficha en curso
            • Funciones de horas
            • Funciones de Internet
            • Funciones de juegos de caracteres
              • Codecs
            • Funciones numéricas
            • Funciones de sistema
            • Funciones de tiempo
            • Funciones trigonométricas
          • Funciones de dll
          • Funciones de proceso
          • Funciones de campo
          • Campos
          • Constantes
          • Variables globales
          • Variables locales
          • Variables del sistema
          • Verificador de fórmulas
          • Conversión automática de datos
          • Introducción de datos literales
          • Secuencias de escape en cadenas de caracteres
          • Composición de sendas en fórmulas
        • Editor de imágenes
        • Selector de fuentes
    • Scripts
      • Lenguajes
        • JavaScript
          • Procesos JavaScript
          • Fórmulas JavaScript
          • Clases
            • Funciones globales
            • Objetos
            • VAbstractBrowser
            • VAbstractDataView
            • VAbstractListDataView
            • VAdvandedGridListDataView
            • VAlternatorListDataView
            • VApp
            • VBoundFieldComboBox
            • VBoundFieldEdit
            • VBoundFieldEditBrowser
            • VBoundFieldListBox
            • VByteArray
            • VCheckBox
            • VClipboard
            • VClockWidget
            • VComboBox
            • VComboListDataView
            • VCoverFlowListDataView
            • VCWebView
            • VDataCatcherEdit
            • VDataCatcherEditBrowser
            • VDataViewDialog
            • VDateEdit
            • VDateEditBrowser
            • VDateTimeEdit
            • VDateTimeEditBrowser
            • VDial
            • VDir
            • VExtension
            • VFile
            • VFileInfo
            • VFilePathEditBrowser
            • VFinder
            • VFont
            • VFormBlockListDataView
            • VFormDataView
            • VFormulaEditBrowser
            • VGaugeWidget
            • VGridListDataView
            • VGroupBox
            • VImage
            • VImageEdit
            • VImageWidget
            • VInstancesList
            • VInstance
            • VInstances
            • VItemRegisterPattern
            • VLabel
            • VLineEdit
            • VLineEditBrowser
            • VListBox
            • VListDataView
            • VLogin
            • VMainWindow
            • VMdiView
            • VMimeData
            • VMultiDataView
            • VNumberSpinBox
            • VNumberSpinBoxBrowser
            • VObjectInfo
            • VObjectInstance
            • VProcess
            • VProgressBar
            • VProjectInfo
            • VPushButton
            • VQmlFormDataView
            • VQmlListDataView
            • VQmlListModel
            • VQuery
            • VRadioButton
            • VRegister
            • VRegisterList
            • VReportListDataView
            • VRequest
            • VResponse
            • VRoot
            • VScreen
            • VScrollArea
            • VServerAdmin
            • VSettings
            • VSlider
            • VSlotListDataView
            • VSolutionInfo
            • VSplitter
            • VSqlDatabase
            • VSSLCertificate
            • VSSLInfo
            • VSSLSessionCipher
            • VStackedWidget
            • VSvgButton
            • VSvgSlideSwitch
            • VSvgToggleSwitch
            • VSvgWidget
            • VSysInfo
            • VTableInfo
            • VTabWidget
            • VTextEdit
            • VTextFile
            • VThermometerWidget
            • VThumbWheel
            • VTimeEdit
            • VTimeEditBrowser
            • VToolBox
            • VTreeItem
            • VTreeItemRegister
            • VTreeListDataView
            • VTreeMenu
            • VTreeMultiTableListDataView
            • VTreeWidget
            • VUser
            • VUserGroup
            • VUserGroupList
            • VUserList
            • VXmlReader
            • VXmlWriter
            • Widget
            • XMLHttpRequest
        • QML
          • Tipos QML
          • Funciones específicas de QML
    • Depuración
      • Depuración de procesos de Velneo
      • Depuración de procesos JavaScript
      • Monitor de vClient
    • Extensiones de Velneo vDevelop
    • Acceso directo a una solución desde vDevelop
    • Buenas prácticas
      • Buenas prácticas de organización
        • Proyectos
        • Organización de carpetas
        • Proyecto de datos
        • Proyecto de aplicación
      • Buenas prácticas de codificación
        • Identificadores
        • Teclas aceleradoras
        • Documenta
        • Diseña los formularios como si no existiesen los layouts
      • Buenas prácticas de rendimiento
        • Arquitectura
          • Listas de registros
          • Lista de resultados de una búsqueda
          • Las cestas
          • Las variables globales
          • La caché de fichas
          • Programa en cloud
        • Base de datos
          • Campos
          • Indices
          • Actualizaciones
          • Eventos de tabla o triggers
          • Variables globales y constantes
          • Tablas en memoria vs tablas en disco
          • Optimizar migraciones de datos
          • Búsquedas en el servidor ¿Cuándo y Cómo?
          • Campos fórmula vs campos en disco
          • Indices condicionados vs búsquedas complejas
          • ¿Cuándo usar tablas de extensión?
          • Indices de trozos y palabras
          • ¿Cuándo usar cada tipo de campo alfa?
        • Formularios
          • Condiciones de visible y activo
          • Carga de subformularios en pestaña, caja o pila
        • Procesos y funciones y eventos
          • 1º, 2º, 3º y 4º plano ¿Cuándo usar cada uno?
          • Bloqueo blando vs bloqueo duro
          • Pasar información del cliente al servidor
          • ¿Cómo optimizar transacciones grandes?
          • ¿Cómo gestionar las transacciones?
          • Grabaciones optimizadas para el usuario
        • Carga de registros en objetos de lista
          • Rejillas
            • Campos punteros a singular
            • Totales
            • Condiciones de activo, visible y color en columna
            • Campos de tipo objeto
        • Conoce los límites
      • Imágenes
      • Buenas prácticas para el desarrollo en equipo
    • Análisis de bases de datos para aplicaciones de Velneo
      • Un centro de enseñanza
      • Facturas de un cliente
      • Repartos de obras de teatro
      • Galería de arte
      • Gestión de un colegio
      • Instalación de lunas para vehículos
      • Libros y autores
      • Tienda de discos
      • Últimos pedidos de un proveedor
      • Existencias por almacén y precios por cliente
      • Generación de tickets para un quiosco
      • Navegación por facturas
  • Velneo vAdmin
    • ¿Qué es Velneo vAdmin?
    • Gestión de usuarios
    • Gestión de aplicaciones
      • Soluciones
      • Instancias
      • Disco
    • Monitorización
      • Lista de comandos
    • Tareas
    • Acceso directo
  • Velneo vClient
    • ¿Qué es Velneo vClient?
    • Movilidad
    • Funcionalidades de Velneo vClient
      • Accesos directos y VRL
      • Cambiar idioma
      • Panel de procesos en 2º plano
      • Manejo de rejillas
      • Uso de la rejilla avanzada
      • Manejo de cestas
      • Refrescos
      • Caché local
      • Edición de campos enlazados a maestro
      • Edición de campos de tipo fecha
      • Capturar imagen desde una cámara
      • Asignar impresoras lógicas
      • Actualización automática
      • Personalización de la ventana de conexión de Velneo vClient
      • Instalador personalizado de Velneo vClient
      • Ordenación de listas
  • Velneo vServer
    • ¿Qué es Velneo vServer?
    • Instalación y configuración
      • Activación de la licencia
      • Línea de comandos de Velneo vServer
      • Parámetros configurables de Velneo vServer
      • Estructura de directorios
    • Iniciar Velneo vServer
    • Funcionalidades
      • Protocolo VATP
      • Protocolo VATPS
      • Multi-hilo
      • Integridad referencial
      • Refrescos terciarios
      • Sistema transaccional
      • Sistema de bloqueos
      • Tecnología bigkey
      • Hilo de control
    • vPacker
  • Velneo vInstallBuilder
    • ¿Qué es Velneo vInstallBuilder?
    • Configurar una instalación
    • Probar una instalación
    • Crear el instalable
    • Accesos directos
  • Velneo vModApache
    • ¿Qué es Velneo vModApache?
    • Instalación y configuración
    • Nomenclatura de objetos en urls
    • Uso de ficheros adjuntos
    • Caché local de Velneo vModApache
  • Velneo vDataClient
    • ¿Qué es Velneo vDataClient?
    • Iniciar Velneo vDataClient
    • Interfaz de Velneo vDataClient
    • Procesos
    • Utilidades
    • Acceso directo a una instancia de datos
  • Velneo vTranslator
    • ¿Qué es Velneo vTranslator?
    • Importación y exportación basada en XLIFF
    • Acceso directo a una solución
  • Velneo ODBC Driver
    • ¿Qué es velneo ODBC Driver?
    • Referencia de comandos SQL
  • Velneo vVersion
    • ¿Qué es Velneo vVersion?
  • Velneo vERP
    • ¿Qué es Velneo vERP?
    • Manual del programador
    • Documentación del ApiRest
    • Novedades de la versión
  • Velneo vTutor
    • ¿Qué es vTutor?
    • Tutores de objetos básicos
      • Tutor de árboles visores de tablas arboladas
      • Tutor de búsquedas
      • Tutor de cestas
      • Tutor de formularios
      • Tutor de informes
      • Tutor de localizador básico
      • Tutor de marcos
      • Tutor de rejillas
      • Tutor de rejillas avanzadas
    • Tutores de objetos avanzados
      • Tutor de alternadores de lista
      • Tutor de comboview
      • Tutor de drag and drop
      • Tutor de eventos
      • Tutor de grabación de fichas
      • Tutor de gráficos
      • Tutor de impresión de informes
      • Tutor de lupas
      • Tutor de protocolo TCP/IP
    • Tutores de controles
      • Tutor de botones de menú
      • Tutor de controles SVG
      • Tutor de edición numérica
      • Tutor de visor html dinámico
      • Tutor de vistas de datos de lista
    • Tutores de procesos y manejadores de evento avanzados
      • Tutor de comandos de interfaz y acciones
      • Tutor de importación y exportación de ficheros ASCII
      • Tutor de portapapeles
      • Tutor de procesos
      • Tutor de SDV
    • Tutores de scripts
      • QML: hola mundo
      • QML: tutor básico
      • QML: tutor de vistas
      • Tutor de XMLHttpRequest (webServices)
  • Velneo cloud
    • ¿Qué es Velneo Cloud?
    • Panel de control vServer cloud
      • URC
      • vServer
      • Apache
      • SFTP
      • Usuarios
    • Copias de seguridad
    • Velneo cloud API
      • Uso de Velneo cloud API
    • Explorador de archivos cloud sFTP
    • TCP en Velneo cloud
    • Velneo vModApache en cloud
    • SLA
    • Hora de los servidores en el cloud de Velneo
    • ¿Qué puedo hacer si tengo una incidencia en mi servidor cloud?
Con tecnología de GitBook
En esta página
  • Funciones
  • Enumeraciones
  • Documentación de funciones
  • Constructor
  • Datos de entrada
  • Funciones generales
  • Ejemplos
  • 1 Ejemplo de bucle típico con VXmlReader
  • 2 Procesar un fichero xml con formato xbel 1.0 y mostrar el resultado un control del tipo treeWidget

¿Te fue útil?

  1. Velneo vDevelop
  2. Scripts
  3. Lenguajes
  4. JavaScript
  5. Clases

VXmlReader

Es un parseador rápido de archivos well-formed XML 1.0 para lectura de manera secuencial. Una vez construído el objeto VXmlReader hay que indicarle uno de los siguientes orígenes:

  • Disco con la funcion setFile

  • Memoria añadiendo uno o varios buffers o strings con las funciones addDataBuffer y addDataString.

Funciones

Constructor

Función

Datos de entrada

Retorno

Función

void

void

void

Generales

Retorno

Función

Boolean

String

Number

void

Number

String

String

String

String

String

Number

String

Boolean

Boolean

Boolean

Boolean

Boolean

Boolean

Boolean

Boolean

Boolean

Boolean

Boolean

Boolean

Boolean

Number

String

String

String

String

String

String

void

String

String

Number

Boolean

void

String

String

Number

Enumeraciones

Error

  • NoError = 0

  • UnexpectedElementError = 1

  • CustomError = 2

  • NotWellFormedError = 3

  • PrematureEndOfDocumentError = 4

ReadElementTextBehaviour

  • ErrorOnUnexpectedElement = 0

  • IncludeChildElements = 1

  • SkipChildElements = 2

TokenType

  • NoToken = 0

  • Invalid = 1

  • StartDocument = 2

  • EndDocument = 3

  • StartElement = 4

  • EndElement = 5

  • Characters = 6

  • Comment = 7

  • DTD = 8

  • EntityReference = 9

  • ProcessingInstruction = 10

Documentación de funciones

Constructor

VXmlReader()

Crea un objeto de la clase VXmlReader.

Requiere importar la clase previamente: importClass("VXmlReader").

Ejemplo:

var rss = new VXmlReader();

Datos de entrada

void addDataBuffer( VByteArray data )

void addDataString( String data )

Añade una cadena de texto al objeto de la clase VXmlReader.

void setFile( VFile file )

Funciones generales

Boolean atEnd()

Devuelve true si el lector ha llegado al fin del documento XML, o si se ha producido un error y la lectura ha sido abortada, en caso contrario se devuelve false.

String attributeValue( String qualifiedName )

Number characterOffset()

Devuelve el desplazamiento del carácter en curso, comenzando por la posición 0.

void clear()

Borra cualquier dispositivo o dato del lector y resetea su estado interno al estado inicial.

Number columnNumber()

Devuelve el número de columna en curso, la primera columna ocupa la posición 0.

String documentEncoding()

Si el estado del documento, función tokenType(), es StartDocument la función devuelve una cadena con el valor de su codificación especificada como una declaración XML. En el resto de caso devuelve una cadena vacía.

String documentVersion()

Si el estado del documento, función tokenType(), es StartDocument la función devuelve una cadena con la versión del documento especificada como una declaración XML, en caso contrario devuelve una cadena vacía.

String dtdName()

Si el estado del documento, función tokenType(), es DTD la función retorna el nombre del DTD, en caso contrario devuelve una cadena vacía.

String dtdPublicId()

Si el estado del documento, función tokenType(), es DTD la función retorna el identificador público del DTD, en caso contrario devuelve una cadena vacía.

String dtdSystemId()

Si el estado del documento, función tokenType(), es DTD la función retorna el identificador del sistema DTD, en caso contrario devuelve una cadena vacía.

Number error()

Devuelve el tipo del error en curso o NoError (ver enum Error) si no se ha producido ningún error.

String errorString()

Devuelve el mensaje de error por defecto o el que estaba fijado con la función raiseError().

Boolean hasError()

Devuelve true si se ha producido un error, en caso contrario devuelve false.

Boolean isCDATA()

Devuelve true si el lector retorna caracteres que proceden de una sección CDATA, en caso contrario devuelve false.

Boolean isCharacters()

Devuelve true si tokenType() devuelve el valor "Characters", en caso contrario devuelve false.

Boolean isComment()

Devuelve true si tokenType() devuelve el valor "Comment", en caso contrario devuelve false.

Boolean isDTD()

Devuelve true si tokenType() devuelve el valor "DTD", en caso contrario devuelve false.

Boolean isEndDocument()

Devuelve true si tokenType() devuelve el valor "EndDocument", en caso contrario devuelve false.

Boolean isEndElement()

Devuelve true si tokenType() devuelve el valor "EndElement", en caso contrario devuelve false.

Boolean isEntityReference()

Devuelve true si tokenType() devuelve el valor "EntityReference", en caso contrario devuelve false.

Boolean isProcessingInstruction()

Devuelve true si tokenType() devuelve el valor "ProcessingInstruction", en caso contrario devuelve false.

Boolean isStandaloneDocument()

Devuelve true si el documento ha sido declarado como único en la declaración XML, en caso contrario devuelve false. Si no ha sido parseada una declaración XML, la función devuelve false.

Boolean isStartDocument()

Devuelve true si tokenType() devuelve el valor "StartDocument", en caso contrario devuelve false.

Boolean isStartElement()

Devuelve true si tokenType() devuelve el valor "StartElement", en caso contrario devuelve false.

Boolean isWhitespace()

Devuelve true si los caracteres retornados por el lector solo contienen espacios en blanco, en caso contrario devuelve false.

Number lineNumber()

Devuelve la línea en curso, las numeración comienza por la línea 1.

String name()

Devuelve el nombre local de un StartElement, EndElement, or an EntityReference.

String namespaceUri()

Devuelve el namespaceUri de a StartElement or EndElement.

String prefix()

Devuelve el prefijo de un StartElement or EndElement.

String processingInstructionData()

Devuelve el dato de un ProcessingInstruction.

String processingInstructionTarget()

Devuelve el target de un ProcessingInstruction.

String qualifiedName()

Devuelve el nombre cualificado de un StartElement o EndElement.

Un nombre calificado es el nombre en bruto de un elemento en los datos XML. Está compuesto por el prefijo del namespace, seguido de dos puntos, seguido por el nombre local del elemento. El prefijo de namespace no es único (el mismo prefijo puede apuntar a diferentes namespaces y diferentes prefijos puede apuntar al mismo namespace).

void raiseError( String message = String )

Levanta un mensaje de error con una texto personalizado.

Parámetros:

  • message: texto del mensaje personalizado para el error.

String readElementText( Number behaviour )

Esta función se llamada cuando se lee un startElement, lee hasta llegar al EndElement correspondiente y devuelve todo el texto en el medio. En caso de error, el token actual (ver TokenType()) después de haber llamado a esta función es EndElement.

La función concatena text() cuando lee o bien caracteres o fichas EntityReference, pero se salta ProcessingInstruction y comentario. Si el token actual no es startElement, se devuelve una cadena vacía.

El comportamiento define lo que sucede en caso de que cualquier otra cosa que se lea antes de llegar EndElement. La función puede incluir el texto desde elementos hijos (útil por ejemplo para HTML), ignorar elementos secundarios, o lanzar una UnexpectedElementError y devolver lo que se ha leído hasta ahora.

Parámetros:

  • behaviour: ver enum ReadElementTextBehaviour

String readElementText()

Esta función se llamada cuando se lee un startElement, lee hasta llegar al EndElement correspondiente y devuelve todo el texto en el medio. En caso de error, el token actual (ver TokenType()) después de haber llamado a esta función es EndElement.

La función concatena text() cuando lee o bien caracteres o fichas EntityReference, pero se salta ProcessingInstruction y comentario. Si el token actual no es startElement, se devuelve una cadena vacía.

Number readNext()

Lee el siguiente token y devuelve su tipo. Ver enum TokenType.

Si se dispara una excepción que devuelve el error() al ejecutar readNext() produce que la lectura adicional del stream XML ya no sea posible, en ese punto atEnd() devuelve true, hasError() devuelve verdadero, y esta función devuelve QXmlStreamReader válida.

La excepción que devuelve el error() PrematureEndOfDocumentError se notifica cuando se alcanza el final del documento XML, pero realmente no se ha alcanzado el final del documento XML completo. En ese caso, el análisis se puede reanudar llamando addData() para agregar el siguiente fragmento de XML, cuando el stream está siendo leído desde un QByteArray, o esperando más datos que se recibirán a través de un stream.

Boolean readNextStartElement()

Lee hasta el inicio del siguiente elemento dentro del elemento en curso. Devuelve true cuando alcanza un elemento de inicio. Devuelve false cuando alcanza un elemento final o cuando se produce un error.

El elemento en curso es el elemento que coincida con el elemento de inicio más recientemente analizado del que aún no se haya alcanzado el final. Cuando el analizador haya alcanzado el elemento final, el elemento principal se convierte en el elemento actual.

Es posible recorrer un documento llamando repetidamente a esta función garantizando al mismo tiempo que el lector no haya alcanzado el final del documento.

void skipCurrentElement()

Lee hasta el final del elemento en curso, omitiendo cualquier nodo hijo. Esta función es útil para saltarse elementos desconocidos.

El elemento en curso es el elemento que coincida con el elemento de inicio más recientemente analizado del que aún no se haya alcanzado un elemento final coincidente. Cuando el analizador alcanza el elemento final, el elemento padre se convierte en el elemento en curso.

String text()

Devuelve el texto de los elementos de tipo Characters, Comment, DTD, o EntityReference.

String tokenString()

Devuelve una cadena con el valor del token en curso.

Number tokenType()

Devuelve el estado del documento. Ver enum TokenType.

El tocken en curso también puede ser consultado con las funciones isStartDocument(), isEndDocument(), isStartElement(), isEndElement(), isCharacters(), isComment(), isDTD(), isEntityReference(), and isProcessingInstruction().

Ejemplos

1 Ejemplo de bucle típico con VXmlReader

// Abrimos el fichero
var inFile = new VFile( senda );
inFile.open(VFile.OpenModeReadOnly);

// Preparamos el objeto para parsear el XML
var xml = new VXmlReader();
xml.setFile(inFile);
VXmlReader xml;
xml.setFile( myVFile );

while (!xml.atEnd())
{
xml.readNext();
… // procesar
};
if (xml.hasError())
{
… // manejar el error
};
importClass("VXmlReader");
importClass("VFile");

// -------------------------------------------------------
// Parseador de ficheros XML en formato xbel 1.0
// -------------------------------------------------------

// Preparamos el control treewidget
var treeWidget = theRoot.dataView().control("TREE_WIDGET");
treeWidget.clear();

// Leemos el fichero desde la senda del control
var fileEdit = theRoot.dataView().control("FILE");
var inFile = new VFile( fileEdit.text );
inFile.open(VFile.OpenModeReadOnly);

// Preparamos el objeto para parsear el XML
var xml = new VXmlReader();
xml.setFile(inFile);

// Leemos el primer elemento del fichero para comprobar que es de tipo xbel versión 1.0
if (xml.readNextStartElement()) 
{
    if (xml.name() == "xbel" && xml.attributeValue("version") == "1.0")
    {
        // XBEL read
        while (xml.readNextStartElement()) 
        {
            if (xml.name() == "folder")
                readFolder(treeWidget, 0, xml);
            else if (xml.name() == "bookmark")
                readBookmark(treeWidget, 0, xml);
            else if (xml.name() == "separator")
                readSeparator(treeWidget, 0, xml);
            else
                xml.skipCurrentElement();
        };
    }
    else
        xml.raiseError("Este fichero no es un XBEL 1.0");
};

// Ajusta las columnas al contenido
treeWidget.resizeColumnToContents(0);
treeWidget.setFocus();

// --------------------------
// Lectura de la carpeta
// --------------------------
function readFolder(tree, item, xml)
{
    var itemFolder;
    if (item)
        itemFolder = item.addChild();
    else
        itemFolder = tree.addTopLevelItem();
    var folded = (xml.attributeValue("folded") != "no");
    itemFolder.setExpanded(!folded);

    while (xml.readNextStartElement()) 
    {
        if (xml.name() == "title")
            readTitle(itemFolder, xml);
        else if (xml.name() == "folder")
            readFolder(tree, itemFolder, xml);
        else if (xml.name() == "bookmark")
            readBookmark(tree, itemFolder, xml);
        else if (xml.name() == "separator")
            readSeparator(tree, itemFolder, xml);
        else
            xml.skipCurrentElement();
    };
};

// ----------------------
// Lectura del  título
// ----------------------
function readTitle( item, xml )
{
    var title = xml.readElementText();
    item.setText(0, title);
};

// ---------------------------
// Lectura del  bookmark
// ---------------------------
function readBookmark(tree, item, xml)
{
    var itemBookmark;
    if (item)
        itemBookmark = item.addChild();
    else
        itemBookmark = tree.addTopLevelItem();

    itemBookmark.setFlags(0 | itemBookmark.flags() | VTreeItem.ItemIsEditable);
    itemBookmark.setText(0, "Título desconocido");
    itemBookmark.setText(1, xml.attributeValue("href"));

    while (xml.readNextStartElement()) 
    {
        if (xml.name() == "title")
            readTitle(itemBookmark, xml);
        else
            xml.skipCurrentElement();
    };
};

// --------------------------
// Lectura del separador
// --------------------------
function readSeparator(tree, item, xml)
{
    var itemSeparator;
    if (item)
        itemSeparator = item.addChild();
    else
        itemSeparator = tree.addTopLevelItem();

    itemSeparator.setText(0, "...............................................................................");
    xml.skipCurrentElement();
};

Última actualización hace 4 años

¿Te fue útil?

()

( VByteArray data )

( String data )

( VFile file )

()

( String qualifiedName )

()

()

()

()

()

()

()

()

()

()

()

()

()

()

()

()

()

()

()

()

()

()

()

()

()

()

()

()

()

()

( String message = String )

( Number behaviour )

()

()

()

()

()

()

()

Añade una buffer contenido en un objeto de la clase al objeto de la clase VXmlReader.

Asigna un fichero (objeto de la clase ) al objeto de la clase VXmlReader para procesar su contenido.

2 Procesar un fichero xml con formato xbel 1.0 y mostrar el resultado un control del tipo

VByteArray
VFile
treeWidget
VXmlReader
addDataBuffer
addDataString
setFile
atEnd
attributeValue
characterOffset
clear
columnNumber
documentEncoding
documentVersion
dtdName
dtdPublicId
dtdSystemId
error
errorString
hasError
isCDATA
isCharacters
isComment
isDTD
isEndDocument
isEndElement
isEntityReference
isProcessingInstruction
isStandaloneDocument
isStartDocument
isStartElement
isWhitespace
lineNumber
name
namespaceUri
prefix
processingInstructionData
processingInstructionTarget
qualifiedName
raiseError
readElementText
readElementText
readNext
readNextStartElement
skipCurrentElement
text
tokenString
tokenType