Add a new option to Params: startupCommands

startupCommands is an array of beanshell commands which will be executed
on the interpeter for each telnet client before the client is handed
control

Author: jasonwyatt

app/src/main/java/jwf/debugport/app/MainActivity.java

@@ -37,7 +37,12 @@ protected void onCreate(@Nullable Bundle savedInstanceState) {
     public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {
         TextView status = (TextView) findViewById(R.id.server_status);
         if (isChecked) {
-            Params params = new Params();
+            Params params = new Params()
+                    .setStartupCommands(new String[]{
+                            "import android.os.*;",
+                            "import java.util.*;",
+                            "x = 1+1;",
+                    });
             DebugPortService.start(this, params);
             if (status != null) {
                 status.setText(getString(R.string.server_status, getIpAddress(), params.getPort()));

library/src/main/java/jwf/debugport/Params.java

@@ -4,25 +4,51 @@
 import android.os.Parcelable;
 
 /**
- *
+ * Configuration parameters for the {@link DebugPortService}
  */
 public class Params implements Parcelable {
     public static final int DEFAULT_PORT = 8562;
+    private String[] mStartupCommands;
     private int mPort;
 
     public Params() {
         mPort = DEFAULT_PORT;
+        mStartupCommands = new String[0];
     }
 
+    /**
+     * Set the port on which the {@link jwf.debugport.internal.TelnetServer} should be made available.
+     */
     public Params setPort(int port) {
         mPort = port;
         return this;
     }
 
+    /**
+     * Get the port on which the {@link jwf.debugport.internal.TelnetServer} will be made available.
+     */
     public int getPort() {
         return mPort;
     }
 
+    /**
+     * Set an array of commands which should be executed on the interpreter before the telnet client
+     * is given control.  This can be useful if you need to run a bunch of <code>import</code>
+     * statements, or configure some state.
+     */
+    public Params setStartupCommands(String[] commands) {
+        mStartupCommands = commands;
+        return this;
+    }
+
+    /**
+     * Get the startup commands which will be executed on the interpreter before each telnet client
+     * is given control.
+     */
+    public String[] getStartupCommands() {
+        return mStartupCommands;
+    }
+
     @Override
     public int describeContents() {
         return hashCode();
@@ -31,13 +57,20 @@ public int describeContents() {
     @Override
     public void writeToParcel(Parcel dest, int flags) {
         dest.writeInt(mPort);
+        dest.writeInt(mStartupCommands.length);
+        dest.writeStringArray(mStartupCommands);
     }
 
     public static final Creator<Params> CREATOR = new Creator<Params>() {
         @Override
         public Params createFromParcel(Parcel source) {
             Params p = new Params();
             p.setPort(source.readInt());
+
+            int startupCommandsLength = source.readInt();
+            String[] startupCommands = new String[startupCommandsLength];
+            source.readStringArray(startupCommands);
+            p.setStartupCommands(startupCommands);
             return p;
         }
 

library/src/main/java/jwf/debugport/internal/ClientConnection.java

@@ -19,12 +19,14 @@ class ClientConnection implements Runnable, Commands.ExitListener {
     private final Socket mClient;
     private final WeakReference<TelnetServer> mParent;
     private final Application mApp;
+    private final String[] mStartupCommands;
     private TelnetConsoleInterface mConsole;
 
-    public ClientConnection(Context context, Socket client, TelnetServer parent) {
+    public ClientConnection(Context context, Socket client, TelnetServer parent, String[] startupCommands) {
         mApp = (Application) context.getApplicationContext();
         mClient = client;
         mParent = new WeakReference<>(parent);
+        mStartupCommands = startupCommands;
     }
 
     public void close() {
@@ -49,6 +51,11 @@ public void run() {
             interpreter.set("cmd", new Commands(this));
             interpreter.set("app", mApp);
             interpreter.eval("importCommands(\"jwf.debugport.commands\")");
+
+            for (String startupCommand : mStartupCommands) {
+                interpreter.eval(startupCommand);
+            }
+
             interpreter.setExitOnEOF(false);
             interpreter.run();
         } catch (Exception e) {

library/src/main/java/jwf/debugport/internal/TelnetServer.java

@@ -85,7 +85,7 @@ public void run() {
             }
 
             synchronized (mLock) {
-                clientConn = new ClientConnection(mApp, client, this);
+                clientConn = new ClientConnection(mApp, client, this, mParams.getStartupCommands());
                 mClients.add(clientConn);
             }
             new Thread(clientConn).start();