Beginnings of Whirled service which is a system for building worlds made

of interconnected scenes on top of the Cocktail services.


git-svn-id: svn+ssh://src.earth.threerings.net/narya/trunk@228 542714f4-19e9-0310-aa3c-eee0fc999fb1

src/java/com/threerings/whirled/client/SceneService.java

@@ -0,0 +1,19 @@
+//
+// $Id: SceneService.java,v 1.1 2001/08/11 04:09:50 mdb Exp $
+
+package com.threerings.whirled.client;
+
+import com.threerings.cocktail.cher.client.Client;
+import com.threerings.cocktail.cher.client.InvocationManager;
+
+import com.threerings.whirled.Log;
+
+/**
+ * The scene service class provides the client interface to the scene
+ * related invocation services.
+ */
+public class SceneService
+{
+    /** The module name for the scene services. */
+    public static final String MODULE = "whirled!scene";
+}

src/java/com/threerings/whirled/client/persist/SceneRepository.java

@@ -0,0 +1,32 @@
+//
+// $Id: SceneRepository.java,v 1.1 2001/08/11 04:09:50 mdb Exp $
+
+package com.threerings.whirled.client.persist;
+
+import java.io.IOException;
+
+import com.threerings.whirled.data.Scene;
+import com.threerings.whirled.util.NoSuchSceneException;
+
+/**
+ * The scene repository provides access to a persistent repository of
+ * scene information. The scenes in the repository can be updated with
+ * individual scenes fetched from the server as well as with new scene
+ * bundles that are periodically distributed to bring all clients into
+ * sync with the latest snapshot of the scene database.
+ *
+ * @see com.threerings.whirled.client.Scene
+ */
+public interface SceneRepository
+{
+    /**
+     * Fetches the scene with the specified scene id.
+     *
+     * @exception IOException thrown if an error occurs attempting to load
+     * a scene.
+     * @exception NoSuchSceneException thrown if no scene exists with the
+     * specified scene id.
+     */
+    public Scene getScene (int sceneid)
+        throws IOException, NoSuchSceneException;
+}