Skip to content
This repository has been archived by the owner on Jun 14, 2024. It is now read-only.

Converted to plain AsciiDoc #191

Merged
merged 15 commits into from
Jun 30, 2020
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
181 changes: 21 additions & 160 deletions pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -30,15 +30,8 @@
<name>Jakarta EE Tutorial</name>

<properties>
<site.output.dir>${project.build.directory}/staging</site.output.dir>
<maven.site.skip>true</maven.site.skip>
<asciidoctor.maven.plugin.version>1.5.7.1</asciidoctor.maven.plugin.version>
<!-- XXX - jbake needs an older version than this -->
<asciidoctorj.version>1.6.2</asciidoctorj.version>
<asciidoctorj.pdf.version>1.5.0-alpha.16</asciidoctorj.pdf.version>
<jruby.version>9.2.6.0</jruby.version>
<!-- status: DRAFT, BETA, etc., or blank for final -->
<status>DRAFT</status>
<asciidoctor.maven.plugin.version>2.0.0-RC.1</asciidoctor.maven.plugin.version>
</properties>
<scm>
<connection>scm:git:git@github.com:eclipse-ee4j/jakartaee-tutorial.git</connection>
Expand All @@ -55,133 +48,37 @@
<defaultGoal>package</defaultGoal>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-enforcer-plugin</artifactId>
<version>1.4.1</version>
<executions>
<execution>
<id>enforce-versions</id>
<goals>
<goal>enforce</goal>
</goals>
<configuration>
<rules>
<requireJavaVersion>
<version>[1.8.0,1.9.0)</version>
<message>You need JDK8 or lower</message>
</requireJavaVersion>
</rules>
</configuration>
</execution>
</executions>
</plugin>
<plugin>
<groupId>org.glassfish.doc</groupId>
<artifactId>glassfish-doc-maven-plugin</artifactId>
<groupId>org.asciidoctor</groupId>
<artifactId>asciidoctor-maven-plugin</artifactId>
<version>${asciidoctor.maven.plugin.version}</version>
<executions>
<execution>
<id>generate-toc</id>
<id>asciidoc-to-html</id>
<phase>generate-resources</phase>
<goals>
<goal>toc</goal>
<goal>process-asciidoc</goal>
</goals>
<configuration>
<chapterPatterns>
[0-9]+\s.*,Preface.*,Part\s.*
</chapterPatterns>
<ignoreTagPatterns>JEET.*</ignoreTagPatterns>
<backend>html5</backend>
<attributes>
<doctype>book</doctype>
<status>${status}</status>
<data-uri />
<icons>font</icons>
<toc>left</toc>
<icons>font</icons>
<sectanchors>true</sectanchors>
<idprefix />
<idseparator>-</idseparator>
<docinfo1>true</docinfo1>
</attributes>
</configuration>
</execution>
<execution>
<id>generate-book</id>
<phase>generate-resources</phase>
<goals>
<goal>book</goal>
</goals>
</execution>
</executions>
</plugin>
<plugin>
<groupId>com.blazebit</groupId>
<artifactId>jbake-maven-plugin</artifactId>
<version>1.0.0</version>
<configuration>
<outputDirectory>${site.output.dir}</outputDirectory>
<properties>
<status>${status}</status>
</properties>
</configuration>
<executions>
<execution>
<id>build-site</id>
<phase>generate-resources</phase>
<goals>
<goal>build</goal>
</goals>
</execution>
</executions>
<dependencies>
<dependency>
<groupId>org.asciidoctor</groupId>
<artifactId>asciidoctorj</artifactId>
<version>1.5.5</version>
</dependency>
</dependencies>
</plugin>
<plugin>
<groupId>org.asciidoctor</groupId>
<artifactId>asciidoctor-maven-plugin</artifactId>
<version>${asciidoctor.maven.plugin.version}</version>
<dependencies>
<dependency>
<groupId>org.jruby</groupId>
<artifactId>jruby-complete</artifactId>
<version>${jruby.version}</version>
</dependency>
<dependency>
<groupId>org.asciidoctor</groupId>
<artifactId>asciidoctorj</artifactId>
<version>${asciidoctorj.version}</version>
</dependency>
<dependency>
<groupId>org.asciidoctor</groupId>
<artifactId>asciidoctorj-pdf</artifactId>
<version>${asciidoctorj.pdf.version}</version>
</dependency>
</dependencies>
<configuration>
<sourceDirectory>${project.build.directory}/book</sourceDirectory>
<sourceDocumentName>book.adoc</sourceDocumentName>
<!-- XXX - below depends on running jbake first -->
<imagesDir>${project.build.directory}/staging/</imagesDir>
<backend>pdf</backend>
<outputFile>JakartaEETutorial.pdf</outputFile>
<attributes>
<pdf-stylesdir>${project.basedir}/src/theme</pdf-stylesdir>
<pdf-style>jakartaee</pdf-style>
<doctype>book</doctype>
<status>${status}</status>
<data-uri />
<icons>font</icons>
<pagenums />
<toc />
<icons>font</icons>
<sectanchors>true</sectanchors>
<idprefix />
<idseparator>-</idseparator>
<docinfo1>true</docinfo1>
<embedAssets>true</embedAssets>
</attributes>
<sourceDocumentName>index.adoc</sourceDocumentName>
<sourceHighlighter>coderay</sourceHighlighter>
</configuration>
<executions>
<execution>
<id>generate-pdf-doc</id>
<phase>generate-resources</phase>
<goals>
<goal>process-asciidoc</goal>
</goals>
</execution>
</executions>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
Expand All @@ -200,43 +97,7 @@
</dependency>
</dependencies>
</plugin>

<!--
This is the rule that builds the zip file for download.
-->
<plugin>
<artifactId>maven-assembly-plugin</artifactId>
<inherited>false</inherited>
<executions>
<execution>
<phase>package</phase>
<goals>
<goal>single</goal>
</goals>
<configuration>
<descriptors>
<descriptor>tutorial.xml</descriptor>
</descriptors>
</configuration>
</execution>
</executions>
</plugin>
</plugins>

<pluginManagement>
<plugins>
<plugin>
<groupId>org.glassfish.doc</groupId>
<artifactId>glassfish-doc-maven-plugin</artifactId>
<version>1.2</version>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-assembly-plugin</artifactId>
<version>2.4</version>
</plugin>
</plugins>
</pluginManagement>
</build>

<profiles>
Expand Down
30 changes: 30 additions & 0 deletions src/main/asciidoc/batch-processing/batch-processing.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
= Batch Processing

[[GKJIQ6]][[batch-processing]]

This chapter describes Jakarta Batch,
which provides support for defining, implementing, and running
batch jobs. Batch jobs are tasks that can be executed without user
interaction. The batch framework is composed of a job specification
language based on XML, a Java API, and a batch runtime.

include::batch-processing001.adoc[]

include::batch-processing002.adoc[]

include::batch-processing003.adoc[]

include::batch-processing004.adoc[]

include::batch-processing005.adoc[]

include::batch-processing006.adoc[]

include::batch-processing007.adoc[]

include::batch-processing008.adoc[]

include::batch-processing009.adoc[]

include::batch-processing010.adoc[]

Original file line number Diff line number Diff line change
@@ -1,16 +1,6 @@
type=page
status=published
title=Introduction to Batch Processing
next=batch-processing002.html
prev=batch-processing.html
~~~~~~
Introduction to Batch Processing
================================

[[BCGJDEEH]][[introduction-to-batch-processing]]

Introduction to Batch Processing
--------------------------------
== Introduction to Batch Processing

Some enterprise applications contain tasks that can be executed without
user interaction. These tasks are executed periodically or when resource
Expand Down Expand Up @@ -48,8 +38,7 @@ other common characteristics of batch frameworks.

[[sthref261]][[steps-in-batch-jobs]]

Steps in Batch Jobs
~~~~~~~~~~~~~~~~~~~
=== Steps in Batch Jobs

A step is an independent and sequential phase of a batch job. Batch jobs
contain chunk-oriented steps and task-oriented steps.
Expand Down Expand Up @@ -86,7 +75,7 @@ batch job.
[[BABFJBAH]]

.*Figure 58-1 Chunk Steps in a Batch Job*
image:img/jakartaeett_dt_058.png[
image:jakartaeett_dt_058.png[
"This figure shows a batch job that contains two chunk steps: step A and
step B. Step A has the three parts of a chunk-oriented step: input
retrieval A, business processing A, and output writing A. Step B also
Expand All @@ -109,8 +98,7 @@ files from the bills generated for the previous month.

[[sthref263]][[parallel-processing]]

Parallel Processing
~~~~~~~~~~~~~~~~~~~
=== Parallel Processing

Batch jobs often process large amounts of data or perform
computationally expensive operations. Batch applications can benefit
Expand All @@ -127,8 +115,7 @@ run in parallel.

[[sthref264]][[status-and-decision-elements]]

Status and Decision Elements
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
=== Status and Decision Elements

Batch frameworks keep track of a status for every step in a job. The
status indicates if a step is running or if it has completed. If the
Expand All @@ -150,7 +137,7 @@ chunk steps, task steps and a decision element.
[[BCGDCDCA]]

.*Figure 58-2 Steps and Decision Elements in a Job*
image:img/jakartaeett_dt_059.png[
image:jakartaeett_dt_059.png[
"This figure shows a batch job that contains two chunk steps, a task step
and a decision element. The job starts with chunk step A, continues with
chunk step B, and then decision element D evaluates condition 1. The
Expand All @@ -160,8 +147,7 @@ ends."]

[[sthref266]][[batch-framework-functionality]]

Batch Framework Functionality
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
=== Batch Framework Functionality

Batch applications have the following common requirements.

Expand Down
Loading