added annotation to provide way to mark class fields to be added as custom ones by DSLBuilder

Author: raydac

jbbp/src/main/java/com/igormaznitsa/jbbp/io/AbstractMappedClassFieldObserver.java

@@ -19,6 +19,7 @@
 import com.igormaznitsa.jbbp.exceptions.JBBPException;
 import com.igormaznitsa.jbbp.exceptions.JBBPIllegalArgumentException;
 import com.igormaznitsa.jbbp.mapper.Bin;
+import com.igormaznitsa.jbbp.utils.DslBinCustom;
 import com.igormaznitsa.jbbp.mapper.BinType;
 import com.igormaznitsa.jbbp.model.JBBPFieldInt;
 import com.igormaznitsa.jbbp.model.JBBPFieldLong;
@@ -148,7 +149,9 @@ protected void processObject(final Object obj, Field field, final Object customF
     field = ReflectUtils.makeAccessible(field);
 
     final Bin clazzAnno = obj.getClass().getAnnotation(Bin.class);
+    final DslBinCustom clazzCustomAnno = obj.getClass().getAnnotation(DslBinCustom.class);
     final Bin fieldAnno = field == null ? null : field.getAnnotation(Bin.class);
+    final DslBinCustom fieldCustomAnno = field == null ? null : field.getAnnotation(DslBinCustom.class);
 
     this.onStructStart(obj, field, clazzAnno == null ? fieldAnno : clazzAnno);
 

jbbp/src/main/java/com/igormaznitsa/jbbp/utils/DslBinCustom.java

@@ -0,0 +1,61 @@
+package com.igormaznitsa.jbbp.utils;
+
+import com.igormaznitsa.jbbp.io.JBBPByteOrder;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Inherited;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Annotation allows to mark a field as custom data type for DSL builder.
+ * @since 1.4.1
+ * @see com.igormaznitsa.jbbp.utils.JBBPDslBuilder
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target( {ElementType.FIELD, ElementType.TYPE})
+@Inherited
+public @interface DslBinCustom {
+  /**
+   * Name of the field.
+   * @return name of the field, if empty then undefined
+   */
+  String name() default "";
+
+  /**
+   * Name of the custom type.
+   * @return type of the field, if empty then undefined
+   */
+  String type() default "";
+
+  /**
+   * Byte order for the field.
+   * @return byte order of data represented by the field
+   */
+  JBBPByteOrder byteOrder() default JBBPByteOrder.BIG_ENDIAN;
+
+  /**
+   * Expression to be placed in extra part of type. It means type[:extra]
+   * @return extra value, if empty then undefined
+   */
+  String extraExpression() default "";
+
+  /**
+   * Expression to represent array size of the field.
+   * @return array size of the field, if empty then not defined
+   */
+  String arraySizeExpression() default "";
+
+  /**
+   * Order of the field.
+   * @return order of the field.
+   */
+  int order() default 0;
+
+  /**
+   * Field allows provide some comment.
+   * @return comment for the annotation
+   */
+  String comment() default "";
+}