Add missing JavaDoc (#180)

resolves #58

Author: Andy2003

core/src/main/kotlin/org/neo4j/graphql/SchemaBuilder.kt

@@ -15,6 +15,9 @@ import org.neo4j.graphql.handler.relation.CreateRelationHandler
 import org.neo4j.graphql.handler.relation.CreateRelationTypeHandler
 import org.neo4j.graphql.handler.relation.DeleteRelationHandler
 
+/**
+ * Contains factory methods to generate an augmented graphql schema
+ */
 object SchemaBuilder {
 
     /**
@@ -31,6 +34,12 @@ object SchemaBuilder {
         return buildSchema(typeDefinitionRegistry, config, dataFetchingInterceptor)
     }
 
+    /**
+     * @param typeDefinitionRegistry a registry containing all the types, that should be augmented
+     * @param config defines how the schema should get augmented
+     * @param dataFetchingInterceptor since this library registers dataFetcher for its augmented methods, these data
+     * fetchers may be called by other resolver. This interceptor will let you convert a cypher query into real data.
+     */
     @JvmStatic
     @JvmOverloads
     fun buildSchema(typeDefinitionRegistry: TypeDefinitionRegistry, config: SchemaConfig = SchemaConfig(), dataFetchingInterceptor: DataFetchingInterceptor? = null): GraphQLSchema {

core/src/main/kotlin/org/neo4j/graphql/handler/BaseDataFetcher.kt

@@ -11,6 +11,9 @@ import org.neo4j.graphql.Cypher
 import org.neo4j.graphql.aliasOrName
 import org.neo4j.graphql.handler.projection.ProjectionBase
 
+/**
+ * The is a base class for the implementation of graphql data fetcher used in this project
+ */
 abstract class BaseDataFetcher(val fieldDefinition: GraphQLFieldDefinition) : ProjectionBase(), DataFetcher<Cypher> {
 
     override fun get(env: DataFetchingEnvironment?): Cypher {

core/src/main/kotlin/org/neo4j/graphql/handler/BaseDataFetcherForContainer.kt

@@ -9,6 +9,9 @@ import org.neo4j.cypherdsl.core.*
 import org.neo4j.cypherdsl.core.Cypher.*
 import org.neo4j.graphql.*
 
+/**
+ * This is a base class for all Node or Relation related data fetcher.
+ */
 abstract class BaseDataFetcherForContainer(
         val type: GraphQLFieldsContainer,
         fieldDefinition: GraphQLFieldDefinition

core/src/main/kotlin/org/neo4j/graphql/handler/CreateTypeHandler.kt

@@ -6,6 +6,10 @@ import org.neo4j.cypherdsl.core.Statement
 import org.neo4j.cypherdsl.core.StatementBuilder
 import org.neo4j.graphql.*
 
+/**
+ * This class handles all the logic related to the creation of nodes.
+ * This includes the augmentation of the create<Node>-mutator and the related cypher generation
+ */
 class CreateTypeHandler private constructor(
         type: GraphQLFieldsContainer,
         fieldDefinition: GraphQLFieldDefinition

core/src/main/kotlin/org/neo4j/graphql/handler/CypherDirectiveHandler.kt

@@ -9,6 +9,9 @@ import org.neo4j.cypherdsl.core.Functions
 import org.neo4j.cypherdsl.core.Statement
 import org.neo4j.graphql.*
 
+/**
+ * This class handles all logic related to custom Cypher queries declared by fields with a @cypher directive
+ */
 class CypherDirectiveHandler(
         private val type: GraphQLFieldsContainer?,
         private val isQuery: Boolean,

core/src/main/kotlin/org/neo4j/graphql/handler/DeleteHandler.kt

@@ -8,6 +8,10 @@ import org.neo4j.cypherdsl.core.Statement
 import org.neo4j.cypherdsl.core.StatementBuilder.OngoingUpdate
 import org.neo4j.graphql.*
 
+/**
+ * This class handles all the logic related to the deletion of nodes.
+ * This includes the augmentation of the delete<Node>-mutator and the related cypher generation
+ */
 class DeleteHandler private constructor(
         type: GraphQLFieldsContainer,
         private val idField: GraphQLFieldDefinition,

core/src/main/kotlin/org/neo4j/graphql/handler/MergeOrUpdateHandler.kt

@@ -11,6 +11,10 @@ import org.neo4j.cypherdsl.core.Statement
 import org.neo4j.cypherdsl.core.StatementBuilder.OngoingMatchAndUpdate
 import org.neo4j.graphql.*
 
+/**
+ * This class handles all the logic related to the updating of nodes.
+ * This includes the augmentation of the update<Node> and merge<Node>-mutator and the related cypher generation
+ */
 class MergeOrUpdateHandler private constructor(
         type: GraphQLFieldsContainer,
         private val merge: Boolean,

core/src/main/kotlin/org/neo4j/graphql/handler/QueryHandler.kt

@@ -8,6 +8,10 @@ import org.neo4j.cypherdsl.core.Statement
 import org.neo4j.graphql.*
 import org.neo4j.graphql.handler.filter.OptimizedFilterHandler
 
+/**
+ * This class handles all the logic related to the querying of nodes and relations.
+ * This includes the augmentation of the query-fields and the related cypher generation
+ */
 class QueryHandler private constructor(
         type: GraphQLFieldsContainer,
         fieldDefinition: GraphQLFieldDefinition)

core/src/main/kotlin/org/neo4j/graphql/handler/filter/OptimizedFilterHandler.kt

@@ -24,6 +24,14 @@ typealias WhereClauseFactory = (
 
 typealias ConditionBuilder = (ExposesWith) -> OrderableOngoingReadingAndWithWithoutWhere
 
+/**
+ * This its a specialized handler that uses an alternative approach for filtering. By using multiple MATCH clauses,
+ * this can facilitate the use of optimizations within the neo4j database, which can lead to significant performance
+ * improvements for large data sets.
+ *
+ * If this handler cannot generate an optimization for the passed filter, an [OptimizedQueryException] will be
+ * thrown, so the calling site can fall back to the non-optimized logic
+ */
 class OptimizedFilterHandler(val type: GraphQLFieldsContainer) : ProjectionBase() {
 
     fun generateFilterQuery(variable: String, fieldDefinition: GraphQLFieldDefinition, field: Field, readingWithoutWhere: OngoingReadingWithoutWhere, rootNode: PropertyContainer): OngoingReading {

core/src/main/kotlin/org/neo4j/graphql/handler/projection/ProjectionBase.kt

@@ -15,7 +15,9 @@ import org.neo4j.graphql.parser.ParsedQuery
 import org.neo4j.graphql.parser.QueryParser.parseArguments
 import org.neo4j.graphql.parser.QueryParser.parseFilter
 
-
+/**
+ * This class contains the logic for projecting nodes and relations
+ */
 open class ProjectionBase {
     companion object {
         const val NATIVE_ID = "_id"