Skip to content

Instantly share code, notes, and snippets.

@cvasilak
Created October 30, 2014 09:51
Show Gist options
  • Save cvasilak/b55f515be0b1d40aba01 to your computer and use it in GitHub Desktop.
Save cvasilak/b55f515be0b1d40aba01 to your computer and use it in GitHub Desktop.
diff --git a/article.txt b/article.txt
index 5ce0226..23ce3b2 100644
--- a/article.txt
+++ b/article.txt
@@ -1,8 +1,12 @@
-Creating an App for managing WildFly application server
+Managing a WildFly/EAP application server on the road!
-In this tutorial we will show how to create an app that allows you to remotely administer a JBoss 7, WildFly or JBoss EAP using the server's exposed http management interface.
+Already WildFly(http://www.wildfly.org] and EAP(http://www.jboss.org/products/eap/overview/) come equipped with a powerful web-based administration console to manage most of the inner-workings of the application server. Ease of administration and usage of the application server is one of it's strategic themes (apart from its blazing fast speed!) with constant improvements (http://hbraun.info/2014/10/updated-management-console-in-wildfly-8-2/).
-The app, named JBoss Admin App, has been written by Christos Vasilakis and it is fully available on Git Hub at https://github.com/cvasilak/JBoss-Admin-Android and as well on Google Play Store.
+In this tutorial we will show you another tool that can be used to quickly perform administration tasks when you happen to be on the road. If you are using an Android powered smart-phone, you would be happy to know that an app is available on the Google Play Store that can help on the administration. Although not all the feature-set supported by the web console is provided, still the careful chosen subset of it can help when you want to take a quick glance on your server's health, manage your deployments or tune a setting in the server's exposed management tree.
+
+The app is named JBoss Admin and it's available for immediate download from the Google Play Store(http://tinyurl.com/jboss-admin-android) free or charge.
+
+(Note: If your platform of choice is iOS then you would be happy to know that JBoss Admin is also available on the Apple Store(http://tinyurl.com/jboss-admin-ios) too!)
Application Features
@@ -14,13 +18,13 @@ Deployments Management: You can upload an artifact (installed on your phone) and
Browse the management tree: The whole management tree is exposed for you to configure, similar to the JBoss-cli {-gui} tool provided by the server. You can easily modify attributes and execute operations. Documentation of attributes and operation parameters is easily accessed for you to refer.
-Note that both operating modes (Standalone/Domain) of the server are supported
+Note that both operating modes (Standalone/Domain) of the server are supported.
Application architecture
-The application utilizes the HTTP management interface exposed by the server (the same mechanism utilized by the server's administration console) to execute management operations. Let's have a brief look on the code to see how it works.
+The application utilizes the HTTP management interface exposed by the server (the same mechanism utilized by the web console) to execute management operations. Let's have a brief look on the code to see how it works.
-In order to allow reuse (in a possible different application), the management operations that the Android UI classes invoke, are encapsulated in the JBossOperationsManager class. There you can find different methods, each responsible for a different management operation. Here is an example that executes a simple operation to fetch the management version supported by the server:
+In order to allow reuse (in a possible different application), the management operations that the Android UI classes invoke, are encapsulated in the JBossOperationsManager(https://github.com/cvasilak/JBoss-Admin-Android/blob/master/src/org/cvasilak/jboss/mobile/app/net/JBossOperationsManager.java) class. There you can find different methods, each responsible for a different management operation. Here is an example that executes a simple operation(https://docs.jboss.org/author/display/WFLY8/Admin+Guide#AdminGuide-SimpleOperations) to fetch the management version supported by the server:
@@ -38,9 +42,9 @@ public void fetchJBossManagementVersion(final Callback callback) {
}
-Inside the method we build a parameters map [1] with the command we want to execute ('read-attribute') plus any parameters that the command expects. Once that is done, we simple pass it to a TalkToJBossServerTask class [2], a subclass of Android's provided AsyncTask, to execute the actual request. The class will encode the parameters to JSON representation that the server expects, and perform the actual HTTP request. Notice on the construction of the task, we pass the user's provided Callback class to be called once the task completes (either with success or failure).
+Inside the method we build a parameters map [1] with the command we want to execute ('read-attribute') plus any parameters that the command expects. Once that is done, we simple pass it to a TalkToJBossServerTask(https://github.com/cvasilak/JBoss-Admin-Android/blob/master/src/org/cvasilak/jboss/mobile/app/net/TalkToJBossServerTask.java) class [2], a subclass of Android's provided AsyncTask(http://developer.android.com/reference/android/os/AsyncTask.html), to execute the actual request. The class will encode the parameters to JSON representation that the server expects, and perform the actual HTTP request. Notice on the construction of the task, we pass the user's provided Callback(https://github.com/cvasilak/JBoss-Admin-Android/blob/master/src/org/cvasilak/jboss/mobile/app/net/Callback.java) class to be called once the task completes (either with success or failure).
-Composite operations (an operation that can contain multiple operations) are also supported by just combining the parameters during build. Here is an example that invokes a composite operation to fetch VM metrics residing in deferent management resources on the server's management tree:
+Composite operations(https://docs.jboss.org/author/display/WFLY8/Admin+Guide#AdminGuide-CompositeOperations) (an operation that can contain multiple operations) are also supported by just combining the parameters during build. Here is an example that invokes a composite operation to fetch VM metrics residing in deferent management resources on the server's management tree:
public void fetchJVMMetrics(final Callback callback) {
@@ -82,7 +86,6 @@ public void fetchJVMMetrics(final Callback callback) {
The example is similar to the simple operation shown earlier, but in [1] we combine the parameters in one simple composite ParametersMap, which is then passed to a TalkToJBossServerTask to execute.
-That completes our brief overview of the Android code. Feel free to clone the project from github and play around!
+That completes our brief overview of the Android code. Both Android(https://github.com/cvasilak/JBoss-Admin-Android) and iOS(https://github.com/cvasilak/JBoss-Admin) versions of the apps are available as OSS, so feel free to clone the projects from GitHub, play around and provide feedback to the developer[https://twitter.com/cvasilak].
- Advertisement
-embed video plugin powered by Union Development
\ No newline at end of file
+<iframe src="//player.vimeo.com/video/110015199" width="700" height="394" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen></iframe>
\ No newline at end of file
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment