📄 ref.sdo.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html> <head> <title>SDO Functions</title> <meta http-equiv="content-type" content="text/html; charset=UTF-8"> </head> <body><div style="text-align: center;"> <div class="prev" style="text-align: left; float: left;"><a href="book.sdo.html">SDO</a></div> <div class="next" style="text-align: right; float: right;"><a href="function.sdo-das-changesummary-beginlogging.html">SDO_DAS_ChangeSummary::beginLogging</a></div> <div class="up"><a href="book.sdo.html">SDO</a></div> <div class="home"><a href="index.html">PHP Manual</a></div></div><hr /><div> <h1 class="title">SDO Functions</h1> <div class="partintro"> <div id="sdo.das.table" class="section"> <h2 class="title">Data Access Services</h2> <p class="para"> The table below lists the currently provided SDO Data Access Services: <table class="informaltable"> <colgroup> <thead valign="middle"> <tr valign="middle"> <th colspan="1">DAS Name</th> <th colspan="1">Description</th> </tr> </thead> <tbody valign="middle" class="tbody"> <tr valign="middle"> <td colspan="1" rowspan="1" align="left"> <a href="ref.sdo-das-xml.html" class="link">SDO_DAS_XML</a> </td> <td colspan="1" rowspan="1" align="left"> An XML Data Access Service supporting reading/writing SDOs as XML documents. </td> </tr> <tr valign="middle"> <td colspan="1" rowspan="1" align="left"> <a href="ref.sdo.das.rel.html" class="link">SDO_DAS_Relational</a> </td> <td colspan="1" rowspan="1" align="left"> A PDO-based Data Access Service supporting reading/writing SDO to relational databases. Implements an optimistic concurrency policy for updates. </td> </tr> </tbody> </colgroup> </table> </p> </div> <div id="sdo.classes" class="section"> <h2 class="title">Predefined Classes</h2> <p class="para"> SDO consists of three sets of interfaces. The first set covers those interfaces for use by typical SDO applications. These are identified by the package prefix 'SDO_'. The second set is those used to reflect on, and work with, the model of a data object. These are identified by the package prefix 'SDO_Model_'. Finally, the third set are those use by Data Access Service implementations and are identified by the package prefix 'SDO_DAS_'. The majority of SDO users will not need to use or understand the 'SDO_Model_' and 'SDO_DAS_' interfaces. </p> <div id="sdo.class.sdo-apis" class="section"> <h2 class="title">SDO Application Programmer Interface</h2> <div id="sdo.class.sdo-dataobject" class="section"> <h2 class="title"> <b class="classname">SDO_DataObject</b> </h2> <p class="para"> The main interface through which data objects are manipulated. In addition to the methods below, SDO_DataObject extends the ArrayAccess, SDO_PropertyAccess (defines <b>__get()</b> / <b>__set()</b> methods for property access overloading), Iterator, and Countable interfaces. </p> <div id="sdo.class.SDO_DataObject.methods" class="section"> <h2 class="title">Methods</h2> <ul class="itemizedlist"> <li class="listitem"> <p class="para"> <a href="function.sdo-dataobject-getsequence.html" class="link">getSequence</a> - get the sequence for the data object </p> </li> <li class="listitem"> <p class="para"> <a href="function.sdo-dataobject-createdataobject.html" class="link">createDataObject</a> - create a child data object </p> </li> <li class="listitem"> <p class="para"> <a href="function.sdo-dataobject-clear.html" class="link">clear</a> - unset the properties of a data object </p> </li> <li class="listitem"> <p class="para"> <a href="function.sdo-dataobject-getcontainer.html" class="link">getContainer</a> - get the container (also known as 'parent') of this data object </p> </li> <li class="listitem"> <p class="para"> <a href="function.sdo-dataobject-gettypename.html" class="link">getTypeName</a> - get the name of the type for this data object </p> </li> <li class="listitem"> <p class="para"> <a href="function.sdo-dataobject-gettypenamespaceuri.html" class="link">getTypeNamespaceURI</a> - get the namespace URI of the type for this data object </p> </li> </ul> </div> </div> <div id="sdo.class.sdo-sequence" class="section"> <h2 class="title"> <b class="classname">SDO_Sequence</b> </h2> <p class="para"> The interface through which sequenced data objects can be accessed to preserve ordering across a data object's properties and to allow unstructured text. SDO_Sequence preserves contiguous indices and therefore inserting or removing elements may shift other elements up or down. In addition to the methods below, SDO_Sequence extends the ArrayAccess, Iterator and Countable interface. </p> <div id="sdo.class.SDO_Sequence.methods" class="section"> <h2 class="title">Methods</h2> <ul class="itemizedlist"> <li class="listitem"> <p class="para"> <a href="function.sdo-sequence-getproperty.html" class="link">getProperty</a> - get the property for a given sequence index </p> </li> <li class="listitem"> <p class="para"> <a href="function.sdo-sequence-move.html" class="link">move</a> - move an element from one property index to another </p> </li> <li class="listitem"> <p class="para"> <a href="function.sdo-sequence-insert.html" class="link">insert</a> - insert a new value into the sequence </p> </li> </ul> </div> </div> <div id="sdo.class.sdo-list" class="section"> <h2 class="title"> <b class="classname">SDO_List</b> </h2> <p class="para"> The interface through which many-valued properties are manipulated. In addition to the method defined below, SDO_List extends ArrayAccess, Iterator and Countable. SDO_List preserves contiguous indices and therefore inserting or removing elements may shift other elements up or down. </p> <div id="sdo.class.SDO-List.methods" class="section"> <h2 class="title">Methods</h2> <ul class="itemizedlist"> <li class="listitem"> <p class="para"> <a href="function.sdo-list-insert.html" class="link">insert</a> - insert a new value into the list </p> </li> </ul> </div> </div> <div id="sdo.class.sdo-datafactory" class="section"> <h2 class="title"> <b class="classname">SDO_DataFactory</b> </h2> <p class="para"> The interface through which data objects can be created. A Data Access Service is responsible for populating the model (i.e. configuring the data factory with the type and structure information for the data objects it can create.) for the factory and can then optionally return an instance of, or implement, the SDO_DataFactory interface. </p> <div id="sdo.class.SDO-DataFactory.methods" class="section"> <h2 class="title">Methods</h2> <ul class="itemizedlist"> <li class="listitem"> <p class="para"> <a href="function.sdo-datafactory-create.html" class="link">create</a> - create a new data object </p> </li> </ul> </div> </div> <div id="sdo.class.sdo-exception" class="section"> <h2 class="title"> <b class="classname">SDO_Exception</b> </h2> <p class="para"> An SDO_Exception is thrown when the caller's request cannot be completed. The subclasses of SDO_Exception are: <ul class="itemizedlist"> <li class="listitem"> <p class="para">SDO_PropertyNotSetException - the property specified exists but has not been set or does not have a default value </p> </li> <li class="listitem"> <p class="para">SDO_PropertyNotFoundException - the property specified is not part of the data object's type </p> </li> <li class="listitem"> <p class="para">SDO_TypeNotFoundException - the specified namespace URI or type name is unknown </p> </li> <li class="listitem"> <p class="para">SDO_InvalidConversionException - conversion between the types of the assignment is not possible </p> </li> <li class="listitem"> <p class="para">SDO_IndexOutOfBoundsException - the numeric index into a data object, sequence or list is not in the valid range </p> </li> <li class="listitem"> <p class="para">SDO_UnsupportedOperationException - the request cannot be completed because it is not allowed, for example an attempt to set a read-only property. </p> </li> </ul> </p> <div id="sdo.class.SDO_Exception.methods" class="section"> <h2 class="title">Methods</h2> <p class="para">One method is added to those inherited from the built in <a href="language.exceptions.html#language.exceptions.extending" class="link">Exception</a> class: </p> <ul class="itemizedlist"> <li class="listitem"> <p class="para"> <a href="function.sdo-exception-getcause.html" class="link">getCause</a> - get the cause of this SDO_Exception </p> </li> </ul> </div> </div> </div> <div id="sdo.class.sdo-model-apis" class="section"> <h2 class="title">SDO Reflection Application Programmer Interfaces</h2> <div id="sdo.class.sdo-reflectiondataobject" class="section"> <h2 class="title"> <b class="classname">SDO_Model_ReflectionDataObject</b> </h2> <p class="para"> The main interface used to reflect on a data object instance to obtain its model type and property information. It is designed to follow the reflection pattern introduced in PHP 5. </p> <div id="sdo.class.SDO_Model_ReflectionDataObject.constructor" class="section"> <h2 class="title">Constructor</h2> <ul class="itemizedlist"> <li class="listitem"> <p class="para"> <a href="function.sdo-model-reflectiondataobject-construct.html" class="link">__construct</a> - construct a new SDO_Model_ReflectionDataObject. </p> </li> </ul> </div> <div id="sdo.class.SDO_Model_ReflectionDataObject.methods" class="section"> <h2 class="title">Methods</h2> <ul class="itemizedlist"> <li class="listitem"> <p class="para"> <a href="function.sdo-model-reflectiondataobject-export.html" class="link">export</a> - get a string describing the data object. </p> </li> <li class="listitem"> <p class="para"> <a href="function.sdo-model-reflectiondataobject-gettype.html" class="link">getType</a> - get the SDO_Model_Type for the data object. </p> </li> <li class="listitem"> <p class="para"> <a href="function.sdo-model-reflectiondataobject-getinstanceproperties.html" class="link">getInstanceProperties</a> - get the instance properties of the data object. </p> </li> <li class="listitem"> <p class="para"> <a href="function.sdo-model-reflectiondataobject-getcontainmentproperty.html" class="link">getContainmentProperty</a> - get the property which defines the containment relationship to the data object. </p> </li> </ul> </div> </div> <div id="sdo.class.sdo-type" class="section"> <h2 class="title"> <b class="classname">SDO_Model_Type</b> </h2> <p class="para"> The interface through which a data object's type information can be retrieved. This interface can be used to find out the type name and namespace URI of the type, whether the type allow open content, and so on. </p> <div id="sdo.class.SDO_Model_Type.methods" class="section"> <h2 class="title">Methods</h2> <ul class="itemizedlist"> <li class="listitem"> <p class="para"> <a href="function.sdo-model-type-getname.html" class="link">getName</a> - get the name of the type. </p> </li> <li class="listitem"> <p class="para"> <a href="function.sdo-model-type-getnamespaceuri.html" class="link">getNamespaceURI</a> - get the namespace URI of the type. </p> </li> <li class="listitem"> <p class="para"> <a href="function.sdo-model-type-isinstance.html" class="link">isInstance</a> - test for a data object being an instance of the type. </p> </li> <li class="listitem"> <p class="para"> <a href="function.sdo-model-type-getproperties.html" class="link">getProperties</a> - get the properties of the type. </p> </li> <li class="listitem"> <p class="para"> <a href="function.sdo-model-type-getproperty.html" class="link">getProperty</a> - get a property of the type. </p> </li> <li class="listitem"> <p class="para"> <a href="function.sdo-model-type-isdatatype.html" class="link">isDataType</a> - test to see if this type is a primitive scalar type. </p> </li> <li class="listitem"> <p class="para"> <a href="function.sdo-model-type-issequencedtype.html" class="link">isSequencedType</a> - test to see if this is a sequenced type. </p> </li> <li class="listitem"> <p class="para"> <a href="function.sdo-model-type-isopentype.html" class="link">isOpenType</a> - test to see if this is an open type. </p> </li> <li class="listitem"> <p class="para"> <a href="function.sdo-model-type-isabstracttype.html" class="link">isAbstractType</a> - test to see if this is an abstract type. </p> </li> <li class="listitem"> <p class="para"> <a href="function.sdo-model-type-getbasetype.html" class="link">getBaseType</a> - get the base type of this type (if one exists). </p> </li> </ul> </div> </div> <div id="sdo.class.sdo-property" class="section"> <h2 class="title"> <b class="classname">SDO_Model_Property</b> </h2> <p class="para"> The interface through which a data object's property information can be retrieved. This interface can be used to find out the type of a property, whether a property has a default value, whether the property is contained or reference by its parent, its cardinality, and so on. </p> <div id="sdo.class.SDO_Model_Property.methods" class="section"> <h2 class="title">Methods</h2> <ul class="itemizedlist"> <li class="listitem"> <p class="para"> <a href="function.sdo-model-property-getname.html" class="link">getName</a> - get the name of the property. </p> </li> <li class="listitem"> <p class="para"> <a href="function.sdo-model-property-gettype.html" class="link">getType</a> - get the type of the property. </p> </li> <li class="listitem"> <p class="para"> <a href="function.sdo-model-property-ismany.html" class="link">isMany</a> - test to see if the property is many-valued. </p> </li> <li class="listitem"> <p class="para"> <a href="function.sdo-model-property-iscontainment.html" class="link">isContainment</a> - test to see if the property describes a containment relationship. </p> </li> <li class="listitem"> <p class="para"> <a href="function.sdo-model-property-getcontainingtype.html" class="link">getContainingType</a> - get the type which contains this property. </p> </li> <li class="listitem"> <p class="para"> <a href="function.sdo-model-property-getdefault.html" class="link">getDefault</a> - get the default value for a property. </p> </li> </ul> </div> </div> </div> <div id="sdo.class.sdo-das-spis" class="section"> <h2 class="title"> SDO Data Access Service Developer Interfaces </h2> <div id="sdo.class.sdodas-dataobject" class="section"> <h2 class="title"> <b class="classname">SDO_DAS_DataObject</b> </h2> <p class="para"> The interface through which a Data Access Service can access a data object's <a href="ref.sdo.html#sdo.class.sdodas-changesummary" class="link">SDO_DAS_ChangeSummary</a>. The change summary is used by the Data Access Service to check for conflicts when applying changes back to a data source. </p> <div id="sdo.class.SDO_DAS_DataObject.methods" class="section"> <h2 class="title">Methods</h2> <ul class="itemizedlist"> <li class="listitem"> <p class="para"> <a href="function.sdo-das-dataobject-getchangesummary.html" class="link">getChangeSummary</a> - get the change summary for a data object </p> </li> </ul> </div> </div> <div id="sdo.class.sdodas-changesummary" class="section"> <h2 class="title"> <b class="classname">SDO_DAS_ChangeSummary</b> </h2> <p class="para"> The interface through which the change history of a data object is accessed. The change summary holds information for any⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -