# Deprecated API

## Contents

- Deprecated Interfaces
- Deprecated Classes
- Deprecated Exceptions
- Deprecated Fields
- Deprecated Methods
- Deprecated Constructors

Deprecated Interfaces
Interface and Description
org.xml.sax.AttributeList This interface has been replaced by the SAX2 `Attributes` interface, which includes Namespace support.

oracle.jcr.CredentialsProvider
A CredentialsProvider generates a Credentials object when no Credentials object is supplied to the `login` method of Repository.

JCR allows the Repository `login` method to be called without Credentials (`login()` and `login(String)`) or with null Credentials (`login(Credentials)` and `login(Credentials, String)`).

The Oracle JCR framework allows a CredentialsProvider to be registered with a Repository. The CredentialsProvider method `getCredentials` is called by the JCR framework when no Credentials are supplied to the `login` method. The Credentials returned by this method are used to authenticate and create a JCR session, no differently than if Credentials were supplied to `login`.

org.xml.sax.DocumentHandler This interface has been replaced by the SAX2 `ContentHandler` interface, which includes Namespace support.
oracle.xml.parser.v2.NSName - use oracle.xml.util.NSName

oracle.jcr.OracleNamespaceRegistry
OracleNamespaceRegistry is the JCR namespace registry.

The namespace registry is cached by the OracleNamespaceRegistry object. The cache is automatically refreshed each time `registerNamespace` or `unregisterNamespace` is called on the OracleNamespaceRegistry object. Call `refresh` to explicitly refresh the cache.

Refer to XDBRepositoryConfiguration for further information on how the JCR namespace registry is stored by the XML DB Content Connector.

oracle.jcr.nodetype.OracleNodeTypeManager
OracleNodeTypeManager allows discovery of JCR node types.

For the XML DB Content Connector, OracleNodeTypeManager also allows XML schemas to be registered for use in JCR. Doing so creates JCR node types corresponding to the schema types and global element declarations defined by the XML schema. Schema-based content and metadata will then be exposed as JCR nodes of these node types, instead of the nt:unstructured node type.

Before a schema is registered for use in JCR, it should be registered for use in the database using the `DBMS_XMLSCHEMA.registerschema` PL/SQL procedure. Only globally-registered schemas can be used in JCR.

The list of registered XML schemas is cached by the OracleNodeTypeManager object. The cache is automatically refreshed each time `registerXMLSchema` or `unregisterXMLSchema` is called on the OracleNodeTypeManager object. Call `refresh` to explicitly refresh the cache.

Refer to XDBRepositoryConfiguration for further information on how the list of registered XML schemas is stored by the XML DB Content Connector.

oracle.jcr.query.OracleQuery OracleQuery is a parsed JCR query.
oracle.jcr.query.OracleQueryResult OracleQueryResult is the result of executing an OracleQuery.
oracle.jcr.OracleRepository OracleRepository is the entry point to a content repository. Use the OracleRepositoryFactory class to create and configure an OracleRepository object. Then call `login` to create a JCR session. OracleRepository objects are both Serializable and Referenceable, allowing them to be stored in a JNDI directory instead of being created and initialized each time.
oracle.jcr.OracleRepositoryConfiguration OracleRepositoryConfiguration specifies the configuration of an OracleRepository.
oracle.jcr.OracleSession OracleSession is an authenticated connection to a content repository.
oracle.jcr.OracleWorkspace OracleWorkspace is a JCR session's view of a repository workspace.
org.xml.sax.Parser This interface has been replaced by the SAX2 `XMLReader` interface, which includes Namespace support.

Deprecated Classes
Class and Description
org.xml.sax.helpers.AttributeListImpl This class implements a deprecated interface, `AttributeList`; that interface has been replaced by `Attributes`, which is implemented in the `AttributesImpl` helper class.
oracle.xml.transviewer.DBAccess Please use oracle.xml.dbaccess.DBAccess
oracle.xml.transviewer.DBAccessBeanInfo Please use oracle.xml.dbaccess.DBAccessBeanInfo
org.xml.sax.HandlerBase This class works with the deprecated `DocumentHandler` interface. It has been replaced by the SAX2 `DefaultHandler` class.
oracle.jcr.xdb.JDBCConnectionCredentials JDBCConnectionCredentials allows creation of a JCR session based on the user identity of an existing JDBC connection. The JCR session created from the JDBC connection will use that JDBC connection to access the XML DB repository.

oracle.jcr.OracleRepositoryFactory
OracleRepositoryFactory creates OracleRepository objects.

An OracleRepository is the entry point to a content repository. Each OracleRepository object encapsulates an OracleRepositoryConfiguration which describes how that OracleRepository operates against the underlying content repository. There is a different OracleRepositoryConfiguration implementation for each type of content repository. For example, an XDBRepositoryConfiguration encapsulates the JDBC OracleDataSource by which an OracleRepository connects to an XML DB repository.

org.xml.sax.helpers.ParserFactory This class works with the deprecated `Parser` interface.
oracle.xdb.dom.XDBAttribute as of Oracle Database 11g release 1, use oracle.xml.parser.v2.XMLAttr
oracle.xdb.dom.XDBBinaryDocument as of Oracle Database 11g release 1
oracle.xdb.dom.XDBCData as of Oracle Database 11g release 1, use oracle.xml.parser.v2.XMLCDATA
oracle.xdb.dom.XDBCharData as of Oracle Database 11g release 1, use oracle.xml.parser.v2.CharData
oracle.xdb.dom.XDBComment as of Oracle Database 11g release 1, use oracle.xml.parser.v2.XMLComment
oracle.xdb.dom.XDBDocFragment as of Oracle Database 11g release 1, use oracle.xml.parser.v2.XMLDocumentFragment
oracle.xdb.dom.XDBDocument as of Oracle Database 11g release 1, use oracle.xml.parser.v2.XMLDocument
oracle.xdb.dom.XDBDocumentType as of Oracle Database 11g release 1, use oracle.xml.parser.v2.DTD
oracle.xdb.dom.XDBDomImplementation as of Oracle Database 11g release 1, use oracle.xml.parser.v2.XMLDOMImplementation
oracle.xdb.dom.XDBElement as of Oracle Database 11g release 1, use oracle.xml.parser.v2.XMLElement
oracle.xdb.dom.XDBEntity as of Oracle Database 11g release 1, use oracle.xml.parser.v2.XMLEntity
oracle.xdb.dom.XDBEntityReference as of Oracle Database 11g release 1, use oracle.xml.parser.v2.XMLEntityReference
oracle.xdb.dom.XDBNamedNodeMap as of Oracle Database 11g release 1, use oracle.xml.parser.v2.XMLAttrList
oracle.xdb.dom.XDBNode as of Oracle Database 11g release 1, use oracle.xml.parser.v2.XMLNode
oracle.xdb.dom.XDBNodeList as of Oracle Database 11g release 1, use oracle.xml.parser.v2.XMLNodeList
oracle.xdb.dom.XDBNotation as of Oracle Database 11g release 1, use oracle.xml.parser.v2.XMLNotation
oracle.xdb.dom.XDBProcInst as of Oracle Database 11g release 1, use oracle.xml.parser.v2.XMLPI

oracle.jcr.xdb.XDBRepositoryConfiguration
XDBRepositoryConfiguration specifies the configuration of an OracleRepository connected to an XML DB repository using the XML DB Content Connector.

An XDBRepositoryConfiguration object is contained by a Repository object. When you deploy a JCR application, you can configure the Repository object and its contained XDBRepositoryConfiguration object for the application, then store the Repository object in a JNDI directory for retrieval at runtime.

The XDBRepositoryConfiguration object also records JCR's namespace registry and the list of XML schemas registered for use in JCR. This configuration data is updated using the methods of OracleNamespaceRegistry and OracleNodeTypeManager. Changes made using these methods take immediate effect within this Repository object. To make these changes permanent, rebind the Repository object into the JNDI directory.

oracle.jcr.xdb.XDBRepositoryConfigurationFactory XDBRepositoryConfigurationFactory is a JNDI ObjectFactory for XDBRepositoryConfiguration objects.
oracle.xdb.dom.XDBText as of Oracle Database 11g release 1, use oracle.xml.parser.v2.XMLText
oracle.xml.parser.v2.XMLSAXSerializer Use either XMLPrintDriver or ScalableDOMPrintDriver.
oracle.xml.parser.schema.XSDConstants This class is replaced by XSDConstantValues

Deprecated Exceptions
Exceptions and Description
oracle.xdb.dom.XDBDOMException as of Oracle Database 11g release 1, use oracle.xml.parser.v2.XMLDomException
oracle.xdb.dom.XDBDOMNotFoundErrException as of Oracle Database 11g release 1
oracle.xdb.dom.XDBNotImplementedException as of Oracle Database 11g release 1

Deprecated Fields
Field and Description
oracle.xdb.XMLType._SQL_TYPECODE
oracle.xdb.XMLType.CONNTYPE_KPRB
oracle.xdb.XMLType.CONNTYPE_OCI8
oracle.xdb.XMLType.CONNTYPE_THIN
oracle.xml.parser.v2.XMLParser.CONTENT_MODEL_DETERMINISTIC Replaced by XDK_FEATURE_CONTENT_MODEL_DETERMINISTIC.
oracle.xdb.XMLType.DEF_INDENT
oracle.xdb.XMLType.MAX_INDENT
oracle.xdb.XMLType.MAX_PFLAG
oracle.xml.sql.query.OracleXMLQuery.MAXROWS_DEFAULT since v2.0; Use `MAXROWS_ALL` instead
oracle.xml.sql.query.OracleXMLQuery.MAXROWS_NONE since v2.0; Use `0` instead
oracle.xdb.XMLType.PRINT_DEFAULT_PROPERTY
oracle.xdb.XMLType.PRINT_NOPRETTY
oracle.xdb.XMLType.PRINT_PRETTY
oracle.xml.sql.query.OracleXMLQuery.SKIPROWS_DEFAULT since v2.0; Use `0` instead
oracle.xml.sql.query.OracleXMLQuery.SKIPROWS_NONE since v2.0; Use `0` instead

Deprecated Methods
Method and Description
oracle.xml.parser.schema.XMLSchema.buildSchemaPathTable() - the path tables are now already built at compile time
oracle.xdb.XMLType.close() use SQLXML sqlxml; sqlxml.free();
oracle.xdb.XMLType.createSchemaBasedXML(String)
oracle.xdb.XMLType.createXML(Connection, CLOB) use createXML(Connection, OracleClob);
oracle.xdb.XMLType.createXML(Connection, CLOB, String, boolean, boolean) use oracle.jdbc.OracleClob someClob; SQLXML newXML = someClob.toSQLXML(); newXML.setSchemaURL(surl);
oracle.xdb.XMLType.createXML(Connection, Document) use java.sql.Connection myconn; SQLXML newXML = myconn.createSQLXML(); DOMResult domResult = newXML.setResult(DOMResult.class); domResult.setNode(myNode);
oracle.xdb.XMLType.createXML(Connection, String) use java.sql.Connection myconn; SQLXML newXML = myconn.createSQLXML(); newXML.setString(xmlval);
oracle.xdb.XMLType.createXML(Connection, String, String, boolean, boolean) use java.sql.Connection myconn; SQLXML newXML = myconn.createSQLXML(); newXML.setString(xmlval); newXML.setSchemaURL(surl);
oracle.xdb.XMLType.createXML(OPAQUE) Use SQLXML newXML = resultSet.getSQLXML(columnNumber);
oracle.xml.parser.schema.XSDSimpleType.derivedFrom(XSDSimpleType, String, String)
oracle.xdb.servlet.XDBServletResponse.encodeRedirectUrl(String)
oracle.xdb.servlet.XDBServletResponse.encodeUrl(String)
oracle.xml.comp.CXMLHandlerBase.endElement(NSName) this is replaced by endElement(namespace, localName, qname)
oracle.xml.comp.CXMLHandlerBase.endElement(String, String, String) this is replaced by endElement(namespace, localName, qname)
oracle.xml.parser.v2.XSLStylesheet.error(String, int)
oracle.xml.parser.v2.XSLStylesheet.execute(XSLTContext) should use XSLProcessor.processXSL function
oracle.xdb.XMLType.existsNode(String, String)
oracle.xdb.XMLType.extract(String, String)
oracle.xml.parser.v2.XMLElement.getAttributeNode(String, String) As of DOM 2
oracle.xml.parser.schema.XSDComplexType.getAttributeSet() - use getAttributeDeclarations and getAttributeWildcard
oracle.xml.parser.schema.XMLSchemaNode.getAttributeSet() - use getAttributeDeclarations
oracle.xml.parser.schema.XSDComplexType.getBaseAttributeSet() - access from base type
oracle.xml.parser.schema.XSDComplexType.getBaseElementSet() - use get base type
oracle.xdb.XMLType.getBlobVal(int) use toBlob(int csid)
oracle.xdb.XMLType.getBlobVal(int, int, int) use toBlob(int csid)
oracle.xdb.XMLType.getClobVal() - use toClob()
oracle.xdb.XMLType.getClobVal(int, int) - use toClob()
oracle.xml.parser.schema.XMLSchemaNode.getComplexTypeTable()
oracle.xdb.XMLType.getDocument() - use SQLXML sqlxml; DOMSource domSource = sqlxml.getSource(DOMSource.class); Document doc = (Document)domSource.getNode();
oracle.xdb.XMLType.getDocumentFragment() - use SQLXML sqlxml; DOMSource domSource = sqlxml.getSource(DOMSource.class); Document doc = (Document)domSource.getNode();
oracle.xdb.XMLType.getDOM() - use SQLXML sqlxml; DOMSource domSource = sqlxml.getSource(DOMSource.class); Document doc = (Document)domSource.getNode();
oracle.xml.parser.v2.XMLDocument.getIDElement(String) As of DOM 2
oracle.xdb.XMLType.getInputStream() - use SQLXML sqlxml; InputStream is = sqlxml.getBinaryStream()
oracle.xdb.XMLType.getInputStream(int, int) - use SQLXML sqlxml; InputStream is = sqlxml.getBinaryStream()
oracle.xml.parser.v2.SAXAttrList.getName(int) as of SAX2 - Replaced by getLocalName(int i)
oracle.xdb.XMLType.getNamespace()
oracle.xml.parser.v2.SAXAttrList.getNamespace(int) as of SAX2 - Replaced by getURI(int i)
oracle.xml.parser.schema.XSDAny.getNamespaceConstraint()
oracle.xml.parser.v2.XSLProcessor.getParam(String) - use getParam(String, String);
oracle.xml.jaxp.JXSAXParser.getParser() Use getXMLReader()
oracle.xml.parser.v2.XMLAttr.getPrevAttribute()
oracle.xml.parser.v2.XMLElement.getQualifiedName() - Use getNodeName
oracle.xml.parser.v2.SAXAttrList.getQualifiedName(int) as of SAX2 - Replaced by getQName(int i)
oracle.xdb.servlet.XDBServletRequest.getRealPath(String)
oracle.xdb.XMLType.getRootElement()
oracle.xdb.servlet.XDBServletContext.getServlet(String)
oracle.xdb.servlet.XDBServletContext.getServletNames()
oracle.xdb.servlet.XDBServletContext.getServlets()
oracle.xml.parser.schema.XMLSchemaNode.getSimpleTypeTable()
oracle.xdb.XMLType.getStringVal() - use SQLXML sqlxml; String s = sqlxml.getString()
oracle.xdb.XMLType.getStringVal(int, int) - use SQLXML sqlxml; String s = sqlxml.getString()
oracle.xml.sql.query.OracleXMLQuery.getXMLDOM(boolean) since 1.2.1; please use getXMLDOM(int) instead
oracle.xml.sql.query.OracleXMLQuery.getXMLString(boolean) since 1.2.1; please use getXMLString(int) instead
oracle.xml.util.XMLUtil.isFirstNameChar(char) Use isNameStartChar(int)
oracle.xml.parser.schema.XSDConstrainingFacet.isFixed(boolean)
oracle.xml.util.XMLUtil.isNameChar(char) Use isNameChar(int)
oracle.xml.parser.schema.XSDElement.isNullable() change to isNillable
oracle.xdb.servlet.XDBServletRequest.isRequestedSessionIdFromUrl()
oracle.xml.sql.query.OracleXMLQuery.keepCursorState(boolean) since 1.2.1; use keepObjectOpen instead.
oracle.xdb.servlet.XDBServletContext.log(Exception, String)
oracle.xml.parser.v2.XMLElement.normalize() As of DOM 2
oracle.xml.util.UnicodeUtil.normalizeUnicode(char[], int, int, int)
oracle.xml.util.UnicodeUtil.normalizeUnicode(String, int)
oracle.xml.util.UnicodeUtil.normalizeUnicodeNFC(char[], int, int)
oracle.xml.util.UnicodeUtil.normalizeUnicodeNFC(String)
oracle.xml.parser.v2.XSLStylesheet.removeParam(String) use XSLProcessor.removeParam to ensure thread safety
oracle.xml.parser.v2.XSLStylesheet.resetParams() use XSLProcessor.resetParams to ensure thread safety
oracle.xml.sql.query.OracleXMLQuery.setCollIdAttr(String) since 1.2.1; please use setCollIdAttrName instead.
oracle.xml.parser.v2.SAXParser.setDocumentHandler(DocumentHandler) as of SAX2.0 - Replaced by setContentHandler
oracle.xml.parser.v2.XSLStylesheet.setParam(String, String) use XSLProcessor.setParams to ensure thread safety
oracle.xml.sql.query.OracleXMLQuery.setRowIdColumn(String) since 1.2.1 -- please use setRowIdAttrValue instead.
oracle.xml.parser.v2.XMLParser.setSchemaValidationMode(boolean) Replaced by setValidationMode(int).
oracle.xdb.servlet.XDBServletResponse.setStatus(int, String)
oracle.xml.sql.query.OracleXMLQuery.setStyleSheet(String) since XSU2.0 -- please use `setStylesheetHeader` instead.
oracle.xml.sql.query.OracleXMLQuery.setStyleSheet(String, String) since XSU2.0 -- please use `setStylesheetHeader` instead.
oracle.xml.parser.v2.XMLParser.setValidationMode(boolean) Replaced by setValidationMode(int).
oracle.xml.parser.schema.XSDValidator.setXMLSchema(XMLSchema)
oracle.xdb.XMLType.writeToOutputStream(OutputStream)
oracle.xdb.XMLType.writeToOutputStream(OutputStream, int, int)

Deprecated Constructors
Constructor and Description
oracle.xml.parser.v2.XMLAttr() use createAttribute(String) or createAttributeNS(String, String) of XMLDocument
oracle.xml.parser.v2.XMLAttr(String, String) use createAttribute(String) method of XMLDocument
oracle.xml.parser.v2.XMLAttr(String, String, String, String) use createAttributeNS(String, String) method of XMLDocument
oracle.xml.parser.v2.XMLAttr(String, String, String, String, String) use crateAttribute(String) or createAttributeNS(String, String) of XMLDocument
oracle.xml.parser.v2.XMLCDATA() use createCDATASection(String) method of XMLDocument
oracle.xml.parser.v2.XMLCDATA(String) see createCDATASection(String) method of XMLDocument
oracle.xml.parser.v2.XMLComment() use createComment(String) method of XMLDocument
oracle.xml.parser.v2.XMLComment(String) use createComment(String) method of XMLDocument
oracle.xml.parser.v2.XMLDocumentFragment() use createDocumentFragment() method in XMLDocuemnt
oracle.xml.parser.v2.XMLEntityReference() use createEntityReference(String) method of XMLDocument
oracle.xml.parser.v2.XMLEntityReference(String) see createEntityReference(String) method of XMLDocuement
oracle.xml.parser.v2.XMLNotation() use XMLNotation(String)
oracle.xml.parser.v2.XMLPI() use createProcessingInstruction(String) method of XMLDocument
oracle.xml.parser.v2.XMLPI(String, String) see createProcessingInstruction(String) of XMLDocument
oracle.xml.parser.v2.XMLText() use createTextNode(String) of XMLDocument
oracle.xml.parser.v2.XMLText(String) use createTextNode(String) method of XMLDocument
oracle.xdb.XMLType(Connection, BLOB, int) use oracle.jdbc.OracleBlob someBlob; SQLXML newXML = someBlob.toSQLXML();
oracle.xdb.XMLType(Connection, byte[])
oracle.xdb.XMLType(Connection, CLOB) use createXML(Connection, OracleClob);
oracle.xdb.XMLType(Connection, CLOB, String, boolean, boolean) use oracle.jdbc.OracleClob someClob; SQLXML newXML = someClob.toSQLXML(); newXML.setSchemaURL(surl);
oracle.xdb.XMLType(Connection, Document) use java.sql.Connection myconn; SQLXML newXML = myconn.createSQLXML(); DOMResult domResult = newXML.setResult(DOMResult.class); domResult.setNode(myNode);
oracle.xdb.XMLType(Connection, Node) use java.sql.Connection myconn; SQLXML newXML = myconn.createSQLXML(); DOMResult domResult = newXML.setResult(DOMResult.class); domResult.setNode(myNode);
oracle.xdb.XMLType(Connection, String) use java.sql.Connection myconn; SQLXML newXML = myconn.createSQLXML(); newXML.setString(xmlval);
oracle.xdb.XMLType(Connection, String, String, boolean, boolean) use java.sql.Connection myconn; SQLXML newXML = myconn.createSQLXML(); newXML.setString(xmlval); newXML.setSchemaURL(surl);
oracle.xdb.XMLType(OpaqueDescriptor, Connection, Object)
oracle.xml.parser.schema.XSDSimpleType(int, String)
oracle.xml.parser.v2.XSLStylesheet() Use XSLProcessor.newXSLStylesheet instead
oracle.xml.parser.v2.XSLStylesheet(InputStream, URL) Use XSLProcessor.newXSLStylesheet instead
oracle.xml.parser.v2.XSLStylesheet(Reader, URL) Use XSLProcessor.newXSLStylesheet instead
oracle.xml.parser.v2.XSLStylesheet(URL, URL) Use XSLProcessor.newXSLStylesheet instead
oracle.xml.parser.v2.XSLStylesheet(XMLDocument, URL) Use XSLProcessor.newXSLStylesheet instead

Copyright © 2003, 2019, Oracle and/or its affiliates. All rights reserved.
Use is subject to license terms. Also see the documentation redistribution policy.
ORACLE CONFIDENTIAL
For authorized use only.
Do not distribute to third parties.