com.mware.ge.mutation

Interface ElementMutation<T extends Element>

All Superinterfaces:

ElementId, ElementLocation, GeObjectId

All Known Subinterfaces:

EdgeMutation, ExistingElementMutation<T>, VertexMutation

All Known Implementing Classes:

EdgeBuilder, EdgeBuilderBase, EdgeBuilderByVertexId, ElementBuilder, ExistingEdgeMutation, ExistingElementMutationImpl, ExistingVertexMutation, StorableEdgeBuilderByVertexId, StorableVertexBuilder, VertexBuilder

public interface ElementMutation<T extends Element>
extends ElementLocation

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_KEY

Method Summary

Modifier and Type	Method and Description
ElementMutation<T>	addExtendedData(String tableName, String row, String column, String key, Value value, Long timestamp, Visibility visibility) Adds an extended data cell to the element.
ElementMutation<T>	addExtendedData(String tableName, String row, String column, String key, Value value, Visibility visibility) Adds an extended data cell to the element.
ElementMutation<T>	addExtendedData(String tableName, String row, String column, Value value, Long timestamp, Visibility visibility) Adds an extended data cell to the element.
ElementMutation<T>	addExtendedData(String tableName, String row, String column, Value value, Visibility visibility) Adds an extended data cell to the element.
ElementMutation<T>	addPropertyValue(String key, String name, Value value, Metadata metadata, Long timestamp, Visibility visibility) Adds or updates a property.
ElementMutation<T>	addPropertyValue(String key, String name, Value value, Metadata metadata, Visibility visibility) Adds or updates a property.
ElementMutation<T>	addPropertyValue(String key, String name, Value value, Visibility visibility) Adds or updates a property.
ElementMutation<T>	deleteExtendedData(String tableName, String row) Deletes an extended data row from an element.
ElementMutation<T>	deleteExtendedData(String tableName, String row, String column, String key, Visibility visibility) Deletes an extended data cell from an element.
ElementMutation<T>	deleteExtendedData(String tableName, String row, String column, Visibility visibility) Deletes an extended data cell from an element.
ElementMutation<T>	deleteExtendedDataTable(String tableName) Deletes an extended data table and its rows from an element.
ElementMutation<T>	deleteProperty(Property property) Deletes a property.
ElementMutation<T>	deleteProperty(String key, String name, Visibility visibility) Deletes a property.
ElementMutation<T>	deleteProperty(String name, Visibility visibility) Deletes the default property with that name.
ElementType	getElementType() Get the type of the element
Iterable<ExtendedDataMutation>	getExtendedData() Gets the extended data mutations.
Iterable<ExtendedDataDeleteMutation>	getExtendedDataDeletes() Gets the extended data columns currently being deleted in this mutation
IndexHint	getIndexHint() Gets the currently set index hint.
Iterable<Property>	getProperties() Gets the properties currently in this mutation.
Iterable<PropertyDeleteMutation>	getPropertyDeletes() Gets the properties currently being deleted in this mutation.
Iterable<PropertySoftDeleteMutation>	getPropertySoftDeletes() Gets the properties currently being soft deleted in this mutation.
boolean	hasChanges() true, if this mutation has any changes.
T	save(Authorizations authorizations) saves the properties to the graph.
ElementMutation<T>	setIndexHint(IndexHint indexHint) Sets the index hint of this element.
ElementMutation<T>	setProperty(String name, Value value, Metadata metadata, Visibility visibility) Sets or updates a property value.
ElementMutation<T>	setProperty(String name, Value value, Visibility visibility) Sets or updates a property value.
ElementMutation<T>	softDeleteProperty(Property property) Soft deletes a property.
ElementMutation<T>	softDeleteProperty(String key, String name, Visibility visibility) Soft deletes a property.
ElementMutation<T>	softDeleteProperty(String name, Visibility visibility) Soft deletes the default property with that name.

Methods inherited from interface com.mware.ge.ElementLocation

edge, getVisibility, vertex

Methods inherited from interface com.mware.ge.ElementId

create, edge, getId, vertex

Field Detail

DEFAULT_KEY

static final String DEFAULT_KEY

See Also:

Constant Field Values

Method Detail

save

T save(Authorizations authorizations)

saves the properties to the graph.

Returns:

the element which was mutated.

setProperty

ElementMutation<T> setProperty(String name,
                               Value value,
                               Visibility visibility)

Sets or updates a property value. The property key will be set to a constant. This is a convenience method which allows treating the multi-valued nature of properties as only containing a single value. Care must be taken when using this method because properties are not only uniquely identified by just key and name but also visibility so adding properties with the same name and different visibility strings is still permitted.

Parameters:

name - The name of the property.

value - The value of the property.

visibility - The visibility to give this property.

setProperty

ElementMutation<T> setProperty(String name,
                               Value value,
                               Metadata metadata,
                               Visibility visibility)

Sets or updates a property value. The property key will be set to a constant. This is a convenience method which allows treating the multi-valued nature of properties as only containing a single value. Care must be taken when using this method because properties are not only uniquely identified by just key and name but also visibility so adding properties with the same name and different visibility strings is still permitted.

Parameters:

name - The name of the property.

value - The value of the property.

metadata - The metadata to assign to this property.

visibility - The visibility to give this property.

addPropertyValue

ElementMutation<T> addPropertyValue(String key,
                                    String name,
                                    Value value,
                                    Visibility visibility)

Adds or updates a property.

Parameters:

key - The unique key given to the property allowing for multi-valued properties.

name - The name of the property.

value - The value of the property.

visibility - The visibility to give this property.

addPropertyValue

ElementMutation<T> addPropertyValue(String key,
                                    String name,
                                    Value value,
                                    Metadata metadata,
                                    Visibility visibility)

Adds or updates a property.

Parameters:

key - The unique key given to the property allowing for multi-valued properties.

name - The name of the property.

value - The value of the property.

metadata - The metadata to assign to this property.

visibility - The visibility to give this property.

addPropertyValue

ElementMutation<T> addPropertyValue(String key,
                                    String name,
                                    Value value,
                                    Metadata metadata,
                                    Long timestamp,
                                    Visibility visibility)

Adds or updates a property.

Parameters:

key - The unique key given to the property allowing for multi-valued properties.

name - The name of the property.

value - The value of the property.

metadata - The metadata to assign to this property.

timestamp - The timestamp of the property.

visibility - The visibility to give this property.

deleteProperty

ElementMutation<T> deleteProperty(Property property)

Deletes a property.

Parameters:

property - the property to delete.

softDeleteProperty

ElementMutation<T> softDeleteProperty(Property property)

Soft deletes a property.

Parameters:

property - the property to soft delete.

deleteProperty

ElementMutation<T> deleteProperty(String name,
                                  Visibility visibility)

Deletes the default property with that name.

Parameters:

name - the property name to delete.

visibility - the visibility of the property to delete.

softDeleteProperty

ElementMutation<T> softDeleteProperty(String name,
                                      Visibility visibility)

Soft deletes the default property with that name.

Parameters:

name - the property name to soft delete.

visibility - the visibility of the property to soft delete.

deleteProperty

ElementMutation<T> deleteProperty(String key,
                                  String name,
                                  Visibility visibility)

Deletes a property.

Parameters:

key - the key of the property to delete.

name - the name of the property to delete.

visibility - the visibility of the property to delete.

softDeleteProperty

ElementMutation<T> softDeleteProperty(String key,
                                      String name,
                                      Visibility visibility)

Soft deletes a property.

Parameters:

key - the key of the property to soft delete.

name - the name of the property to soft delete.

visibility - the visibility of the property to soft delete.

getProperties

Iterable<Property> getProperties()

Gets the properties currently in this mutation.

getPropertyDeletes

Iterable<PropertyDeleteMutation> getPropertyDeletes()

Gets the properties currently being deleted in this mutation.

getPropertySoftDeletes

Iterable<PropertySoftDeleteMutation> getPropertySoftDeletes()

Gets the properties currently being soft deleted in this mutation.

getExtendedData

Iterable<ExtendedDataMutation> getExtendedData()

Gets the extended data mutations.

getExtendedDataDeletes

Iterable<ExtendedDataDeleteMutation> getExtendedDataDeletes()

Gets the extended data columns currently being deleted in this mutation

setIndexHint

ElementMutation<T> setIndexHint(IndexHint indexHint)

Sets the index hint of this element.

getIndexHint

IndexHint getIndexHint()

Gets the currently set index hint.

hasChanges

boolean hasChanges()

true, if this mutation has any changes. false, if this mutation is empty.

addExtendedData

ElementMutation<T> addExtendedData(String tableName,
                                   String row,
                                   String column,
                                   Value value,
                                   Visibility visibility)

Adds an extended data cell to the element.

Parameters:

tableName - The extended data table to add the cell to.

row - The row to add the cell to.

column - The column name.

value - The cell value.

visibility - The visibility of the value.

addExtendedData

ElementMutation<T> addExtendedData(String tableName,
                                   String row,
                                   String column,
                                   Value value,
                                   Long timestamp,
                                   Visibility visibility)

Adds an extended data cell to the element.

Parameters:

tableName - The extended data table to add the cell to.

row - The row to add the cell to.

column - The column name.

value - The cell value.

timestamp - The timestamp of the value. null, to automatically generate one.

visibility - The visibility of the value.

addExtendedData

ElementMutation<T> addExtendedData(String tableName,
                                   String row,
                                   String column,
                                   String key,
                                   Value value,
                                   Visibility visibility)

Adds an extended data cell to the element.

Parameters:

tableName - The extended data table to add the cell to.

row - The row to add the cell to.

column - The column name.

key - The column multi-value key.

value - The cell value.

visibility - The visibility of the value.

addExtendedData

ElementMutation<T> addExtendedData(String tableName,
                                   String row,
                                   String column,
                                   String key,
                                   Value value,
                                   Long timestamp,
                                   Visibility visibility)

Adds an extended data cell to the element.

Parameters:

tableName - The extended data table to add the cell to.

row - The row to add the cell to.

column - The column name.

key - The column multi-value key.

value - The cell value.

timestamp - The timestamp of the value. null, to automatically generate one.

visibility - The visibility of the value.

deleteExtendedData

ElementMutation<T> deleteExtendedData(String tableName,
                                      String row,
                                      String column,
                                      Visibility visibility)

Deletes an extended data cell from an element.

Parameters:

tableName - The extended data table to add the cell to.

row - The row to add the cell to.

column - The column name.

visibility - The visibility of the value.

deleteExtendedData

ElementMutation<T> deleteExtendedData(String tableName,
                                      String row)

Deletes an extended data row from an element.

Parameters:

tableName - The extended data table to add the cell to.

row - The row to add the cell to.

deleteExtendedData

ElementMutation<T> deleteExtendedData(String tableName,
                                      String row,
                                      String column,
                                      String key,
                                      Visibility visibility)

Deletes an extended data cell from an element.

Parameters:

tableName - The extended data table to add the cell to.

row - The row to add the cell to.

column - The column name.

key - The column multi-value key.

visibility - The visibility of the value.

deleteExtendedDataTable

ElementMutation<T> deleteExtendedDataTable(String tableName)

Deletes an extended data table and its rows from an element.

Parameters:

tableName - The extended data table to delete.

getElementType

ElementType getElementType()

Description copied from interface: ElementId

Get the type of the element

Specified by:

getElementType in interface ElementId

Returns:

element type