Home modified by Chris DeGreef

Chris DeGreef — Thu, 05 Dec 2013 16:15:47 -0000

--- v1
+++ v2
@@ -1,8 +1,82 @@
-Welcome to your wiki!
+ExCon, short for External Control, allows you to send commands from the command-line to your running application.  ExCon is a small Java class (a runnable Jar file, "sender") that you run whenever you need to send a command to your application.  Your application needs to include the ExCon "receiver".  The receiver accepts the commands from the ExCon sender and processes them.  Since the receiver runs within you application it can access all of your application's classes and resources.

-This is the default page, edit it as you see fit. To add a new page simply reference it within brackets, e.g.: [SamplePage].
+ExCon doesn't know anything specific about your application unless you tell it.  You do this by creating "command" classes that perform a specific function that you want to expose to the ExCon command-line sender.  You then register each of these command classes with the ExCon receiver.  Registering allows you to give the command a name (for the ExCon sender menu).

-The wiki uses [Markdown](/p/excon/wiki/markdown_syntax/) syntax.
+One of the frequent commands you might ask ExCon sender to do is "help".  This returns a list of the commands that you previously registered with the ExCon receiver.
+
+~~~~~
+> xc help
+
+=========================================================
+Help Table of Contents  (case does not matter)
+=========================================================
+Dump                - Stack trace
+Echo                - Echo to log
+GC                  - Garbage Collection
+Kill                - Application Shutdown
+=========================================================
+~~~~~
+
+The listed commands are some of the provided, standard, commands in ExCon.  You can also ask for help on any one of the commands.
+
+~~~~~
+> xc help dump
+
+=========================================================
+Help for "dump"
+=========================================================
+Dump
+
+  [-m --matches]
+
+    Java Patterns anded together that compare to the Thread header only.
+    none or at least 1
+    isCaseSensitive
+
+  [-v --invertMatches]
+
+    Inverts the selection based on -m.  Only valid with -m
+=========================================================
+~~~~~
+
+And ultimately, you would actually execute the "dump" command by leaving the word "help" off the command-line.  In this case we are asking for only the threads that have "system" in the name.
+
+~~~~~
+> xc dump --matches system
+
+2 system:Reference Handler WAITING
+        java.lang.Object.wait(Native Method)
+        java.lang.Object.wait(Object.java:502)
+        java.lang.ref.Reference$ReferenceHandler.run(Reference.java:133)
+4 system:Signal Dispatcher RUNNABLE
+3 system:Finalizer WAITING
+        java.lang.Object.wait(Native Method)
+        java.lang.ref.ReferenceQueue.remove(ReferenceQueue.java:133)
+        java.lang.ref.ReferenceQueue.remove(ReferenceQueue.java:149)
+        java.lang.ref.Finalizer$FinalizerThread.run(Finalizer.java:177)
+67 system:Java2D Disposer WAITING
+        java.lang.Object.wait(Native Method)
+        java.lang.ref.ReferenceQueue.remove(ReferenceQueue.java:133)
+        java.lang.ref.ReferenceQueue.remove(ReferenceQueue.java:149)
+        sun.java2d.Disposer.run(Disposer.java:143)
+        java.lang.Thread.run(Thread.java:636)
+142 system:Keep-Alive-Timer TIMED_WAITING
+        java.lang.Thread.sleep(Native Method)
+        sun.net.www.http.KeepAliveCache.run(KeepAliveCache.java:168)
+        java.lang.Thread.run(Thread.java:636)
+~~~~~
+
+The results of the "dump" command will vary according to your own application.
+
+If you have this question "But why do I need this?"  There are [other ways to communication] with my application.
+
+[Convenience script] for running ExCon - xc.
+[Requirements for adding ExCon Receiver] to your application.
+[Writing an ExCon command] for your application.
+[Registering your Commands in Java] in your Application.
+[Registering your Commands via Spring].
+
+

 [[members limit=20]]
 [[download_button]]

Home modified by Chris DeGreef

Chris DeGreef — Thu, 05 Dec 2013 16:00:56 -0000

Welcome to your wiki!

This is the default page, edit it as you see fit. To add a new page simply reference it within brackets, e.g.: [SamplePage].

The wiki uses Markdown syntax.

Project Members:

Chris DeGreef (admin)

Recent changes to Home

Home modified by Chris DeGreef

Home modified by Chris DeGreef

Project Members: