/**
* Abstract base class for all put requests that insert a directory.
*
+ * @param <C>
+ * The type of the “ClientPutDir” command
* @author David Roden <droden@gmail.com>
- * @version $Id$
*/
-public class ClientPutDir extends ClientPut {
+public class ClientPutDir<C extends ClientPutDir<?>> extends ClientPut {
+
+ /**
+ * All possible manifest putters. Manifest putters are used to distribute
+ * files of a directory insert to different containers, depending on size,
+ * type, and other factors.
+ *
+ * @author David ‘Bombe’ Roden <bombe@freenetproject.org>
+ */
+ public enum ManifestPutter {
+
+ /**
+ * Use the “simple” manifest putter. Despite its name this is currently
+ * the default manifest putter.
+ */
+ SIMPLE("simple"),
+
+ /** Use the “default” manifest putter. */
+ DEFAULT("default");
+
+ /** The name of the manifest putter. */
+ private final String name;
+
+ /**
+ * Creates a new manifest putter.
+ *
+ * @param name
+ * The name of the manifest putter
+ */
+ private ManifestPutter(String name) {
+ this.name = name;
+ }
+
+ /**
+ * Returns the name of the manifest putter.
+ *
+ * @return The name of the manifest putter
+ */
+ public String getName() {
+ return name;
+ }
+
+ }
/** The default file of the directory. */
protected String defaultName;
+ /** The manifest putter to use. */
+ private ManifestPutter manifestPutter;
+
/**
* Creates a new request with the specified name, identifier, and URI.
*
}
/**
+ * Returns the current manifest putter.
+ *
+ * @return The current manifest putter (may be {@code null})
+ */
+ public ManifestPutter getManifestPutter() {
+ return manifestPutter;
+ }
+
+ /**
+ * Sets the manifest putter for the “ClientPutDir” command. If {@code null}
+ * is given the node will choose a manifest putter.
+ *
+ * @param manifestPutter
+ * The manifest putter to use for the command (may be
+ * {@code null})
+ * @return This ClientPutDir command
+ */
+ @SuppressWarnings("unchecked")
+ public C setManifestPutter(ManifestPutter manifestPutter) {
+ this.manifestPutter = manifestPutter;
+ return (C) this;
+ }
+
+ /**
* {@inheritDoc}
*/
@Override
super.write(writer);
if (defaultName != null)
writer.write("DefaultName=" + defaultName + LINEFEED);
+ if (manifestPutter != null) {
+ writer.write("ManifestPutter=" + manifestPutter.getName() + LINEFEED);
+ }
}
}