com.arangodb.ArangoVertexCollection Maven / Gradle / Ivy
/*
* DISCLAIMER
*
* Copyright 2016 ArangoDB GmbH, Cologne, Germany
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* Copyright holder is ArangoDB GmbH, Cologne, Germany
*/
package com.arangodb;
import com.arangodb.entity.VertexEntity;
import com.arangodb.entity.VertexUpdateEntity;
import com.arangodb.model.*;
import javax.annotation.concurrent.ThreadSafe;
/**
* Interface for operations on ArangoDB vertex collection level.
*
* @author Mark Vollmary
* @see API Documentation
*/
@ThreadSafe
public interface ArangoVertexCollection extends ArangoSerdeAccessor {
/**
* The the handler of the named graph the edge collection is within
*
* @return graph handler
*/
ArangoGraph graph();
/**
* The name of the edge collection
*
* @return collection name
*/
String name();
/**
* Remove a vertex collection form the graph.
*
* @see API
* Documentation
*/
void drop();
/**
* Remove a vertex collection form the graph.
*
* @param options options
* @see API
* Documentation
*/
void drop(VertexCollectionDropOptions options);
/**
* Creates a new vertex in the collection
*
* @param value A representation of a single vertex (POJO or {@link com.arangodb.util.RawData})
* @return information about the vertex
* @see
* API Documentation
*/
VertexEntity insertVertex(Object value);
/**
* Creates a new vertex in the collection
*
* @param value A representation of a single vertex (POJO or {@link com.arangodb.util.RawData})
* @param options Additional options, can be null
* @return information about the vertex
* @see
* API Documentation
*/
VertexEntity insertVertex(Object value, VertexCreateOptions options);
/**
* Retrieves the vertex document with the given {@code key} from the collection.
*
* @param key The key of the vertex
* @param type The type of the vertex-document (POJO or {@link com.arangodb.util.RawData})
* @return the vertex identified by the key
* @see API Documentation
*/
T getVertex(String key, Class type);
/**
* Retrieves the vertex document with the given {@code key} from the collection.
*
* @param key The key of the vertex
* @param type The type of the vertex-document (POJO or {@link com.arangodb.util.RawData})
* @param options Additional options, can be null
* @return the vertex identified by the key
* @see API Documentation
*/
T getVertex(String key, Class type, GraphDocumentReadOptions options);
/**
* Replaces the vertex with key with the one in the body, provided there is such a vertex and no precondition is
* violated
*
* @param key The key of the vertex
* @param value A representation of a single vertex (POJO or {@link com.arangodb.util.RawData})
* @return information about the vertex
* @see API
* Documentation
*/
VertexUpdateEntity replaceVertex(String key, Object value);
/**
* Replaces the vertex with key with the one in the body, provided there is such a vertex and no precondition is
* violated
*
* @param key The key of the vertex
* @param value A representation of a single vertex (POJO or {@link com.arangodb.util.RawData})
* @param options Additional options, can be null
* @return information about the vertex
* @see API
* Documentation
*/
VertexUpdateEntity replaceVertex(String key, Object value, VertexReplaceOptions options);
/**
* Partially updates the vertex identified by document-key. The value must contain a document with the attributes to
* patch (the patch document). All attributes from the patch document will be added to the existing document if they
* do not yet exist, and overwritten in the existing document if they do exist there.
*
* @param key The key of the vertex
* @param value A representation of a single vertex (POJO or {@link com.arangodb.util.RawData})
* @return information about the vertex
* @see
* API Documentation
*/
VertexUpdateEntity updateVertex(String key, Object value);
/**
* Partially updates the vertex identified by document-key. The value must contain a document with the attributes to
* patch (the patch document). All attributes from the patch document will be added to the existing document if they
* do not yet exist, and overwritten in the existing document if they do exist there.
*
* @param key The key of the vertex
* @param value A representation of a single vertex (POJO or {@link com.arangodb.util.RawData})
* @param options Additional options, can be null
* @return information about the vertex
* @see
* API Documentation
*/
VertexUpdateEntity updateVertex(String key, Object value, VertexUpdateOptions options);
/**
* Deletes the vertex with the given {@code key} from the collection.
*
* @param key The key of the vertex
* @see
* API Documentation
*/
void deleteVertex(String key);
/**
* Deletes the vertex with the given {@code key} from the collection.
*
* @param key The key of the vertex
* @param options Additional options, can be null
* @see
* API Documentation
*/
void deleteVertex(String key, VertexDeleteOptions options);
}