Package com.inductiveautomation.perspective.gateway.api

Interface PerspectiveProjectCache

All Known Implementing Classes:

PerspectiveProjectCacheImpl

public interface PerspectiveProjectCache

The PerspectiveProjectCache manages a cache of the latest ProjectConfig and concatenated css classes compiled from the style resource JSON sources on a per project version basis. The cache is keyed by the name of the Project which contains the style resources. Interested parties can add and remove listeners of a project's config and style resource changes by subscribing to the event bus (see getEventBus()).

Method Summary

Modifier and Type	Method	Description
Optional<PerspectiveProject>	get(String name)	Fetch the PerspectiveProject with the given name from the cache.
List<PerspectiveProjectDisplayData>	getAll()	Fetches all PerspectiveProject on the gateway and returns them as a list of PerspectiveProjectDisplayData
Optional<ProjectUpdateResponse>	getDiff(String projectName, RuntimeProject.EffectiveProjectSnapshot snapshot)
List<PerspectiveProjectDisplayData>	getDisplayable()	Fetches all Runnable and displayable PerspectiveProjects on the gateway and returns them as a list of PerspectiveProjectDisplayData
com.google.common.eventbus.EventBus	getEventBus()	Fetch the EventBus for this PerspectiveProjectCache.

Method Details

getEventBus

@Nonnull
com.google.common.eventbus.EventBus getEventBus()

Fetch the EventBus for this PerspectiveProjectCache. Interested parties may Subscribe to receive ProjectUpdatedEvents when projects are updated, and ProjectDeletedEvents when projects are deleted.

Returns:

The event bus

get

@Nonnull
Optional<PerspectiveProject> get(String name)

Fetch the PerspectiveProject with the given name from the cache. If the cache does not have the entry, it will attempt to load from the ProjectManager or another source of record. If the ProjectManager does not have the entry, Optional.empty is returned since this means the project does not exist.

Returns:

An Optional containing the PerspectiveProject with the given name or an empty Optional if it does not exist or a problem occurred fetching it

getAll

@Nonnull
List<PerspectiveProjectDisplayData> getAll()

Fetches all PerspectiveProject on the gateway and returns them as a list of PerspectiveProjectDisplayData

getDisplayable

@Nonnull
List<PerspectiveProjectDisplayData> getDisplayable()

Fetches all Runnable and displayable PerspectiveProjects on the gateway and returns them as a list of PerspectiveProjectDisplayData

getDiff

Optional<ProjectUpdateResponse> getDiff(String projectName,
 RuntimeProject.EffectiveProjectSnapshot snapshot)

Parameters:

projectName - Name of the (leaf) project to diff.

snapshot - The effective snapshot of the copy of the project that you already have.

Returns:

A perspective project diff containing the things that have changed since the given snapshot was generated. Empty optional if the project doesn't exist.