Compare commits

..

58 Commits

Author SHA1 Message Date
Brian Rosenberger 6d85158246 Allow logging via SLF4J and logback-classic. Fixes #5 2023-09-28 10:49:47 +02:00
Brian Rosenberger b2cd9fbda7 Initial release of lock/ unlock operation in MiscService 2023-09-28 09:09:36 +02:00
Brian Rosenberger 485dae7bb1 Bump version 2.0.2-SNAPSHOT 2023-09-28 09:08:47 +02:00
Brian Rosenberger 4c3a1c575c Bump version 2.0.1-SNAPSHOT 2023-09-27 11:49:48 +02:00
Brian Rosenberger 4777c132d4 Allow init_delay and configurable alf_event filters. This closes #4 and closes #2 2023-09-27 11:42:38 +02:00
Brian Rosenberger 39855ae8ba Synchronising MERGE INTO alf event inbound queue. This fixes #1 2023-09-26 15:07:42 +02:00
Brian Rosenberger adcefa1bba First version 2.0.0 release.
git-svn-id: https://brutex.net/svn/xservices/trunk@203 e7e49efb-446e-492e-b9ec-fcafc1997a86
2023-09-26 08:43:16 +00:00
Brian Rosenberger d37d23b253 New Gerenation against ALFEventManagerDocLit.xsd instead of ALFEventManagerSOAP.xsd
git-svn-id: https://brutex.net/svn/xservices/trunk@202 e7e49efb-446e-492e-b9ec-fcafc1997a86
2023-09-22 11:40:57 +00:00
Brian Rosenberger 076e78afe2 Initial version 2.0.0-SNAPHSOT, now includes preview of event manager service and lock service (both within MiscServices
git-svn-id: https://brutex.net/svn/xservices/trunk@201 e7e49efb-446e-492e-b9ec-fcafc1997a86
2023-09-21 13:02:06 +00:00
Brian Rosenberger 5cc829df49 Remove log4j/ log4j2 config files.
git-svn-id: https://brutex.net/svn/xservices/trunk@200 e7e49efb-446e-492e-b9ec-fcafc1997a86
2023-09-19 12:51:25 +00:00
Brian Rosenberger f7c18a86fe Use SLF4J instead of log4j/ log4j2. Introduce lombok.
git-svn-id: https://brutex.net/svn/xservices/trunk@199 e7e49efb-446e-492e-b9ec-fcafc1997a86
2023-09-19 12:50:19 +00:00
Brian Rosenberger 3395c35ad0 Update build system to use gradle and update dependency versions. Compatible up to Tomcat 9.x
git-svn-id: https://brutex.net/svn/xservices/trunk@198 e7e49efb-446e-492e-b9ec-fcafc1997a86
2023-09-13 14:27:58 +00:00
Brian Rosenberger 9d95f5194a Update Log4j2 dependency to 2.17.1 to resolve log4jshell vulnerability
git-svn-id: https://brutex.net/svn/xservices/trunk@197 e7e49efb-446e-492e-b9ec-fcafc1997a86
2022-01-14 14:35:55 +00:00
Brian Rosenberger 7ee16eb26c Klaus Scherbach: Add handleStringList web service operation
git-svn-id: https://brutex.net/svn/xservices/trunk@195 e7e49efb-446e-492e-b9ec-fcafc1997a86
2019-02-11 17:02:11 +00:00
Brian Rosenberger 4895c0b265 Fix missing jar for MiscServices:Sleep function
git-svn-id: https://brutex.net/svn/xservices/trunk@194 e7e49efb-446e-492e-b9ec-fcafc1997a86
2019-01-21 14:51:38 +00:00
Brian Rosenberger a8e5987e75 Fix new version of commons-configurations usage
git-svn-id: https://brutex.net/svn/xservices/trunk@193 e7e49efb-446e-492e-b9ec-fcafc1997a86
2018-08-22 09:11:19 +00:00
Brian Rosenberger f0c1dce235 Moving OA Soap Wrapper into current trunk version
git-svn-id: https://brutex.net/svn/xservices/trunk@192 e7e49efb-446e-492e-b9ec-fcafc1997a86
2018-08-22 09:08:28 +00:00
Brian Rosenberger d24bd44218 Fix new version of commons-configurations usage
git-svn-id: https://brutex.net/svn/xservices/trunk@191 e7e49efb-446e-492e-b9ec-fcafc1997a86
2018-08-22 08:52:06 +00:00
Brian Rosenberger 9a0d90a4b4 Moving OA Soap Wrapper into current trunk version
git-svn-id: https://brutex.net/svn/xservices/trunk@190 e7e49efb-446e-492e-b9ec-fcafc1997a86
2018-08-22 08:44:57 +00:00
Brian Rosenberger a59bd05fde Moving OA Soap Wrapper into current trunk version
git-svn-id: https://brutex.net/svn/xservices/trunk@189 e7e49efb-446e-492e-b9ec-fcafc1997a86
2018-08-22 07:39:06 +00:00
Brian Rosenberger 5aba84c316 Moving OA Soap Wrapper into current trunk version
git-svn-id: https://brutex.net/svn/xservices/trunk@188 e7e49efb-446e-492e-b9ec-fcafc1997a86
2018-08-22 07:36:37 +00:00
Brian Rosenberger 1acb30d0ed Moving OA Soap Wrapper into current trunk version
git-svn-id: https://brutex.net/svn/xservices/trunk@187 e7e49efb-446e-492e-b9ec-fcafc1997a86
2018-08-22 07:36:16 +00:00
Brian Rosenberger 8db4a1a60a Updated JCS from 1.3 to version 2.2
git-svn-id: https://brutex.net/svn/xservices/trunk@186 e7e49efb-446e-492e-b9ec-fcafc1997a86
2018-08-21 07:33:23 +00:00
Brian Rosenberger a4446afac0 Updating underlying libraries to current, major versions. Also updating source level to Java 8 and runtime to Tomcat 8.5. See ivy.xml for details.
git-svn-id: https://brutex.net/svn/xservices/trunk@185 e7e49efb-446e-492e-b9ec-fcafc1997a86
2018-05-03 05:24:04 +00:00
Brian Rosenberger bba63ca750 Properly shut down worker threads to avoid leak
git-svn-id: https://brutex.net/svn/xservices/trunk@184 e7e49efb-446e-492e-b9ec-fcafc1997a86
2016-06-01 05:50:19 +00:00
Brian Rosenberger 98f2419840 Update Mail WS to include underlying ant-mail library
git-svn-id: https://brutex.net/svn/xservices/trunk@183 e7e49efb-446e-492e-b9ec-fcafc1997a86
2016-05-31 14:25:26 +00:00
Brian Rosenberger fcd20c27a7 Update Mail WS to include underlying ant-mail library
git-svn-id: https://brutex.net/svn/xservices/trunk@182 e7e49efb-446e-492e-b9ec-fcafc1997a86
2016-05-31 13:49:11 +00:00
Brian Rosenberger dbe899c014 Updated Ant with minor adjustments
git-svn-id: https://brutex.net/svn/xservices/trunk@181 e7e49efb-446e-492e-b9ec-fcafc1997a86
2015-09-04 08:40:50 +00:00
Brian Rosenberger 99e1f74305 git-svn-id: https://brutex.net/svn/xservices/trunk@178 e7e49efb-446e-492e-b9ec-fcafc1997a86 2015-08-24 08:14:11 +00:00
Brian Rosenberger a53a18d184 Various improvements
git-svn-id: https://brutex.net/svn/xservices/trunk@177 e7e49efb-446e-492e-b9ec-fcafc1997a86
2015-08-24 07:58:52 +00:00
Brian Rosenberger 5d423270c1 Added Serena Dimensions CM RESTful web service to list items from a project
Example properties file to store a technical user

git-svn-id: https://brutex.net/svn/xservices/trunk@176 e7e49efb-446e-492e-b9ec-fcafc1997a86
2015-08-24 07:58:08 +00:00
Brian Rosenberger c28693e484 Added Serena Dimensions CM RESTful web service to list items from a project
git-svn-id: https://brutex.net/svn/xservices/trunk@175 e7e49efb-446e-492e-b9ec-fcafc1997a86
2015-08-24 07:57:03 +00:00
Brian Rosenberger 4437faac94 Added Serena Dimensions CM API to Ivy Library Management
git-svn-id: https://brutex.net/svn/xservices/trunk@174 e7e49efb-446e-492e-b9ec-fcafc1997a86
2015-08-24 07:47:25 +00:00
Brian Rosenberger 992d8a1ea8 Added Apache FOP for PDF creation
git-svn-id: https://brutex.net/svn/xservices/trunk@173 e7e49efb-446e-492e-b9ec-fcafc1997a86
2015-08-24 07:45:25 +00:00
Brian Rosenberger cbc83ad1f9 Updated documentation
git-svn-id: https://brutex.net/svn/xservices/trunk@166 e7e49efb-446e-492e-b9ec-fcafc1997a86
2014-08-21 07:00:57 +00:00
Brian Rosenberger 0ff1a38a14 Minor documentation updates
git-svn-id: https://brutex.net/svn/xservices/trunk@165 e7e49efb-446e-492e-b9ec-fcafc1997a86
2014-07-30 09:16:37 +00:00
Brian Rosenberger f9ec72739c Updated SoapUI test
git-svn-id: https://brutex.net/svn/xservices/trunk@164 e7e49efb-446e-492e-b9ec-fcafc1997a86
2014-07-30 09:11:34 +00:00
Brian Rosenberger eb7a20b60b Enhanced ExecuteService:runCommand documentation with sample requests
git-svn-id: https://brutex.net/svn/xservices/trunk@163 e7e49efb-446e-492e-b9ec-fcafc1997a86
2014-06-17 06:27:39 +00:00
Brian Rosenberger 261810858b Changed to anonymous access for all services
git-svn-id: https://brutex.net/svn/xservices/trunk@162 e7e49efb-446e-492e-b9ec-fcafc1997a86
2014-06-17 06:26:16 +00:00
Brian Rosenberger 3032a6bf23 Updated XmlServices documentation
git-svn-id: https://brutex.net/svn/xservices/trunk@161 e7e49efb-446e-492e-b9ec-fcafc1997a86
2014-06-16 06:10:23 +00:00
Brian Rosenberger ce3aa9d3b4 Updated User Guide
git-svn-id: https://brutex.net/svn/xservices/trunk@160 e7e49efb-446e-492e-b9ec-fcafc1997a86
2014-06-15 10:21:47 +00:00
Brian Rosenberger 3e3498e50c git-svn-id: https://brutex.net/svn/xservices/trunk@159 e7e49efb-446e-492e-b9ec-fcafc1997a86 2014-06-15 09:43:44 +00:00
Brian Rosenberger 7e6b6bef40 Fixed bug: insertNodes inserted nodes in reverse order
git-svn-id: https://brutex.net/svn/xservices/trunk@158 e7e49efb-446e-492e-b9ec-fcafc1997a86
2014-06-15 09:24:33 +00:00
Brian Rosenberger bf6af8a056 Support for styled html output (CSS) added
git-svn-id: https://brutex.net/svn/xservices/trunk@157 e7e49efb-446e-492e-b9ec-fcafc1997a86
2014-06-15 07:50:25 +00:00
Brian Rosenberger e62784a0d5 Fix "includeDirectories/ includeFiles" parameter not working (APAC PoC)
git-svn-id: https://brutex.net/svn/xservices/trunk@156 e7e49efb-446e-492e-b9ec-fcafc1997a86
2014-05-20 10:18:19 +00:00
Brian Rosenberger ff9edbd2e2 Enhance FileService RESTful implementation
git-svn-id: https://brutex.net/svn/xservices/trunk@147 e7e49efb-446e-492e-b9ec-fcafc1997a86
2013-12-20 07:46:30 +00:00
Brian Rosenberger 5a445c63cf Introducing shiro security framework
git-svn-id: https://brutex.net/svn/xservices/trunk@146 e7e49efb-446e-492e-b9ec-fcafc1997a86
2013-12-20 07:45:47 +00:00
Brian Rosenberger 97520fae61 Update doc
git-svn-id: https://brutex.net/svn/xservices/trunk@145 e7e49efb-446e-492e-b9ec-fcafc1997a86
2013-12-20 07:44:45 +00:00
Brian Rosenberger c96909e192 Added a comment how to use the xsl.xinclude ant task
git-svn-id: https://brutex.net/svn/xservices/trunk@144 e7e49efb-446e-492e-b9ec-fcafc1997a86
2013-11-26 20:30:39 +00:00
Brian Rosenberger 3376f9e5db Added project dependency
git-svn-id: https://brutex.net/svn/xservices/trunk@143 e7e49efb-446e-492e-b9ec-fcafc1997a86
2013-11-26 20:08:22 +00:00
Brian Rosenberger d6889bc95b Update IVY dependency management to make use of ivy configurations
git-svn-id: https://brutex.net/svn/xservices/trunk@142 e7e49efb-446e-492e-b9ec-fcafc1997a86
2013-11-26 17:49:53 +00:00
Brian Rosenberger 4282c28f4e Add libraries from other projects as local
git-svn-id: https://brutex.net/svn/xservices/trunk@140 e7e49efb-446e-492e-b9ec-fcafc1997a86
2013-09-29 10:39:32 +00:00
Brian Rosenberger dc6ee97ea9 Add unimplemented methods to to updated Quartz version
git-svn-id: https://brutex.net/svn/xservices/trunk@139 e7e49efb-446e-492e-b9ec-fcafc1997a86
2013-09-29 10:37:40 +00:00
Brian Rosenberger dbb4982f86 Move to Apache Ivy for lib management
git-svn-id: https://brutex.net/svn/xservices/trunk@138 e7e49efb-446e-492e-b9ec-fcafc1997a86
2013-02-12 16:38:25 +00:00
Brian Rosenberger d054921dad Move to Apache Ivy for lib management
git-svn-id: https://brutex.net/svn/xservices/trunk@137 e7e49efb-446e-492e-b9ec-fcafc1997a86
2013-02-12 11:54:04 +00:00
Brian Rosenberger 47cf1af29b Delete JCA jsp
git-svn-id: https://brutex.net/svn/xservices/trunk@136 e7e49efb-446e-492e-b9ec-fcafc1997a86
2013-02-11 11:35:05 +00:00
Brian Rosenberger e974dce20b Delete auto-generated manifest
git-svn-id: https://brutex.net/svn/xservices/trunk@135 e7e49efb-446e-492e-b9ec-fcafc1997a86
2013-02-11 11:34:09 +00:00
Brian Rosenberger 0be38252ec Removed aegis binding
git-svn-id: https://brutex.net/svn/xservices/trunk@134 e7e49efb-446e-492e-b9ec-fcafc1997a86
2013-02-11 09:14:51 +00:00
291 changed files with 18079 additions and 2243 deletions

View File

@ -1,207 +0,0 @@
<html><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>User Guide</title><meta content="DocBook XSL-NS Stylesheets V1.76.1" name="generator"><meta name="description" content="Abstract In complex IT environments it is necessary to integrate different information systems with each other, exchange data between tools and automate actions and function calls depending on events arising from user interaction. To meet the requirements of integration building usually means to implement APIs and to create tool-to-tool bridges. Web Services can help to clean up bridges into interfaces as well as to abstract functions from their underlying platform and implementation. These are the major goals of the loosely coupled integration strategy which is in turn one essential idea of a service-oriented architecture (SOA). provide a low level set of functions and web services. These can be orchestrated into services and used in business processes which make up the execution part of a SOA environment. is an add-on to XBridgeNG 2.0. It runs standalone or in combination with XBridgeNG. Pure XBridgeNG has two components: XML Schema for item based data types (e.g. tickets from a bug tracker system or a database record) Set of Apache Ant tasks to function as a bridge between the XBridgeNG XML format at legacy 3rd party software (e.g. HP Quality Center, Serena TeamTrack, ...) The add Web Services (SOAP) wrapper around Apache Ant tasks (since XBridgeNG 2.0) The current focus is on file-based operations. do not contain an integration server or a process execution engine."></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="book" title="User Guide"><div class="titlepage"><div><div><h1 class="title"><a name="N2000B"></a>User Guide</h1></div><div><div class="author"><h3 class="author"><span class="firstname">Brian</span> <span class="surname">Rosenberger</span></h3><code class="email">&lt;<a class="email" href="mailto:bru@brutex.de">bru@brutex.de</a>&gt;</code></div></div><div><p class="copyright">Copyright &copy; 2010 </p></div><div><div class="legalnotice" title="Legal Notice"><a name="N2002F"></a>
<p>
The copyright holders make no representation about the
suitability of
this document for any purpose. It is provided
<span class="quote">&ldquo;<span class="quote">as is</span>&rdquo;</span>
without expressed or implied warranty.
</p>
</div></div><div><div class="legalnotice" title="Legal Notice"><a name="N20038"></a>
<p>Apache Tomcat and Apache Ant are trademarks of the Apache
Software Foundation.</p>
</div></div><div><p class="pubdate">1997</p></div><div><div class="abstract" title="Abstract"><p class="title"><b>Abstract</b></p>
<p>In complex IT environments it is necessary to integrate
different information systems with each other, exchange data
between
tools and automate actions and function calls depending
on events
arising from user interaction. To meet the requirements
of
integration building usually means to implement APIs and to
create
tool-to-tool bridges. Web Services can help to clean up
bridges into
interfaces as well as to abstract functions from
their underlying
platform and implementation.</p>
<p>These are the major goals of the loosely coupled
integration
strategy which is in turn one essential idea of a
service-oriented
architecture (SOA).</p>
<p>provide a low level set of functions and web services.
These can
be orchestrated into services and used in business
processes which
make up the execution part of a SOA
environment.</p>
<p>is an add-on to XBridgeNG 2.0. It runs standalone or in
combination with XBridgeNG. Pure XBridgeNG has two
components:</p>
<p>
</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
<p>XML Schema for item based data types (e.g. tickets
from a bug
tracker system or a database record)</p>
</li><li class="listitem">
<p>Set of Apache Ant tasks to function as a bridge
between the
XBridgeNG XML format at legacy 3rd party
software (e.g. HP Quality
Center, Serena TeamTrack,
...)</p>
</li><li class="listitem">
<p>The add Web Services (SOAP) wrapper around Apache Ant
tasks
(since XBridgeNG 2.0)</p>
</li></ul></div><p>
</p>
<p>The current focus is on file-based operations. do not
contain an
integration server or a process execution
engine.</p>
</div></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="chapter"><a href="#N2006C">1. Getting started</a></span></dt><dd><dl><dt><span class="sect1"><a href="#N20076">Prerequisites</a></span></dt><dt><span class="sect1"><a href="#N20085">Installation</a></span></dt><dd><dl><dt><span class="sect2"><a href="#N20090">Securing with Basic Authentication</a></span></dt><dt><span class="sect2"><a href="#N2009F">Limit access to</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="#N200B8">2. Available Services</a></span></dt><dd><dl><dt><span class="section"><a href="#N200C2">ArchiveServices</a></span></dt><dt><span class="section"><a href="#N200CB"></a></span></dt><dd><dl><dt><span class="section"><a href="#N200CD">ExecuteServices</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="#N20139">3. XML Types</a></span></dt><dd><dl><dt><span class="section"><a href="#N20143">AntProperty type</a></span></dt></dl></dd></dl></div><div class="list-of-tables"><p><b>List of Tables</b></p><dl><dt>2.1. <a href="#N200E4">runCommand input parameters</a></dt></dl></div>
<div class="chapter" title="Chapter&nbsp;1.&nbsp;Getting started"><div class="titlepage"><div><div><h2 class="title"><a name="N2006C"></a>Chapter&nbsp;1.&nbsp;Getting started</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#N20076">Prerequisites</a></span></dt><dt><span class="sect1"><a href="#N20085">Installation</a></span></dt><dd><dl><dt><span class="sect2"><a href="#N20090">Securing with Basic Authentication</a></span></dt><dt><span class="sect2"><a href="#N2009F">Limit access to</a></span></dt></dl></dd></dl></div>
<p>This chapter describes the installation.</p>
<div class="sect1" title="Prerequisites"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="N20076"></a>Prerequisites</h2></div></div></div>
<p>tbd.</p>
<p>Sun Java SE 1.6.0</p>
<p>Apache Tomcat 6</p>
</div>
<div class="sect1" title="Installation"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="N20085"></a>Installation</h2></div></div></div>
<p>tbd.</p>
<p>In short: Deploy .WAR file to Apache Tomcat</p>
<div class="sect2" title="Securing with Basic Authentication"><div class="titlepage"><div><div><h3 class="title"><a name="N20090"></a>Securing with Basic Authentication</h3></div></div></div>
<p>There is a quick guide explaining Basic Authentication
for
Tomcat here:</p>
<p>
<a class="ulink" href="http://oreilly.com/pub/a/java/archive/tomcat-tips.html?page=1" target="_top">http://oreilly.com/pub/a/java/archive/tomcat-tips.html?page=1</a>
</p>
</div>
<div class="sect2" title="Limit access to"><div class="titlepage"><div><div><h3 class="title"><a name="N2009F"></a>Limit access to</h3></div></div></div>
<p>Sometimes you'll only want to restrict access to to
only
specified host names or IP addresses. This way, only
clients at
those specified addresses can use the web services.
Tomcat provides
two configuration values for that:
RemoteHostValve and
RemoteAddrValve.</p>
<p>These Valves allow you to filter requests by host name or
by IP
address, and to allow or deny hosts that match. The
example below
restricts access to the ArchiveService from any
machine that is not
the local host.</p>
<pre class="programlisting">&lt;Context
path="/XService/ArchiveService" ...&gt; &lt;Valve
className="org.apache.catalina.valves.RemoteAddrValve"
allow="127.0.0.1" deny=""/&gt; &lt;/Context&gt;</pre>
<p>If no allow pattern is given, then patterns that match
the deny
attribute patterns will be rejected, and all others
will be allowed.
Similarly, if no deny pattern is given,
patterns that match the
allow attribute will be allowed, and
all others will be denied.
</p>
<p>The &lt;context&gt; element must be placed into the
server.xml
file (into &lt;engine&gt;&lt;host&gt;).</p>
</div>
</div>
</div>
<div class="chapter" title="Chapter&nbsp;2.&nbsp;Available Services"><div class="titlepage"><div><div><h2 class="title"><a name="N200B8"></a>Chapter&nbsp;2.&nbsp;Available Services</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#N200C2">ArchiveServices</a></span></dt><dt><span class="section"><a href="#N200CB"></a></span></dt><dd><dl><dt><span class="section"><a href="#N200CD">ExecuteServices</a></span></dt></dl></dd></dl></div>
<p>List of available web services and their operations.</p>
<div class="section" title="ArchiveServices"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="N200C2"></a>ArchiveServices</h2></div></div></div>
<p>The ArchiveService bundles file packing operations. Its
WSDL is
located at
http://server:port/XServices/ArchiveService?wsdl</p>
</div>
<div class="section"><div class="titlepage"></div>
<div class="section" title="ExecuteServices"><div class="titlepage"><div><div><h3 class="title"><a name="N200CD"></a>ExecuteServices</h3></div></div></div>
<p>The ExecuteService bundles local and remote command
execution
operations. Its WSDL is located at
http://server:port/XServices/ExecuteService?wsdl</p>
<div class="section" title="runCommand"><div class="titlepage"><div><div><h4 class="title"><a name="N200D6"></a>runCommand</h4></div></div></div>
<p>Run an executable with arguments on the server providing
the
web
service. The command is run within the environment and
under the
user
privileges of the user who is running the Tomcat
Server.</p>
<div class="section"><div class="titlepage"><div><div><h5 class="title"><a name="N200DE"></a></h5></div></div></div>
<p></p>
<div class="table"><a name="N200E4"></a><p class="title"><b>Table&nbsp;2.1.&nbsp;runCommand input parameters</b></p><div class="table-contents">
<table summary="runCommand input parameters" border="1"><colgroup><col class="parameter"><col class="type"><col class="required"><col class="description"></colgroup><thead><tr><th>parameter</th><th>type</th><th>required</th><th>description</th></tr></thead><tbody><tr><td>executable</td><td>String</td><td>Yes</td><td>Command to be run. The command may be
specified with full
path using forward slash
"/" as path separator.
</td></tr><tr><td>argline</td><td>String</td><td>No</td><td>Any command line arguments</td></tr></tbody></table>
</div></div><br class="table-break">
<p></p>
</div>
</div>
</div>
</div>
</div>
<div class="chapter" title="Chapter&nbsp;3.&nbsp;XML Types"><div class="titlepage"><div><div><h2 class="title"><a name="N20139"></a>Chapter&nbsp;3.&nbsp;XML Types</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#N20143">AntProperty type</a></span></dt></dl></div>
<p>This chapter bundles the documentation for common xml types
used
by XServices web service.</p>
<div class="section" title="AntProperty type"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="N20143"></a>AntProperty type</h2></div></div></div>
<p>The AntProperty type defines a list of key/value pairs.</p>
<p>
The defining Java class is
<a class="ulink" href="javadoc/net/brutex/xservices/types/AntProperty.html" target="_top">
<code class="classname">net.brutex.xservices.types.AntProperty</code>
</a>
.
</p>
<pre class="programlisting">
&lt;xs:complexType name="antProperty"&gt;
&lt;xs:sequence&gt;
&lt;xs:element name="name" type="xs:string"/&gt;
&lt;xs:element name="value" type="xs:string"/&gt;
&lt;/xs:sequence&gt;
&lt;/xs:complexType&gt;
</pre>
<pre class="programlisting">
&lt;AntProperty&gt;
&lt;name&gt;key2&lt;/name&gt;
&lt;value&gt;value2&lt;/value&gt;
&lt;/AntProperty&gt;
</pre>
</div>
</div>
</div></body></html>

132
build.gradle Normal file
View File

@ -0,0 +1,132 @@
apply plugin: 'war'
apply plugin: "maven-publish"
apply plugin: "signing"
repositories {
mavenCentral()
}
java {
toolchain {
languageVersion = JavaLanguageVersion.of(8)
}
}
project.version "2.0.2-SNAPSHOT"
group "net.brutex.xservices"
publishing {
publications {
maven(MavenPublication) {
from components.java
}
}
repositories {
maven {
name = 'LocalRemote'
def releasesRepoUrl = 'https://archiva.brutex.net/repository/internal/'
def snapshotsRepoUrl = 'https://archiva.brutex.net/repository/snapshots/'
url = project.version.endsWith('SNAPSHOT') ? snapshotsRepoUrl : releasesRepoUrl
allowInsecureProtocol = false
credentials {
username = mavenuser
password = mavenpass
}
}
maven {
name = 'OSSRH'
def releasesRepoUrl = 'https://s01.oss.sonatype.org/service/local/staging/deploy/maven2/'
def snapshotsRepoUrl = 'https://s01.oss.sonatype.org/content/repositories/snapshots/'
url = project.version.endsWith('SNAPSHOT') ? snapshotsRepoUrl : releasesRepoUrl
credentials {
username = ossrhUsername
password = ossrhPassword
}
}
maven {
name = 'brutexGitea'
def releasesRepoUrl = 'https://source.brutex.net/api/packages/brutex/maven'
def snapshotsRepoUrl = 'https://source.brutex.net/api/packages/brutex/maven'
url = project.version.endsWith('SNAPSHOT') ? snapshotsRepoUrl : releasesRepoUrl
allowInsecureProtocol = false
credentials {
username = mavenuser
password = mavenpass
}
}
}
}
tasks.register('createDist', Zip) {Zip t ->
archiveBaseName = project.name
archiveVersion = version
archiveExtension = "zip"
destinationDirectory = new File(project.buildDir, "/distribution/")
from war.outputs.files
}
dependencies {
compileOnly "javax.servlet:javax.servlet-api:4.0.1"
compileOnly "javax.ws.rs:javax.ws.rs-api:2.1.1"
implementation "org.apache.commons:commons-configuration2:2.9.0"
implementation "org.apache.commons:commons-lang3:3.12.0"
implementation "commons-net:commons-net:3.9.0"
implementation "commons-beanutils:commons-beanutils:1.9.4"
implementation "org.apache.httpcomponents:httpclient:4.5.14"
implementation "org.apache.httpcomponents:fluent-hc:4.5.14"
implementation "commons-io:commons-io:2.11.0"
implementation "org.apache.ant:ant:1.10.13"
implementation "org.apache.ant:ant-nodeps:1.8.1"
implementation "org.apache.ant:ant-jsch:1.10.13"
implementation "org.apache.ant:ant-commons-net:1.10.13"
implementation "org.apache.ant:ant-javamail:1.10.13"
implementation "org.apache.ant:ant-launcher:1.10.13"
implementation "org.apache.commons:commons-jcs-core:2.2.1"
implementation "org.quartz-scheduler:quartz:2.3.2"
implementation "org.slf4j:slf4j-api:2.0.7"
runtimeOnly "ch.qos.logback:logback-core:1.3.8"
runtimeOnly "ch.qos.logback:logback-classic:1.3.8"
//runtimeOnly "org.slf4j:slf4j-simple:2.0.7"
implementation "org.apache.ws.commons.axiom:axiom:1.2.22"
implementation "org.apache.ws.commons.axiom:axiom-impl:1.2.22"
implementation "org.apache.shiro:shiro-core:1.12.0"
implementation "org.apache.shiro:shiro-root:1.12.0"
implementation "org.apache.shiro:shiro-web:1.12.0"
implementation "org.apache.cxf:cxf:3.4.10"
implementation "org.apache.cxf:cxf-rt-databinding-aegis:3.2.14"
runtimeOnly "org.apache.cxf:cxf-rt-transports-http:3.2.14"
runtimeOnly "org.apache.cxf:cxf-rt-frontend-jaxrs:3.2.14"
runtimeOnly "org.apache.cxf:cxf-rt-frontend-jaxws:3.2.14"
runtimeOnly "org.apache.cxf:cxf-rt-security:3.2.14"
implementation "rhino:js:1.7R2"
implementation "org.springframework:spring-core:5.3.29"
implementation "org.springframework:spring-context:5.3.29"
implementation "org.springframework:spring-web:5.3.29"
implementation "com.h2database:h2:2.2.222"
implementation "com.sun.xml.bind:jaxb-impl:2.3.0.1"
implementation "com.sun.xml.bind:jaxb-core:2.3.0.1"
implementation fileTree(dir: "lib/", includes: ["*.jar"], excludes: ["serena.*.jar"])
compileOnly fileTree(dir: "lib/", includes: ["serena.*.jar"])
annotationProcessor "org.projectlombok:lombok:1.18.28"
compileOnly "org.projectlombok:lombok:1.18.28"
}

190
build.xml
View File

@ -1,21 +1,60 @@
<?xml version="1.0"?>
<project default="create-doc" basedir=".">
<project default="create-doc" basedir="." xmlns:ivy="antlib:org.apache.ivy.ant">
<property name="toolsdir" location="C:/JAVA-DEV/" />
<!-- C:\JAVA-DEV\apache-fop-1.1 -->
<taskdef name="fop" classname="org.apache.fop.tools.anttasks.Fop">
<classpath>
<fileset dir="${toolsdir}/fop-2.2/fop">
<include name="build/*.jar" />
<include name="lib/*.jar" />
</fileset>
</classpath>
</taskdef>
<!-- External Syntax Higlighter for docbook xsl -->
<path id="xslthl.path">
<pathelement location="${toolsdir}/xslthl-2.1.3/xslthl-2.1.3.jar" />
</path>
<property name="current-loc" location="." />
<property name="workspace" location=".." />
<property name="htmldir" value="${current-loc}/doc/html" />
<property name="docbookdir" value="C:\JAVA-DEV\docbook-xsl-ns-1.76.1\html\" />
<property name="docbookdir" value="${toolsdir}/docbook-xsl-1.79.1/" />
<property name="fo.stylesheet" value="${docbookdir}/fo/docbook.xsl" />
<property name="fo.stylesheet.hl" value="${docbookdir}/fo/docbook.xsl" />
<property name="html.stylesheet.hl" value="${docbookdir}/html/docbook.xsl" />
<property name="html.chunked.stylesheet.hl" value="${docbookdir}/html/docbook.xsl" />
<property name="eclipse.stylesheet" value="${docbookdir}/eclipse/eclipse.xsl" />
<property name="html.stylesheet" value="${docbookdir}/html/docbook.xsl" />
<property name="javahelp.stylesheet" value="${docbookdir}/javahelp/javahelp.xsl" />
<property name="xhtml5.stylesheet" value="${docbookdir}/xhtml5/docbook.xsl" />
<property name="docbooksource" value="${current-loc}/doc" />
<property name="xalan" value="org.apache.xalan.processor.TransformerFactoryImpl" />
<property name="web.dir" value="${current-loc}/web" />
<property name="build.dir" value="${current-loc}/build/classes" />
<property name="bin.dir" value="${current-loc}/bin" />
<property name="delivery.dir" value="c:/TEMP/_DELIVERY_AREA" />
<property name="name" value="XServices" />
<!-- XSLT Chunking Properties -->
<property name="base.dir" value="${htmldir}" />
<target name="merge">
<xsl.xinclude in="${docbooksource}/BruteXServices_User_Guide.xml"
out="${docbooksource}/BruteXServices_User_Guide.dbk"
/>
<!-- XInclude support comes with Eclipse XML Tools Project,
the Ant target needs to be executed in the Eclispe Workspace JRE
in order to get found. Any custom project specific runtime
may not work.
-->
<xsl.xinclude in="${docbooksource}/BruteXServices_User_Guide.xml" out="${docbooksource}/BruteXServices_User_Guide.dbk" />
</target>
<target name="clean-doc">
@ -24,26 +63,141 @@
</target>
<target name="create-doc" depends="clean-doc, merge">
<xslt force="true" style="${docbookdir}/../toHTML.xsl"
in="${docbooksource}/BruteXServices_User_Guide.dbk"
out="${htmldir}/index.html">
<xslt force="true" style="${html.stylesheet.hl}" in="${docbooksource}/BruteXServices_User_Guide.dbk" out="${htmldir}/index.html">
<factory name="${xalan}" />
<classpath refid="xslthl.path" />
<param name="highlight.xslthl.config" expression="file:///${docbookdir}/highlighting/xslthl-config.xml" />
<param name="highlight.source" expression="1" />
<param name="html.stylesheet" expression="style.css" />
</xslt>
<copy file="${docbooksource}/style.css" overwrite="true" tofile="${htmldir}/style.css" />
</target>
<!--
- target: chunks-html
- description: Iterates through a directory and transforms
- .xml files into seperate .html files using the DocBook XSL.
-->
<target name="build-chunks" depends="clean-doc, merge" description="chunk HTML from DocBook XML">
<xslt style="${html.chunked.stylesheet.hl}" extension=".html" basedir="${docbooksource}" destdir="${htmldir}">
<factory name="${xalan}" />
<classpath refid="xslthl.path" />
<include name="**/*.dbk" />
<param name="base.dir" expression="${htmldir}/" />
<param name="use.id.as.filename" expression="1" />
<param name="html.stylesheet" expression="styles.css" />
<param name="section.autolabel" expression="1" />
<param name="html.cleanup" expression="1" />
<param name="chunk.first.selection" expression="1" />
<param name="navig.showtitles" expression="1" />
<param name="highlight.xslthl.config" expression="file:///${docbookdir}/highlighting/xslthl-config.xml" />
<param name="highlight.source" expression="1" />
</xslt>
<copy file="${docbooksource}/style.css" overwrite="true" tofile="${htmldir}/style.css" />
</target>
<target name="build-pdf" depends="merge" description="PDF from DocBook XML">
<!-- Convert DocBook Files into FO -->
<xslt style="${fo.stylesheet.hl}" extension=".fo" basedir="${docbooksource}" destdir="${htmldir}">
<include name="BruteXServices_User_Guide.dbk" />
<classpath refid="xslthl.path" />
<param name="fop1.extensions" expression="1" />
<param name="section.autolabel" expression="1" />
<param name="chapter.autolabel" expression="1" />
<param name="appendix.autolabel" expression="1" />
<param name="section.label.includes.component.label" expression="1" />
<param name="highlight.xslthl.config" expression="file:///${docbookdir}/highlighting/xslthl-config.xml" />
<param name="highlight.source" expression="1" />
<param name="paper.type" expression="A4" />
</xslt>
<!-- Convert FO Files into pdf -->
<fop format="application/pdf" outdir="${htmldir}">
<fileset dir="${htmldir}">
<include name="**/*.fo" />
</fileset>
</fop>
</target>
<target name="build-html5" depends="clean-doc, merge" description="Generates HTML5 files">
<xslt style="${xhtml5.stylesheet}" extension=".html" basedir="${docbooksource}" destdir="${htmldir}">
<include name="**/*.dbk" />
<param name="html.stylesheet" expression="style.css" />
<param name="docbook.css.source" expression="" />
<param name="section.autolabel" expression="1" />
<param name="make.clean.html" expression="1" />
</xslt>
</target>
<target name="create-webdoc" depends="clean-doc, merge">
<xslt force="true" style="${docbookdir}/../fo/docbook.xsl"
in="${docbooksource}/BruteXServices_User_Guide.dbk"
out="${htmldir}/xservices.fo">
<factory name="${xalan}" />
<param name="base.dir" expression="${htmldir}/"/>
<param name="use.id.as.filename" expression="1" />
<param name="fop.extensions" expression="0" />
<!--
- target: build-javahelp
- description: Iterates through a directory and transforms
- .xml files into .html files using the DocBook XSL.
-->
<target name="build-javahelp" depends="clean-doc, merge" description="JavaHelp from DocBook XML">
<xslt style="${javahelp.stylesheet}" extension=".html" basedir="${docbooksource}" destdir="${htmldir}">
<include name="**/*.dbk" />
<outputproperty name="indent" value="yes" />
</xslt>
</target>
<target name="build-eclipse" depends="clean-doc, merge" description="Eclipse help from DocBook XML">
<xslt style="${eclipse.stylesheet}" basedir="${docbooksource}" destdir="${htmldir}">
<include name="**/*.dbk" />
</xslt>
</target>
<!-- =================================
target: resolve
================================= -->
<target name="resolve" description="--> retrieve dependencies with ivy">
<ivy:retrieve />
</target>
<target name="build-war">
<ivy:retrieve pattern="c://TEMP/lib/default/[artifact]-[revision].[ext]" conf="master" />
<jar destfile="${bin.dir}/XServices.jar"
basedir="${build.dir}"
includes="net/**/*"/>
<war destfile="${delivery.dir}\\${name}.war" webxml="${web.dir}/WEB-INF/web.xml">
<fileset dir="${web.dir}/">
<include name="**/*.*" />
</fileset>
<lib dir="c://TEMP/lib/default">
<!--<exclude name="portlet.jar"/>-->
</lib>
<lib dir="${bin.dir}" />
<classes dir="${build.dir}">
<!--We already packed all classes into a jar,
so put only remaining config files into
classes
-->
<exclude name="net/**/*"/>
</classes>
</war>
<tstamp>
<format property="build.version" pattern="yyyyMMddhhmmss" />
</tstamp>
<mkdir dir="${delivery.dir}\\${name}\\${name}-${build.version}" />
<move file="${delivery.dir}\\${name}.war" toFile="${delivery.dir}\\${name}\\${name}-${build.version}\\${name}.war" />
<copy todir="${delivery.dir}\\${name}\\${name}-${build.version}\\html">
<fileset dir="${htmldir}">
</fileset>
</copy>
<echo>Distribution: ${delivery.dir}\\${name}\\${name}-${build.version} </echo>
</target>
<target name="hot-deploy" depends="build-war">
<copy file="${delivery.dir}\\${name}\\${name}-${build.version}\\${name}.war" toFile="C://JAVA-DEV//Tomcat//apache-tomcat-8.5.30 -localtest//webapps//XServices.war" />
</target>
</project>

View File

@ -1,8 +0,0 @@
<?xml version='1.0' encoding='utf-8'?>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude" id="archiveservices">
<title>ArchiveServices</title>
<para>The ArchiveService bundles file packing operations. Its
WSDL is located at
http://server:port/XServices/ArchiveService?wsdl</para>
</section>

View File

@ -0,0 +1,23 @@
<?xml version='1.0' encoding='utf-8'?>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude" id="archiveservices">
<title>ArchiveServices</title>
<para>The ArchiveService bundles file packing operations. Its
WSDL is located at
http://server:port/XServices/ArchiveService?wsdl</para>
<xi:include href="./bzip2.xml" />
<xi:include href="./bzip2FromArchive.xml" />
<xi:include href="./gzip.xml" />
<xi:include href="./gzipFromArchive.xml" />
<xi:include href="./gunzip.xml" />
<xi:include href="./bunzip2.xml" />
<xi:include href="./gunzipFromURL.xml" />
<xi:include href="./bunzip2FromURL.xml" />
<xi:include href="./zip.xml" />
<xi:include href="./zipFromArchive.xml" />
<xi:include href="./unzip.xml" />
<xi:include href="./unrar.xml" />
<xi:include href="./untar.xml" />
</section>

View File

@ -0,0 +1,20 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>bunzip2</title>
<para>Extract files from a bzip2 archive.
Sample request:
<screen><![CDATA[
...
]]></screen>
Sample response:
<programlisting language="xml"><![CDATA[
...
]]></programlisting>
</para>
<para></para>
</section>

View File

@ -0,0 +1,21 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>bunzip2FromURL</title>
<para>Extract files from a bzip2 archive. The archive is located on the web (http/ https)
and will be downloaded automatically.
Sample request:
<screen><![CDATA[
...
]]></screen>
Sample response:
<programlisting language="xml"><![CDATA[
...
]]></programlisting>
</para>
<para></para>
</section>

View File

@ -0,0 +1,20 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>gzip</title>
<para>Create a GNU zip archive.
Sample request:
<screen><![CDATA[
...
]]></screen>
Sample response:
<programlisting language="xml"><![CDATA[
...
]]></programlisting>
</para>
<para></para>
</section>

View File

@ -0,0 +1,20 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>bzip2FromArchive</title>
<para>Create a new bzip2 archive from files located within another archive.
Sample request:
<screen><![CDATA[
...
]]></screen>
Sample response:
<programlisting language="xml"><![CDATA[
...
]]></programlisting>
</para>
<para></para>
</section>

View File

@ -0,0 +1,20 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>gunzip</title>
<para>Extract files from a GNU zip archive.
Sample request:
<screen><![CDATA[
...
]]></screen>
Sample response:
<programlisting language="xml"><![CDATA[
...
]]></programlisting>
</para>
<para></para>
</section>

View File

@ -0,0 +1,21 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>gunzipFromURL</title>
<para>Extract files from a GNU zip archive. The archive is located on the web (http/ https)
and will be downloaded automatically.
Sample request:
<screen><![CDATA[
...
]]></screen>
Sample response:
<programlisting language="xml"><![CDATA[
...
]]></programlisting>
</para>
<para></para>
</section>

View File

@ -0,0 +1,20 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>bzip2</title>
<para>Create a bzip2 archive.
Sample request:
<screen><![CDATA[
...
]]></screen>
Sample response:
<programlisting language="xml"><![CDATA[
...
]]></programlisting>
</para>
<para></para>
</section>

View File

@ -0,0 +1,20 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>gzipFromArchive</title>
<para>Create a new GNU zip archive from files located within another archive.
Sample request:
<screen><![CDATA[
...
]]></screen>
Sample response:
<programlisting language="xml"><![CDATA[
...
]]></programlisting>
</para>
<para></para>
</section>

View File

@ -0,0 +1,20 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>untar</title>
<para>Extract files from a tarball archive.
Sample request:
<screen><![CDATA[
...
]]></screen>
Sample response:
<programlisting language="xml"><![CDATA[
...
]]></programlisting>
</para>
<para></para>
</section>

View File

@ -0,0 +1,20 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>unrar</title>
<para>Extract files from a RAR archive.
Sample request:
<screen><![CDATA[
...
]]></screen>
Sample response:
<programlisting language="xml"><![CDATA[
...
]]></programlisting>
</para>
<para></para>
</section>

View File

@ -0,0 +1,20 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>unzip</title>
<para>Extract files from a zip archive.
Sample request:
<screen><![CDATA[
...
]]></screen>
Sample response:
<programlisting language="xml"><![CDATA[
...
]]></programlisting>
</para>
<para></para>
</section>

View File

@ -0,0 +1,20 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>zip</title>
<para>Compress files and store them in a ZIP archive.
Sample request:
<screen><![CDATA[
...
]]></screen>
Sample response:
<programlisting language="xml"><![CDATA[
...
]]></programlisting>
</para>
<para></para>
</section>

View File

@ -0,0 +1,20 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>zipFromArchive</title>
<para>Create a new ZIP archive from files located within another archive.
Sample request:
<screen><![CDATA[
...
]]></screen>
Sample response:
<programlisting language="xml"><![CDATA[
...
]]></programlisting>
</para>
<para></para>
</section>

File diff suppressed because it is too large Load Diff

View File

@ -7,7 +7,7 @@
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Brutex XServices Documentation</title>
<bookinfo>
<date>Januar 2012</date>
<date>June 2014</date>
<author>
<firstname>Brian</firstname>
<surname>Rosenberger</surname>
@ -15,7 +15,7 @@
</author>
<corpname>Brutex Network</corpname>
<copyright>
<year>2012</year>
<year>2014</year>
</copyright>
<legalnotice>
<para>
@ -51,23 +51,35 @@
<para>This chapter describes the installation process.</para>
<xi:include href="common/installation.xml" />
</chapter>
<chapter id="services">
<chapter id="soapservices">
<beginpage />
<title>Available Services</title>
<title>Available SOAP Services</title>
<para>List of available web services and their operations.</para>
<xi:include href="ArchiveServices.xml" />
<xi:include href="DateServices.xml" />
<xi:include href="ExecuteServices.xml" />
<xi:include href="FileServices.xml" />
<xi:include href="MailServices.xml" />
<xi:include href="MiscServices.xml" />
<xi:include href="ArchiveServices/ArchiveServices.xml" />
<xi:include href="DateServices/DateServices.xml" />
<xi:include href="ExecuteServices/ExecuteServices.xml" />
<xi:include href="FileServices/FileServices.xml" />
<xi:include href="JobServices/JobServices.xml" />
<xi:include href="MailServices/MailServices.xml" />
<xi:include href="MiscServices/MiscServices.xml" />
<xi:include href="StorageServices/StorageServices.xml" />
<xi:include href="StringServices/StringServices.xml" />
<xi:include href="XmlServices/XmlServices.xml" />
</chapter>
<chapter id="restservices">
<beginpage />
<title>Available RESTful Services</title>
<para>List of available web services and their operations.</para>
<xi:include href="CVSInfoService/CVSInfoService.xml" />
<xi:include href="FileInfoService/FileInfoService.xml" />
</chapter>
<chapter id="xmltypes">
<beginpage />
<title>XML Types</title>
<para>This chapter bundles the documentation for common XML types used
by XServices web service.</para>
<xi:include href="Types.xml" />
<xi:include href="types/Types.xml" />
</chapter>
</book>

View File

@ -0,0 +1,17 @@
<?xml version="1.0" encoding="utf-8"?>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude" id="cvsinfoservices">
<title>CVSInfoService</title>
<para>RESTful service to query a CVS repository, search files and content. Includes caching mechanism.
</para>
<para>Endpoint address: http://localhost:8080/XServices/cvsinfo</para>
<para>WADL : http://localhost:8080/XServices/cvsinfo?_wadl</para>
<!--
<xi:include href="./dateAdd.xml" />
-->
</section>

View File

@ -18,11 +18,17 @@
</listitem>
</itemizedlist>
</para>
<xi:include href="DateServices/getDate.xml" />
<xi:include href="DateServices/getDateExtended.xml" />
<xi:include href="DateServices/formatDate.xml" />
<xi:include href="DateServices/getInTimezone.xml" />
<xi:include href="DateServices/getTimestamp.xml" />
<xi:include href="DateServices/getTimestamp2.xml" />
<xi:include href="DateServices/getTimezones.xml" />
<xi:include href="./dateAdd.xml" />
<xi:include href="./dateTimeDiff.xml" />
<xi:include href="./dateTimeDiff2.xml" />
<xi:include href="./getDate.xml" />
<xi:include href="./getDateExtended.xml" />
<xi:include href="./formatDate.xml" />
<xi:include href="./formatDateAdvanced.xml" />
<xi:include href="./getInTimezone.xml" />
<xi:include href="./getTimestamp.xml" />
<xi:include href="./getTimestamp2.xml" />
<xi:include href="./getTimezones.xml" />
<xi:include href="./parseDate.xml" />
<xi:include href="./parseDateAdvanced.xml" />
</section>

View File

@ -0,0 +1,20 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>dateAdd</title>
<para>Add or substract a time span from/ to a date.
Sample request:
<screen><![CDATA[
...
]]></screen>
Sample response:
<programlisting language="xml"><![CDATA[
...
]]></programlisting>
</para>
<para>Hints here</para>
</section>

View File

@ -0,0 +1,20 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>dateTimeDiff</title>
<para>Calculate elapsed time between two dates. Returns the elapsed time in milliseconds.
Sample request:
<screen><![CDATA[
...
]]></screen>
Sample response:
<programlisting language="xml"><![CDATA[
...
]]></programlisting>
</para>
<para>Hints here</para>
</section>

View File

@ -0,0 +1,20 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>dateTimeDiff</title>
<para>Calculate Fully elapsed units between two dates. Example: 4:15:10-4:15:55 in minutes = 0 and in seconds = 45.
Sample request:
<screen><![CDATA[
...
]]></screen>
Sample response:
<programlisting language="xml"><![CDATA[
...
]]></programlisting>
</para>
<para>Hints here</para>
</section>

View File

@ -0,0 +1,37 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>formatDateAdvanced</title>
<para>
Transform Time/ Date representation. Formats a date with a free form pattern. Uses SimpleDateFormat patterns.
</para>
<para>
The following pattern letters are defined (all other characters from 'A' to 'Z' and from 'a' to 'z' are reserved):
<programlisting><![CDATA[
Letter Date or Time Component Presentation Examples
G Era designator Text AD
y Year Year 1996; 96
M Month in year Month July; Jul; 07
w Week in year Number 27
W Week in month Number 2
D Day in year Number 189
d Day in month Number 10
F Day of week in month Number 2
E Day in week Text Tuesday; Tue
a Am/pm marker Text PM
H Hour in day (0-23) Number 0
k Hour in day (1-24) Number 24
K Hour in am/pm (0-11) Number 0
h Hour in am/pm (1-12) Number 12
m Minute in hour Number 30
s Second in minute Number 55
S Millisecond Number 978
z Time zone General time zone Pacific Standard Time; PST; GMT-08:00
Z Time zone RFC 822 time zone -0800
]]></programlisting>
</para>
</section>

View File

@ -8,7 +8,7 @@
<title>getDate</title>
<para>Get current time and date.
Sample request:
<screen><![CDATA[
<programlisting language="xml"><![CDATA[
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://ws.xservices.brutex.net">
@ -17,7 +17,7 @@
<ws:getDate/>
</soapenv:Body>
</soapenv:Envelop
]]></screen>
]]></programlisting>
Sample response:
<programlisting language="xml"><![CDATA[
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

View File

@ -8,7 +8,7 @@
<title>getDateExtended</title>
<para>Get current time and date (extended Version).
Sample response:
<screen>
<programlisting language="xml">
<![CDATA[
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
@ -25,7 +25,7 @@
</soap:Body>
</soap:Envelope>
]]>
</screen>
</programlisting>
</para>
</section>

View File

@ -8,7 +8,8 @@
<title>getTimestamp</title>
<para>Get current timestamp in milliseconds (epoch).
Sample request:
<screen><![CDATA[
<programlisting language="xml">
<![CDATA[
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://ws.xservices.brutex.net">
@ -17,15 +18,18 @@
<ws:getTimestamp/>
</soapenv:Body>
</soapenv:Envelop
]]></screen>
]]>
</programlisting>
Sample response:
<screen><![CDATA[
<programlisting language="xml">
<![CDATA[
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns1:getTimestampResponse xmlns:ns1="http://ws.xservices.brutex.net">
<ns1:return>]]><emphasis>1325488875703</emphasis><![CDATA[</ns1:return>
</ns1:getTimestampResponse>
</soap:Body>
</soap:Envelope>]]></screen>
</soap:Envelope>]]>
</programlisting>
</para>
</section>

View File

@ -8,7 +8,8 @@
<title>getTimestamp2</title>
<para>Get current timestamp in seconds (unix timestamp).
Sample request:
<screen><![CDATA[
<programlisting language="xml">
<![CDATA[
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://ws.xservices.brutex.net">
@ -17,15 +18,18 @@
<ws:getTimestamp2/>
</soapenv:Body>
</soapenv:Envelop
]]></screen>
]]>
</programlisting>
Sample response:
<screen><![CDATA[
<programlisting language="xml">
<![CDATA[
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns1:getTimestamp2Response xmlns:ns1="http://ws.xservices.brutex.net">
<ns1:return>]]><emphasis>1325488876</emphasis><![CDATA[</ns1:return>
</ns1:getTimestamp2Response>
</soap:Body>
</soap:Envelope>]]></screen>
</soap:Envelope>]]>
</programlisting>
</para>
</section>

View File

@ -0,0 +1,26 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>parseDate</title>
<para>
Converts a string into date using pre-defined date formats
<itemizedlist>
<listitem>
<para>ISO8601 (example: "2012-01-17T23:50:00+01:00")</para>
</listitem>
<listitem>
<para>RFC822 (example: "2012-01-17T23:50:00+0100")</para>
</listitem>
<listitem>
<para>YYYYMMDD (example: "2012/01/17")</para>
</listitem>
<listitem>
<para>DDMMYYYY (example: "17.01.2012")</para>
</listitem>
</itemizedlist>
</para>
</section>

View File

@ -0,0 +1,13 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>parseDateAdvanced</title>
<para>
Converts a string into date using any format.
</para>
</section>

View File

@ -1,13 +0,0 @@
<?xml version='1.0' encoding="utf-8"?>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude"
id="executeservices">
<title>ExecuteServices</title>
<para>The ExecuteService bundles local and remote command
execution operations. Its WSDL is located at
http://server:port/XServices/ExecuteService?wsdl</para>
<xi:include href="ExecuteServices/rExec.xml" />
<xi:include href="ExecuteServices/runCommand.xml" />
<xi:include href="ExecuteServices/runCommandWithSSH.xml" />
<xi:include href="ExecuteServices/telnet.xml" />
</section>

View File

@ -0,0 +1,18 @@
<?xml version='1.0' encoding="utf-8"?>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude"
id="executeservices">
<title>ExecuteServices</title>
<para>The ExecuteService bundles local and remote command
execution operations. Its WSDL is located at
http://server:port/XServices/ExecuteService?wsdl</para>
<xi:include href="./rExec.xml" />
<xi:include href="./runCommand.xml" />
<xi:include href="./runCommandAsync.xml" />
<xi:include href="./runCommandAsyncWithArgs.xml" />
<xi:include href="./runCommandWithArgs.xml" />
<xi:include href="./runCommandWithSSH.xml" />
<xi:include href="./runCommandWithSSHKeyAuth.xml" />
<xi:include href="./runJavaScript.xml" />
<xi:include href="./telnet.xml" />
</section>

View File

@ -53,4 +53,59 @@
</title>
<xi:include href="../types/ReturnCode.xml" />
</section>
<section>
<para>
Sample request: Start Windows Command Interpreter and print "Hello World" to STDOUT.
<programlisting language="xml">
<![CDATA[<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.xservices.brutex.net">
<soapenv:Header/>
<soapenv:Body>
<ws:runCommand>
<executable>c:/windows/system32/cmd.exe</executable>
<argline>/C "echo Hallo Welt!"</argline>
<timeout>3000</timeout>
</ws:runCommand>
</soapenv:Body>
</soapenv:Envelope>]]>
</programlisting>
Sample response:
<programlisting language="xml">
<![CDATA[<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:runCommandResponse xmlns:ns2="http://ws.xservices.brutex.net">
<return>
<returnCode>0</returnCode>
<stdOut/>
<stdErr/>
<propertyList>
<name>ExecuteService.result</name>
<value>0</value>
</propertyList>
<propertyList>
<name>ExecuteService.stdout</name>
<value>Hallo Welt!</value>
</propertyList>
<propertyList>
<name>ExecuteService.stderr</name>
<value/>
</propertyList>
</return>
</ns2:runCommandResponse>
</soap:Body>
</soap:Envelope>]]></programlisting></para></section>
<section>
<para>
Sample request: Start notepad.exe and close it after 15 seconds.
<programlisting language="xml">
<![CDATA[<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.xservices.brutex.net">
<soapenv:Header/>
<soapenv:Body>
<ws:runCommand>
<executable>c:/windows/system32/notepad.exe</executable>
<argline></argline>
<timeout>15000</timeout>
</ws:runCommand>
</soapenv:Body>
</soapenv:Envelope>]]></programlisting></para></section>
</section>

View File

@ -0,0 +1,13 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>runCommandAsync</title>
<para>Run an executable with arguments on the server providing the web
service and don't wait for the executable to finish.
The command is run within the environment and under the user
privileges of the user who is running the Tomcat Server.</para>
</section>

View File

@ -0,0 +1,13 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>runCommandAsyncWithArgs</title>
<para>Run an executable with arguments on the server providing the web
service and don't wait for the executable to finish.
The command is run within the environment and under the user
privileges of the user who is running the Tomcat Server.</para>
</section>

View File

@ -0,0 +1,12 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>runCommandWithArgs</title>
<para>Run an executable with arguments on the server providing the web
service. The command is run within the environment and under the user
privileges of the user who is running the Tomcat Server.</para>
</section>

View File

@ -0,0 +1,11 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>runCommandWithSSHKeyAuth</title>
<para>Executes a command through a SSH session.</para>
</section>

View File

@ -0,0 +1,10 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>runJavaScript</title>
<para>Execute a JavaScript and or Java program using Mozilla Rhino JIT-Compiler.</para>
</section>

View File

@ -0,0 +1,13 @@
<?xml version="1.0" encoding="utf-8"?>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude" id="fileinfoservices">
<title>FileInfoService</title>
<para>The FileInfoService allows listing/ searching/ browsing and download of files and directories. Includes caching mechanism.
</para>
<para>Endpoint address: http://localhost:8080/XServices/fileinfo</para>
<para>WADL : http://localhost:8080/XServices/fileinfo?_wadl</para>
<!--
<xi:include href="./dateAdd.xml" />
-->
</section>

View File

@ -5,4 +5,6 @@
<title>FileServices</title>
<para>The FileServces bundles various file operations. Its WSDL is located at
http://server:port/XServices/FileService?wsdl</para>
<xi:include href="./downloadFile.xml" />
<xi:include href="./encodeFile.xml" />
</section>

View File

@ -8,7 +8,7 @@
<title>downloadFile</title>
<para>Downloads a file as base64 encoded.
Sample request:
<screen><![CDATA[
<programlisting language="xml"><![CDATA[
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.xservices.brutex.net">
<soapenv:Header/>
<soapenv:Body>
@ -21,7 +21,7 @@
</ws:downloadFile>
</soapenv:Body>
</soapenv:Envelope>
]]></screen>
]]></programlisting>
Sample response:
<programlisting language="xml"><![CDATA[
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

View File

@ -0,0 +1,13 @@
<?xml version="1.0" encoding="utf-8"?>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude"
id="jobservices">
<title>JobServices</title>
<para>The JobService bundles re-occuring or scheduled operations. Its WSDL is located at
http://server:port/XServices/JobService?wsdl</para>
<!--
<xi:include href="MiscServices/generateUUID.xml" />
<xi:include href="MiscServices/getHostinfo.xml" />
<xi:include href="MiscServices/sleep.xml" />
-->
</section>

View File

@ -5,5 +5,5 @@
<title>MailServices</title>
<para>The MailService contains mail send and receive operations. Its WSDL is located at
http://server:port/XServices/MailService?wsdl</para>
<xi:include href="MailServices/sendMailSimple.xml" />
<xi:include href="./sendMailSimple.xml" />
</section>

View File

@ -5,7 +5,7 @@
<title>MiscServices</title>
<para>The MiscService bundles various operations. Its WSDL is located at
http://server:port/XServices/MiscService?wsdl</para>
<xi:include href="MiscServices/generateUUID.xml" />
<xi:include href="MiscServices/getHostinfo.xml" />
<xi:include href="MiscServices/sleep.xml" />
<xi:include href="./generateUUID.xml" />
<xi:include href="./getHostinfo.xml" />
<xi:include href="./sleep.xml" />
</section>

View File

@ -0,0 +1,12 @@
<?xml version='1.0' encoding="utf-8"?>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude"
id="storageservices">
<title>StorageServices</title>
<para>The StorageService will provide get/ push operations to store and retrieve data from various backends.
This is currently under development and not yet released.
Its WSDL is located at
http://server:port/XServices/StorageService?wsdl</para>
<xi:include href="./operationName.xml" />
</section>

View File

@ -0,0 +1,59 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title> ...
</title>
<para>Description here</para>
<section>
<title>&inp;
</title>
<para />
<table frame="all">
<title>Input parameters
</title>
<tgroup cols="4">
<colspec colnum="1" colname="parameter" />
<colspec colnum="2" colname="type" />
<colspec colnum="3" colname="required" />
<colspec colnum="4" colname="description" />
<thead>
<row>
<entry>parameter</entry>
<entry>type</entry>
<entry>required</entry>
<entry>description</entry>
</row>
</thead>
<tbody>
<row>
<entry>host</entry>
<entry>HostConnection</entry>
<entry>Yes</entry>
<entry>
Host where to execute the command. See
<link linkend='hostconnection'>HostConnection</link>
.
</entry>
</row>
<row>
<entry>command</entry>
<entry>String</entry>
<entry>No</entry>
<entry>Any command including arguments</entry>
</row>
&param-timeout;
</tbody>
</tgroup>
</table>
<para />
</section>
<section>
<title>&outp;
</title>
<xi:include href="../types/ReturnCode.xml" />
</section>
</section>

View File

@ -0,0 +1,11 @@
<?xml version='1.0' encoding="utf-8"?>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude"
id="stringservices">
<title>StringServices</title>
<para>The StringService provides String manipulation capabilities.
Its WSDL is located at
http://server:port/XServices/StringService?wsdl</para>
<xi:include href="./replaceRegEx.xml" />
</section>

View File

@ -1,13 +0,0 @@
<?xml version='1.0' encoding='UTF-8'?>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<!-- Sort alphabetically -->
<xi:include href="types/AntProperty.xml" />
<xi:include href="types/DateInfoType.xml" />
<xi:include href="types/FileResource.xml" />
<xi:include href="types/HostConnection.xml" />
<xi:include href="types/PatternElement.xml" />
<xi:include href="types/PatternSetType.xml" />
<xi:include href="types/ReturnCode.xml" />
<xi:include href="types/SelectorType.xml" />
</section>

View File

@ -0,0 +1,17 @@
<?xml version='1.0' encoding="utf-8"?>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude"
id="xmlservices">
<title>XmlServices</title>
<para>The XmlService provides operations to manipulate XML structures.
Its WSDL is located at
http://server:port/XServices/XmlService?wsdl</para>
<xi:include href="./insertNodes.xml" />
<xi:include href="./insertNodes2.xml" />
<xi:include href="./replaceNodes.xml" />
<xi:include href="./replaceNodes2.xml" />
<xi:include href="./selectXPath.xml" />
<xi:include href="./setAttribute.xml" />
<xi:include href="./wrapInCDATA.xml" />
</section>

View File

@ -0,0 +1,74 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>insertNodes</title>
<para>Insert an xml fragment into other elements specified by an XPath expression.
This operation is namespace aware.
Sample request:
<programlisting language="xml"><![CDATA[
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.xservices.brutex.net">
<soapenv:Header/>
<soapenv:Body>
<ws:insertNodes>
<sourcexml><![CDATA[
<books>
<author>
<name>Mensiok</name>
<surname>Bello</surname>
</author>
<author>
<name>Schwab</name>
<surname>Rumsau</surname>
</author>
<author>
<name>Dollibert</name>
<surname>Rach</surname>
</author>
</books>
]]]]><![CDATA[></sourcexml>
<encoding>utf-8</encoding>
<namespaceList>
<!--Zero or more repetitions:-->
<namespace>
<prefix></prefix>
<uri></uri>
</namespace>
</namespaceList>
<xpath>/books/author</xpath>
<!--Optional:-->
<xmldata><![CDATA[<age namespace="http://btx"/>]]]]><![CDATA[></xmldata>
</ws:insertNodes>
</soapenv:Body>
</soapenv:Envelope>
]]></programlisting>
Sample response:
<programlisting language="xml"><![CDATA[
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:insertNodesResponse xmlns:ns2="http://ws.xservices.brutex.net">
<return><![CDATA[<?xml version='1.0' encoding='UTF-8'?>
<books>
<author>
<name>Mensiok</name>
<surname>Bello</surname>
<age namespace="http://btx"/></author>
<author>
<name>Schwab</name>
<surname>Rumsau</surname>
<age namespace="http://btx"/></author>
<author>
<name>Dollibert</name>
<surname>Rach</surname>
<age namespace="http://btx"/></author>
</books>]]]]><![CDATA[></!></return>
</ns2:insertNodesResponse>
</soap:Body>
</soap:Envelope>
]]></programlisting>
</para>
</section>

View File

@ -0,0 +1,19 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>insertNodes2</title>
<para>Insert an xml fragment into xml resource (i.e. file, URL) specified by an XPath expression.
This operation is namespace aware.
Sample request:
<programlisting language="xml"><![CDATA[
...]]></programlisting>
Sample response:
<programlisting language="xml"><![CDATA[
...]]></programlisting>
</para>
</section>

View File

@ -0,0 +1,74 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>replaceNodes</title>
<para>Replace an xml fragment with another xml fragment. This operation is namespace aware.
Sample request:
<programlisting language="xml"><![CDATA[
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://ws.xservices.brutex.net">
<soapenv:Header/>
<soapenv:Body>
<ws:replaceNodes>
<sourcexml><![CDATA[
<books>
<author>
<name>Mensiok</name>
<surname>Bello</surname>
</author>
<author>
<name>Schwab</name>
<surname>Rumsau</surname>
</author>
<author>
<name>Dollibert</name>
<surname>Rach</surname>
</author>
</books>
]]]]><![CDATA[>
</sourcexml>
<encoding>utf-8</encoding>
<namespaceList>
<!--Zero or more repetitions:-->
<namespace>
<prefix></prefix>
<uri></uri>
</namespace>
</namespaceList>
<xpath>*/name[text()='Schwab']</xpath>
<!--Optional:-->
<xmldata><![CDATA[<name>Meyer</name><age>45</age><!--edited here-->]]]]><![CDATA[></xmldata>
</ws:replaceNodes>
</soapenv:Body>
</soapenv:Envelope>
]]></programlisting>
Sample response:
<programlisting language="xml"><![CDATA[
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:replaceNodesResponse xmlns:ns2="http://ws.xservices.brutex.net">
<return><![CDATA[<?xml version='1.0' encoding='UTF-8'?>
<books>
<author>
<name>Mensiok</name>
<surname>Bello</surname>
</author>
<author>
<name>Meyer</name><age>45</age><!--edited here-->
<surname>Rumsau</surname>
</author>
<author>
<name>Dollibert</name>
<surname>Rach</surname>
</author>
</books>]]]]><![CDATA[></return>
</ns2:replaceNodesResponse>
</soap:Body>
</soap:Envelope>]]></programlisting>
</para>
</section>

View File

@ -0,0 +1,19 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>replaceNodes2</title>
<para>Replace an xml fragment with another xml fragment read from a resource (i.e. file, URL). This operation is namespace aware.
Sample request:
<programlisting language="xml">
...
</programlisting>
Sample response:
<programlisting language="xml"><![CDATA[
...]]></programlisting>
</para>
</section>

View File

@ -0,0 +1,73 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>selectXPath</title>
<para>Selects xmlfragements, nodes, attribute or text from xml data using an XPath expression.
This function requires namespaces to be declared correctly.</para>
<para>
Sample request:
<programlisting language="xml"><![CDATA[
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://ws.xservices.brutex.net">
<soapenv:Header/>
<soapenv:Body>
<ws:selectXPath>
<sourcexml>
<![CDATA[<notes xmlns="http://demo.brutex.net" xmlns:bx="http://bx.brutex.net">
<bx:note>
<to>Lena</to>
<from>Jani</from>
<heading>Reminder ABC</heading>
<body>Don't forget me this weekend!</body>
</bx:note>
<note>
<to>John</to>
<from>Lena</from>
<heading>Call Mr. ABC</heading>
<body>Please call back</body>
</note>
<bx:note>
<to>Brian</to>
<from>JJohn</from>
<heading>Reminder XServices</heading>
<body>How to use selectXPath?</body>
</bx:note>
</notes>
]]]]><![CDATA[>
</sourcexml>
<encoding>utf-8</encoding>
<namespaceList>
<namespace>
<prefix>ns</prefix>
<uri>http://demo.brutex.net</uri>
</namespace>
<namespace>
<prefix>bx</prefix>
<uri>http://bx.brutex.net</uri>
</namespace>
</namespaceList>
<xpath>*/bx:note/ns:heading/text()</xpath>
</ws:selectXPath>
</soapenv:Body>
</soapenv:Envelope>
]]></programlisting>
Sample response:
<programlisting language="xml"><![CDATA[
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:selectXPathResponse xmlns:ns2="http://ws.xservices.brutex.net">
<return>
<stringlist>Reminder ABC</stringlist>
<stringlist>Reminder XServices</stringlist>
<size>2</size>
</return>
</ns2:selectXPathResponse>
</soap:Body>
</soap:Envelope>
]]></programlisting>
</para>
</section>

View File

@ -0,0 +1,77 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>setAttribute</title>
<para>Set an attribute into elements matched by an XPath expression.</para>
<para>
Sample request:
<programlisting language="xml"><![CDATA[
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.xservices.brutex.net">
<soapenv:Header/>
<soapenv:Body>
<ws:setAttribute>
<sourcexml>
<![CDATA[<notes xmlns="http://demo.brutex.net">
<note>
<to>Lena</to>
<from>Jani</from>
<heading>Reminder ABC</heading>
<body>Don't forget me this weekend!</body>
</note>
<note>
<to>John</to>
<from>Lena</from>
<heading>Call Mr. ABC</heading>
<body>Please call back</body>
</note>
</notes>
]]]]><![CDATA[></sourcexml>
<encoding>utf-8</encoding>
<!--Optional:-->
<namespaceList>
<!--Zero or more repetitions:-->
<namespace>
<prefix>bx</prefix>
<uri>http://demo.brutex.net</uri>
</namespace>
</namespaceList>
<xpath>*/bx:note</xpath>
<attribute>
<name>priority</name>
<!--Optional:-->
<value>high</value>
</attribute>
</ws:setAttribute>
</soapenv:Body>
</soapenv:Envelope>
]]></programlisting>
Sample response:
<programlisting language="xml"><![CDATA[
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:setAttributeResponse xmlns:ns2="http://ws.xservices.brutex.net">
<return><![CDATA[<?xml version='1.0' encoding='UTF-8'?>
<notes xmlns="http://demo.brutex.net">
<note xmlns:axis2ns16="http://demo.brutex.net" axis2ns16:priority="high">
<to>Lena</to>
<from>Jani</from>
<heading>Reminder ABC</heading>
<body>Don't forget me this weekend!</body>
</note>
<note xmlns:axis2ns17="http://demo.brutex.net" axis2ns17:priority="high">
<to>John</to>
<from>Lena</from>
<heading>Call Mr. ABC</heading>
<body>Please call back</body>
</note>
</notes>]]]]><![CDATA[></return>
</ns2:setAttributeResponse>
</soap:Body>
</soap:Envelope>
]]></programlisting>
</para>
</section>

View File

@ -0,0 +1,36 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>wrapInCDATA</title>
<para>Simply wraps any data fragment into &lt;![CDATA[ ... ]]&gt; section. This can be useful if you
want to preserve indentation or line breaks.
</para>
<para>
Sample request:
<programlisting language="xml"><![CDATA[
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://ws.xservices.brutex.net">
<soapenv:Header/>
<soapenv:Body>
<ws:wrapInCDATA>
<data>Hello World, here is some &lt;xml&gt; data</data>
</ws:wrapInCDATA>
</soapenv:Body>
</soapenv:Envelope>
]]></programlisting>
Sample response:
<programlisting language="xml"><![CDATA[
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:wrapInCDATAResponse xmlns:ns2="http://ws.xservices.brutex.net">
<return>&lt;![CDATA[Hello World, here is some &lt;xml> data]]&gt;</return>
</ns2:wrapInCDATAResponse>
</soap:Body>
</soap:Envelope>
]]></programlisting>
</para>
</section>

20
doc/_template/_template.xml vendored Normal file
View File

@ -0,0 +1,20 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title>_template</title>
<para>Description here
Sample request:
<screen><![CDATA[
...
]]></screen>
Sample response:
<programlisting language="xml"><![CDATA[
...
]]></programlisting>
</para>
<para>Hints here</para>
</section>

11
doc/_template/_templateServices.xml vendored Normal file
View File

@ -0,0 +1,11 @@
<?xml version='1.0' encoding="utf-8"?>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude"
id="templateservices">
<title>TemplateServices</title>
<para>The TemplateService bundles ...
Its WSDL is located at
http://server:port/XServices/TemplateService?wsdl</para>
<xi:include href="./operationName.xml" />
</section>

59
doc/_template/operationName.xml vendored Normal file
View File

@ -0,0 +1,59 @@
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE section [
<!ENTITY % myent SYSTEM "../entities.ent">
%myent;
]>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<title> ...
</title>
<para>Description here</para>
<section>
<title>&inp;
</title>
<para />
<table frame="all">
<title>Input parameters
</title>
<tgroup cols="4">
<colspec colnum="1" colname="parameter" />
<colspec colnum="2" colname="type" />
<colspec colnum="3" colname="required" />
<colspec colnum="4" colname="description" />
<thead>
<row>
<entry>parameter</entry>
<entry>type</entry>
<entry>required</entry>
<entry>description</entry>
</row>
</thead>
<tbody>
<row>
<entry>host</entry>
<entry>HostConnection</entry>
<entry>Yes</entry>
<entry>
Host where to execute the command. See
<link linkend='hostconnection'>HostConnection</link>
.
</entry>
</row>
<row>
<entry>command</entry>
<entry>String</entry>
<entry>No</entry>
<entry>Any command including arguments</entry>
</row>
&param-timeout;
</tbody>
</tgroup>
</table>
<para />
</section>
<section>
<title>&outp;
</title>
<xi:include href="../types/ReturnCode.xml" />
</section>
</section>

View File

@ -1,8 +1,25 @@
<?xml version="1.0" encoding="UTF-8"?>
<abstract>
<title>Abstract</title>
<para>In complex IT environments it is often necessary to integrate different information systems with each other, exchange data between software tools and automate actions based on events arising from user interaction. Web Services is a popular way to make remote functions available to a broad range of clients. A WebService is independent from platforms and programming languages. XML Messages are exchanged through common protocols like TCP/IP or SMTP, processed and returned (request/ response paradigm).</para>
<para>Because of their nature, WebServices are a great technology to overcome system boundaries and to "orchestrate" your IT environment. They make up the basis for SOA and are the pieces that assemble automated business processes.</para>
<para>XServices is a collection of pre-build WebServices with the intention to avoid duplicate work and "re-inventing the wheel". The historical base for XServices is the 'XBridgeNG' software, which provided a set of Apache Ant Tasks with quite the same intention. The available WebService operations are most likely the "most wanted" ones, some of the for sure are "must have". This collection may overlap with other libraries. In summary the current version contains 8 WebServices with over 50 operations.</para>
<para>In complex IT environments it is often necessary to integrate
different information systems with each other, exchange data between
software tools and automate actions based on events arising from user
interaction. Web Services is a popular way to make remote functions
available to a broad range of clients. A WebService is independent
from platforms and programming languages. XML Messages are exchanged
through common protocols like TCP/IP or SMTP, processed and returned
(request/ response paradigm).</para>
<para>Because of their nature, WebServices are a great technology to
overcome system boundaries and to "orchestrate" your IT environment.
They make up the basis for SOA and are the pieces that assemble
automated business processes.</para>
<para>XServices is a collection of pre-build WebServices with the
intention to avoid duplicate work and "re-inventing the wheel". The
historical base for XServices is the 'XBridgeNG' software, which
provided a set of Apache Ant Tasks with quite the same intention. The
available WebService operations are most likely the "most wanted"
ones, some of them for sure are "must have". This collection may
overlap with other libraries. In summary the current version contains
8 WebServices with over 50 operations.</para>
</abstract>

View File

@ -3,11 +3,11 @@
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink">
<section>
<title>Installation</title>
<para>tbd.</para>
<para>Sun Java SE 1.6.0</para>
<para>Apache Tomcat 7</para>
<para>As of February 2013, XServices require Java 7. Older builds run against Java 5.</para>
<para>As of April 2018, XServices require Java 8 and Tomcat 8.5.</para>
<para>tbd.</para>
<para>In short: Deploy .WAR file to Apache Tomcat</para>
<section>
@ -21,7 +21,7 @@
</para>
</section>
<section>
<title>Limit access to</title>
<title>Limit access by IP address</title>
<para>Sometimes you&apos;ll only want to restrict access to to
only
specified host names or IP addresses. This way, only
@ -57,5 +57,5 @@
server.xml
file (into &lt;engine&gt;&lt;host&gt;).</para>
</section>
</section>
</section>

File diff suppressed because one or more lines are too long

View File

Binary file not shown.

13
doc/style.css Normal file
View File

@ -0,0 +1,13 @@
pre.programlisting {
background-color: #FFFF99 ;
border: 1px solid #006600 ;
}
/*Section headings*/
div.chapter div.titlepage h2 {
font-size: 180%;
font-family: Helvetica;
font-weight: Bold;
color: #444444
}

13
doc/types/Types.xml Normal file
View File

@ -0,0 +1,13 @@
<?xml version='1.0' encoding='UTF-8'?>
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
xmlns:xi="http://www.w3.org/2001/XInclude">
<!-- Sort alphabetically -->
<xi:include href="./AntProperty.xml" />
<xi:include href="./DateInfoType.xml" />
<xi:include href="./FileResource.xml" />
<xi:include href="./HostConnection.xml" />
<xi:include href="./PatternElement.xml" />
<xi:include href="./PatternSetType.xml" />
<xi:include href="./ReturnCode.xml" />
<xi:include href="./SelectorType.xml" />
</section>

BIN
gradle/wrapper/gradle-wrapper.jar vendored Normal file

Binary file not shown.

View File

@ -0,0 +1,7 @@
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-8.2-bin.zip
networkTimeout=10000
validateDistributionUrl=true
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

248
gradlew vendored Normal file
View File

@ -0,0 +1,248 @@
#!/bin/sh
#
# Copyright © 2015-2021 the original authors.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
##############################################################################
#
# Gradle start up script for POSIX generated by Gradle.
#
# Important for running:
#
# (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
# noncompliant, but you have some other compliant shell such as ksh or
# bash, then to run this script, type that shell name before the whole
# command line, like:
#
# ksh Gradle
#
# Busybox and similar reduced shells will NOT work, because this script
# requires all of these POSIX shell features:
# * functions;
# * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
# «${var#prefix}», «${var%suffix}», and «$( cmd )»;
# * compound commands having a testable exit status, especially «case»;
# * various built-in commands including «command», «set», and «ulimit».
#
# Important for patching:
#
# (2) This script targets any POSIX shell, so it avoids extensions provided
# by Bash, Ksh, etc; in particular arrays are avoided.
#
# The "traditional" practice of packing multiple parameters into a
# space-separated string is a well documented source of bugs and security
# problems, so this is (mostly) avoided, by progressively accumulating
# options in "$@", and eventually passing that to Java.
#
# Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
# and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
# see the in-line comments for details.
#
# There are tweaks for specific operating systems such as AIX, CygWin,
# Darwin, MinGW, and NonStop.
#
# (3) This script is generated from the Groovy template
# https://github.com/gradle/gradle/blob/HEAD/subprojects/plugins/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
# within the Gradle project.
#
# You can find Gradle at https://github.com/gradle/gradle/.
#
##############################################################################
# Attempt to set APP_HOME
# Resolve links: $0 may be a link
app_path=$0
# Need this for daisy-chained symlinks.
while
APP_HOME=${app_path%"${app_path##*/}"} # leaves a trailing /; empty if no leading path
[ -h "$app_path" ]
do
ls=$( ls -ld "$app_path" )
link=${ls#*' -> '}
case $link in #(
/*) app_path=$link ;; #(
*) app_path=$APP_HOME$link ;;
esac
done
# This is normally unused
# shellcheck disable=SC2034
APP_BASE_NAME=${0##*/}
APP_HOME=$( cd "${APP_HOME:-./}" && pwd -P ) || exit
# Use the maximum available, or set MAX_FD != -1 to use that value.
MAX_FD=maximum
warn () {
echo "$*"
} >&2
die () {
echo
echo "$*"
echo
exit 1
} >&2
# OS specific support (must be 'true' or 'false').
cygwin=false
msys=false
darwin=false
nonstop=false
case "$( uname )" in #(
CYGWIN* ) cygwin=true ;; #(
Darwin* ) darwin=true ;; #(
MSYS* | MINGW* ) msys=true ;; #(
NONSTOP* ) nonstop=true ;;
esac
CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
# Determine the Java command to use to start the JVM.
if [ -n "$JAVA_HOME" ] ; then
if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
# IBM's JDK on AIX uses strange locations for the executables
JAVACMD=$JAVA_HOME/jre/sh/java
else
JAVACMD=$JAVA_HOME/bin/java
fi
if [ ! -x "$JAVACMD" ] ; then
die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
Please set the JAVA_HOME variable in your environment to match the
location of your Java installation."
fi
else
JAVACMD=java
if ! command -v java >/dev/null 2>&1
then
die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
Please set the JAVA_HOME variable in your environment to match the
location of your Java installation."
fi
fi
# Increase the maximum file descriptors if we can.
if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
case $MAX_FD in #(
max*)
# In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked.
# shellcheck disable=SC3045
MAX_FD=$( ulimit -H -n ) ||
warn "Could not query maximum file descriptor limit"
esac
case $MAX_FD in #(
'' | soft) :;; #(
*)
# In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked.
# shellcheck disable=SC3045
ulimit -n "$MAX_FD" ||
warn "Could not set maximum file descriptor limit to $MAX_FD"
esac
fi
# Collect all arguments for the java command, stacking in reverse order:
# * args from the command line
# * the main class name
# * -classpath
# * -D...appname settings
# * --module-path (only if needed)
# * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
# For Cygwin or MSYS, switch paths to Windows format before running java
if "$cygwin" || "$msys" ; then
APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" )
JAVACMD=$( cygpath --unix "$JAVACMD" )
# Now convert the arguments - kludge to limit ourselves to /bin/sh
for arg do
if
case $arg in #(
-*) false ;; # don't mess with options #(
/?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath
[ -e "$t" ] ;; #(
*) false ;;
esac
then
arg=$( cygpath --path --ignore --mixed "$arg" )
fi
# Roll the args list around exactly as many times as the number of
# args, so each arg winds up back in the position where it started, but
# possibly modified.
#
# NB: a `for` loop captures its iteration list before it begins, so
# changing the positional parameters here affects neither the number of
# iterations, nor the values presented in `arg`.
shift # remove old arg
set -- "$@" "$arg" # push replacement arg
done
fi
# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
# Collect all arguments for the java command;
# * $DEFAULT_JVM_OPTS, $JAVA_OPTS, and $GRADLE_OPTS can contain fragments of
# shell script including quotes and variable substitutions, so put them in
# double quotes to make sure that they get re-expanded; and
# * put everything else in single quotes, so that it's not re-expanded.
set -- \
"-Dorg.gradle.appname=$APP_BASE_NAME" \
-classpath "$CLASSPATH" \
org.gradle.wrapper.GradleWrapperMain \
"$@"
# Stop when "xargs" is not available.
if ! command -v xargs >/dev/null 2>&1
then
die "xargs is not available"
fi
# Use "xargs" to parse quoted args.
#
# With -n1 it outputs one arg per line, with the quotes and backslashes removed.
#
# In Bash we could simply go:
#
# readarray ARGS < <( xargs -n1 <<<"$var" ) &&
# set -- "${ARGS[@]}" "$@"
#
# but POSIX shell has neither arrays nor command substitution, so instead we
# post-process each arg (as a line of input to sed) to backslash-escape any
# character that might be a shell metacharacter, then use eval to reverse
# that process (while maintaining the separation between arguments), and wrap
# the whole thing up as a single "set" statement.
#
# This will of course break if any of these variables contains a newline or
# an unmatched quote.
#
eval "set -- $(
printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
xargs -n1 |
sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
tr '\n' ' '
)" '"$@"'
exec "$JAVACMD" "$@"

92
gradlew.bat vendored Normal file
View File

@ -0,0 +1,92 @@
@rem
@rem Copyright 2015 the original author or authors.
@rem
@rem Licensed under the Apache License, Version 2.0 (the "License");
@rem you may not use this file except in compliance with the License.
@rem You may obtain a copy of the License at
@rem
@rem https://www.apache.org/licenses/LICENSE-2.0
@rem
@rem Unless required by applicable law or agreed to in writing, software
@rem distributed under the License is distributed on an "AS IS" BASIS,
@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@rem See the License for the specific language governing permissions and
@rem limitations under the License.
@rem
@if "%DEBUG%"=="" @echo off
@rem ##########################################################################
@rem
@rem Gradle startup script for Windows
@rem
@rem ##########################################################################
@rem Set local scope for the variables with windows NT shell
if "%OS%"=="Windows_NT" setlocal
set DIRNAME=%~dp0
if "%DIRNAME%"=="" set DIRNAME=.
@rem This is normally unused
set APP_BASE_NAME=%~n0
set APP_HOME=%DIRNAME%
@rem Resolve any "." and ".." in APP_HOME to make it shorter.
for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
@rem Find java.exe
if defined JAVA_HOME goto findJavaFromJavaHome
set JAVA_EXE=java.exe
%JAVA_EXE% -version >NUL 2>&1
if %ERRORLEVEL% equ 0 goto execute
echo.
echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
echo.
echo Please set the JAVA_HOME variable in your environment to match the
echo location of your Java installation.
goto fail
:findJavaFromJavaHome
set JAVA_HOME=%JAVA_HOME:"=%
set JAVA_EXE=%JAVA_HOME%/bin/java.exe
if exist "%JAVA_EXE%" goto execute
echo.
echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
echo.
echo Please set the JAVA_HOME variable in your environment to match the
echo location of your Java installation.
goto fail
:execute
@rem Setup the command line
set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
@rem Execute Gradle
"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %*
:end
@rem End local scope for the variables with windows NT shell
if %ERRORLEVEL% equ 0 goto mainEnd
:fail
rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
rem the _cmd.exe /c_ return code!
set EXIT_CODE=%ERRORLEVEL%
if %EXIT_CODE% equ 0 set EXIT_CODE=1
if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE%
exit /b %EXIT_CODE%
:mainEnd
if "%OS%"=="Windows_NT" endlocal
:omega

BIN
lib/DocBuilder-20131001.jar Normal file

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Some files were not shown because too many files have changed in this diff Show More