Uses of Class
com.senzing.sdk.SzException
Packages that use 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
Subclasses of SzException in com.senzing.sdkModifier 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
ExtendsSzRetryableException
to define an exceptional condition where an operation failed because a database condition that is transient and would like be resolved on a repeated attempt.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 configured 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.Methods in com.senzing.sdk that throw SzExceptionModifier and TypeMethodDescriptiondefault String
SzEngine.addRecord
(SzRecordKey recordKey, String recordDefinition) Convenience method for callingSzEngine.addRecord(SzRecordKey, String, Set)
usingSzFlag.SZ_ADD_RECORD_DEFAULT_FLAGS
as the value for theflags
parameter.SzEngine.addRecord
(SzRecordKey recordKey, String recordDefinition, Set<SzFlag> flags) Loads a record into the repository and performs entity resolution.SzDiagnostic.checkRepositoryPerformance
(int secondsToRun) Conducts a rudimentary repository test to gauge I/O and network performance.void
SzEngine.closeExportReport
(long exportHandle) Closes an export report.long
SzEngine.countRedoRecords()
Gets the number of redo records pending processing.SzConfigManager.createConfig()
Creates a newSzConfig
instance from the template configuration definition.SzConfigManager.createConfig
(long configId) Creates a newSzConfig
instance for a configuration ID.SzConfigManager.createConfig
(String configDefinition) Creates a newSzConfig
instance from a configuration definition.default String
SzEngine.deleteRecord
(SzRecordKey recordKey) Convenience method for callingSzEngine.deleteRecord(SzRecordKey, Set)
usingSzFlag.SZ_DELETE_RECORD_DEFAULT_FLAGS
as the value for theflags
parameter.SzEngine.deleteRecord
(SzRecordKey recordKey, Set<SzFlag> flags) Deletes a record from the repository and performs entity resolution.SzConfig.export()
Retrieves the definition for this configuration.default long
SzEngine.exportCsvEntityReport
(String csvColumnList) Convenience method for callingSzEngine.exportCsvEntityReport(String, Set)
usingSzFlag.SZ_EXPORT_DEFAULT_FLAGS
as the value for theflags
parameter.long
SzEngine.exportCsvEntityReport
(String csvColumnList, Set<SzFlag> flags) Initiates an export report of entity data in CSV format.default long
SzEngine.exportJsonEntityReport()
Convenience method for callingSzEngine.exportJsonEntityReport(Set)
usingSzFlag.SZ_EXPORT_DEFAULT_FLAGS
as the value for theflags
parameter.long
SzEngine.exportJsonEntityReport
(Set<SzFlag> flags) Initiates an export report of entity data in JSON Lines format.SzEngine.fetchNext
(long exportHandle) Fetches the next line of entity data from an open export report.default String
SzEngine.findInterestingEntities
(long entityId) Convenience method for callingSzEngine.findInterestingEntities(long, Set)
withSzFlag.SZ_FIND_INTERESTING_ENTITIES_DEFAULT_FLAGS
as the value for theflags
parameter.SzEngine.findInterestingEntities
(long entityId, Set<SzFlag> flags) Experimental method.default String
SzEngine.findInterestingEntities
(SzRecordKey recordKey) Convenience method for callingSzEngine.findInterestingEntities(SzRecordKey, Set)
withSzFlag.SZ_FIND_INTERESTING_ENTITIES_DEFAULT_FLAGS
as the value for theflags
parameter.SzEngine.findInterestingEntities
(SzRecordKey recordKey, Set<SzFlag> flags) Experimental method.default String
SzEngine.findNetwork
(SzEntityIds entityIds, int maxDegrees, int buildOutDegrees, int buildOutMaxEntities) Convenience method for callingSzEngine.findNetwork(SzEntityIds, int, int, int, Set)
withSzFlag.SZ_FIND_NETWORK_DEFAULT_FLAGS
as the value for theflags
parameter.SzEngine.findNetwork
(SzEntityIds entityIds, int maxDegrees, int buildOutDegrees, int buildOutMaxEntities, Set<SzFlag> flags) Retrieves a network of relationships among entities, specified by entity IDs.default String
SzEngine.findNetwork
(SzRecordKeys recordKeys, int maxDegrees, int buildOutDegrees, int buildOutMaxEntities) Convenience method for callingSzEngine.findNetwork(SzRecordKeys, int, int, int, Set)
withSzFlag.SZ_FIND_NETWORK_DEFAULT_FLAGS
as the value for theflags
parameter.SzEngine.findNetwork
(SzRecordKeys recordKeys, int maxDegrees, int buildOutDegrees, int buildOutMaxEntities, Set<SzFlag> flags) Retrieves a network of relationships among entities, specified by record IDs.default String
SzEngine.findPath
(long startEntityId, long endEntityId, int maxDegrees) Convenience method for callingSzEngine.findPath(long, long, int, SzEntityIds, Set, Set)
usingnull
as the value for both the "avoid entity ID's" and the "required data sources" parameters andSzFlag.SZ_FIND_PATH_DEFAULT_FLAGS
as the value for theflags
parameter.default String
SzEngine.findPath
(long startEntityId, long endEntityId, int maxDegrees, SzEntityIds avoidEntityIds, Set<String> requiredDataSources) Convenience method for callingSzEngine.findPath(long, long, int, SzEntityIds, Set, Set)
usingSzFlag.SZ_FIND_PATH_DEFAULT_FLAGS
as the value for theflags
parameter.SzEngine.findPath
(long startEntityId, long endEntityId, int maxDegrees, SzEntityIds avoidEntityIds, Set<String> requiredDataSources, Set<SzFlag> flags) Searches for the shortest relationship path between two entities, specified by entity IDs.default String
Convenience method for callingSzEngine.findPath(long, long, int, SzEntityIds, Set, Set)
usingnull
as the value for both the "avoid entity ID's" and the "required data sources" parameters.default String
SzEngine.findPath
(SzRecordKey startRecordKey, SzRecordKey endRecordKey, int maxDegrees) Convenience method for callingSzEngine.findPath(SzRecordKey, SzRecordKey, int, SzRecordKeys, Set, Set)
usingnull
as the value for both the "avoid record keys" and the "required data sources" parameters andSzFlag.SZ_FIND_PATH_DEFAULT_FLAGS
as the value for theflags
parameter.default String
SzEngine.findPath
(SzRecordKey startRecordKey, SzRecordKey endRecordKey, int maxDegrees, SzRecordKeys avoidRecordKeys, Set<String> requiredDataSources) Convenience method for callingSzEngine.findPath(SzRecordKey, SzRecordKey, int, SzRecordKeys, Set, Set)
usingSzFlag.SZ_FIND_PATH_DEFAULT_FLAGS
as the value for theflags
parameter.SzEngine.findPath
(SzRecordKey startRecordKey, SzRecordKey endRecordKey, int maxDegrees, SzRecordKeys avoidRecordKeys, Set<String> requiredDataSources, Set<SzFlag> flags) Searches for the shortest relationship path between two entities, specified by record IDs.default String
SzEngine.findPath
(SzRecordKey startRecordKey, SzRecordKey endRecordKey, int maxDegrees, Set<SzFlag> flags) Convenience method for callingSzEngine.findPath(SzRecordKey, SzRecordKey, int, SzRecordKeys, Set, Set)
usingnull
as the value for both the "avoid record keys" and the "required data sources" parameters.long
SzEnvironment.getActiveConfigId()
Gets the currently active configuration ID for theSzEnvironment
.SzEnvironment.getConfigManager()
Provides a reference to theSzConfigManager
instance associated with thisSzEnvironment
.SzConfigManager.getConfigRegistry()
Gets the configuration registry.SzConfig.getDataSourceRegistry()
Gets the data source registry for this configuration.long
SzConfigManager.getDefaultConfigId()
Gets the default configuration ID for the repository.SzEnvironment.getDiagnostic()
Provides a reference to theSzDiagnostic
instance associated with thisSzEnvironment
.SzEnvironment.getEngine()
Provides a reference to theSzEngine
instance associated with thisSzEnvironment
.default String
SzEngine.getEntity
(long entityId) Convenience method for callingSzEngine.getEntity(long,Set)
usingSzFlag.SZ_ENTITY_DEFAULT_FLAGS
as the value for theflags
parameter.Retrieves information about an entity, specified by entity ID.default String
SzEngine.getEntity
(SzRecordKey recordKey) Convenience method for callingSzEngine.getEntity(SzRecordKey,Set)
usingSzFlag.SZ_ENTITY_DEFAULT_FLAGS
as the value for theflags
parameter.SzEngine.getEntity
(SzRecordKey recordKey, Set<SzFlag> flags) Retrieves information about an entity, specified by record ID.SzDiagnostic.getFeature
(long featureId) Experimental/internal for Senzing support use.SzProduct.getLicense()
Gets the details and entitlements of the applied product license.SzEnvironment.getProduct()
Provides a reference to theSzProduct
instance associated with thisSzEnvironment
.default String
SzEngine.getRecord
(SzRecordKey recordKey) Convenience method for callingSzEngine.getRecord(SzRecordKey, Set)
usingSzFlag.SZ_RECORD_DEFAULT_FLAGS
as the value for theflags
parameter.SzEngine.getRecord
(SzRecordKey recordKey, Set<SzFlag> flags) Retrieves information about a record.default String
SzEngine.getRecordPreview
(String recordDefinition) Convenience method for callingSzEngine.getRecordPreview(String, Set)
usingSzFlag.SZ_RECORD_PREVIEW_DEFAULT_FLAGS
as the value for theflags
parameter.SzEngine.getRecordPreview
(String recordDefinition, Set<SzFlag> flags) Describes the features resulting from the hypothetical load of a record.SzEngine.getRedoRecord()
Retrieves and removes a pending redo record.SzDiagnostic.getRepositoryInfo()
Returns overview information about the repository.SzEngine.getStats()
Gets and resets the internal engine workload statistics for the current operating system process.SzProduct.getVersion()
Gets the product version details.default String
SzEngine.getVirtualEntity
(Set<SzRecordKey> recordKeys) Convenience method for callingSzEngine.getVirtualEntity(Set, Set)
usingSzFlag.SZ_VIRTUAL_ENTITY_DEFAULT_FLAGS
as the value for theflags
parameter.SzEngine.getVirtualEntity
(Set<SzRecordKey> recordKeys, Set<SzFlag> flags) Describes how an entity would look if composed of a given set of records.default String
SzEngine.howEntity
(long entityId) Convenience method for callingSzEngine.howEntity(long, Set)
usingSzFlags.SZ_HOW_ENTITY_DEFAULT_FLAGS
as the value for theflags
parameter.Explains how an entity was constructed from its records.void
SzEngine.primeEngine()
Pre-loads engine resources.default String
SzEngine.processRedoRecord
(String redoRecord) Convenience method for callingSzEngine.processRedoRecord(String, Set)
usingSzFlag.SZ_REDO_DEFAULT_FLAGS
as the value for theflags
parameter.SzEngine.processRedoRecord
(String redoRecord, Set<SzFlag> flags) Processes the provided redo record.void
SzDiagnostic.purgeRepository()
Permanently deletes all data in the repository, except the configuration.default String
SzEngine.reevaluateEntity
(long entityId) Convenience method for callingSzEngine.reevaluateEntity(long, Set)
usingSzFlag.SZ_REEVALUATE_ENTITY_DEFAULT_FLAGS
as the value for theflags
parameter.SzEngine.reevaluateEntity
(long entityId, Set<SzFlag> flags) Reevaluates an entity by entity ID.default String
SzEngine.reevaluateRecord
(SzRecordKey recordKey) Convenience method for callingSzEngine.reevaluateRecord(SzRecordKey, Set)
usingSzFlag.SZ_REEVALUATE_RECORD_DEFAULT_FLAGS
as the value for theflags
parameter.SzEngine.reevaluateRecord
(SzRecordKey recordKey, Set<SzFlag> flags) Reevaluates an entity by record ID.long
SzConfigManager.registerConfig
(String configDefinition) Registers a configuration definition in the repository with an auto-generated comment.long
SzConfigManager.registerConfig
(String configDefinition, String configComment) Registers a configuration definition in the repository.SzConfig.registerDataSource
(String dataSourceCode) Adds a data source to this configuration.void
SzEnvironment.reinitialize
(long configId) Reinitializes theSzEnvironment
with the specified configuration ID.void
SzConfigManager.replaceDefaultConfigId
(long currentDefaultConfigId, long newDefaultConfigId) Replaces the existing default configuration ID with a new configuration ID.default String
SzEngine.searchByAttributes
(String attributes) Convenience method for callingSzEngine.searchByAttributes(String, String, Set)
with anull
value for the search profile parameter andSzFlag.SZ_SEARCH_BY_ATTRIBUTES_DEFAULT_FLAGS
as the value for theflags
parameter.default String
SzEngine.searchByAttributes
(String attributes, String searchProfile) Convenience method for callingSzEngine.searchByAttributes(String, String, Set)
usingSzFlag.SZ_SEARCH_BY_ATTRIBUTES_DEFAULT_FLAGS
as the value for theflags
parameter.SzEngine.searchByAttributes
(String attributes, String searchProfile, Set<SzFlag> flags) Searches for entities that match or relate to the provided attributes.default String
SzEngine.searchByAttributes
(String attributes, Set<SzFlag> flags) Convenience method for callingSzEngine.searchByAttributes(String, String, Set)
with anull
value for the search profile parameter.long
SzConfigManager.setDefaultConfig
(String configDefinition) Registers a configuration in the repository and then sets its ID as the default for the repository with an auto-generated comment.long
SzConfigManager.setDefaultConfig
(String configDefinition, String configComment) Registers a configuration in the repository and then sets its ID as the default for the repository.void
SzConfigManager.setDefaultConfigId
(long configId) Sets the default configuration ID.void
SzConfig.unregisterDataSource
(String dataSourceCode) Removes a data source from this configuration.default String
SzEngine.whyEntities
(long entityId1, long entityId2) Convenience method for callingSzEngine.whyEntities(long, long, Set)
withSzFlag.SZ_WHY_ENTITIES_DEFAULT_FLAGS
as the value for theflags
parameter.SzEngine.whyEntities
(long entityId1, long entityId2, Set<SzFlag> flags) Describes the ways two entities relate to each other.default String
SzEngine.whyRecordInEntity
(SzRecordKey recordKey) Convenience method for callingSzEngine.whyRecordInEntity(SzRecordKey, Set)
withSzFlag.SZ_WHY_RECORD_IN_ENTITY_DEFAULT_FLAGS
as the value for theflags
parameter.SzEngine.whyRecordInEntity
(SzRecordKey recordKey, Set<SzFlag> flags) Describes the ways a record relates to the rest of its respective entity.default String
SzEngine.whyRecords
(SzRecordKey recordKey1, SzRecordKey recordKey2) Convenience method for callingSzEngine.whyRecords(SzRecordKey, SzRecordKey, Set)
withSzFlag.SZ_WHY_RECORDS_DEFAULT_FLAGS
as the value for theflags
parameter.SzEngine.whyRecords
(SzRecordKey recordKey1, SzRecordKey recordKey2, Set<SzFlag> flags) Describes the ways two records relate to each other.default String
Convenience method for callingSzEngine.whySearch(String, long, String, Set)
with anull
value for the search profile parameter andSzFlag.SZ_WHY_SEARCH_DEFAULT_FLAGS
as the value for theflags
parameter.default String
Convenience method for callingSzEngine.whySearch(String, long, String, Set)
usingSzFlag.SZ_WHY_SEARCH_DEFAULT_FLAGS
as the value for theflags
parameter.Describes the ways a set of search attributes relate to an entity.default String
Convenience method for callingSzEngine.whySearch(String, long, String, Set)
with anull
value for the search profile parameter. -
Uses of SzException in com.senzing.sdk.core
Methods in com.senzing.sdk.core that return SzExceptionModifier and TypeMethodDescriptionstatic SzException
SzCoreUtilities.createSzException
(int errorCode, String message) Creates the appropriateSzException
instance for the specified error code.Methods in com.senzing.sdk.core that throw SzExceptionModifier and TypeMethodDescriptionlong
SzCoreEnvironment.getActiveConfigId()
SzCoreEnvironment.getConfigManager()
SzCoreEnvironment.getDiagnostic()
SzCoreEnvironment.getEngine()
SzCoreEnvironment.getProduct()
void
SzCoreEnvironment.reinitialize
(long configId)