Package com.inductiveautomation.ignition.gateway.config

Interface PropertyReference

public interface PropertyReference

A property reference represents when a property of a resource references another resource. For example, a database alarm journal profile may reference a database connection. In this example, the alarm journal represents the "source" of the reference, and the database connection is the "target".

Property references are used to find dependencies between resources so that rename and delete operations can be performed safely, either by forcing the user to confirm that the operation will break references (delete), or by automatically updating references to the new name (rename).

To support rename, the property reference must also contain the logic to create a new copy of the relevant source configuration with the reference updated to a new name.

Note that it is not common to use this class directly. Instead, you will register ReferenceFinders for your resource type or extension point, which will then be automatically used by the system to create these PropertyReference objects.

Method Summary

Modifier and Type	Method	Description
static PropertyReference	create(ResourcePath sourceResource, String sourceProperty, ResourcePath targetResource, Function<ResourcePath,ChangeOperation> updateFunction)
String	getSourceProperty()
ResourcePath	getSourceResource()
ResourcePath	getTargetResource()
Optional<ChangeOperation>	updateReference(ResourcePath newTargetReference)

Method Details

getSourceResource

ResourcePath getSourceResource()

getSourceProperty

String getSourceProperty()

getTargetResource

ResourcePath getTargetResource()

updateReference

Optional<ChangeOperation> updateReference(ResourcePath newTargetReference)

create

static PropertyReference create(ResourcePath sourceResource,
 String sourceProperty,
 ResourcePath targetResource,
 Function<ResourcePath,ChangeOperation> updateFunction)