diff --git a/README.md b/README.md index 098de065..e0f00be6 100644 --- a/README.md +++ b/README.md @@ -27,15 +27,15 @@ For example **(these environment variables are only set in your terminal session #### Linux bash ```shell -export BENERATOR_HOME=/home/user1/rapiddweller-benerator-ce-3.0.0-jdk-11-dist +export BENERATOR_HOME=/home/user1/rapiddweller-benerator-ce-3.0.1-jdk-11-dist export PATH=$BENERATOR_HOME/bin:$PATH chmod a+x $BENERATOR_HOME/bin/*.sh ``` #### Windows 10 PowerShell ```powershell -$env:BENERATOR_HOME='C:\Users\user1\rapiddweller-benerator-ce-3.0.0-jdk-11-dist' -$env:Path += 'C:\Users\user1\rapiddweller-benerator-ce-3.0.0-jdk-11-dist\bin' +$env:BENERATOR_HOME='C:\Users\user1\rapiddweller-benerator-ce-3.0.1-jdk-11-dist' +$env:Path += 'C:\Users\user1\rapiddweller-benerator-ce-3.0.1-jdk-11-dist\bin' ``` 5. create your own benerator script myscript.xml with the following content @@ -119,7 +119,7 @@ mvn -version 1. Choose how to install: a) Download a Prebuilt Distribution from **Project Overview > Releases** - (current release is `3.0.0`, cp. rapiddweller-benerator-ce-3.0.0-jdk-11-dist.zip) + (current release is `3.0.1`, cp. rapiddweller-benerator-ce-3.0.1-jdk-11-dist.zip) and unzip the downloaded file in an appropriate directory, e.g. `/Developer/Applications` or `C:\Program Files\Development`. @@ -135,10 +135,10 @@ mvn -version - Windows Details: Open the System Control Panel, choose Advanced Settings - Environment Variables. Choose New in the User Variables section. Enter BENERATOR_HOME as name and the path as value - (e.g. `C:\Program Files\Development\rapiddweller-benerator-ce-3.0.0-jdk-11`). Click OK several times. + (e.g. `C:\Program Files\Development\rapiddweller-benerator-ce-3.0.1-jdk-11`). Click OK several times. - Mac/Unix/Linux Details: Add an entry that points to Benerator, - e.g.: `export BENERATOR_HOME=/Developer/Applications/rapiddweller-benerator-ce-3.0.0-jdk-11` + e.g.: `export BENERATOR_HOME=/Developer/Applications/rapiddweller-benerator-ce-3.0.1-jdk-11` 4. On Unix/Linux/Mac systems: **Set permissions** Open a shell on the installation's root directory and execute diff --git a/doc/command_line_tools.md b/doc/command_line_tools.md index 24d17e97..e75346f0 100644 --- a/doc/command_line_tools.md +++ b/doc/command_line_tools.md @@ -91,7 +91,7 @@ so the report will look something like this: ```text +---------------------------------------------------------------------------+ -| Benchmark throughput of Benerator Community Edition 3.0.0-jdk-11 | +| Benchmark throughput of Benerator Community Edition 3.0.1-jdk-11 | | on a Mac OS X 11.4 x86_64 with 8 cores | | Java version 11.0.11 | | OpenJDK 64-Bit Server VM 11.0.11+9 (AdoptOpenJDK) | @@ -134,7 +134,7 @@ the following result: ```text +-----------------------------------------------------------------------------+ -| Benchmark throughput of Benerator Enterprise Edition 3.0.0-jdk-11 | +| Benchmark throughput of Benerator Enterprise Edition 3.0.1-jdk-11 | | on a Mac OS X 11.4 x86_64 with 8 cores | | Java version 11.0.11 | | OpenJDK 64-Bit Server VM 11.0.11+9 (AdoptOpenJDK) | diff --git a/doc/installation.md b/doc/installation.md index bbdf9cd4..1a414e90 100644 --- a/doc/installation.md +++ b/doc/installation.md @@ -7,7 +7,7 @@ Download Benerator from: [https://github.com/rapiddweller/rapiddweller-benerator-ce/releases/](https://github.com/rapiddweller/rapiddweller-benerator-ce/releases/) You should download the most recent version of the rapiddweller-benerator-dist archive from the download page, e.g. -_rapiddweller-benerator-ce-3.0.0-jdk-11-dist.zip_ . +_rapiddweller-benerator-ce-3.0.1-jdk-11-dist.zip_ . !!! warning @@ -84,7 +84,7 @@ On any OS, open a console window (shell,cmd or powershell) and type ... ```shell $ benerator -–version -Benerator Community Edition 3.0.0-jdk-11 +Benerator Community Edition 3.0.1-jdk-11 Java version: 11.0.11 JVM product: OpenJDK 64-Bit Server VM 11.0.11+9 (AdoptOpenJDK) System: Mac OS X 10.16 x86_64 diff --git a/src/main/resources/com/rapiddweller/benerator/benerator-3.0.1.xsd b/src/main/resources/com/rapiddweller/benerator/benerator-3.0.1.xsd new file mode 100644 index 00000000..8b0ddd46 --- /dev/null +++ b/src/main/resources/com/rapiddweller/benerator/benerator-3.0.1.xsd @@ -0,0 +1,1367 @@ + + + + + The Benerator schema describes the generation setup for Benerator. + + + + + Root element of Benerator files + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Imports classes, domains, platforms or defaults + + + + + + + + + + + + Prints a message to the console + + + + + + + + + + + + + + + + + + + + + Emit a beep + + + + + Include a properties file + + + + + + + + Global property value + + + + + + + + + + + + + + + + + + Instantiates a JavaBean of the given class. + If the 'id' is set, the bean is put into the context with that name. + If the JavaBean itself has a property named 'id', + this one is set to the value specified here. + + + + + + + + + + + + + + + + + + + + + + + + Sets a JavaBean's property to the value specified as 'value' attribute + or to the object stored in the setting 'ref'. + + + + + + + + + + + + + + + + + + + References a JavaBean (of the 'id' specified by the 'bean' attribute) + + + + + + + + In-memory storage system + + + + + + + + Instantiates and executes a JavaBean that implements the Task interface. + Properties are handled like in the <bean> tag. + The task is executed 'count' times in a number of 'threads' parallel threads. + Invocations are executed in groups of size 'pageSize' + + + + + + + + + + + + + Executes a script, e.g. SQL + + + + + + + + + + + + + + + + + + + + evaluates a script, e.g. SQL + + + + + + + + + + + + + Finishes Benerator execution with an error message and, if specified, an error code. + The 'exitCode' is returned to the calling process as process exit code. + + + + + + + + + + + + + Evaluates the 'test' expression. + If it returns true, then the <them> element is executed, + otherwise the <else> element. + + + + + + + + + + + + + + + + + + + + Runs the contained elements in a loop as long as the 'test' expression resolves to true. + + + + + + + + + + + + + + Waits for either a fixed 'duration' or a random one with the distribution characteristics + specified by 'min', 'max', granularity' and 'distribution'. + Time is measured in milliseconds. + + + + + + + + + + + + + Creates a DOM Tree + + + + + + + + + + + + + + Can be used to define meta model for entities. + + + + + + + + + + + + + + + + + + + + + + + + Marker for pre parsing generate tags to type descriptors and distribute them to custom storage systems. + + + + + + + + + + + + Generates entities. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Iterates entities from a 'source'. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Defines a variable that is recreated by a generator on each entity creation + + + + + + + + + + + + + + + + + Defines a simple-type component of an entity. + + + + + + + + + + Defines a complex-type component of an entity (sub entity). + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Defines a simple-type component of an entity which is a unique key. + + + + + + + + + + Defines a combination of simple-type components of an entity which forms a unique key. + + + + + + + + + + + + + Defines a simple-type component of an entity which refers the unique key of another entity. + + + + + + + + + + Defines a combination of simple-type components of an entity + which refer to a composite unique key of another entity. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + A number or datetime value specifying the lower bound of an allowed value range. + + + + + + + + Specifies if the 'min' value is included in the allowed value range. + + + + + + + + A number or datetime value specifying the upper bound of an allowed value range. + + + + + + + + Specifies if the 'max' value is included in the allowed value range. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Filters data import with a script expression. + + EE + 2.0.0 + + + + + + + + + + + + + + + + + + + + + + + + + Flag to apply to a data source, indicating whether imported data + shall be imported as formatted string (formatted) or as raw data objects (raw). + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Defines default generation configurations for field names that occur in different data types. + Popular examples: 'createdAt', 'createdBy'. + + + + + + + + + + + + + + + Attributes for which to verify anonymization. + + EE + 2.0.0 + + + + + + + + + + + + + + Relational database + + + + + + + + + + + + + + + + + + + + + + + + + + + Transcodes rows from one database to another + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + A JMS queue or topic to read data from or write data to. + + EE + 2.0.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + EE + 2.0.0 + + Data format to use for JMS messages + + + + + + + + + + + + + + + + + + + + Importer for entity data from a Kafka queue. + + EE + 2.0.0 + + + + + + + + + + + + + + + + Exporter for entity data to a Kafka queue + + EE + 2.0.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + The URL by which a schema definition of the message protocol (eg. AVRO schema) can be retrieved + + 3.0.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 3.0.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + One of Benerator's predefined simple data types. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Value (like '12345') or script expression (like '{prototype.count}') + which resolves to an integer greater or equal to 0. + + + + + + + + + + + + + + + + Value (like '12345') or script expression (like '{prototype.count}') + which resolves to an integer greater or equal to 1. + + + + + + + + + + + + + + + + Value (like '12345') or script expression (like '{prototype.count}') + which resolves to value that can specify a bound of a value range, + eg. integer, double or date. + + + + + + + + + + + + + + + + + + + + + + + + + + + + long value (like '12345') or script expression (like '{prototype.count}') which resolves to a long. + + + + + + + + + + + + + + + + double value (like '3.141') or script expression (like '{Math.PI}') which resolves to a double. + + + + + + + + + + + + + + + boolean value or script expression which resolves to a boolean. + + + + + + + + + + + + + 64-bit long value greater or equals to 0. + + + + + + + 64-bit long value greater or equals to 1. + + + + + + + + + Script expression in the form '{header:text}' of which an optional 'header' identifies the script lange + to use for the evaluation of 'text'. If no header is used (like 'text'), the text is evaluated in the + default script language. + + + + + + + + + + + When set to 'ignored', the related attribute, id or reference is not processed + + + + + + + + + + + A handler to call when an error occurs in the related element. + Each instance logs the error message with a log level corresponding to the name. + The 'fatal' error-handler cancels execution additionally. + + + + + + + + + + + + + + + + + + + +