oracle.pgx.api.graphalteration

Interface GraphAlterationBuilder

public interface GraphAlterationBuilder

Builder to describe the alterations (graph schema modification) to perform to a graph. It is for example possible to add or remove vertex and edge providers.

Since:

20.1

Method Summary

Modifier and Type	Method and Description
GraphAlterationBuilder	addEdgeProvider(EntityProviderConfig edgeProviderConfig) Adds an edge provider specified by the provided configuration
GraphAlterationBuilder	addEdgeProvider(java.lang.String pathToEdgeProviderConfig) Adds an edge provider for which the configuration is in a file at the specified path
GraphAlterationBuilder	addVertexProvider(EntityProviderConfig vertexProviderConfig) Adds a vertex provider specified by the provided configuration
GraphAlterationBuilder	addVertexProvider(java.lang.String pathToVertexProviderConfig) Adds a vertex provider for which the configuration is in a file at the specified path
default PgxGraph	build() Create a new graph that is the result of the alteration of the current graph.
default PgxGraph	build(java.lang.String newGraphName) Create a new graph that is the result of the alteration of the current graph.
default PgxFuture<PgxGraph>	buildAsync() Create a new graph that is the result of the alteration of the current graph.
PgxFuture<PgxGraph>	buildAsync(java.lang.String newGraphName) Create a new graph that is the result of the alteration of the current graph.
default PgxGraph	buildNewSnapshot() Create a new snapshot for the current graph that is the result of the alteration of the current snapshot.
PgxFuture<PgxGraph>	buildNewSnapshotAsync() Create a new snapshot for the current graph that is the result of the alteration of the current snapshot.
GraphAlterationBuilder	cascadeEdgeProviderRemovals(boolean cascadeEdgeProviderRemovals) Specifies if the edge providers associated to a vertex provider (the vertex provider is either the source or destination provider for that edge provider) being removed should be automatically removed too or not.
GraphAlterationBuilder	removeEdgeProvider(java.lang.String edgeProviderName) Removes the edge provider that has the given name
GraphAlterationBuilder	removeVertexProvider(java.lang.String vertexProviderName) Removes the vertex provider that has the given name.
void	setDataSourceVersion(java.lang.String version) Sets the version information for the built graph or snapshot

Method Detail

addEdgeProvider

GraphAlterationBuilder addEdgeProvider(EntityProviderConfig edgeProviderConfig)

Adds an edge provider specified by the provided configuration

Parameters:

edgeProviderConfig - the configuration of the edge provider to add

Returns:

the current alteration builder

Throws:

java.io.IOException

addEdgeProvider

GraphAlterationBuilder addEdgeProvider(java.lang.String pathToEdgeProviderConfig)
                                throws java.io.IOException

Adds an edge provider for which the configuration is in a file at the specified path

Parameters:

pathToEdgeProviderConfig - the path to the JSON configuration of the edge provider

Returns:

the current alteration builder

Throws:

java.io.IOException

addVertexProvider

GraphAlterationBuilder addVertexProvider(EntityProviderConfig vertexProviderConfig)

Adds a vertex provider specified by the provided configuration

Parameters:

vertexProviderConfig - the configuration of the vertex provider to add

Returns:

the current alteration builder

Throws:

java.io.IOException

addVertexProvider

GraphAlterationBuilder addVertexProvider(java.lang.String pathToVertexProviderConfig)
                                  throws java.io.IOException

Adds a vertex provider for which the configuration is in a file at the specified path

Parameters:

pathToVertexProviderConfig - the path to the JSON configuration of the vertex provider

Returns:

the current alteration builder

Throws:

java.io.IOException

build

default PgxGraph build()
                throws java.util.concurrent.ExecutionException,
                       java.lang.InterruptedException

Create a new graph that is the result of the alteration of the current graph. (Blocking version of buildAsync())

Returns:

the current alteration builder

Throws:

java.io.IOException

java.util.concurrent.ExecutionException

java.lang.InterruptedException

build

default PgxGraph build(java.lang.String newGraphName)
                throws java.util.concurrent.ExecutionException,
                       java.lang.InterruptedException

Create a new graph that is the result of the alteration of the current graph. (Blocking version of buildAsync(String))

Parameters:

newGraphName - name of the new graph to create

Returns:

the current alteration builder

Throws:

java.io.IOException

java.util.concurrent.ExecutionException

java.lang.InterruptedException

buildAsync

default PgxFuture<PgxGraph> buildAsync()

Create a new graph that is the result of the alteration of the current graph.

Returns:

the current alteration builder

Throws:

java.io.IOException

buildAsync

PgxFuture<PgxGraph> buildAsync(java.lang.String newGraphName)

Create a new graph that is the result of the alteration of the current graph.

Parameters:

newGraphName - name of the new graph to create

Returns:

the current alteration builder

Throws:

java.io.IOException

buildNewSnapshot

default PgxGraph buildNewSnapshot()
                           throws java.util.concurrent.ExecutionException,
                                  java.lang.InterruptedException

Create a new snapshot for the current graph that is the result of the alteration of the current snapshot. (Blocking version of buildNewSnapshotAsync())

Returns:

the current alteration builder

Throws:

java.io.IOException

java.util.concurrent.ExecutionException

java.lang.InterruptedException

buildNewSnapshotAsync

PgxFuture<PgxGraph> buildNewSnapshotAsync()

Create a new snapshot for the current graph that is the result of the alteration of the current snapshot.

Returns:

the current alteration builder

Throws:

java.io.IOException

cascadeEdgeProviderRemovals

GraphAlterationBuilder cascadeEdgeProviderRemovals(boolean cascadeEdgeProviderRemovals)

Specifies if the edge providers associated to a vertex provider (the vertex provider is either the source or destination provider for that edge provider) being removed should be automatically removed too or not. By default, edge providers are not automatically removed whenever an associated vertex is removed. In that setting, if the associated edge providers are not specifically removed, an exception will be thrown to indicate that issue.

Parameters:

cascadeEdgeProviderRemovals - whether or not to automatically remove associated edge providers of removed vertex providers

Returns:

the current alteration builder

removeEdgeProvider

GraphAlterationBuilder removeEdgeProvider(java.lang.String edgeProviderName)

Removes the edge provider that has the given name

Parameters:

edgeProviderName - the name of the provider to remove

Returns:

the current alteration builder

Throws:

java.io.IOException

removeVertexProvider

GraphAlterationBuilder removeVertexProvider(java.lang.String vertexProviderName)

Removes the vertex provider that has the given name. Also removes the associated edge providers if true was specified when calling cascadeEdgeProviderRemovals(boolean).

Parameters:

vertexProviderName - the name of the provider to remove

Returns:

the current alteration builder

Throws:

java.io.IOException

setDataSourceVersion

void setDataSourceVersion(java.lang.String version)

Sets the version information for the built graph or snapshot

Parameters:

version - the version information

Since:

21.1