X-Git-Url: http://jsfdemo.indexdata.com/?a=blobdiff_plain;f=src%2Fmain%2Fjava%2Forg%2Fyaz4j%2FPackage.java;h=83aa74b8a83e9d3eac1715da86cae80780d4fcfe;hb=ec11eeeb5288f7d1048aed90874cd896468159d4;hp=5bd6461bc310d73627e956ce1c2a7f35d21098e9;hpb=2def7bc64faa1dfb9f3393f2c2ef0bca0c6265e1;p=yaz4j-moved-to-github.git

diff --git a/src/main/java/org/yaz4j/Package.java b/src/main/java/org/yaz4j/Package.java
index 5bd6461..83aa74b 100644
--- a/src/main/java/org/yaz4j/Package.java
+++ b/src/main/java/org/yaz4j/Package.java
@@ -3,35 +3,65 @@ package org.yaz4j;
 import org.yaz4j.jni.SWIGTYPE_p_ZOOM_package_p;
 import org.yaz4j.jni.yaz4jlib;
 
+/**
+ * Allows to perform an extended-service operation.
+ * 
+ * Once created, a package is configured by means of options, then the package 
+ * is send and the result is inspected (again, by means of options).
+ * 
+ * @see org.yaz4j.ConnectionExtended#getPackage(java.lang.String) 
+ * 
+ * @author jakub
+ */
 public class Package {
 
-    private SWIGTYPE_p_ZOOM_package_p pack = null;
-    private ConnectionExtended connection = null;
-    private String type;
+  private SWIGTYPE_p_ZOOM_package_p pack;
+  private ConnectionExtended connection;
+  private String type;
 
-    Package(SWIGTYPE_p_ZOOM_package_p pack, ConnectionExtended connection, String type) {
-        this.type = type;
-        this.connection = connection;
-        this.pack = pack;
-    }
+  Package(SWIGTYPE_p_ZOOM_package_p pack, ConnectionExtended connection,
+    String type) {
+    this.type = type;
+    this.connection = connection;
+    this.pack = pack;
+  }
 
-    public void finalize() {
-        dispose();
-    }
+  public void finalize() {
+    _dispose();
+  }
 
-    public PackageOptionsCollection getPackageOptions() {
-        return new PackageOptionsCollection(pack);
-    }
+  /**
+   * Write option for a specified key
+   * @param key option name
+   * @param value option value
+   * @return package (self) for chainability
+   */
+  public Package option(String key, String value) {
+    yaz4jlib.ZOOM_package_option_set(pack, key, value);
+    return this;
+  }
 
-    public void send() {
-        yaz4jlib.ZOOM_package_send(pack, type);
-    }
+  /**
+   * Read option for a specified key.
+   * @param key option name
+   * @return option value
+   */
+  public String option(String key) {
+    return yaz4jlib.ZOOM_package_option_get(pack, key);
+  }
+
+  /**
+   * Send the package.
+   */
+  public void send() {
+    yaz4jlib.ZOOM_package_send(pack, type);
+  }
 
-    public void dispose() {
-        if (pack != null) {
-            yaz4jlib.ZOOM_package_destroy(pack);
-            connection = null;
-            pack = null;
-        }
+  void _dispose() {
+    if (pack != null) {
+      yaz4jlib.ZOOM_package_destroy(pack);
+      connection = null;
+      pack = null;
     }
+  }
 }