added the functionality required to power the Sidebox Configure button on

the Front Page

src/venice-base/com/silverwrist/venice/script/LibraryVeniceCast.java

@@ -24,6 +24,7 @@ import com.silverwrist.venice.app.AdvancedUserService;
 import com.silverwrist.venice.community.CategoryService;
 import com.silverwrist.venice.community.CommunityService;
 import com.silverwrist.venice.iface.*;
+import com.silverwrist.venice.sidebox.SideboxDescriptor;
 import com.silverwrist.venice.sidebox.SideboxService;
 
 public class LibraryVeniceCast
@@ -138,4 +139,12 @@ public class LibraryVeniceCast
 
   } // end queryUserDefaultPropertyNamespace
 
+  public final SideboxDescriptor toSideboxDescriptor(Object obj)
+  {
+    if (obj instanceof SideboxDescriptor)
+      return (SideboxDescriptor)obj;
+    throw new ClassCastException("LibraryVeniceCast.toSideboxDescriptor: invalid cast");
+
+  } // end toSideboxDescriptor
+
 } // end class LibraryVeniceCast

src/venice-base/com/silverwrist/venice/sidebox/SideboxDescriptor.java

@@ -0,0 +1,59 @@
+/*
+ * The contents of this file are subject to the Mozilla Public License Version 1.1
+ * (the "License"); you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at <http://www.mozilla.org/MPL/>.
+ * 
+ * Software distributed under the License is distributed on an "AS IS" basis, WITHOUT
+ * WARRANTY OF ANY KIND, either express or implied. See the License for the specific
+ * language governing rights and limitations under the License.
+ * 
+ * The Original Code is the Venice Web Communities System.
+ * 
+ * The Initial Developer of the Original Code is Eric J. Bowersox <erbo@silcom.com>,
+ * for Silverwrist Design Studios.  Portions created by Eric J. Bowersox are
+ * Copyright (C) 2003 Eric J. Bowersox/Silverwrist Design Studios.  All Rights Reserved.
+ * 
+ * Contributor(s): 
+ */
+package com.silverwrist.venice.sidebox;
+
+public class SideboxDescriptor
+{
+  /*--------------------------------------------------------------------------------
+   * Attributes
+   *--------------------------------------------------------------------------------
+   */
+
+  private int m_sbid;
+  private String m_descr;
+
+  /*--------------------------------------------------------------------------------
+   * Constructor
+   *--------------------------------------------------------------------------------
+   */
+
+  SideboxDescriptor(int sbid, String descr)
+  {
+    m_sbid = sbid;
+    m_descr = descr;
+
+  } // end constructor
+
+  /*--------------------------------------------------------------------------------
+   * Public getters
+   *--------------------------------------------------------------------------------
+   */
+
+  public int getID()
+  {
+    return m_sbid;
+
+  } // end getID
+
+  public String getDescription()
+  {
+    return m_descr;
+
+  } // end getDescription
+
+} // end class SideboxDescriptor

src/venice-base/com/silverwrist/venice/sidebox/SideboxManager.java

@@ -357,4 +357,52 @@ public class SideboxManager implements NamedObject, ComponentInitialize, Compone
 
   } // end getSideboxes
 
+  public List getSideboxDescriptors(DynamoUser user, String context_namespace, String context_name,
+				    Object context_param) throws DatabaseException
+  {
+    List rc = m_ops.getSideboxDescriptors(user.getUID(),m_ns_cache.namespaceNameToId(context_namespace),context_name,
+					  context_param);
+    if (rc.isEmpty())
+      return Collections.EMPTY_LIST;
+    return Collections.unmodifiableList(rc);
+
+  } // end getSideboxDescriptors
+
+  public List getAllSideboxDescriptors(String context_namespace, String context_name) throws DatabaseException
+  {
+    List rc = m_ops.getAllSideboxDescriptors(m_ns_cache.namespaceNameToId(context_namespace),context_name);
+    if (rc.isEmpty())
+      return Collections.EMPTY_LIST;
+    return Collections.unmodifiableList(rc);
+
+  } // end getAllSideboxDescriptors
+
+  public void moveSideboxItemToPosition(DynamoUser user, String context_namespace, String context_name,
+					Object context_param, int sbid, int new_pos) throws DatabaseException
+  {
+    m_ops.moveSideboxItemToPosition(user.getUID(),m_ns_cache.namespaceNameToId(context_namespace),context_name,
+				    context_param,sbid,new_pos);
+
+  } // end moveSideboxItemToPosition
+
+  public void removeSidebox(DynamoUser user, String context_namespace, String context_name, Object context_param,
+			    int sbid) throws DatabaseException
+  {
+    m_ops.removeSidebox(user.getUID(),m_ns_cache.namespaceNameToId(context_namespace),context_name,context_param,sbid);
+
+  } // end removeSidebox
+
+  public void addSidebox(DynamoUser user, String context_namespace, String context_name, Object context_param,
+			 int sbid) throws DatabaseException
+  {
+    m_ops.addSidebox(user.getUID(),m_ns_cache.namespaceNameToId(context_namespace),context_name,context_param,sbid);
+
+  } // end addSidebox
+
+  public void copyUserConfig(DynamoUser from, DynamoUser to) throws DatabaseException
+  {
+    m_ops.copyUserConfig(from.getUID(),to.getUID());
+
+  } // end copyUserConfig
+
 } // end class SideboxManager

src/venice-base/com/silverwrist/venice/sidebox/SideboxMessages.properties

@@ -19,3 +19,6 @@ context.param.ser=Unable to serialize context parameter of class {0}.
 no.sidebox=Unable to find definition for sidebox with ID #{0}.
 property.deserialize=The value of property "{0}" could not be deserialized.
 no.sbtype=Unable to find sidebox type factory for type namespace {0}, name {1}.
+sbox.not.in.list=The sidebox with ID #{0} does not exist in the current list.
+sbox.already.in.list=The sidebox with ID #{0} already exists in the current list.
+sbox.impermissible=The sidebox with ID #{0} is not permitted in the current list.

src/venice-base/com/silverwrist/venice/sidebox/SideboxOps.java

@@ -17,6 +17,7 @@
  */
 package com.silverwrist.venice.sidebox;
 
+import java.util.*;
 import com.silverwrist.dynamo.db.OpsBase;
 import com.silverwrist.dynamo.except.*;
 import com.silverwrist.dynamo.iface.*;
@@ -49,6 +50,22 @@ abstract class SideboxOps extends OpsBase
 
   abstract Object getSideboxProperty(int sbid, PropertyKey key) throws DatabaseException;
 
+  abstract List getSideboxDescriptors(int uid, int context_nsid, String context_name, Object context_param)
+      throws DatabaseException;
+
+  abstract List getAllSideboxDescriptors(int context_nsid, String context_name) throws DatabaseException;
+
+  abstract void moveSideboxItemToPosition(int uid, int context_nsid, String context_name, Object context_param,
+					  int sbid, int new_pos) throws DatabaseException;
+
+  abstract void removeSidebox(int uid, int context_nsid, String context_name, Object context_param, int sbid)
+      throws DatabaseException;
+
+  abstract void addSidebox(int uid, int context_nsid, String context_name, Object context_param, int sbid)
+      throws DatabaseException;
+
+  abstract void copyUserConfig(int uid_from, int uid_to) throws DatabaseException;
+
   /*--------------------------------------------------------------------------------
    * External static operations
    *--------------------------------------------------------------------------------

src/venice-base/com/silverwrist/venice/sidebox/SideboxOps_mysql.java

@@ -301,4 +301,560 @@ public class SideboxOps_mysql extends SideboxOps
 
   } // end getSideboxProperty
 
+  List getSideboxDescriptors(int uid, int context_nsid, String context_name, Object context_param)
+      throws DatabaseException
+  {
+    String context_param_ser = serializeContextParam(context_param);
+    Connection conn = null;
+    PreparedStatement stmt = null;
+    ResultSet rs = null;
+
+    try
+    { // get a connection
+      conn = getConnection();
+
+      // create and execute the statement
+      if (context_param_ser==null)
+	stmt = conn.prepareStatement("SELECT m.sbid, m.descr FROM sbox_deploy d, sbox_master m WHERE m.sbid = d.sbid "
+				     + "AND d.uid = ? AND d.ctx_nsid = ? AND d.ctx_name = ? AND d.param IS NULL "
+				     + "ORDER BY d.seq;");
+      else
+      { // use the version with the parameter
+	stmt = conn.prepareStatement("SELECT m.sbid, m.descr FROM sbox_deploy d, sbox_master m WHERE m.sbid = d.sbid "
+				     + "AND d.uid = ? AND d.ctx_nsid = ? AND d.ctx_name = ? AND d.param = ? "
+				     + "ORDER BY d.seq;");
+	stmt.setString(4,context_param_ser);
+
+      } // end else
+
+      stmt.setInt(1,uid);
+      stmt.setInt(2,context_nsid);
+      stmt.setString(3,context_name);
+      rs = stmt.executeQuery();
+
+      // Build the return list.
+      ArrayList rc = new ArrayList();
+      while (rs.next())
+	rc.add(new SideboxDescriptor(rs.getInt(1),rs.getString(2)));
+      rc.trimToSize();
+      return rc;
+
+    } // end try
+    catch (SQLException e)
+    { // translate to a general DatabaseException
+      throw generalException(e);
+
+    } // end catch
+    finally
+    { // shut everything down
+      SQLUtils.shutdown(rs);
+      SQLUtils.shutdown(stmt);
+      SQLUtils.shutdown(conn);
+
+    } // end finally
+
+  } // end getSideboxDescriptors
+
+  List getAllSideboxDescriptors(int context_nsid, String context_name) throws DatabaseException
+  {
+    Connection conn = null;
+    PreparedStatement stmt = null;
+    ResultSet rs = null;
+
+    try
+    { // get a connection
+      conn = getConnection();
+
+      // create and execute the statement
+      stmt = conn.prepareStatement("SELECT m.sbid, m.descr FROM sbox_master m, sbox_context c WHERE m.sbid = c.sbid "
+				   + "AND c.ctx_nsid = ? AND c.ctx_name = ? ORDER BY m.descr");
+      stmt.setInt(1,context_nsid);
+      stmt.setString(2,context_name);
+      rs = stmt.executeQuery();
+
+      // Build the return list.
+      ArrayList rc = new ArrayList();
+      while (rs.next())
+	rc.add(new SideboxDescriptor(rs.getInt(1),rs.getString(2)));
+      rc.trimToSize();
+      return rc;
+
+    } // end try
+    catch (SQLException e)
+    { // translate to a general DatabaseException
+      throw generalException(e);
+
+    } // end catch
+    finally
+    { // shut everything down
+      SQLUtils.shutdown(rs);
+      SQLUtils.shutdown(stmt);
+      SQLUtils.shutdown(conn);
+
+    } // end finally
+
+  } // end getAllSideboxDescriptors
+
+  void moveSideboxItemToPosition(int uid, int context_nsid, String context_name, Object context_param, int sbid,
+				 int new_pos) throws DatabaseException
+  {
+    String context_param_ser = serializeContextParam(context_param);
+    Connection conn = null;
+    PreparedStatement stmt = null;
+    Statement stmt2 = null;
+    PreparedStatement stmt_ren = null;
+    ResultSet rs = null;
+
+    try
+    { // get a connection
+      conn = getConnection();
+
+      // lock the deploy table
+      stmt2 = conn.createStatement();
+      stmt2.executeUpdate("LOCK TABLES sbox_deploy WRITE;");
+
+      // locate the current position of the sidebox in the list
+      if (context_param_ser==null)
+	stmt = conn.prepareStatement("SELECT seq FROM sbox_deploy WHERE sbid = ? AND uid = ? AND ctx_nsid = ? "
+				     + "AND ctx_name = ? AND param IS NULL;");
+      else
+      { // add context parameter to statement
+	stmt = conn.prepareStatement("SELECT seq FROM sbox_deploy WHERE sbid = ? AND uid = ? AND ctx_nsid = ? "
+				     + "AND ctx_name = ? AND param = ?;");
+	stmt.setString(5,context_param_ser);
+
+      } // end else
+
+      stmt.setInt(1,sbid);
+      stmt.setInt(2,uid);
+      stmt.setInt(3,context_nsid);
+      stmt.setString(4,context_name);
+      rs = stmt.executeQuery();
+      if (!(rs.next()))
+      { // sidebox does not exist here - throw exception
+	DatabaseException de = new DatabaseException(SideboxOps_mysql.class,"SideboxMessages","sbox.not.in.list");
+	de.setParameter(0,String.valueOf(sbid));
+	throw de;
+
+      } // end if
+
+      int old_pos = rs.getInt(1);
+      if (old_pos==new_pos)
+	return;  // this is a no-op
+
+      SQLUtils.shutdown(rs);   // prep for next statement
+      rs = null;
+      SQLUtils.shutdown(stmt);
+
+      if (new_pos<0)
+	new_pos = 0;  // range-check on low end
+      else
+      { // need to range-check on high end - create statement to get max index
+	if (context_param_ser==null)
+	  stmt = conn.prepareStatement("SELECT MAX(seq) FROM sbox_deploy WHERE uid = ? AND ctx_nsid = ? "
+				       + "AND ctx_name = ? AND param IS NULL;");
+	else
+	{ // add context parameter to statement
+	  stmt = conn.prepareStatement("SELECT MAX(seq) FROM sbox_deploy WHERE uid = ? AND ctx_nsid = ? "
+				       + "AND ctx_name = ? AND param = ?;");
+	  stmt.setString(4,context_param_ser);
+
+	} // end else
+
+	stmt.setInt(1,uid);
+	stmt.setInt(2,context_nsid);
+	stmt.setString(3,context_name);
+	rs = stmt.executeQuery();
+	int max_pos = SQLUtils.getReturnCountInt(rs,1);
+	SQLUtils.shutdown(rs);   // prep for next statement
+	rs = null;
+	SQLUtils.shutdown(stmt);
+	if (new_pos>max_pos)
+	  new_pos = max_pos;
+
+      } // end else
+
+      // Start by renumbering the original item to index -1, normally unused.
+      if (context_param_ser==null)
+	stmt_ren = conn.prepareStatement("UPDATE sbox_deploy SET seq = ? WHERE sbid = ? AND uid = ? AND ctx_nsid = ? "
+					 + "AND ctx_name = ? AND param IS NULL;");
+      else
+      { // include the context parameter
+	stmt_ren = conn.prepareStatement("UPDATE sbox_deploy SET seq = ? WHERE sbid = ? AND uid = ? AND ctx_nsid = ? "
+					 + "AND ctx_name = ? AND param = ?;");
+	stmt_ren.setString(6,context_param_ser);
+
+      } // end else
+
+      stmt_ren.setInt(1,-1);
+      stmt_ren.setInt(2,sbid);
+      stmt_ren.setInt(3,uid);
+      stmt_ren.setInt(4,context_nsid);
+      stmt_ren.setString(5,context_name);
+      stmt_ren.executeUpdate();
+
+      // Now renumber the items in between the new position and the old position.
+      if (new_pos<old_pos)
+      { // prepare statement to shift some items down
+	if (context_param_ser==null)
+	  stmt = conn.prepareStatement("UPDATE sbox_deploy SET seq = seq + 1 WHERE seq >= ? AND seq <= ? AND uid = ? "
+				       + "AND ctx_nsid = ? AND ctx_name = ? AND param IS NULL;");
+	else
+	{ // include the context parameter
+	  stmt = conn.prepareStatement("UPDATE sbox_deploy SET seq = seq + 1 WHERE seq >= ? AND seq <= ? AND uid = ? "
+				       + "AND ctx_nsid = ? AND ctx_name = ? AND param = ?;");
+	  stmt.setString(6,context_param_ser);
+
+	} // end else
+
+	stmt.setInt(1,new_pos);
+	stmt.setInt(2,old_pos);
+	stmt.setInt(3,uid);
+	stmt.setInt(4,context_nsid);
+	stmt.setString(5,context_name);
+
+      } // end if
+      else
+      { // prepare statement to shift some items up
+	if (context_param_ser==null)
+	  stmt = conn.prepareStatement("UPDATE sbox_deploy SET seq = seq - 1 WHERE seq >= ? AND seq <= ? AND uid = ? "
+				       + "AND ctx_nsid = ? AND ctx_name = ? AND param IS NULL;");
+	else
+	{ // include the context parameter
+	  stmt = conn.prepareStatement("UPDATE sbox_deploy SET seq = seq - 1 WHERE seq >= ? AND seq <= ? AND uid = ? "
+				       + "AND ctx_nsid = ? AND ctx_name = ? AND param = ?;");
+	  stmt.setString(6,context_param_ser);
+
+	} // end else
+
+	stmt.setInt(1,old_pos);
+	stmt.setInt(2,new_pos);
+	stmt.setInt(3,uid);
+	stmt.setInt(4,context_nsid);
+	stmt.setString(5,context_name);
+
+      } // end else
+
+      stmt.executeUpdate();
+
+      // Now move the old element back into place in its new position, using the statement we've already prepared
+      // and just changing its parameters.
+      stmt_ren.setInt(1,new_pos);
+      stmt_ren.executeUpdate();
+
+    } // end try
+    catch (SQLException e)
+    { // translate to a general DatabaseException
+      throw generalException(e);
+
+    } // end catch
+    finally
+    { // shut everything down
+      MySQLUtils.unlockTables(conn);
+      SQLUtils.shutdown(rs);
+      SQLUtils.shutdown(stmt_ren);
+      SQLUtils.shutdown(stmt2);
+      SQLUtils.shutdown(stmt);
+      SQLUtils.shutdown(conn);
+
+    } // end finally
+
+  } // end moveSideboxItemToPosition
+
+  void removeSidebox(int uid, int context_nsid, String context_name, Object context_param, int sbid)
+      throws DatabaseException
+  {
+    String context_param_ser = serializeContextParam(context_param);
+    Connection conn = null;
+    PreparedStatement stmt = null;
+    Statement stmt2 = null;
+    ResultSet rs = null;
+
+    try
+    { // get a connection
+      conn = getConnection();
+
+      // lock the deploy table
+      stmt2 = conn.createStatement();
+      stmt2.executeUpdate("LOCK TABLES sbox_deploy WRITE;");
+
+      // look for the item in the list, and get its old position
+      // locate the current position of the sidebox in the list
+      if (context_param_ser==null)
+	stmt = conn.prepareStatement("SELECT seq FROM sbox_deploy WHERE sbid = ? AND uid = ? AND ctx_nsid = ? "
+				     + "AND ctx_name = ? AND param IS NULL;");
+      else
+      { // add context parameter to statement
+	stmt = conn.prepareStatement("SELECT seq FROM sbox_deploy WHERE sbid = ? AND uid = ? AND ctx_nsid = ? "
+				     + "AND ctx_name = ? AND param = ?;");
+	stmt.setString(5,context_param_ser);
+
+      } // end else
+
+      stmt.setInt(1,sbid);
+      stmt.setInt(2,uid);
+      stmt.setInt(3,context_nsid);
+      stmt.setString(4,context_name);
+      rs = stmt.executeQuery();
+      if (!(rs.next()))
+      { // sidebox does not exist here - throw exception
+	DatabaseException de = new DatabaseException(SideboxOps_mysql.class,"SideboxMessages","sbox.not.in.list");
+	de.setParameter(0,String.valueOf(sbid));
+	throw de;
+
+      } // end if
+
+      int old_pos = rs.getInt(1);
+
+      SQLUtils.shutdown(rs);   // prep for next statement
+      rs = null;
+      SQLUtils.shutdown(stmt);
+
+      // Erase this row from the table.
+      if (context_param_ser==null)
+	stmt = conn.prepareStatement("DELETE FROM sbox_deploy WHERE sbid = ? AND uid = ? AND ctx_nsid = ? "
+				     + "AND ctx_name = ? AND param IS NULL;");
+      else
+      { // include the context parameter
+	stmt = conn.prepareStatement("DELETE FROM sbox_deploy WHERE sbid = ? AND uid = ? AND ctx_nsid = ? "
+				     + "AND ctx_name = ? AND param = ?;");
+	stmt.setString(5,context_param_ser);
+
+      } // end else
+
+      stmt.setInt(1,sbid);
+      stmt.setInt(2,uid);
+      stmt.setInt(3,context_nsid);
+      stmt.setString(4,context_name);
+      stmt.executeUpdate();
+
+      // Now renumber all the following rows to close the gap.
+      SQLUtils.shutdown(stmt);
+      if (context_param_ser==null)
+	stmt = conn.prepareStatement("UPDATE sbox_deploy SET seq = seq - 1 WHERE seq >= ? AND uid = ? "
+				     + "AND ctx_nsid = ? AND ctx_name = ? AND param IS NULL;");
+      else
+      { // include the context parameter
+	stmt = conn.prepareStatement("UPDATE sbox_deploy SET seq = seq - 1 WHERE seq >= ? AND uid = ? "
+				     + "AND ctx_nsid = ? AND ctx_name = ? AND param = ?;");
+	stmt.setString(5,context_param_ser);
+
+      } // end else
+
+      stmt.setInt(1,old_pos);
+      stmt.setInt(2,uid);
+      stmt.setInt(3,context_nsid);
+      stmt.setString(4,context_name);
+      stmt.executeUpdate();
+
+    } // end try
+    catch (SQLException e)
+    { // translate to a general DatabaseException
+      throw generalException(e);
+
+    } // end catch
+    finally
+    { // shut everything down
+      MySQLUtils.unlockTables(conn);
+      SQLUtils.shutdown(rs);
+      SQLUtils.shutdown(stmt2);
+      SQLUtils.shutdown(stmt);
+      SQLUtils.shutdown(conn);
+
+    } // end finally
+
+  } // end removeSidebox
+
+  void addSidebox(int uid, int context_nsid, String context_name, Object context_param, int sbid)
+      throws DatabaseException
+  {
+    String context_param_ser = serializeContextParam(context_param);
+    Connection conn = null;
+    PreparedStatement stmt = null;
+    Statement stmt2 = null;
+    ResultSet rs = null;
+
+    try
+    { // get a connection
+      conn = getConnection();
+
+      // lock the deploy table
+      stmt2 = conn.createStatement();
+      stmt2.executeUpdate("LOCK TABLES sbox_deploy WRITE, sbox_context READ;");
+
+      // see if the given sidebox is already in the list
+      if (context_param_ser==null)
+	stmt = conn.prepareStatement("SELECT seq FROM sbox_deploy WHERE sbid = ? AND uid = ? AND ctx_nsid = ? "
+				     + "AND ctx_name = ? AND param IS NULL;");
+      else
+      { // add context parameter to statement
+	stmt = conn.prepareStatement("SELECT seq FROM sbox_deploy WHERE sbid = ? AND uid = ? AND ctx_nsid = ? "
+				     + "AND ctx_name = ? AND param = ?;");
+	stmt.setString(5,context_param_ser);
+
+      } // end else
+
+      stmt.setInt(1,sbid);
+      stmt.setInt(2,uid);
+      stmt.setInt(3,context_nsid);
+      stmt.setString(4,context_name);
+      rs = stmt.executeQuery();
+      if (rs.next())
+      { // already in list - throw exception
+	DatabaseException de = new DatabaseException(SideboxOps_mysql.class,"SideboxMessages","sbox.already.in.list");
+	de.setParameter(0,String.valueOf(sbid));
+	throw de;
+
+      } // end if
+
+      SQLUtils.shutdown(rs);   // prep for next statement
+      rs = null;
+      SQLUtils.shutdown(stmt);
+
+      // Make sure this sidebox is permissible in this context.
+      stmt = conn.prepareStatement("SELECT sbid FROM sbox_context WHERE sbid = ? AND ctx_nsid = ? AND ctx_name = ?;");
+      stmt.setInt(1,sbid);
+      stmt.setInt(2,context_nsid);
+      stmt.setString(3,context_name);
+      rs = stmt.executeQuery();
+      if (!(rs.next()))
+      { // impermissible in this list - throw an exception
+	DatabaseException de = new DatabaseException(SideboxOps_mysql.class,"SideboxMessages","sbox.impermissible");
+	de.setParameter(0,String.valueOf(sbid));
+	throw de;
+
+      } // end if
+
+      SQLUtils.shutdown(rs);   // prep for next statement
+      rs = null;
+      SQLUtils.shutdown(stmt);
+
+      // Get the number of items we already have in the list, which is also the index of the new item (as
+      // elements start numbering with 0).
+      if (context_param_ser==null)
+	stmt = conn.prepareStatement("SELECT COUNT(*) FROM sbox_deploy WHERE uid = ? AND ctx_nsid = ? "
+				     + "AND ctx_name = ? AND param IS NULL;");
+      else
+      { // add context parameter to statement
+	stmt = conn.prepareStatement("SELECT COUNT(*) FROM sbox_deploy WHERE uid = ? AND ctx_nsid = ? "
+				     + "AND ctx_name = ? AND param = ?;");
+	stmt.setString(4,context_param_ser);
+
+      } // end else
+
+      stmt.setInt(1,uid);
+      stmt.setInt(2,context_nsid);
+      stmt.setString(3,context_name);
+      rs = stmt.executeQuery();
+      int new_seq = SQLUtils.getReturnCountInt(rs,1);
+
+      SQLUtils.shutdown(rs);   // prep for next statement
+      rs = null;
+      SQLUtils.shutdown(stmt);
+
+      // Insert the new sidebox into the table.
+      stmt = conn.prepareStatement("INSERT INTO sbox_deploy (uid, ctx_nsid, ctx_name, param, seq, sbid) "
+				   + "VALUES (?, ?, ?, ?, ?, ?);");
+      stmt.setInt(1,uid);
+      stmt.setInt(2,context_nsid);
+      stmt.setString(3,context_name);
+      stmt.setString(4,context_param_ser);
+      stmt.setInt(5,new_seq);
+      stmt.setInt(6,sbid);
+      stmt.executeUpdate();
+
+    } // end try
+    catch (SQLException e)
+    { // translate to a general DatabaseException
+      throw generalException(e);
+
+    } // end catch
+    finally
+    { // shut everything down
+      MySQLUtils.unlockTables(conn);
+      SQLUtils.shutdown(rs);
+      SQLUtils.shutdown(stmt2);
+      SQLUtils.shutdown(stmt);
+      SQLUtils.shutdown(conn);
+
+    } // end finally
+
+  } // end addSidebox
+
+  void copyUserConfig(int uid_from, int uid_to) throws DatabaseException
+  {
+    Connection conn = null;
+    PreparedStatement stmt = null;
+    Statement stmt2 = null;
+    ResultSet rs = null;
+
+    try
+    { // get a connection
+      conn = getConnection();
+
+      // lock the deploy table
+      stmt2 = conn.createStatement();
+      stmt2.executeUpdate("LOCK TABLES sbox_deploy WRITE;");
+
+      // start by getting the configuration for the existing user
+      stmt = conn.prepareStatement("SELECT ctx_nsid, ctx_name, param, seq, sbid FROM sbox_deploy WHERE uid = ?;");
+      stmt.setInt(1,uid_from);
+      rs = stmt.executeQuery();
+      LinkedList items = new LinkedList();
+      while (rs.next())
+      { // save in a cheap and simple fashion
+	Object[] tmp = new Object[5];
+	tmp[0] = rs.getObject(1);
+	tmp[1] = rs.getObject(2);
+	tmp[2] = rs.getObject(3);
+	tmp[3] = rs.getObject(4);
+	tmp[4] = rs.getObject(5);
+	items.addLast(tmp);
+
+      } // end while
+
+      SQLUtils.shutdown(rs);   // prep for next statement
+      rs = null;
+      SQLUtils.shutdown(stmt);
+
+      // erase existing config for destination user
+      stmt = conn.prepareStatement("DELETE FROM sbox_deploy WHERE uid = ?;");
+      stmt.setInt(1,uid_to);
+      stmt.executeUpdate();
+
+      // now copy over the configuration
+      SQLUtils.shutdown(stmt);
+      stmt = conn.prepareStatement("INSERT INTO sbox_deploy (uid, ctx_nsid, ctx_name, param, seq, sbid) "
+				   + "VALUES (?, ?, ?, ?, ?, ?);");
+      stmt.setInt(1,uid_to);
+      while (!(items.isEmpty()))
+      { // add the items in, one at a time
+	Object[] tmp = (Object[])(items.removeFirst());
+	stmt.setObject(2,tmp[0],Types.INTEGER);
+	stmt.setObject(3,tmp[1],Types.VARCHAR);
+	stmt.setObject(4,tmp[2],Types.VARCHAR);
+	stmt.setObject(5,tmp[3],Types.INTEGER);
+	stmt.setObject(6,tmp[4],Types.INTEGER);
+	stmt.executeUpdate();
+
+      } // end while
+
+    } // end try
+    catch (SQLException e)
+    { // translate to a general DatabaseException
+      throw generalException(e);
+
+    } // end catch
+    finally
+    { // shut everything down
+      MySQLUtils.unlockTables(conn);
+      SQLUtils.shutdown(rs);
+      SQLUtils.shutdown(stmt2);
+      SQLUtils.shutdown(stmt);
+      SQLUtils.shutdown(conn);
+
+    } // end finally
+
+  } // end copyUserConfig
+
 } // end class SideboxOps_mysql

src/venice-base/com/silverwrist/venice/sidebox/SideboxService.java

@@ -18,7 +18,9 @@
 package com.silverwrist.venice.sidebox;
 
 import java.util.List;
+import com.silverwrist.dynamo.except.DatabaseException;
 import com.silverwrist.dynamo.except.DynamoException;
+import com.silverwrist.dynamo.iface.DynamoUser;
 import com.silverwrist.dynamo.iface.Request;
 
 public interface SideboxService
@@ -26,4 +28,20 @@ public interface SideboxService
   public List getSideboxes(Request req, String context_namespace, String context_name, Object context_param)
       throws DynamoException;
 
+  public List getSideboxDescriptors(DynamoUser user, String context_namespace, String context_name,
+				    Object context_param) throws DatabaseException;
+
+  public List getAllSideboxDescriptors(String context_namespace, String context_name) throws DatabaseException;
+
+  public void moveSideboxItemToPosition(DynamoUser user, String context_namespace, String context_name,
+					Object context_param, int sbid, int new_pos) throws DatabaseException;
+
+  public void removeSidebox(DynamoUser user, String context_namespace, String context_name, Object context_param,
+			    int sbid) throws DatabaseException;
+
+  public void addSidebox(DynamoUser user, String context_namespace, String context_name, Object context_param,
+			 int sbid) throws DatabaseException;
+
+  public void copyUserConfig(DynamoUser from, DynamoUser to) throws DatabaseException;
+
 } // end interface SideboxService