feat: added some component properties

Author: zihluwang

webcal/src/main/java/com/onixbyte/icalendar/CalendarUtil.java

@@ -17,6 +17,14 @@
 
 package com.onixbyte.icalendar;
 
+import com.onixbyte.icalendar.property.parameter.AlternateRepresentation;
+import com.onixbyte.icalendar.property.parameter.Language;
+
+import java.time.format.DateTimeFormatter;
+import java.util.Objects;
+import java.util.Optional;
+import java.util.function.Supplier;
+
 /**
  * CalendarUtil
  *

webcal/src/main/java/com/onixbyte/icalendar/calendar/property/Method.java

@@ -17,7 +17,7 @@
 
 package com.onixbyte.icalendar.calendar.property;
 
-public enum Method implements CalendarProperty {
+public enum Method implements Property {
 
     PUBLISH("PUBLISH"),
     REQUEST("REQUEST"),

webcal/src/main/java/com/onixbyte/icalendar/calendar/property/ProductIdentifier.java

@@ -22,7 +22,7 @@
  *
  * @author Zihlu WANG
  */
-public final class ProductIdentifier implements CalendarProperty {
+public final class ProductIdentifier implements Property {
 
     private final String value;
 

…/calendar/property/CalendarProperty.java …calendar/calendar/property/Property.javawebcal/src/main/java/com/onixbyte/icalendar/calendar/property/CalendarProperty.java renamed to webcal/src/main/java/com/onixbyte/icalendar/calendar/property/Property.java webcal/src/main/java/com/onixbyte/icalendar/calendar/property/CalendarProperty.java renamed to webcal/src/main/java/com/onixbyte/icalendar/calendar/property/Property.java

@@ -17,7 +17,7 @@
 
 package com.onixbyte.icalendar.calendar.property;
 
-import com.onixbyte.icalendar.property.CalendarResolvable;
+import com.onixbyte.icalendar.property.Resolvable;
 
-public interface CalendarProperty extends CalendarResolvable {
+public interface Property extends Resolvable {
 }

…dar/calendar/property/CalendarScale.java …e/icalendar/calendar/property/Scale.javawebcal/src/main/java/com/onixbyte/icalendar/calendar/property/CalendarScale.java renamed to webcal/src/main/java/com/onixbyte/icalendar/calendar/property/Scale.java webcal/src/main/java/com/onixbyte/icalendar/calendar/property/CalendarScale.java renamed to webcal/src/main/java/com/onixbyte/icalendar/calendar/property/Scale.java

@@ -18,11 +18,11 @@
 package com.onixbyte.icalendar.calendar.property;
 
 /**
- * CalendarScale
+ * Scale
  *
  * @author Zihlu WANG
  */
-public enum CalendarScale implements CalendarProperty {
+public enum Scale implements Property {
 
     GREGORIAN,
     ;

webcal/src/main/java/com/onixbyte/icalendar/calendar/property/Version.java

@@ -22,7 +22,7 @@
  *
  * @author Zihlu WANG
  */
-public enum Version implements CalendarProperty {
+public enum Version implements Property {
 
     VERSION_2_0,
     ;

webcal/src/main/java/com/onixbyte/icalendar/component/Calendar.java

@@ -17,7 +17,7 @@
 
 package com.onixbyte.icalendar.component;
 
-import com.onixbyte.icalendar.calendar.property.CalendarScale;
+import com.onixbyte.icalendar.calendar.property.Scale;
 import com.onixbyte.icalendar.calendar.property.Method;
 import com.onixbyte.icalendar.calendar.property.ProductIdentifier;
 import com.onixbyte.icalendar.calendar.property.Version;
@@ -60,7 +60,7 @@ public final class Calendar {
     /**
      * This property are OPTIONAL, but MUST NOT occur more than once.
      */
-    private CalendarScale scale;
+    private Scale scale;
 
     /**
      * This property are OPTIONAL, but MUST NOT occur more than once.

webcal/src/main/java/com/onixbyte/icalendar/component/property/Attachment.java

@@ -20,28 +20,35 @@
 import com.onixbyte.icalendar.property.parameter.FormatType;
 
 import java.net.URI;
+import java.util.Objects;
 import java.util.Optional;
 
 /**
  * Attachment
  *
  * @author Zihlu WANG
  */
-public final class Attachment implements ComponentProperty {
+public record Attachment(FormatType formatType,
+                         URI uri,
+                         String content) implements ComponentProperty {
 
-    private FormatType formatType;
-
-    private URI uri;
+    private static final String PROPERTY_NAME = "ATTACH";
 
     @Override
     public String resolve() {
-        final var attachmentBuilder = new StringBuilder("ATTACH");
+        if (Objects.isNull(uri) && (Objects.isNull(content) || content.isBlank())) {
+            return null;
+        }
+
+        final var attachmentBuilder = new StringBuilder(PROPERTY_NAME);
 
         Optional.ofNullable(formatType)
-                .ifPresent((fmtType) -> attachmentBuilder.append(fmtType.resolve()));
+                .ifPresent((fmtType) -> attachmentBuilder.append(";").append(fmtType.resolve()));
 
-        attachmentBuilder.append(":")
-                .append(uri.toString());
+        Optional.ofNullable(uri).ifPresentOrElse(
+                (_uri) -> attachmentBuilder.append(":").append(_uri),
+                () -> attachmentBuilder.append(";ENCODING=BASE64;VALUE=BINARY:").append(content));
+        attachmentBuilder.append("\n");
 
         return attachmentBuilder.toString();
     }

webcal/src/main/java/com/onixbyte/icalendar/component/property/CalendarDuration.java

@@ -0,0 +1,30 @@
+/*
+ * Copyright (C) 2024-2024 OnixByte.
+ *
+ * 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.
+ */
+
+package com.onixbyte.icalendar.component.property;
+
+import java.time.Duration;
+
+public record CalendarDuration(Duration duration) implements ComponentProperty {
+
+    private static final String PROPERTY_NAME = "DURATION";
+
+    @Override
+    public String resolve() {
+        return PROPERTY_NAME + ":" + duration.toString() + "\n";
+    }
+}

webcal/src/main/java/com/onixbyte/icalendar/component/property/Categories.java

@@ -17,5 +17,49 @@
 
 package com.onixbyte.icalendar.component.property;
 
-public class Categories {
+import java.util.ArrayList;
+import java.util.List;
+
+public final class Categories implements ComponentProperty {
+
+    private static final String PROPERTY_NAME = "CATEGORIES";
+
+    private final List<String> value;
+
+    private Categories(List<String> value) {
+        this.value = value;
+    }
+
+    public static class Builder {
+        private List<String> categories;
+
+        private Builder() {
+            categories = new ArrayList<>();
+        }
+
+        public Builder addCategory(String category) {
+            if (!categories.contains(category)) {
+                categories.add(category);
+            }
+            return this;
+        }
+
+        public Builder addCategories(List<String> categories) {
+            categories.forEach(this::addCategory);
+            return this;
+        }
+
+        public Categories build() {
+            return new Categories(categories);
+        }
+    }
+
+    public static Builder builder() {
+        return new Builder();
+    }
+
+    @Override
+    public String resolve() {
+        return PROPERTY_NAME + ":" + String.join(",", value) + "\n";
+    }
 }