[JBTM-2238] Browser for examining Transaction Log MBeans

pom.xml

@@ -124,6 +124,7 @@
     <url>https://github.com/jbosstm/quickstart</url>
   </scm>
   <modules>
+    <module>tooling/browser</module>
     <module>jca-and-tomcat</module>
     <module>jca-and-hibernate</module>
     <module>jta-and-hibernate</module>

tooling/browser/pom.xml

@@ -0,0 +1,64 @@
+<?xml version="1.0"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <groupId>org.jboss.narayana.quickstart.tooling</groupId>
+    <version>5.0.3.Final-SNAPSHOT</version>
+
+    <description>
+        Examples showing how to use Narayana tooling
+    </description>
+    <modelVersion>4.0.0</modelVersion>
+    <artifactId>tooling</artifactId>
+    <packaging>jar</packaging>
+    <name>Narayana Tooling</name>
+
+    <properties>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <jmh.version>0.9.3</jmh.version>
+        <version.org.jboss.narayana>5.0.3.Final-SNAPSHOT</version.org.jboss.narayana>
+        <version.org.jboss.logging.jboss-logging>3.1.3.GA</version.org.jboss.logging.jboss-logging>
+        <version.org.jboss.logging.jboss-logging-processor>1.1.0.Final</version.org.jboss.logging.jboss-logging-processor>
+        <version.org.jboss.spec.javax.transaction>1.0.0.Final</version.org.jboss.spec.javax.transaction>
+        <version.org.jboss.jboss-transaction-spi>7.1.0.Final</version.org.jboss.jboss-transaction-spi>
+        <version.junit>4.11</version.junit>
+        <version.exec.plugin>1.2.1</version.exec.plugin>
+    </properties>
+    <dependencies>
+        <dependency>
+            <groupId>org.jboss.narayana.jta</groupId>
+            <artifactId>narayana-jta</artifactId>
+            <version>${version.org.jboss.narayana}</version>
+            <exclusions>
+                <exclusion>
+                    <groupId>org.jboss.logmanager</groupId>
+                    <artifactId>jboss-logmanager</artifactId>
+                </exclusion>
+            </exclusions>
+        </dependency>
+
+        <!-- For logging -->
+        <dependency>
+            <groupId>org.jboss.logging</groupId>
+            <artifactId>jboss-logging</artifactId>
+            <version>3.1.0.GA</version>
+        </dependency>
+
+        <dependency>
+            <groupId>org.jboss.spec.javax.transaction</groupId>
+            <artifactId>jboss-transaction-api_1.2_spec</artifactId>
+            <version>${version.org.jboss.spec.javax.transaction}</version>
+        </dependency>
+
+        <dependency>
+            <groupId>org.jboss</groupId>
+            <artifactId>jboss-transaction-spi</artifactId>
+            <version>${version.org.jboss.jboss-transaction-spi}</version>
+            <exclusions>
+                <exclusion>
+                    <groupId>org.jboss.logging</groupId>
+                    <artifactId>jboss-logging-spi</artifactId>
+                </exclusion>
+            </exclusions>
+        </dependency>
+
+    </dependencies>
+</project>

tooling/browser/readme.txt

@@ -0,0 +1,47 @@
+/*
+ * JBoss, Home of Professional Open Source.
+ * Copyright 2014, Red Hat, Inc., and individual contributors
+ * as indicated by the @author tags. See the copyright.txt file in the
+ * distribution for a full listing of individual contributors.
+ *
+ * This is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation; either version 2.1 of
+ * the License, or (at your option) any later version.
+ *
+ * This software is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this software; if not, write to the Free
+ * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+ * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
+ */
+
+OVERVIEW
+--------
+
+Interactive browser for examining transaction log MBeans
+
+USAGE
+-----
+mvn -e compile exec:java -Dexec.mainClass=org.jboss.narayana.jta.quickstarts.BrowserCommand -Dexec.args="path to tx-object-store"
+
+EXPECTED OUTPUT
+---------------
+help - show command options and syntax
+quit - exit the browser
+store_dir - get/set the location of the object store
+probe - refresh the view of the object store
+exception_trace - true | false - show full exception traces
+types - list record types
+select - <type> - start browsing a particular transaction type
+ls - [type] - list transactions of type type. Use the select command to set the default type
+> 
+
+WHAT JUST HAPPENED?
+-------------------
+The quickstart shows how to browse transaction record MBeans. Starting the example presents a list of
+possible commands and instructions on how to proceed. Type help and press return for help on all commands.