+
+ /**
+ * convenience method to pass the serviceHandle reference that instantiated
+ * this service on to the menu entry constructor
+ *
+ * @param wsmenu
+ * the menu to which any menu entries/sub menus are to be
+ * attached
+ * @param alignFrame
+ * the alignFrame instance that provides input data for the
+ * service
+ */
+ public void attachWSMenuEntry(JMenu wsmenu, final AlignFrame alignFrame)
+ {
+ if (serviceHandle == null)
+ {
+ throw new Error(
+ "IMPLEMENTATION ERROR: cannot attach WS Menu Entry without service handle reference!");
+ }
+ attachWSMenuEntry(wsmenu, serviceHandle, alignFrame);
+ }
+
+ /**
+ * method implemented by each WSClient implementation that creates menu
+ * entries that enact their service using data from alignFrame.
+ *
+ * @param wsmenu
+ * where new menu entries (and submenus) are to be attached
+ * @param serviceHandle
+ * the serviceHandle document for the service that entries are
+ * created for
+ * @param alignFrame
+ */
+ public abstract void attachWSMenuEntry(JMenu wsmenu,
+ final ServiceHandle serviceHandle, final AlignFrame alignFrame);