Issue 508
[zxing.git] / core / src / com / google / zxing / Result.java
index 3173af3..ee1af52 100644 (file)
@@ -1,5 +1,5 @@
 /*
- * Copyright 2007 Google Inc.
+ * Copyright 2007 ZXing authors
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
 
 package com.google.zxing;
 
+import java.util.Enumeration;
 import java.util.Hashtable;
 
 /**
  * <p>Encapsulates the result of decoding a barcode within an image.</p>
  *
- * @author srowen@google.com (Sean Owen)
+ * @author Sean Owen
  */
 public final class Result {
 
   private final String text;
   private final byte[] rawBytes;
-  private final ResultPoint[] resultPoints;
+  private ResultPoint[] resultPoints;
   private final BarcodeFormat format;
   private Hashtable resultMetadata;
+  private final long timestamp;
 
   public Result(String text,
                 byte[] rawBytes,
                 ResultPoint[] resultPoints,
                 BarcodeFormat format) {
+    this(text, rawBytes, resultPoints, format, System.currentTimeMillis());
+  }
+
+  public Result(String text,
+                byte[] rawBytes,
+                ResultPoint[] resultPoints,
+                BarcodeFormat format,
+                long timestamp) {
     if (text == null && rawBytes == null) {
       throw new IllegalArgumentException("Text and bytes are null");
     }
@@ -43,6 +53,7 @@ public final class Result {
     this.resultPoints = resultPoints;
     this.format = format;
     this.resultMetadata = null;
+    this.timestamp = timestamp;
   }
 
   /**
@@ -69,15 +80,16 @@ public final class Result {
   }
 
   /**
-   * @return {@link BarcodeFormat} representing the format of the barcode that was recognized and decoded
+   * @return {@link BarcodeFormat} representing the format of the barcode that was decoded
    */
   public BarcodeFormat getBarcodeFormat() {
     return format;
   }
 
   /**
-   * @return {@link Hashtable} mapping {@link ResultMetadataType} keys to values. May be <code>null</code>.
-   *  This contains optional metadata about what was detected about the barcode, like orientation.
+   * @return {@link Hashtable} mapping {@link ResultMetadataType} keys to values. May be
+   *   <code>null</code>. This contains optional metadata about what was detected about the barcode,
+   *   like orientation.
    */
   public Hashtable getResultMetadata() {
     return resultMetadata;
@@ -90,6 +102,36 @@ public final class Result {
     resultMetadata.put(type, value);
   }
 
+  public void putAllMetadata(Hashtable metadata) {
+    if (metadata != null) {
+      if (resultMetadata == null) {
+        resultMetadata = metadata;
+      } else {
+        Enumeration e = metadata.keys();
+        while (e.hasMoreElements()) {
+          ResultMetadataType key = (ResultMetadataType) e.nextElement();
+          Object value = metadata.get(key);
+          resultMetadata.put(key, value);
+        }
+      }
+    }
+  }
+
+  public void addResultPoints(ResultPoint[] newPoints) {
+    if (resultPoints == null) {
+      resultPoints = newPoints;
+    } else if (newPoints != null && newPoints.length > 0) {
+      ResultPoint[] allPoints = new ResultPoint[resultPoints.length + newPoints.length];
+      System.arraycopy(resultPoints, 0, allPoints, 0, resultPoints.length);
+      System.arraycopy(newPoints, 0, allPoints, resultPoints.length, newPoints.length);
+      resultPoints = allPoints;
+    }
+  }
+
+  public long getTimestamp() {
+    return timestamp;
+  }
+
   public String toString() {
     if (text == null) {
       return "[" + rawBytes.length + " bytes]";