feat(java,info): add vertex info builder

maven-projects/info/src/main/java/org/apache/graphar/info/PropertyGroup.java

@@ -142,110 +142,3 @@ public boolean isValidated() {
         return true;
     }
 }
-
-class PropertyGroups {
-    private final List<PropertyGroup> propertyGroupList;
-    private final Map<String, PropertyGroup> propertyGroupMap;
-    private final Map<String, Property> properties;
-
-    PropertyGroups(List<PropertyGroup> propertyGroupList) {
-        this.propertyGroupList = List.copyOf(propertyGroupList);
-        this.properties =
-                propertyGroupList.stream()
-                        .flatMap(propertyGroup -> propertyGroup.getPropertyMap().values().stream())
-                        .collect(
-                                Collectors.toUnmodifiableMap(
-                                        Property::getName, Function.identity()));
-        HashMap<String, PropertyGroup> tempPropertyGroupMap = new HashMap<>(this.properties.size());
-        for (PropertyGroup propertyGroup : propertyGroupList) {
-            for (Property property : propertyGroup) {
-                tempPropertyGroupMap.put(property.getName(), propertyGroup);
-            }
-        }
-        this.propertyGroupMap = Map.copyOf(tempPropertyGroupMap);
-    }
-
-    private PropertyGroups(
-            List<PropertyGroup> propertyGroupList,
-            Map<String, PropertyGroup> propertyGroupMap,
-            Map<String, Property> properties) {
-        this.propertyGroupList = propertyGroupList;
-        this.propertyGroupMap = propertyGroupMap;
-        this.properties = properties;
-    }
-
-    Optional<PropertyGroups> addPropertyGroupAsNew(PropertyGroup propertyGroup) {
-        if (propertyGroup == null || propertyGroup.size() == 0 || hasPropertyGroup(propertyGroup)) {
-            return Optional.empty();
-        }
-        for (Property property : propertyGroup) {
-            if (hasProperty(property.getName())) {
-                return Optional.empty();
-            }
-        }
-        List<PropertyGroup> newPropertyGroupsAsList =
-                Stream.concat(propertyGroupList.stream(), Stream.of(propertyGroup))
-                        .collect(Collectors.toUnmodifiableList());
-        Map<String, PropertyGroup> tempPropertyGroupAsMap = new HashMap<>(propertyGroupMap);
-        for (Property property : propertyGroup) {
-            tempPropertyGroupAsMap.put(property.getName(), propertyGroup);
-        }
-        Map<String, Property> newProperties =
-                Stream.concat(
-                                properties.values().stream(),
-                                propertyGroup.getPropertyMap().values().stream())
-                        .collect(
-                                Collectors.toUnmodifiableMap(
-                                        Property::getName, Function.identity()));
-        return Optional.of(
-                new PropertyGroups(
-                        newPropertyGroupsAsList,
-                        Map.copyOf(tempPropertyGroupAsMap),
-                        newProperties));
-    }
-
-    boolean hasProperty(String propertyName) {
-        return properties.containsKey(propertyName);
-    }
-
-    boolean hasPropertyGroup(PropertyGroup propertyGroup) {
-        return propertyGroupList.contains(propertyGroup);
-    }
-
-    int getPropertyGroupNum() {
-        return propertyGroupList.size();
-    }
-
-    DataType getPropertyType(String propertyName) {
-        checkPropertyExist(propertyName);
-        return properties.get(propertyName).getDataType();
-    }
-
-    boolean isPrimaryKey(String propertyName) {
-        checkPropertyExist(propertyName);
-        return properties.get(propertyName).isPrimary();
-    }
-
-    boolean isNullableKey(String propertyName) {
-        checkPropertyExist(propertyName);
-        return properties.get(propertyName).isNullable();
-    }
-
-    List<PropertyGroup> getPropertyGroupList() {
-        return propertyGroupList;
-    }
-
-    PropertyGroup getPropertyGroup(String propertyName) {
-        checkPropertyExist(propertyName);
-        return propertyGroupMap.get(propertyName);
-    }
-
-    private void checkPropertyExist(String propertyName) {
-        if (null == propertyName) {
-            throw new IllegalArgumentException("Property name is null");
-        }
-        if (!hasProperty(propertyName)) {
-            throw new IllegalArgumentException("Property " + propertyName + " does not exist");
-        }
-    }
-}

maven-projects/info/src/main/java/org/apache/graphar/info/PropertyGroups.java

@@ -0,0 +1,145 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you 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.
+ */
+
+package org.apache.graphar.info;
+
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.Optional;
+import java.util.function.Function;
+import java.util.stream.Collectors;
+import java.util.stream.Stream;
+import org.apache.graphar.info.type.DataType;
+
+public class PropertyGroups {
+    private final List<PropertyGroup> propertyGroupList;
+    private final Map<String, PropertyGroup> propertyGroupMap;
+    private final Map<String, Property> properties;
+
+    public PropertyGroups(List<PropertyGroup> propertyGroupList) {
+        this.propertyGroupList = List.copyOf(propertyGroupList);
+        this.properties =
+                propertyGroupList.stream()
+                        .flatMap(propertyGroup -> propertyGroup.getPropertyMap().values().stream())
+                        .collect(
+                                Collectors.toUnmodifiableMap(
+                                        Property::getName, Function.identity()));
+        HashMap<String, PropertyGroup> tempPropertyGroupMap = new HashMap<>(this.properties.size());
+        for (PropertyGroup propertyGroup : propertyGroupList) {
+            for (Property property : propertyGroup) {
+                tempPropertyGroupMap.put(property.getName(), propertyGroup);
+            }
+        }
+        this.propertyGroupMap = Map.copyOf(tempPropertyGroupMap);
+    }
+
+    private PropertyGroups(
+            List<PropertyGroup> propertyGroupList,
+            Map<String, PropertyGroup> propertyGroupMap,
+            Map<String, Property> properties) {
+        this.propertyGroupList = propertyGroupList;
+        this.propertyGroupMap = propertyGroupMap;
+        this.properties = properties;
+    }
+
+    public Optional<PropertyGroups> addPropertyGroupAsNew(PropertyGroup propertyGroup) {
+        if (propertyGroup == null || propertyGroup.size() == 0 || hasPropertyGroup(propertyGroup)) {
+            return Optional.empty();
+        }
+        for (Property property : propertyGroup) {
+            if (hasProperty(property.getName())) {
+                return Optional.empty();
+            }
+        }
+        List<PropertyGroup> newPropertyGroupsAsList =
+                Stream.concat(propertyGroupList.stream(), Stream.of(propertyGroup))
+                        .collect(Collectors.toUnmodifiableList());
+        Map<String, PropertyGroup> tempPropertyGroupAsMap = new HashMap<>(propertyGroupMap);
+        for (Property property : propertyGroup) {
+            tempPropertyGroupAsMap.put(property.getName(), propertyGroup);
+        }
+        Map<String, Property> newProperties =
+                Stream.concat(
+                                properties.values().stream(),
+                                propertyGroup.getPropertyMap().values().stream())
+                        .collect(
+                                Collectors.toUnmodifiableMap(
+                                        Property::getName, Function.identity()));
+        return Optional.of(
+                new PropertyGroups(
+                        newPropertyGroupsAsList,
+                        Map.copyOf(tempPropertyGroupAsMap),
+                        newProperties));
+    }
+
+    boolean hasProperty(String propertyName) {
+        return properties.containsKey(propertyName);
+    }
+
+    boolean hasPropertyGroup(PropertyGroup propertyGroup) {
+        return propertyGroupList.contains(propertyGroup);
+    }
+
+    int getPropertyGroupNum() {
+        return propertyGroupList.size();
+    }
+
+    DataType getPropertyType(String propertyName) {
+        checkPropertyExist(propertyName);
+        return properties.get(propertyName).getDataType();
+    }
+
+    boolean isPrimaryKey(String propertyName) {
+        checkPropertyExist(propertyName);
+        return properties.get(propertyName).isPrimary();
+    }
+
+    boolean isNullableKey(String propertyName) {
+        checkPropertyExist(propertyName);
+        return properties.get(propertyName).isNullable();
+    }
+
+    List<PropertyGroup> getPropertyGroupList() {
+        return propertyGroupList;
+    }
+
+    Map<String, PropertyGroup> getPropertyGroupMap() {
+        return propertyGroupMap;
+    }
+
+    PropertyGroup getPropertyGroup(String propertyName) {
+        checkPropertyExist(propertyName);
+        return propertyGroupMap.get(propertyName);
+    }
+
+    Map<String, Property> getProperties() {
+        return properties;
+    }
+
+    private void checkPropertyExist(String propertyName) {
+        if (null == propertyName) {
+            throw new IllegalArgumentException("Property name is null");
+        }
+        if (!hasProperty(propertyName)) {
+            throw new IllegalArgumentException(
+                    "Property " + propertyName + " does not exist in the property group " + this);
+        }
+    }
+}

maven-projects/info/src/main/java/org/apache/graphar/info/VertexInfo.java

@@ -24,6 +24,7 @@
 import java.util.List;
 import java.util.Optional;
 import java.util.Set;
+import org.apache.graphar.info.builder.ElementGenericAbstractBuilder;
 import org.apache.graphar.info.type.DataType;
 import org.apache.graphar.info.yaml.GraphYaml;
 import org.apache.graphar.info.yaml.VertexYaml;
@@ -36,6 +37,48 @@ public class VertexInfo {
     private final URI baseUri;
     private final VersionInfo version;
 
+    public static VertexInfoBuilder builder() {
+        return new VertexInfoBuilder();
+    }
+
+    public static class VertexInfoBuilder
+            extends ElementGenericAbstractBuilder<VertexInfo, VertexInfoBuilder> {
+        private String type;
+        private long chunkSize;
+
+        private VertexInfoBuilder() {
+            super(VertexInfo.class, VertexInfoBuilder.class);
+        }
+
+        public VertexInfoBuilder type(String type) {
+            this.type = type;
+            return this;
+        }
+
+        public VertexInfoBuilder chunkSize(long chunkSize) {
+            this.chunkSize = chunkSize;
+            return this;
+        }
+
+        @Override
+        protected void check() {
+            if (chunkSize < 0) {
+                throw new IllegalArgumentException("Chunk size cannot be negative: " + chunkSize);
+            }
+            if (baseUri == null) {
+                throw new IllegalArgumentException("Base URI cannot be null");
+            }
+        }
+    }
+
+    public VertexInfo(VertexInfoBuilder builder) {
+        this.type = builder.type;
+        this.chunkSize = builder.chunkSize;
+        this.propertyGroups = builder.propertyGroups;
+        this.baseUri = builder.baseUri;
+        this.version = builder.version;
+    }
+
     public VertexInfo(
             String type,
             long chunkSize,