[Java]: Fix for aeron-io#197 - TokenListener.onGroupHeader(Token, int) added as a meta data callback to indicate the number of times the group with repeat.

Author: mjpt777

examples/java/uk/co/real_logic/sbe/examples/ExampleTokenListener.java

@@ -124,6 +124,15 @@ public void onEndComposite(final Token fieldToken, final List<Token> tokens, fin
  namedScope.pop();
  }
 
+ public void onGroupHeader(final Token token, final int numInGroup)
+ {
+ printScope();
+ out.append(token.name())
+ .append(" Group Header : numInGroup=")
+ .append(Integer.toString(numInGroup))
+ .println();
+ }
+
  public void onBeginGroup(final Token token, final int groupIndex, final int numInGroup)
  {
  namedScope.push(token.name() + ".");

main/java/uk/co/real_logic/sbe/otf/OtfMessageDecoder.java

@@ -123,6 +123,8 @@ private static int decodeGroups(final DirectBuffer buffer,
  final int nextGroupIndex = findNextOrLimit(tokens, beginFieldsIndex, toIndex, Signal.BEGIN_GROUP);
  final int endOfFieldsIndex = Math.min(endGroupIndex, nextGroupIndex) - 1;
 
+ listener.onGroupHeader(token, numInGroup);
+
  for (int g = 0; g < numInGroup; g++)
  {
  listener.onBeginGroup(token, g, numInGroup);

main/java/uk/co/real_logic/sbe/otf/TokenListener.java

@@ -106,6 +106,14 @@ void onBitSet(Token fieldToken,
  */
  void onEndComposite(Token fieldToken, List<Token> tokens, int fromIndex, int toIndex);
 
+ /**
+ * Group encountered.
+ *
+ * @param token describing the group.
+ * @param numInGroup number of times the group will be repeated.
+ */
+ void onGroupHeader(Token token, int numInGroup);
+
  /**
  * Beginning of group encoded type encountered.
  *