%Library.SerialObject
abstract serial class %Library.SerialObject extends %Library.SwizzleObject
For information on this class, see Introduction to Serial Objects.
The %SerialObject class builds upon the functionality provided by the %RegisteredObject class and gives an object the ability to serialize itself and be embedded within another object.Method Inventory
- %Delete()
- %DeleteId()
- %GetSwizzleObject()
- %IsNull()
- %Open()
- %OpenId()
- LogicalToOdbc()
- OdbcToLogical()
Parameters
Methods
Returns a %Status value indicating success or failure.
%DeleteId() is identical in operation to the %Delete() method except that it uses and Id value instead of an OID value to find an object. Refer to Object Concurrency Options for more details on the optional concurrency argument.
%GetSwizzleObject() automatically detects and handles circular references between objects. For example, %GetSwizzleObject() will detect if object A refers to object B and object B likewise refers to object A. In this case it will avoid falling into an infinite, recursive loop.
Note that either reference attribute, A to B or B to A, can be specified as being a required attribute but not both of them. If both reference attributes are required then %GetSwizzleObject() will fail.
By default %GetSwizzleObject() automatically manages transactions. You can enable and disable
automatic transaction support using the $$SetTransactionMode^%apiOBJ()
routine.
When %GetSwizzleObject() serializes an object, it initiates one transaction (by calling TSTART) for the entire set of serializations, including the original object and any related objects. If the serialization operation is successful, %GetSwizzleObject() will issue a TCOMMIT command to commit the transaction and write the data to the database. If %GetSwizzleObject() encounters an error during the transaction it rolls back the entire transaction and performs the following actions:
- It issues a TROLLBACK command to rollback any changes to the database that may have occurred. (In the case of persistent objects with system assigned ids changes to the on-disk counter value, used to determine the next available object id number, are not rolled back.)
- It attempts to restore the in-memory state of all the objects involved in the transaction to their pre-transaction state. This includes restoring any modified flags, and restoring to null ("") any OID values that have been assigned during the course of the transaction. Additional property values changed during the course of the transaction are not restored, however.
- It calls the %RollBack() method on each object involved with the transaction. The order in which the %RollBack() methods are called is undefined. %RollBack() will call a user-written %OnRollback() method if it is present.
Returns a %Status value indicating success or failure.
%OpenId() is identical in operation to the %Open() method except that it uses and Id value instead of an OID value to find an object instance.
%OpenId() returns an OREF value that refers to the in-memory object instance.
Inherited Members
Inherited Methods
- %AddToSaveSet()
- %AddToSyncSet()
- %ClassIsLatestVersion()
- %ClassName()
- %ConstructClone()
- %DispatchClassMethod()
- %DispatchGetModified()
- %DispatchGetProperty()
- %DispatchMethod()
- %DispatchSetModified()
- %DispatchSetMultidimProperty()
- %DispatchSetProperty()
- %Extends()
- %GetParameter()
- %IsA()
- %IsModified()
- %New()
- %NormalizeObject()
- %ObjectIsNull()
- %ObjectModified()
- %OnBeforeAddToSync()
- %OnDetermineClass()
- %OriginalNamespace()
- %PackageName()
- %RemoveFromSaveSet()
- %ResolveConcurrencyConflict()
- %SerializeObject()
- %SetModified()
- %SyncObjectIn()
- %SyncTransport()
- %ValidateObject()
Subclasses
- %CSP.Mgr.Helper.AlternativeServer
- %CSP.Mgr.Helper.ApplicationPath
- %CSP.Mgr.Helper.CacheServer
- %CSP.Mgr.Helper.CachedForms
- %CSP.Mgr.Helper.Connection
- %CSP.Mgr.Helper.Form
- %CSP.Util.Action
- %CSP.Util.Condition
- %CSP.Util.FormButton
- %CSP.Util.Link
- %CSP.Util.Menu
- %CSP.Util.MenuItem
- %DeepSee.Dashboard.CalculatedMember
- %DeepSee.Dashboard.ChartDataSeries
- %DeepSee.Dashboard.Control
- %DeepSee.Dashboard.DataProperty
- %DeepSee.Dashboard.PivotCondition
- %DeepSee.Dashboard.PivotLevel
- %DeepSee.Dashboard.Widget
- %DeepSee.PMML.Builder.AbstractBuilder
- %DeepSee.PMML.Data
- %DeepSee.PMML.Dataset.Field
- %DeepSee.PMML.ModelOutput
- %DeepSee.UserLibrary.WorksheetAxis
- %DeepSee.UserLibrary.WorksheetCell
- %DeepSee.extensions.modelling.conf.Attributes
- %DeepSee.extensions.modelling.conf.Call
- %DeepSee.extensions.modelling.conf.LDA
- %DeepSee.extensions.modelling.conf.NaiveBayes
- %DeepSee.extensions.modelling.conf.Operation
- %DeepSee.extensions.modelling.conf.PCA
- %DeepSee.extensions.modelling.conf.Report
- %DeepSee.extensions.modelling.conf.Sequence
- %DeepSee.extensions.modelling.conf.Sort
- %DeepSee.extensions.modelling.conf.Table
- %External.Messaging.JMSMessageProperty
- %External.Messaging.SQSMessageAttribute
- %Library.ArrayOfDataTypes
- %Library.ArrayOfObjects
- %Library.IStruct
- %Library.ListOfDataTypes
- %Library.ListOfObjects
- %Library.RelationshipObject
- %Net.MIMESerialPart
- %Net.MailMessagePart
- %OAuth2.Error
- %OAuth2.Server.Claim
- %SOAP.Security.Created
- %SOAP.Security.Password
- %SQL.StatementColumn
- %SQL.StatementObject
- %SQL.StatementParameter
- %Studio.Extension.MenuItem
- %WebStress.Control.AppServers
- %WebStress.Control.GeneratorStatus
- %WebStress.Control.Processes
- %WebStress.Control.Progress
- %WebStress.Control.ValidData.Request.Parameters
- %WebStress.Control.ValidData.Response
- %WebStress.Control.ValidData.Response.Generators
- %WebStress.Control.ValidData.Response.Generators.Data
- %WebStress.Playback.Session
- %XML.Security.Algorithm
- %iKnow.TextTransformation.OutputKeyValue
- %iKnow.TextTransformation.OutputLocation
- %iKnow.TextTransformation.OutputSection
- Ens.Alerting.Action
- Ens.Config.BusinessPartnerContact
- Ens.Config.Setting
- Ens.Config.SubProduction
- EnsLib.DICOM.Util.PresentationContext
- EnsLib.ITK.DTS.Framework.Status
- EnsLib.ITK.Framework.DistributionEnvelope
- EnsLib.ITK.Framework.ErrorCode
- EnsLib.JMS.Property
- EnsLib.REST.DynamicObjVDoc
- EnsLib.UDDI.dsig.SignatureValueType
- EnsLib.UDDI.uddi.accessPoint
- EnsLib.UDDI.uddi.addressLine
- EnsLib.UDDI.uddi.description
- EnsLib.UDDI.uddi.discoveryURL
- EnsLib.UDDI.uddi.email
- EnsLib.UDDI.uddi.errInfo
- EnsLib.UDDI.uddi.name
- EnsLib.UDDI.uddi.overviewURL
- EnsLib.UDDI.uddi.personName
- EnsLib.UDDI.uddi.phone
- EnsLib.UDDI.wsdl.Binding
- EnsLib.UDDI.wsdl.Port
- EnsLib.UDDI.wsdl.PortType
- EnsLib.UDDI.wsdl.SOAPService
- EnsLib.Workflow.TaskStatus
- EnsLib.ebXML.SOAPHeader
- EnsLib.ebXML.schema.msg.AckRequested
- EnsLib.ebXML.schema.msg.Acknowledgment
- EnsLib.ebXML.schema.msg.Description
- EnsLib.ebXML.schema.msg.Error
- EnsLib.ebXML.schema.msg.ErrorList
- EnsLib.ebXML.schema.msg.From
- EnsLib.ebXML.schema.msg.Manifest
- EnsLib.ebXML.schema.msg.MessageData
- EnsLib.ebXML.schema.msg.MessageHeader
- EnsLib.ebXML.schema.msg.MessageOrder
- EnsLib.ebXML.schema.msg.PartyId
- EnsLib.ebXML.schema.msg.Reference
- EnsLib.ebXML.schema.msg.Schema
- EnsLib.ebXML.schema.msg.Service
- EnsLib.ebXML.schema.msg.StatusRequest
- EnsLib.ebXML.schema.msg.StatusResponse
- EnsLib.ebXML.schema.msg.SyncReply
- EnsLib.ebXML.schema.msg.To
- EnsLib.ebXML.schema.msg.base
- EnsLib.ebXML.schema.msg.sequenceNumber.type
- EnsPortal.MsgFilter.Condition
- EnsPortal.MsgFilter.Filter
- EnsPortal.MsgFilter.Term
- EnsPortal.Util.ManagedAlertCriteria