Funciones del DAS XML de SDO
Clases predefinidas
El DAS XML proporciona dos clases principales. La primera es SDO_DAS_XML, la cual es la clase principal usada para obtener los datos de la fuente XML y para volver a escribir los datos. La segunda es la clase SDO_DAS_XML_Document, que representa los datos del documento XML.
También hay algunas clases de excepciones que pueden ser lanzadas si se encuentran errores al buscar o analizar los ficheros xsd o xml.
SDO_DAS_XML
Esta es la clase principal del DAS XML, que se utiliza para obtener los datos de la fuente xml así como para volver a escribir los datos. Y sus métodos para cargar y guardar ficheros xml:
Métodos
-
create Este es un método estático disponible en la clase SDO_DAS_XML. Usado para construir un objeto SDO_DAS_XML.
-
addTypes Funciona casi de la misma manera que create() pero se usa para añadir el contenido de un segundo o subsiguiente fichero de esquema a un DAS XML que ya ha sido creado.
-
createDataObject Se puede usar para construir un objeto de datos SDO de un tipo dado.
-
createDocument Se puede usar para construir un objeto Documento XML desde cero.
-
loadFile Carga el documento de instancia de xml desde un fichero. Este fichero puede estar en el sistema de ficheros local o en un host remoto.
-
loadString Lo mismo que el método de arriba. Carga la instancia xml que está disponible como cadena.
-
saveFile Guarda un objeto SDO_DAS_XML_Document como un fichero xml.
-
saveString Guarda un objeto SDO_DAS_XML_Document como una cadena xml.
SDO_DAS_XML_Document
Esta clase se usa para obtener el nombre y el espacio de nombres del elemento documento, y para obtener el objeto de datos raíz del documento. Por último, también se usa para establecer la versión de XML y la codificación de un documento en la salida.
Métodos
-
getRootDataObject Obtiene el DataObject raíz.
-
getRootElementName Obtiene el nombre del DataObject raíz.
-
getRootElementURI Obtiene el URI del DataObject raíz.
-
setEncoding Establece la cadena de codificaicon con el valor dado.
-
setXMLDeclaraion Para establecer/desestablecer la declaración xml.
-
setXMLVersion Establece la versión de cml con el valor dado.
SDO_DAS_XML_ParserException
Es una subclase de SDO_Exception. Lanzada por cualquier error de análisis al cargar el fichero xsd/xml.
SDO_DAS_XML_FileException
Es una subclase de SDO_Exception. Lanzada por cualquier método que carga datos desde un fichero, cuando no se puede encontrar el fichero.
Limitaciones en comparación con la especificación 2.0 de SDO
La » especificación 2.0 de SDO define la referenciación entre los tipos XML y los tipos SDO. Con SDO de Java, esta referenciación es implementada por XMLHelper. Con SDO para PHP, esta referenciación es implementada por el Servicio de Acceso a Datos XML. El DAS XML implementa la referenciación descrita en la especificación 2.0 de SDO con algunas restricciones. Una lista detallada de las limitaciones es:
-
Tipo Simple con sdoJava:instanceClass - no se proporciona un equivalente con PHP.
-
Tipo Simple con sdoJava:extendedInstanceClass - no se proporciona un equivalente con PHP.
-
Tipo Simple con lista de itemType.
-
Tipo Simple con unión.
-
Tipo Complejo con sdo:aliasName - no hay soporte de PHP para alias de Tipo SDO.
-
Atributo con sdo:aliasName - no hay soporte de PHP para alias de propiedades SDO.
-
Atribuo con valor predeterminado - no hay soporte de PHP para valores predeterminados de propiedades SDO.
-
Atributo con valor fijo - no hay soporte de PHP para propiedades de sólo lectura o valores predeterminados de SDO.
-
Atributo referenciando a DataObject con sdo:propertyType - ho hay soporte para sdo:propertyType="...".
-
Atributo con propiedad bidireccional para un DataObject con sdo:oppositeProperty y sdo:propertyType - no hay soporte de PHP para opuestos SDO.
-
Elemento con sdo:aliasName - no hay soporte de PHP para alias de propiedades SDO.
-
Elemento con grupo de sustitución.
-
Elemento de Tipo Simple con valor predeterminado - no hay soporte de PHP para valores predeterminados SDO.
-
Elemento de Tipo Simple con valor fijo - no hay soporte de PHP para propiedades de sólo lectura o valores predeterminados de SDO.
-
Elemento de Tipo Simple con sdo:string - no hay soporte para sdo:string="true".
-
Elemento referenciando un DataObject con sdo:propertyType - no hay soporte para sdo:propertyType="..."
-
Elemento con referencia bidireccional a un DataObject con sdo:oppositeProperty and sdo:propertyType - no hay soporte de PHP para opuestos SDO.
Tabla de contenidos
- SDO_DAS_XML::addTypes — Para cargar un segundo o subsiguiente fichero de esquema en un objteo SDO_DAS_XML
- SDO_DAS_XML::create — Para crar un objeto SDO_DAS_XML para un fichero de esquema dado
- SDO_DAS_XML::createDataObject — Crea un objeto SDO_DataObject dados un URI de espacio de nombres y un nombre de tipo
- SDO_DAS_XML::createDocument — Crea un objeto Documento XML desde cero, sin la necesidad de cargar un documento desde un fichero o una cadena
- SDO_DAS_XML::loadFile — Devuelve un objeto SDO_DAS_XML_Document para la ruta dada al documento de instancia xml
- SDO_DAS_XML::loadString — Devuelve un SDO_DAS_XML_Document para una cadena de instancia xml dada
- SDO_DAS_XML::saveFile — Guarda el objeto SDO_DAS_XML_Document en un fichero
- SDO_DAS_XML::saveString — Guarda el objeto the SDO_DAS_XML_Document en una cadena
- SDO_DAS_XML_Document::getRootDataObject — Devuelve el SDO_DataObject raíz
- SDO_DAS_XML_Document::getRootElementName — Devuelve el nombre del elemento raíz
- SDO_DAS_XML_Document::getRootElementURI — Devuelve la cadena del URI del elemento raíz
- SDO_DAS_XML_Document::setEncoding — Establece la cadena dada como codificación
- SDO_DAS_XML_Document::setXMLDeclaration — Establece la declaración de xml
- SDO_DAS_XML_Document::setXMLVersion — Establece la cadena dada como versión de xml