This is an automated email from the ASF dual-hosted git repository.
git-site-role pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/plc4x-website.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 06dafaa Site checkin for project PLC4X: Jenkins Tools
06dafaa is described below
commit 06dafaa6457bfc733bbb16d41e6854c926acf326
Author: jenkins <[email protected]>
AuthorDate: Thu Feb 27 17:41:11 2020 +0000
Site checkin for project PLC4X: Jenkins Tools
---
sitemap.html | 10 +-
users/download.html | 11 +-
users/gettingstarted.html | 11 +-
users/index.html | 11 +-
users/industry40.html | 11 +-
users/integrations/apache-calcite.html | 11 +-
users/integrations/apache-camel.html | 11 +-
users/integrations/apache-edgent.html | 11 +-
users/integrations/apache-iotdb.html | 11 +-
users/integrations/apache-kafka.html | 11 +-
users/integrations/apache-nifi.html | 11 +-
users/integrations/apache-streampipes.html | 11 +-
users/integrations/eclipse-ditto.html | 11 +-
users/integrations/elastic-logstash.html | 11 +-
users/integrations/index.html | 11 +-
users/opm.html | 338 -------------------
users/plc4j/gettingstarted.html | 11 +-
users/plc4j/virtual-modbus.html | 11 +-
users/protocols/ab-eth.html | 11 +-
users/protocols/ads.html | 11 +-
users/protocols/bacnetip.html | 11 +-
users/protocols/deltav.html | 11 +-
users/protocols/df1.html | 11 +-
users/protocols/ethernet-ip.html | 11 +-
users/protocols/index.html | 11 +-
users/protocols/knxnetip.html | 11 +-
users/protocols/modbus.html | 11 +-
users/protocols/opc-ua.html | 11 +-
users/protocols/s7.html | 11 +-
users/protocols/simulated.html | 11 +-
users/security.html | 11 +-
users/testing.html | 457 --------------------------
users/tools/{opm.html => capture-replay.html} | 125 +++----
users/tools/connection-pool.html | 11 +-
users/tools/index.html | 11 +-
users/tools/opm.html | 11 +-
users/tools/scraper.html | 11 +-
users/tools/testing.html | 11 +-
38 files changed, 314 insertions(+), 990 deletions(-)
diff --git a/sitemap.html b/sitemap.html
index 76efcdf..4bce952 100644
--- a/sitemap.html
+++ b/sitemap.html
@@ -178,13 +178,15 @@
<ul>
-<li><a href="users/connection-pool.html">Connection Pool</a></li>
+<li><a href="users/tools/capture-replay.html">Capture Replay</a></li>
-<li><a href="users/opm.html">Object PLC Mapping (OPM)</a></li>
+<li><a href="users/tools/onnection-pool.html">Connection Pool</a></li>
-<li><a href="users/scraper.html">Scraper</a></li>
+<li><a href="users/tools/opm.html">Object PLC Mapping (OPM)</a></li>
-<li><a href="users/testing.html">PLC4X without a PLC and Unit
Testing</a></li></ul></li>
+<li><a href="users/tools/scraper.html">Scraper</a></li>
+
+<li><a href="users/tools/testing.html">PLC4X without a PLC and Unit
Testing</a></li></ul></li>
<li><a href="users/industry40.html">Industry 4.0 with Apache</a></li>
diff --git a/users/download.html b/users/download.html
index 5cbb14b..906dc0a 100644
--- a/users/download.html
+++ b/users/download.html
@@ -162,16 +162,19 @@
<a href="../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/gettingstarted.html b/users/gettingstarted.html
index 67686fb..b4bfd77 100644
--- a/users/gettingstarted.html
+++ b/users/gettingstarted.html
@@ -162,16 +162,19 @@
<a href="../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/index.html b/users/index.html
index e0a9d0a..ca6f4be 100644
--- a/users/index.html
+++ b/users/index.html
@@ -162,16 +162,19 @@
<a href="../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/industry40.html b/users/industry40.html
index 429fc6d..94cbde7 100644
--- a/users/industry40.html
+++ b/users/industry40.html
@@ -162,16 +162,19 @@
<a href="../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/integrations/apache-calcite.html
b/users/integrations/apache-calcite.html
index 3158c3b..5fb326c 100644
--- a/users/integrations/apache-calcite.html
+++ b/users/integrations/apache-calcite.html
@@ -162,16 +162,19 @@
<a href="../../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/integrations/apache-camel.html
b/users/integrations/apache-camel.html
index 8570b05..ef2ad75 100644
--- a/users/integrations/apache-camel.html
+++ b/users/integrations/apache-camel.html
@@ -162,16 +162,19 @@
<a href="../../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/integrations/apache-edgent.html
b/users/integrations/apache-edgent.html
index 1675493..4bf6766 100644
--- a/users/integrations/apache-edgent.html
+++ b/users/integrations/apache-edgent.html
@@ -162,16 +162,19 @@
<a href="../../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/integrations/apache-iotdb.html
b/users/integrations/apache-iotdb.html
index bd62e7d..1218858 100644
--- a/users/integrations/apache-iotdb.html
+++ b/users/integrations/apache-iotdb.html
@@ -162,16 +162,19 @@
<a href="../../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/integrations/apache-kafka.html
b/users/integrations/apache-kafka.html
index 3f6a29e..f5711f1 100644
--- a/users/integrations/apache-kafka.html
+++ b/users/integrations/apache-kafka.html
@@ -162,16 +162,19 @@
<a href="../../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/integrations/apache-nifi.html
b/users/integrations/apache-nifi.html
index 1e7c1f2..79f3689 100644
--- a/users/integrations/apache-nifi.html
+++ b/users/integrations/apache-nifi.html
@@ -162,16 +162,19 @@
<a href="../../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/integrations/apache-streampipes.html
b/users/integrations/apache-streampipes.html
index 7a6929c..098dacb 100644
--- a/users/integrations/apache-streampipes.html
+++ b/users/integrations/apache-streampipes.html
@@ -162,16 +162,19 @@
<a href="../../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/integrations/eclipse-ditto.html
b/users/integrations/eclipse-ditto.html
index ae11395..5edca4b 100644
--- a/users/integrations/eclipse-ditto.html
+++ b/users/integrations/eclipse-ditto.html
@@ -162,16 +162,19 @@
<a href="../../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/integrations/elastic-logstash.html
b/users/integrations/elastic-logstash.html
index bd6959e..83dcb12 100644
--- a/users/integrations/elastic-logstash.html
+++ b/users/integrations/elastic-logstash.html
@@ -162,16 +162,19 @@
<a href="../../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/integrations/index.html b/users/integrations/index.html
index 46ce55a..38c6716 100644
--- a/users/integrations/index.html
+++ b/users/integrations/index.html
@@ -162,16 +162,19 @@
<a href="../../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/opm.html b/users/opm.html
deleted file mode 100644
index eacecbc..0000000
--- a/users/opm.html
+++ /dev/null
@@ -1,338 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";>
- <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
-<head>
- <meta http-equiv="Content-Type"
content="text/html; charset=UTF-8"/>
- <title>PLC4X – </title>
- <script src="../js/jquery.slim.min.js" type="javascript"></script>
- <!--script src="../js/popper.min.js" type="javascript"></script-->
- <script src="../js/bootstrap.bundle.min.js" type="javascript"></script>
- <!-- FontAwesome -->
- <link rel="stylesheet" href="../css/all.min.css" type="text/css"/>
- <!-- Bootstrap -->
- <link rel="stylesheet" href="../css/bootstrap.min.css" type="text/css"/>
- <!-- Some Maven Site defaults -->
- <link rel="stylesheet" href="../css/maven-base.css" type="text/css"/>
- <link rel="stylesheet" href="../css/maven-theme.css" type="text/css"/>
- <!-- The PLC4X version of a bootstrap theme -->
- <link rel="stylesheet" href="../css/themes/plc4x.css" type="text/css"
id="pagestyle"/>
- <!-- A custom style for printing content -->
- <link rel="stylesheet" href="../css/print.css" type="text/css"
media="print"/>
-
- <meta http-equiv="Content-Language" content="en"/>
-
-</head>
-<body class="composite">
-<nav class="navbar navbar-light navbar-expand-md bg-faded
justify-content-center border-bottom">
- <!--a href="/" class="navbar-brand d-flex w-50 mr-auto">Navbar 3</a-->
- <a href="https://plc4x.apache.org/"; id="bannerLeft"><img
src="../images/apache_plc4x_logo_small.png" alt="Apache PLC4X"/></a>
- <button class="navbar-toggler" type="button" data-toggle="collapse"
data-target="#collapsingNavbar3">
- <span class="navbar-toggler-icon"></span>
- </button>
- <div class="navbar-collapse collapse w-100" id="collapsingNavbar3">
- <ul class="navbar-nav w-100 justify-content-center">
- <li class="nav-item">
- <a class="nav-link" href="../index.html">Home</a>
- </li>
-
<li class="nav-item active">
- <a class="nav-link"
href="../users/index.html">Users</a>
- </li>
- <li class="nav-item">
- <a class="nav-link"
href="../developers/index.html">Developers</a>
- </li>
- <li class="nav-item">
- <a class="nav-link"
href="../apache/index.html">Apache</a>
- </li>
- </ul>
- <ul class="nav navbar-nav ml-auto justify-content-end">
- <li class="nav-item row valign-middle">
- <a href="https://www.apache.org/events/current-event.html";
class="col"><img src="https://www.apache.org/events/current-event-234x60.png";
alt="Apache Events"/></a>
- <div class="col">
- <a href="https://www.apache.org/"; id="bannerRight"><img
src="../images/apache_logo_small.png" alt="Apache Software Foundation"/></a>
- </div>
- </li>
- </ul>
- </div>
-</nav>
-<div class="container-fluid">
- <div class="row h-100">
-
-
-
<nav class="col-sm-push col-md-2 pt-3 sidebar">
- <div class="sidebar-sticky">
- <ul class="nav flex-column">
- <li
class="nav-item">
- <a href="../users/index.html"
class="nav-link">Section Home</a>
- </li>
-
-
- <li
class="nav-item">
- <a href="../users/download.html"
class="nav-link">Download</a>
- </li>
-
-
- <li
class="nav-item">
- <a href="../users/gettingstarted.html"
class="nav-link">Getting Started</a>
- <ul class="flex-column pl-4 nav">
- <li class="nav-item">
- <a href="../users/plc4j/gettingstarted.html"
class="nav-link">Java</a>
- </li>
- <li class="nav-item">
- <a href="../users/plc4j/virtual-modbus.html"
class="nav-link">Virtual Modbus</a>
- </li>
- </ul>
- </li>
-
-
- <li
class="nav-item">
- <a href="../users/protocols/index.html"
class="nav-link">Protocols</a>
- <ul class="flex-column pl-4 nav">
- <li class="nav-item">
- <a href="../users/protocols/ab-eth.html"
class="nav-link">AB-ETH</a>
- </li>
- <li class="nav-item">
- <a href="../users/protocols/ads.html"
class="nav-link">ADS/AMS</a>
- </li>
- <li class="nav-item">
- <a href="../users/protocols/bacnetip.html"
class="nav-link">BACnet/IP</a>
- </li>
- <li class="nav-item">
- <a href="../users/protocols/deltav.html"
class="nav-link">DeltaV</a>
- </li>
- <li class="nav-item">
- <a href="../users/protocols/df1.html"
class="nav-link">DF1</a>
- </li>
- <li class="nav-item">
- <a href="../users/protocols/ethernet-ip.html"
class="nav-link">EtherNet/IP</a>
- </li>
- <li class="nav-item">
- <a href="../users/protocols/knxnetip.html"
class="nav-link">KNXnet/IP</a>
- </li>
- <li class="nav-item">
- <a href="../users/protocols/modbus.html"
class="nav-link">Modbus (TCP/Serial)</a>
- </li>
- <li class="nav-item">
- <a href="../users/protocols/opc-ua.html"
class="nav-link">OPC UA</a>
- </li>
- <li class="nav-item">
- <a href="../users/protocols/s7.html"
class="nav-link">S7 (Step7)</a>
- </li>
- <li class="nav-item">
- <a href="../users/protocols/simulated.html"
class="nav-link">Simulated</a>
- </li>
- </ul>
- </li>
-
-
- <li
class="nav-item">
- <a href="../users/integrations/index.html"
class="nav-link">Integrations</a>
- <ul class="flex-column pl-4 nav">
- <li class="nav-item">
- <a
href="../users/integrations/apache-calcite.html" class="nav-link">Apache
Calcite</a>
- </li>
- <li class="nav-item">
- <a href="../users/integrations/apache-camel.html"
class="nav-link">Apache Camel</a>
- </li>
- <li class="nav-item">
- <a href="../users/integrations/apache-edgent.html"
class="nav-link">Apache Edgent</a>
- </li>
- <li class="nav-item">
- <a href="../users/integrations/apache-iotdb.html"
class="nav-link">Apache IoTDB</a>
- </li>
- <li class="nav-item">
- <a href="../users/integrations/apache-kafka.html"
class="nav-link">Apache Kafka</a>
- </li>
- <li class="nav-item">
- <a href="../users/integrations/apache-nifi.html"
class="nav-link">Apache NiFi</a>
- </li>
- <li class="nav-item">
- <a
href="../users/integrations/apache-streampipes.html" class="nav-link">Apache
StreamPipes</a>
- </li>
- <li class="nav-item">
- <a href="../users/integrations/eclipse-ditto.html"
class="nav-link">Eclipse Ditto</a>
- </li>
- <li class="nav-item">
- <a
href="../users/integrations/elastic-logstash.html" class="nav-link">Elastic
Logstash</a>
- </li>
- </ul>
- </li>
-
-
- <li
class="nav-item">
- <a href="../users/tools/index.html"
class="nav-link">Tools</a>
- <ul class="flex-column pl-4 nav">
- <li class="nav-item">
- <a href="../users/connection-pool.html"
class="nav-link">Connection Pool</a>
- </li>
- <li class="nav-item">
- <strong class="nav-link">Object PLC Mapping
(OPM)</strong>
- </li>
- <li class="nav-item">
- <a href="../users/scraper.html"
class="nav-link">Scraper</a>
- </li>
- <li class="nav-item">
- <a href="../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
- </li>
- </ul>
- </li>
-
-
- <li
class="nav-item">
- <a href="../users/industry40.html"
class="nav-link">Industry 4.0 with Apache</a>
- </li>
-
-
- <li
class="nav-item">
- <a href="../users/security.html"
class="nav-link">Security</a>
- </li>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- </ul>
- </div>
- </nav>
- <main role="main"
class="ml-sm-auto px-4 col-sm-pull col-md-9 col-lg-10 h-100">
- <div class="sect1">
-<h2 id="object_plc_mapping">Object PLC Mapping</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="what_is_object_plc_mapping">What is Object PLC Mapping</h3>
-<div class="paragraph">
-<p>Object PLC Mapping (OPM) is heavily inspired by the Java Persistence API
(JPA) [1].
-One of the main goal of the PLC4X Project is to make it easy to communicate
with PLC devices to enable the development
-of applications that interact with PLCs.
-As many (or even most) of the application programmers are no experts in PLC
Communication and protocols it should be as
-easy as possible to interact with PLCs without too much domain knowledge.
-This is exactly the reason why JPA was initialized many years ago to allow the
interaction with a Database by simply
-calling methods on POJOs (Plain old Java Object).
-This is exactly what the OPM Module is for, to enable PLC communication by
simply interacting with a POJO.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="simple_example">Simple Example</h3>
-<div class="paragraph">
-<p>The following short code snippet shows how to read one value from a PLC via
OPM.
-First, a <em>PlcEntityManager</em> is instantiated, then a
<strong>connected</strong> entity is fetched for a given PLC connection address.
-Connected means that all method calls of the entity are intersected and
replaced by PLC calls.
-This is then used to print one value to the console.
-In the second snippet one can see how the Entity class looks. The address
where to read the variable <em>pressure</em> from is given
-in the <em>@PlcField</em> annotation.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="prettyprint highlight"><code data-lang="java">public static void
main(String[] args) {
- PlcEntityManager em = new PlcEntityManager();
- MyEntity entity = em.connect(MyEntity.class, "s7://...");
- System.out.println(entity.getPressure());
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The class <em>MyEntity</em> is given by</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="prettyprint highlight"><code data-lang="java">@PlcEntity
-public class MyEntity {
-
- @PlcField("DB01:DW01:LONG")
- private double pressure;
-
- public void MyEntity() {
- // For OPM
- }
-
- public double getPressure() {
- return pressure;
- }
-}</code></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="annotations">Annotations</h3>
-
-</div>
-<div class="sect2">
-<h3 id="more_details">More details</h3>
-
-</div>
-<div class="sect2">
-<h3 id="references">References</h3>
-<div class="paragraph">
-<p>[1] <a
href="https://www.oracle.com/technetwork/java/javaee/tech/persistence-jsp-140049.html";
class="bare">https://www.oracle.com/technetwork/java/javaee/tech/persistence-jsp-140049.html</a></p>
-</div>
-</div>
-</div>
-</div>
- </main>
- <footer class="pt-4 my-md-5 pt-md-5 w-100 border-top">
- <div class="row justify-content-md-center" style="font-size: 13px">
- <div class="col col-6 text-center">
- Copyright © 2017–2020 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>.
-All rights reserved.<br/>
- Apache PLC4X, PLC4X, Apache, the Apache feather logo, and
the Apache PLC4X project logo are either registered trademarks or trademarks of
The Apache Software Foundation in the United States and other countries. All
other marks mentioned may be trademarks or registered trademarks of their
respective owners.
- <br/><div
style="text-align:center;">Home screen image taken from <a
- href="https://flic.kr/p/chEftd";>Flickr</a>, "Tesla
Robot Dance" by Steve Jurvetson, licensed
- under <a
href="https://creativecommons.org/licenses/by/2.0/";>CC BY 2.0 Generic</a>,
image cropped
- and blur effect added.</div>
- </div>
- </div>
- </footer>
- </div>
-</div>
-
-<!-- Bootstrap core JavaScript
-================================================== -->
-<!-- Placed at the end of the document so the pages load faster -->
-<script src="../js/jquery.slim.min.js"></script>
-<script src="../js/popper.min.js"></script>
-<script src="../js/bootstrap.min.js"></script>
-<script type="text/javascript">
- $('.carousel .carousel-item').each(function(){
- var next = $(this).next();
- if (!next.length) {
- next = $(this).siblings(':first');
- }
- next.children(':first-child').clone().appendTo($(this));
-
- for (let i = 0; i < 3; i++) {
- next=next.next();
- if (!next.length) {
- next = $(this).siblings(':first');
- }
- next.children(':first-child').clone().appendTo($(this));
- }
- });
-</script>
-</body>
-</html>
\ No newline at end of file
diff --git a/users/plc4j/gettingstarted.html b/users/plc4j/gettingstarted.html
index e98c144..9ee8d59 100644
--- a/users/plc4j/gettingstarted.html
+++ b/users/plc4j/gettingstarted.html
@@ -162,16 +162,19 @@
<a href="../../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/plc4j/virtual-modbus.html b/users/plc4j/virtual-modbus.html
index ce9a83e..7555a78 100644
--- a/users/plc4j/virtual-modbus.html
+++ b/users/plc4j/virtual-modbus.html
@@ -162,16 +162,19 @@
<a href="../../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/protocols/ab-eth.html b/users/protocols/ab-eth.html
index 73c2077..a2f3477 100644
--- a/users/protocols/ab-eth.html
+++ b/users/protocols/ab-eth.html
@@ -162,16 +162,19 @@
<a href="../../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/protocols/ads.html b/users/protocols/ads.html
index 73727ba..33057a2 100644
--- a/users/protocols/ads.html
+++ b/users/protocols/ads.html
@@ -162,16 +162,19 @@
<a href="../../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/protocols/bacnetip.html b/users/protocols/bacnetip.html
index 84b06df..3b56968 100644
--- a/users/protocols/bacnetip.html
+++ b/users/protocols/bacnetip.html
@@ -162,16 +162,19 @@
<a href="../../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/protocols/deltav.html b/users/protocols/deltav.html
index 04c90a3..2f0a0d6 100644
--- a/users/protocols/deltav.html
+++ b/users/protocols/deltav.html
@@ -162,16 +162,19 @@
<a href="../../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/protocols/df1.html b/users/protocols/df1.html
index 83142a5..4b151ab 100644
--- a/users/protocols/df1.html
+++ b/users/protocols/df1.html
@@ -162,16 +162,19 @@
<a href="../../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/protocols/ethernet-ip.html b/users/protocols/ethernet-ip.html
index 8bd0ed0..09779bd 100644
--- a/users/protocols/ethernet-ip.html
+++ b/users/protocols/ethernet-ip.html
@@ -162,16 +162,19 @@
<a href="../../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/protocols/index.html b/users/protocols/index.html
index 7db63a8..4c126fe 100644
--- a/users/protocols/index.html
+++ b/users/protocols/index.html
@@ -162,16 +162,19 @@
<a href="../../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/protocols/knxnetip.html b/users/protocols/knxnetip.html
index 3d85a3a..e0046ec 100644
--- a/users/protocols/knxnetip.html
+++ b/users/protocols/knxnetip.html
@@ -162,16 +162,19 @@
<a href="../../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/protocols/modbus.html b/users/protocols/modbus.html
index 7f0e79f..c1ea398 100644
--- a/users/protocols/modbus.html
+++ b/users/protocols/modbus.html
@@ -162,16 +162,19 @@
<a href="../../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/protocols/opc-ua.html b/users/protocols/opc-ua.html
index 33fcf5e..e4864bc 100644
--- a/users/protocols/opc-ua.html
+++ b/users/protocols/opc-ua.html
@@ -162,16 +162,19 @@
<a href="../../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/protocols/s7.html b/users/protocols/s7.html
index 3c99e5f..924713c 100644
--- a/users/protocols/s7.html
+++ b/users/protocols/s7.html
@@ -162,16 +162,19 @@
<a href="../../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/protocols/simulated.html b/users/protocols/simulated.html
index 1001746..bb3fbc6 100644
--- a/users/protocols/simulated.html
+++ b/users/protocols/simulated.html
@@ -162,16 +162,19 @@
<a href="../../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/security.html b/users/security.html
index ee845c4..e18ca68 100644
--- a/users/security.html
+++ b/users/security.html
@@ -162,16 +162,19 @@
<a href="../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/testing.html b/users/testing.html
deleted file mode 100644
index f86c816..0000000
--- a/users/testing.html
+++ /dev/null
@@ -1,457 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";>
- <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
-<head>
- <meta http-equiv="Content-Type"
content="text/html; charset=UTF-8"/>
- <title>PLC4X – </title>
- <script src="../js/jquery.slim.min.js" type="javascript"></script>
- <!--script src="../js/popper.min.js" type="javascript"></script-->
- <script src="../js/bootstrap.bundle.min.js" type="javascript"></script>
- <!-- FontAwesome -->
- <link rel="stylesheet" href="../css/all.min.css" type="text/css"/>
- <!-- Bootstrap -->
- <link rel="stylesheet" href="../css/bootstrap.min.css" type="text/css"/>
- <!-- Some Maven Site defaults -->
- <link rel="stylesheet" href="../css/maven-base.css" type="text/css"/>
- <link rel="stylesheet" href="../css/maven-theme.css" type="text/css"/>
- <!-- The PLC4X version of a bootstrap theme -->
- <link rel="stylesheet" href="../css/themes/plc4x.css" type="text/css"
id="pagestyle"/>
- <!-- A custom style for printing content -->
- <link rel="stylesheet" href="../css/print.css" type="text/css"
media="print"/>
-
- <meta http-equiv="Content-Language" content="en"/>
-
-</head>
-<body class="composite">
-<nav class="navbar navbar-light navbar-expand-md bg-faded
justify-content-center border-bottom">
- <!--a href="/" class="navbar-brand d-flex w-50 mr-auto">Navbar 3</a-->
- <a href="https://plc4x.apache.org/"; id="bannerLeft"><img
src="../images/apache_plc4x_logo_small.png" alt="Apache PLC4X"/></a>
- <button class="navbar-toggler" type="button" data-toggle="collapse"
data-target="#collapsingNavbar3">
- <span class="navbar-toggler-icon"></span>
- </button>
- <div class="navbar-collapse collapse w-100" id="collapsingNavbar3">
- <ul class="navbar-nav w-100 justify-content-center">
- <li class="nav-item">
- <a class="nav-link" href="../index.html">Home</a>
- </li>
-
<li class="nav-item active">
- <a class="nav-link"
href="../users/index.html">Users</a>
- </li>
- <li class="nav-item">
- <a class="nav-link"
href="../developers/index.html">Developers</a>
- </li>
- <li class="nav-item">
- <a class="nav-link"
href="../apache/index.html">Apache</a>
- </li>
- </ul>
- <ul class="nav navbar-nav ml-auto justify-content-end">
- <li class="nav-item row valign-middle">
- <a href="https://www.apache.org/events/current-event.html";
class="col"><img src="https://www.apache.org/events/current-event-234x60.png";
alt="Apache Events"/></a>
- <div class="col">
- <a href="https://www.apache.org/"; id="bannerRight"><img
src="../images/apache_logo_small.png" alt="Apache Software Foundation"/></a>
- </div>
- </li>
- </ul>
- </div>
-</nav>
-<div class="container-fluid">
- <div class="row h-100">
-
-
-
<nav class="col-sm-push col-md-2 pt-3 sidebar">
- <div class="sidebar-sticky">
- <ul class="nav flex-column">
- <li
class="nav-item">
- <a href="../users/index.html"
class="nav-link">Section Home</a>
- </li>
-
-
- <li
class="nav-item">
- <a href="../users/download.html"
class="nav-link">Download</a>
- </li>
-
-
- <li
class="nav-item">
- <a href="../users/gettingstarted.html"
class="nav-link">Getting Started</a>
- <ul class="flex-column pl-4 nav">
- <li class="nav-item">
- <a href="../users/plc4j/gettingstarted.html"
class="nav-link">Java</a>
- </li>
- <li class="nav-item">
- <a href="../users/plc4j/virtual-modbus.html"
class="nav-link">Virtual Modbus</a>
- </li>
- </ul>
- </li>
-
-
- <li
class="nav-item">
- <a href="../users/protocols/index.html"
class="nav-link">Protocols</a>
- <ul class="flex-column pl-4 nav">
- <li class="nav-item">
- <a href="../users/protocols/ab-eth.html"
class="nav-link">AB-ETH</a>
- </li>
- <li class="nav-item">
- <a href="../users/protocols/ads.html"
class="nav-link">ADS/AMS</a>
- </li>
- <li class="nav-item">
- <a href="../users/protocols/bacnetip.html"
class="nav-link">BACnet/IP</a>
- </li>
- <li class="nav-item">
- <a href="../users/protocols/deltav.html"
class="nav-link">DeltaV</a>
- </li>
- <li class="nav-item">
- <a href="../users/protocols/df1.html"
class="nav-link">DF1</a>
- </li>
- <li class="nav-item">
- <a href="../users/protocols/ethernet-ip.html"
class="nav-link">EtherNet/IP</a>
- </li>
- <li class="nav-item">
- <a href="../users/protocols/knxnetip.html"
class="nav-link">KNXnet/IP</a>
- </li>
- <li class="nav-item">
- <a href="../users/protocols/modbus.html"
class="nav-link">Modbus (TCP/Serial)</a>
- </li>
- <li class="nav-item">
- <a href="../users/protocols/opc-ua.html"
class="nav-link">OPC UA</a>
- </li>
- <li class="nav-item">
- <a href="../users/protocols/s7.html"
class="nav-link">S7 (Step7)</a>
- </li>
- <li class="nav-item">
- <a href="../users/protocols/simulated.html"
class="nav-link">Simulated</a>
- </li>
- </ul>
- </li>
-
-
- <li
class="nav-item">
- <a href="../users/integrations/index.html"
class="nav-link">Integrations</a>
- <ul class="flex-column pl-4 nav">
- <li class="nav-item">
- <a
href="../users/integrations/apache-calcite.html" class="nav-link">Apache
Calcite</a>
- </li>
- <li class="nav-item">
- <a href="../users/integrations/apache-camel.html"
class="nav-link">Apache Camel</a>
- </li>
- <li class="nav-item">
- <a href="../users/integrations/apache-edgent.html"
class="nav-link">Apache Edgent</a>
- </li>
- <li class="nav-item">
- <a href="../users/integrations/apache-iotdb.html"
class="nav-link">Apache IoTDB</a>
- </li>
- <li class="nav-item">
- <a href="../users/integrations/apache-kafka.html"
class="nav-link">Apache Kafka</a>
- </li>
- <li class="nav-item">
- <a href="../users/integrations/apache-nifi.html"
class="nav-link">Apache NiFi</a>
- </li>
- <li class="nav-item">
- <a
href="../users/integrations/apache-streampipes.html" class="nav-link">Apache
StreamPipes</a>
- </li>
- <li class="nav-item">
- <a href="../users/integrations/eclipse-ditto.html"
class="nav-link">Eclipse Ditto</a>
- </li>
- <li class="nav-item">
- <a
href="../users/integrations/elastic-logstash.html" class="nav-link">Elastic
Logstash</a>
- </li>
- </ul>
- </li>
-
-
- <li
class="nav-item">
- <a href="../users/tools/index.html"
class="nav-link">Tools</a>
- <ul class="flex-column pl-4 nav">
- <li class="nav-item">
- <a href="../users/connection-pool.html"
class="nav-link">Connection Pool</a>
- </li>
- <li class="nav-item">
- <a href="../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
- </li>
- <li class="nav-item">
- <a href="../users/scraper.html"
class="nav-link">Scraper</a>
- </li>
- <li class="nav-item">
- <strong class="nav-link">PLC4X without a PLC and
Unit Testing</strong>
- </li>
- </ul>
- </li>
-
-
- <li
class="nav-item">
- <a href="../users/industry40.html"
class="nav-link">Industry 4.0 with Apache</a>
- </li>
-
-
- <li
class="nav-item">
- <a href="../users/security.html"
class="nav-link">Security</a>
- </li>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- </ul>
- </div>
- </nav>
- <main role="main"
class="ml-sm-auto px-4 col-sm-pull col-md-9 col-lg-10 h-100">
- <div class="sect1">
-<h2 id="testing_or_using_plc4x_without_a_plc">Testing (or using PLC4X without
a PLC)</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="the_mock_driver">The Mock Driver</h3>
-<div class="paragraph">
-<p>PLC4X has a <em>Mock Driver</em> which was initially implemented to be used
for Unit Tests and this still is its main purpose.
-But this driver is also very suitable to play around a bit with the PLC4X API
if no <em>Hardware</em> PLC is available.
-The driver can be found in the Maven module</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="prettyprint highlight"><code><dependency>
- <groupId>org.apache.plc4x</groupId>
- <artifactId>plc4j-transport-test</artifactId>
- <version>${current.version}</version>
- <scope>test</scope>
-</dependency></code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The connection string Syntax for the mock driver is
<code>mock:{name-of-the-connection}</code>. So you can use multiple Mock
Devices at the same time.</p>
-</div>
-<div class="paragraph">
-<p>The Mock Driver does nothing else than forwarding all Requests to a
<em>Virtual Device</em> which we can provide to control all responses and also
Monitor them, e.g. for unit tests.
-The Interface for the Mock Device is</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="prettyprint highlight"><code>public interface MockDevice {
-
- Pair<PlcResponseCode, PlcValue> read(String fieldQuery);
-
- PlcResponseCode write(String fieldQuery, Object value);
-
- Pair<PlcResponseCode, PlcSubscriptionHandle> subscribe(String
fieldQuery);
-
- void unsubscribe();
-
- // ...
-
-}</code></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="simple_example">Simple Example</h3>
-<div class="paragraph">
-<p>Imagine we have some Code which we cannot control or whose functionality we
want to test.
-This can be done with the Mock Driver in the following way.</p>
-</div>
-<div class="paragraph">
-<p>First, a new Mock Connection is established (like any other connection also
would be):</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="prettyprint highlight"><code>PlcDriverManager driverManager = new
PlcDriverManager();
-PlcMockConnection connection = (PlcMockConnection)
driverManager.getConnection("mock:my-mock-connection");</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You see, that we directly cast the Connection to a
<code>PlcMockConnection</code>. This is done, because we need to
<em>connect</em> a Device to this Mock Connection.</p>
-</div>
-<div class="paragraph">
-<p>This is done in the following Snippet</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="prettyprint
highlight"><code>connection.setDevice(mockDevice);</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Here, we pass it an instance of <code>MockDevice</code> which could be a
simple Implementation of the interface like</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="prettyprint highlight"><code>MockDevice mockDevice = new
MockDevice() {
-
- Pair<PlcResponseCode, PlcValue> read(String fieldQuery) {
- System.out.println("I got a read to " + fieldQuery);
- return Pair.of(PlcResponseCode.OK, new PlcString("hello"));
- }
-
- PlcResponseCode write(String fieldQuery, Object value) {
- System.out.println("I got a write to " + fieldQuery + " with the value
" + value);
- return PlcResponseCode.OK;
- }
-
- // ...
-
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This would just return a String Value <code>hello</code> for every request
and print all read and write requests to the Console.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="unit_testing_with_the_mock_driver">Unit Testing with the Mock
Driver</h3>
-<div class="paragraph">
-<p>To use the Mock driver in Unit Tests the easiest way is to generate the
<code>MockDriver</code> instance as Mockito (or any other Framework) Mock.
-Like in the following Example</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="prettyprint highlight"><code>MockDevice mockDevice =
Mockito.mock(MockDevice.class);
-
-PlcDriverManager driverManager = new PlcDriverManager();
-PlcMockConnection connection = (PlcMockConnection)
driverManager.getConnection("mock:my-mock-connection");
-connection.setDevice(mockDevice);
-
-// Populate the Mock to avoid a NPE
-when(mockDevice).read(anyString()).thenReturn(Pair.of(PlcResponseCode.OK, new
PlcString("hello")));
-
-// Some Demo code that uses the same Driver Manager and either the connection
from above
-// or at least mock:my-mock-connection as connection string
-// Here: send a request to the field "MyAdress"
-connection
- .readRequestBuilder
- .addItem("station", "MyAdress")
- .build()
- .execute()
- .get();
-
-// Check that the we really issued a Read request to the Field "MyAdress"
-verify(mockDevice).read(eq("MyAdress"));</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>But as the <em>MockDriver</em> uses a static Mock Connection registry the
following Code works also</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="prettyprint highlight"><code>MockDevice mockDevice =
Mockito.mock(MockDevice.class);
-
-// Setup
-PlcDriverManager driverManager = new PlcDriverManager();
-PlcMockConnection connection = (PlcMockConnection)
driverManager.getConnection("mock:my-mock-connection");
-connection.setDevice(mockDevice);
-// Populate the Mock to avoid a NPE
-when(mockDevice).read(anyString()).thenReturn(Pair.of(PlcResponseCode.OK, new
PlcString("hello")));
-
-// Some Demo code that uses the same Driver Manager and either the connection
from above
-// or at least mock:my-mock-connection as connection string
-// Here: send a request to the field "MyAdress"
-// and we build up a new Connection
-try (PlcConnection conn =
driverManager.getConnection("mock:my-mock-connection")) {
- conn
- .readRequestBuilder
- .addItem("station", "MyAdress")
- .build()
- .execute()
- .get();
-} catch (Exception e) {
- // do nothing
-}
-
-// Check that the we really issued a Read request to the Field "MyAdress"
-verify(mockDevice).read(eq("MyAdress"));</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The Snippet above shows that the part under test really has to share
nothing with the test code except for the connection string.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="conclusion">Conclusion</h3>
-<div class="paragraph">
-<p>The above examples show that the <code>MockDriver</code> driver can not
only be used to play around with the API but is also a powerful tool to
-do unit testing of Code which uses the PLC4X API.
-All that needs to be done is to either pass an instance of the Mocked
Connection or just use the same Connection string (e.g. from a test
configuration) that was used to Prepare a Mock Device.
-Some Examples of futher (more Complex) use cases can be found in the PLC4X
Codebases, e.g. in the following classes</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>org.apache.plc4x.java.opm.PlcEntityManagerTest</code></p>
-</li>
-<li>
-<p><code>org.apache.plc4x.java.opm.PlcEntityManagerComplexTest</code></p>
-</li>
-<li>
-<p><code>org.apache.plc4x.java.scraper.ScraperTest</code></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>and many more Test classes, especially in the OPM and the Scraper
Module.</p>
-</div>
-</div>
-</div>
-</div>
- </main>
- <footer class="pt-4 my-md-5 pt-md-5 w-100 border-top">
- <div class="row justify-content-md-center" style="font-size: 13px">
- <div class="col col-6 text-center">
- Copyright © 2017–2020 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>.
-All rights reserved.<br/>
- Apache PLC4X, PLC4X, Apache, the Apache feather logo, and
the Apache PLC4X project logo are either registered trademarks or trademarks of
The Apache Software Foundation in the United States and other countries. All
other marks mentioned may be trademarks or registered trademarks of their
respective owners.
- <br/><div
style="text-align:center;">Home screen image taken from <a
- href="https://flic.kr/p/chEftd";>Flickr</a>, "Tesla
Robot Dance" by Steve Jurvetson, licensed
- under <a
href="https://creativecommons.org/licenses/by/2.0/";>CC BY 2.0 Generic</a>,
image cropped
- and blur effect added.</div>
- </div>
- </div>
- </footer>
- </div>
-</div>
-
-<!-- Bootstrap core JavaScript
-================================================== -->
-<!-- Placed at the end of the document so the pages load faster -->
-<script src="../js/jquery.slim.min.js"></script>
-<script src="../js/popper.min.js"></script>
-<script src="../js/bootstrap.min.js"></script>
-<script type="text/javascript">
- $('.carousel .carousel-item').each(function(){
- var next = $(this).next();
- if (!next.length) {
- next = $(this).siblings(':first');
- }
- next.children(':first-child').clone().appendTo($(this));
-
- for (let i = 0; i < 3; i++) {
- next=next.next();
- if (!next.length) {
- next = $(this).siblings(':first');
- }
- next.children(':first-child').clone().appendTo($(this));
- }
- });
-</script>
-</body>
-</html>
\ No newline at end of file
diff --git a/users/tools/opm.html b/users/tools/capture-replay.html
similarity index 79%
copy from users/tools/opm.html
copy to users/tools/capture-replay.html
index e1f9547..f77ff6e 100644
--- a/users/tools/opm.html
+++ b/users/tools/capture-replay.html
@@ -162,16 +162,19 @@
<a href="../../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <strong class="nav-link">Capture Replay</strong>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
@@ -222,74 +225,86 @@
</nav>
<main role="main"
class="ml-sm-auto px-4 col-sm-pull col-md-9 col-lg-10 h-100">
<div class="sect1">
-<h2 id="object_plc_mapping">Object PLC Mapping</h2>
+<h2 id="capture_replay">Capture Replay</h2>
<div class="sectionbody">
-<div class="sect2">
-<h3 id="what_is_object_plc_mapping">What is Object PLC Mapping</h3>
<div class="paragraph">
-<p>Object PLC Mapping (OPM) is heavily inspired by the Java Persistence API
(JPA) [1].
-One of the main goal of the PLC4X Project is to make it easy to communicate
with PLC devices to enable the development
-of applications that interact with PLCs.
-As many (or even most) of the application programmers are no experts in PLC
Communication and protocols it should be as
-easy as possible to interact with PLCs without too much domain knowledge.
-This is exactly the reason why JPA was initialized many years ago to allow the
interaction with a Database by simply
-calling methods on POJOs (Plain old Java Object).
-This is exactly what the OPM Module is for, to enable PLC communication by
simply interacting with a POJO.</p>
+<p>Some times the problem with industry protocols is, that the most
interesting protocols live in places that are not very welcoming to IT
folks.</p>
</div>
+<div class="paragraph">
+<p>Either too hot or too cold and usually no good coffee around.</p>
</div>
-<div class="sect2">
-<h3 id="simple_example">Simple Example</h3>
<div class="paragraph">
-<p>The following short code snippet shows how to read one value from a PLC via
OPM.
-First, a <em>PlcEntityManager</em> is instantiated, then a
<strong>connected</strong> entity is fetched for a given PLC connection address.
-Connected means that all method calls of the entity are intersected and
replaced by PLC calls.
-This is then used to print one value to the console.
-In the second snippet one can see how the Entity class looks. The address
where to read the variable <em>pressure</em> from is given
-in the <em>@PlcField</em> annotation.</p>
+<p>The <code>Capture Replay</code> tool is a little helper, that can possibly
help with this.</p>
</div>
-<div class="listingblock">
-<div class="content">
-<pre class="prettyprint highlight"><code data-lang="java">public static void
main(String[] args) {
- PlcEntityManager em = new PlcEntityManager();
- MyEntity entity = em.connect(MyEntity.class, "s7://...");
- System.out.println(entity.getPressure());
-}</code></pre>
+<div class="paragraph">
+<p>Especially when it comes to developing passive mode drivers this tool can
come in very handy.</p>
</div>
+<div class="paragraph">
+<p>It allows to replay recorded network traffic and to directly intercept this
traffic in any passive mode drivers.</p>
</div>
<div class="paragraph">
-<p>The class <em>MyEntity</em> is given by</p>
+<p>Possibly it could also work with non passive drivers, but I expect
synchronization to be tricky.</p>
</div>
-<div class="listingblock">
-<div class="content">
-<pre class="prettyprint highlight"><code data-lang="java">@PlcEntity
-public class MyEntity {
-
- @PlcField("DB01:DW01:LONG")
- private double pressure;
-
- public void MyEntity() {
- // For OPM
- }
-
- public double getPressure() {
- return pressure;
- }
-}</code></pre>
+<div class="sect2">
+<h3 id="getting_a_capture">Getting a Capture</h3>
+<div class="paragraph">
+<p>In order to create a capture I usually connect a device running
<code>WireShark</code> to the network.</p>
+</div>
+<div class="paragraph">
+<p>Ideally to the replication port of a network switch so I can record all the
traffic.</p>
</div>
+<div class="paragraph">
+<p>An alternative would be to run <code>WireShark</code> on one of the
PCs/Servers having access to the traffic I’m interested in.
+So if for example I wanted to work on a driver for control system
<code>X</code>, capturing the traffic on one of the <code>X</code> servers is
probably the simplest way to do it.
+If complicance rules prevent ths a third option would be to use a network tap
to record the capture.</p>
</div>
</div>
<div class="sect2">
-<h3 id="annotations">Annotations</h3>
-
+<h3 id="replaying_the_capture">Replaying the Capture</h3>
+<div class="paragraph">
+<p>Now you need to copy the <code>pcapng</code> file ideally to your
development system.</p>
</div>
-<div class="sect2">
-<h3 id="more_details">More details</h3>
-
+<div class="paragraph">
+<p>The capture can be replayed by the tool you find in
<code>plc4j/tools/capture-replay</code>.</p>
</div>
-<div class="sect2">
-<h3 id="references">References</h3>
<div class="paragraph">
-<p>[1] <a
href="https://www.oracle.com/technetwork/java/javaee/tech/persistence-jsp-140049.html";
class="bare">https://www.oracle.com/technetwork/java/javaee/tech/persistence-jsp-140049.html</a></p>
+<p>Here simply look for the
<code>target/plc4j-capture-replay-0.5.0-uber-jar.jar</code> and run:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>java -jar
target/plc4j-capture-replay-{current-last-released-version}-uber-jar.jar
--input-file {path to capture} --output-device {name of the network device}
--replay-speed 1 --loop true</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The options <code>input-file</code> and <code>output-device</code> are
mandatory, the rest is optional:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>input-file</code> specifies the path to the capture file (pcapng)</p>
+</li>
+<li>
+<p><code>output-device</code> name of the network device that will be used for
output (name listed when running <code>ifconfig</code> on Linux and Mac or
<code>ipconfig</code> on Windows)</p>
+</li>
+<li>
+<p><code>replay-speed</code> Speed the replay will be played back. 1 is real
time, 0 or less is <code>as fast as possible</code>, 0.5 is 50% slower than the
original and 2 is twice as fast</p>
+</li>
+<li>
+<p><code>loop</code> if set to true it will automatically start replaying the
capture from the start as soon as the end is reached</p>
+</li>
+</ul>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<div class="title">Tip</div>
+</td>
+<td class="content">
+The replay-speed is ideal to see how your driver can cope with different
volumes of traffic. So even if your driver is currently working fine, consider
using this tool in order to find out if your system could cope with 50% more
nodes or increased polling intervals etc.
+</td>
+</tr>
+</table>
</div>
</div>
</div>
diff --git a/users/tools/connection-pool.html b/users/tools/connection-pool.html
index 79c8e99..2938ff8 100644
--- a/users/tools/connection-pool.html
+++ b/users/tools/connection-pool.html
@@ -162,16 +162,19 @@
<a href="../../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/tools/index.html b/users/tools/index.html
index 2b9bb7e..3ec3bf1 100644
--- a/users/tools/index.html
+++ b/users/tools/index.html
@@ -162,16 +162,19 @@
<strong class="nav-link">Tools</strong>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/tools/opm.html b/users/tools/opm.html
index e1f9547..a550d0c 100644
--- a/users/tools/opm.html
+++ b/users/tools/opm.html
@@ -162,16 +162,19 @@
<a href="../../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <strong class="nav-link">Object PLC Mapping
(OPM)</strong>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/tools/scraper.html b/users/tools/scraper.html
index 593563c..9b4d853 100644
--- a/users/tools/scraper.html
+++ b/users/tools/scraper.html
@@ -162,16 +162,19 @@
<a href="../../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <strong class="nav-link">Scraper</strong>
+ </li>
+ <li class="nav-item">
+ <a href="../../users/tools/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
diff --git a/users/tools/testing.html b/users/tools/testing.html
index deb2454..23ad685 100644
--- a/users/tools/testing.html
+++ b/users/tools/testing.html
@@ -162,16 +162,19 @@
<a href="../../users/tools/index.html"
class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
- <a href="../../users/connection-pool.html"
class="nav-link">Connection Pool</a>
+ <a href="../../users/tools/capture-replay.html"
class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
- <a href="../../users/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
+ <a href="../../users/tools/onnection-pool.html"
class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
- <a href="../../users/scraper.html"
class="nav-link">Scraper</a>
+ <a href="../../users/tools/opm.html"
class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
- <a href="../../users/testing.html"
class="nav-link">PLC4X without a PLC and Unit Testing</a>
+ <a href="../../users/tools/scraper.html"
class="nav-link">Scraper</a>
+ </li>
+ <li class="nav-item">
+ <strong class="nav-link">PLC4X without a PLC and
Unit Testing</strong>
</li>
</ul>
</li>
![https://www.apache.org/events/current-event-234x60.png"](https://www.apache.org/events/current-event-234x60.png"){kind=link}