Uses of Class
com.senzing.sdk.SzException
Package
Description
This package provides the interfaces, utility classes, enumerations,
constants and exception types pertaining to the Senzing SDK for Java.
This package provides the "core" implementation of the Senzing SDK for
Java defined in the
com.senzing.sdk
package.-
Uses of SzException in com.senzing.sdk
Modifier and TypeClassDescriptionclass
Defines an exceptional condition when an invalid input value is provided to a Senzing operation preventing the successful completion of that operation.class
Defines an exceptional condition when a failure has occurred pertaining to the Senzing configuration.class
ExtendsSzRetryableException
to define an exceptional condition where a database connection was lost causing a Senzing operation to fail.class
ExtendsSzUnrecoverableException
to define an exceptional condition triggered by a database error from which we cannot recover (e.g.: missing or unexpected schema definition).class
ExtendsSzUnrecoverableException
to define an exceptional condition triggered by an invalid, expired or exhausted Senzing license.class
ExtendsSzBadInputException
to define an exceptional condition where the provided bad input to a Senzing operation is an identifier that could not be used to successfully locate required data for that operation.class
ExtendsSzUnrecoverableException
to define an exceptional condition triggered by Senzing not being initialized.class
Describes an exceptional condition when an attempt is made to replace a Senzing value with a new value providing it has not not already been changed, however, the current value is no longer the expected value and has therefore already been changed.class
Defines an exceptional condition where the failure is an intermittent condition and the operation may be retried with the same parameters with an expectation of success.class
ExtendsSzRetryableException
to define an exceptional condition where an operation failed because a timeout was exceeded.class
ExtendsSzUnrecoverableException
to define an exceptional condition caused by an otherwise unhandled and unexpected failure in the Senzing SDK.class
ExtendsSzBadInputException
to define an exceptional condition where a specified data source code is not confifgured in the current active configuration and therefore the data source could not be found.class
Defines an exceptional condition where the failure is not recoverable and all operations should be stopped until the system can be modified to resolve the condition causing the failure.Modifier and TypeMethodDescriptionlong
Adds the configuration described by the specified JSON to the repository with the specified comment and returns the identifier for referencing the the config in the entity repository.SzConfig.addDataSource
(long configHandle, String dataSourceCode) Adds a new data source that is identified by the specified data source code to the in-memory configuration associated with the specified configuraiton handle.SzEngine.addRecord
(SzRecordKey recordKey, String recordDefinition, Set<SzFlag> flags) SzDiagnostic.checkDatastorePerformance
(int secondsToRun) Runs non-destruction DB performance tests and returns detail of the result as a JSONString
.void
SzConfig.closeConfig
(long configHandle) Closes the in-memory configuration associated with the specified config handle and cleans up system resources.void
SzEngine.closeExport
(long exportHandle) This function closes an export handle of a previously opened export to clean up system resources.long
SzEngine.countRedoRecords()
Gets the number of redo records pending to be processed.long
SzConfig.createConfig()
Creates a new in-memory configuration using the default configuraiton template and returns the configuration handle for working with it.void
SzConfig.deleteDataSource
(long configHandle, String dataSourceCode) Deletes the data source identified by the specified data source code from the in-memory configuration associated with the specified config handle.SzEngine.deleteRecord
(SzRecordKey recordKey, Set<SzFlag> flags) Delete a previously loaded record identified by the data source code and record ID from the specifiedSzRecordKey
.SzConfig.exportConfig
(long configHandle) Obtains the configuration definition formatted as JSON for the in-memory configuration associated with the specified configuration handle.long
SzEngine.exportCsvEntityReport
(String csvColumnList, Set<SzFlag> flags) Initiates an export of entity data in CSV format and returns an "export handle" that can be used to read the export data and must be closed when complete.long
SzEngine.exportJsonEntityReport
(Set<SzFlag> flags) Iniitiates an export of entity data as JSON-lines format and returns an "export handle" that can be used to read the export data and must be closed when complete.SzEngine.fetchNext
(long exportHandle) Fetches the next line of entity data from the export identified by the specified export handle.SzEngine.findInterestingEntities
(long entityId, Set<SzFlag> flags) SzEngine.findInterestingEntities
(SzRecordKey recordKey, Set<SzFlag> flags) An experimental method to obtain interesting entities pertaining to the entity that contains a specific record that is identified by the data source code and record ID associated with the specifiedSzRecordKey
using the specifiedSet
ofSzFlag
instances.SzEngine.findNetwork
(SzEntityIds entityIds, int maxDegrees, int buildOutDegrees, int buildOutMaxEntities, Set<SzFlag> flags) Finds a network of entity relationships surrounding the paths between a set of entities identified by one or more entity ID's specified in an instance ofSzEntityIds
-- which is aSet
of non-nullLong
entity ID's.SzEngine.findNetwork
(SzRecordKeys recordKeys, int maxDegrees, int buildOutDegrees, int buildOutMaxEntities, Set<SzFlag> flags) Finds a network of entity relationships surrounding the paths between a set of entities having the constituent records identified by the data source code and record ID pairs contained in the specified instance ofSzRecordKeys
-- which is aSet
of one or more non-nullSzRecordKey
instances.SzEngine.findPath
(long startEntityId, long endEntityId, int maxDegrees, SzEntityIds avoidEntityIds, Set<String> requiredDataSources, Set<SzFlag> flags) Finds a relationship path between two entities identified by their entity ID's.SzEngine.findPath
(SzRecordKey startRecordKey, SzRecordKey endRecordKey, int maxDegrees, SzRecordKeys avoidRecordKeys, Set<String> requiredDataSources, Set<SzFlag> flags) Finds a relationship path between two entities identified by the data source codes and record ID's of their constituent records given by the specified start and endSzRecordKey
instances.long
SzEnvironment.getActiveConfigId()
Gets the currently active configuration ID for theSzEnvironment
.SzConfigManager.getConfig
(long configId) Gets the configuration with the specified config ID and returns the configuration defintion as aString
.SzEnvironment.getConfig()
Provides a reference to theSzConfig
instance associated with thisSzEnvironment
.SzEnvironment.getConfigManager()
Provides a reference to theSzConfigManager
instance associated with thisSzEnvironment
.SzConfigManager.getConfigs()
Gets the list of saved configuration ID's with their comments and timestamps and return the JSONString
describing them.SzConfig.getDataSources
(long configHandle) Extracts the data sources from the in-memory configuration associated with the specified config handle returns the JSON text describing the data sources from the configuration.SzDiagnostic.getDatastoreInfo()
Gathers detailed information on the data store and returns it as a JSONString
.long
SzConfigManager.getDefaultConfigId()
Gets the configuration ID of the default configuration for the repository and returns it.SzEnvironment.getDiagnostic()
Provides a reference to theSzDiagnostic
instance associated with thisSzEnvironment
.SzEnvironment.getEngine()
Provides a reference to theSzEngine
instance associated with thisSzEnvironment
.This method is used to retrieve information about a specific resolved entity.SzEngine.getEntity
(SzRecordKey recordKey, Set<SzFlag> flags) This method is used to retrieve information about the resolved entity that contains a specific record that is identified by the data source code and record ID associated with the specifiedSzRecordKey
.SzDiagnostic.getFeature
(long featureId) Experimental/internal method for obtaining diagnostic feature definition for the specified feature identifier.SzProduct.getLicense()
Returns the currently configured license details.SzEnvironment.getProduct()
Provides a reference to theSzProduct
instance associated with thisSzEnvironment
.SzEngine.getRecord
(SzRecordKey recordKey, Set<SzFlag> flags) Retrieves the record identified by the data source code and record ID from the specifiedSzRecordKey
.SzEngine.getRedoRecord()
Retrieves a pending redo record from the reevaluation queue.SzEngine.getStats()
Returns the current internal engine workload statistics for the process.SzProduct.getVersion()
Returns the currently installed version details.SzEngine.getVirtualEntity
(Set<SzRecordKey> recordKeys, Set<SzFlag> flags) Describes a hypothetically entity that would be composed of the one or more records identified by the data source code and record ID pairs in the specifiedSet
ofSzRecordKey
instances.Deterimes how an entity identified by the specified entity ID was constructed from its constituent records.long
SzConfig.importConfig
(String configDefinition) Creates a new in-memory configuration using the specified configuration definition and returns the configuration handle for working with it.SzEngine.preprocessRecord
(String recordDefinition, Set<SzFlag> flags) void
SzEngine.primeEngine()
May optionally be called to pre-initialize some of the heavier weight internal resources of theSzEngine
.SzEngine.processRedoRecord
(String redoRecord, Set<SzFlag> flags) Processes the specified redo record using the specified flags.void
SzDiagnostic.purgeRepository()
Purges all data in the configured repository.SzEngine.reevaluateEntity
(long entityId, Set<SzFlag> flags) Reevaluate a resolved entity identified by the specified entity ID.SzEngine.reevaluateRecord
(SzRecordKey recordKey, Set<SzFlag> flags) Reevaluate the record identified by the data source code and record ID from the specifiedSzRecordKey
.void
SzEnvironment.reinitialize
(long configId) Reinitializes theSzEnvironment
with the specified configuration ID.void
SzConfigManager.replaceDefaultConfigId
(long currentDefaultConfigId, long newDefaultConfigId) Replaces the current configuration ID of the repository with the specified new configuration ID providing the current configuration ID of the repository is equal to the specified old configuration ID.SzEngine.searchByAttributes
(String attributes, String searchProfile, Set<SzFlag> flags) This method searches for entities that match or relate to the provided search attributes using the optionally specified search profile.SzEngine.searchByAttributes
(String attributes, Set<SzFlag> flags) This method is equivalent to callingSzEngine.searchByAttributes(String, String, Set)
with anull
value for the search profile parameter.void
SzConfigManager.setDefaultConfigId
(long configId) Sets the default configuration for the repository to the specified configuration ID.SzEngine.whyEntities
(long entityId1, long entityId2, Set<SzFlag> flags) Determines the ways in which two entities identified by the specified entity ID's are related to each other.SzEngine.whyRecordInEntity
(SzRecordKey recordKey, Set<SzFlag> flags) Determines why the record identified by the data source code and record ID in the specified in anSzRecordKey
is included in its respective entity.SzEngine.whyRecords
(SzRecordKey recordKey1, SzRecordKey recordKey2, Set<SzFlag> flags) Determines ways in which two records identified by the data source code and record ID pairs from the specifiedSzRecordKey
instances are related to each other. -
Uses of SzException in com.senzing.sdk.core
Modifier and TypeMethodDescriptionlong
SzCoreEnvironment.getActiveConfigId()
SzCoreEnvironment.getConfig()
SzCoreEnvironment.getConfigManager()
SzCoreEnvironment.getDiagnostic()
SzCoreEnvironment.getEngine()
SzCoreEnvironment.getProduct()
void
SzCoreEnvironment.reinitialize
(long configId)